使用指南

基本使用流程

  1. 在浏览器中打开 index.html（Classic 主题）或 liquid.html（Liquid 主题）
  2. 在右侧面板中填写你的运动数据——至少需要设置距离和配速，其余字段有默认值
  3. 选择一张校园地图作为背景——南体育场、军工操场或北体育场
  4. 选择一个轨迹样式——预设的固定轨迹、或者勾选"随机轨迹"让系统自动生成
  5. 观察左侧预览卡片——调整参数直到卡片看起来满意为止
  6. 点击"保存高清图片"按钮下载 PNG 文件
  7. （可选）点击"保存配置"按钮将当前所有设置保存到浏览器，下次打开页面自动恢复

运动数据参数说明

  • 标题——卡片顶部显示的运动标题，例如"晨跑 5 公里"或"HIIT 间歇跑"
  • 距离（公里）——跑步的总距离。可以输入精确数值，也可以设置最小/最大范围让系统随机填充
  • 配速（分钟/公里）——每公里的平均用时。支持 mm'ss" 格式（例如 5'30" 表示每公里 5 分 30 秒）。同样可以设置随机范围
  • 卡路里——根据公式 69 × 距离（公里） × 1.036 自动计算。公式基于 MET 法（8 km/h 速度跑步的代谢当量），1.036 是环境温度校正系数
  • 运动时长——自动计算：配速（转换为十进制分钟）× 距离，结果拆分为小时:分钟:秒

时间与环境参数

  • 日期和时间——卡片上显示的跑步日期和具体时间。默认使用当前日期和时间
  • 温度（℃）——跑步时的气温。如果不填，使用默认值。支持负值（哈尔滨冬天经常零下）
  • 湿度（%）——相对湿度百分比。影响卡片上的天气图标选择
  • 风速（m/s）——可选的风速数据。如果有值，卡片上会显示风的信息

地图与轨迹设置

  • 校园场地——在下拉菜单中选择南体育场、军工操场或北体育场。选择后卡片背景自动切换为对应的卫星地图
  • 轨迹样式——5 种预设的固定轨迹可供选择。每种样式有不同的圈数、形状和颜色
  • 随机轨迹——勾选后系统使用椭圆分解算法自动生成随机轨迹。每次点击"重新生成"或修改参数后轨迹都会重新随机生成
  • 渐变色轨迹——开启后轨迹颜色在路径上不断变化（绿→黄→红），模拟 Keep 的配速颜色编码。关闭后轨迹为单一颜色
  • 手动绘制——在预览卡片上用手指或鼠标直接画出跑步轨迹。绘制的笔画被保存为坐标数组，可以导出和重放

自定义背景地图

在"地图与轨迹"分组中点击"上传自定义背景"，选择一个本地图片文件。支持的格式包括 JPG、PNG、WebP。上传后背景地图替换为你的图片，轨迹会根据新图片的比例自动调整缩放。

头像上传

在右侧面板的顶部区域有一个头像占位符。点击它可以上传你的头像照片。头像会显示在卡片上（圆形裁剪），和 Keep 卡片中的用户头像一致。上传后头像数据以 base64 格式存储在 IndexedDB 中。