训记训练数据 Dashboard 是一个基于训记 Open API 的自托管训练数据看板。用户用自己的训记 API Key 把训练记录拉到本地，在浏览器里查看减脂与增肌两个方向的多维分析、训练日历热力图和逐个动作的进步曲线。项目采用 MIT 许可证开源，代码部署在用户自己的机器上，数据不出本地。
一句话定位：它不替用户记录训练——记录仍由训记 App 完成——它负责把积累下来的训练数据变成能下钻、能对比、能回答「最近练得怎么样」的图表。作为效率工具，它适合已在用训记记录训练、又想看清自己长期趋势的健身用户。在工具推荐类内容里，这种围绕单一数据源深耕的小项目，往往比大而全的分析平台更耐用。
场景痛点
在训记 App 里翻训练记录，常见的问题是「看得见单次，看不见趋势」。想知道这个月的容量比上个月涨了多少、某个动作的重量爬到哪一步了、减脂期的有氧里程和心率变化如何，往往要一页页往回翻，凭记忆拼凑结论。App 内的统计维度也偏固定，换个角度（比如按星期几看训练分布、按部位看月度容量）就没有现成答案。
另一个问题是数据归属。训练记录属于个人健康信息，有些用户不希望把它交给第三方在线服务再分析一遍。市面上的分析看板大多做多用户 SaaS，注册、上传、托管一条龙，数据反而离开了用户自己的设备。
把这两个问题放在一起，答案指向一类小众但稳妥的方案：给自己搭一个训练数据的个人仪表盘。
核心功能
六个分析页面
看板按分析目标拆成六个页面：
| 页面 | 内容 |
| 总览 | KPI、月度趋势、力量 vs 有氧、部位分布 |
| 减脂分析 | 有氧里程 / 消耗、心率、训练记录 |
| 增肌训练 | 容量增长、部位月度、Top 动作 |
| 训练节奏 | 周频率、星期 / 时段分布 |
| 动作进步 | 动作趋势、PR；下钻看历史组数与重量进步 |
| 训练日历 | 热力图；下钻看当日完整训练 |
总览页回答整体状态，减脂和增肌两个页面分别服务两种训练目标，训练节奏页暴露作息规律，动作进步页和训练日历页负责逐动作、逐日的细节回看。
多维下钻
所有图表支持按月 / 周 / 部位 / 动作 / 日五个维度下钻。看到某个月容量异常，可以钻到那个月的具体动作；看到某个动作的 PR，可以钻到打破 PR 那天的完整训练内容。分析不再是静态报表，而是一层层的提问与验证。
数据留在本地
架构上这是标准的自托管方案：每人使用自己的训记 API Key（形如 xjllm_...），原始数据按日缓存在本地 data/cache/ 目录，聚合结果写入 analysis.json，全部不离开用户机器。.gitignore 已排除这些文件，项目也不做多用户 SaaS。看板本身是跑在浏览器里的 Web应用，无需安装客户端。
同步交给容器内的自动化定时任务：默认每天 06:30 增量抓取，并强制重抓最近 3 天数据以覆盖延迟补录的训练记录，同步频率和重抓窗口都可在 .env 中调整。
安装与使用
以下使用教程以 Docker 路线为主，末尾附不经 Docker 的本地开发路线。
前置条件
- 已安装 Docker（推荐），或本机具备 Python 3.10+ 与 Node 20+
- 在训记 App 中申请 Open API / LLM Key（形如
xjllm_...）；Key 只属于用户自己的账号，不要提交到 Git，不要发给别人
安装（Docker 路线）
浏览器打开 http://localhost:8080。首次启动后在总览页点「增量同步训练数据」，也可以交给容器内定时任务自动同步。
配置项说明
| 变量 | 必填 | 说明 |
XUNJI_API_KEY | 是 | 训记 Open API Key |
DASHBOARD_PORT | 否 | 默认 8080 |
SYNC_ENABLED | 否 | 默认 true，定时增量抓取 |
SYNC_CRON | 否 | 默认 30 6 * * *（每天 06:30） |
SYNC_REFRESH_DAYS | 否 | 每次强制重抓最近 N 天，默认 3 |
TZ | 否 | 默认 Asia/Shanghai |
不用 Docker 的本地开发路线
部署与运维要点
- 日常运维走
./scripts/docker-ops.sh：status查状态与健康检查，logs看日志，refresh重新聚合分析数据，rebuild在代码更新后无缓存重建 - 可部署到云主机（如腾讯云轻量 / CVM），流程与家用 Ubuntu 相同
- 公网暴露警告：看板当前无登录功能，把未设访问控制的实例直接挂公网等同于公开训练数据。README 的建议是前面加 Nginx / Caddy 启用 HTTPS，安全组只放行 443，或走 VPN / Tailscale 访问
- 仓库不包含任何默认 API Key，未配置
XUNJI_API_KEY时同步会直接失败并提示；若 Key 曾泄露，在训记 App 中轮换
仓库于 2026 年 8 月 27 日完成初始开源发布（作者 imklayhu），同日有 README 更新，截至当日约 3 star，距离 GitHub精选级别的人气还很远，但功能完整度和安全说明的坦诚程度不输成熟项目，暂无正式 release 版本号。训记 App、Open API 及其商标归各自权利人所有，使用 API 须遵守训记官方条款。
我的使用感受
这套看板最打动人的是边界感：它明确说自己不做多用户 SaaS，数据只存本地，连「无登录」这个短板都直白地写进 README 警告用户别直接挂公网。功能上也克制——只围绕训记已有数据做分析，不越界替代记录。在近期的软件发现经历里，这种把丑话说在前头的实用软件并不多见。「动作进步曲线下钻到历史组数」和「训练日历下钻到当日完整训练」这两条链路，基本覆盖了复盘时最常问的问题，部署完它就是跑在自己机器上的一个有趣的网站，也带着点有趣软件式的个人项目气质。
官方网站
https://github.com/imklayhu/xunji-log
下载地址
https://pan.quark.cn/s/74c2add79ec5
