健康看板编辑助手

为什么需要它

维护个人健康看板时，编辑风险远高于「把数据填进去」这件事本身。化验指标需要长期对比，data.json 和 HTML 模板会随记录不断膨胀；一旦字段口径漂移、历史被覆盖，或近千行模板被整体重写，修复成本会迅速超过重新整理 Excel。本技能的核心不是替你看报告，而是用一套固定纪律约束编辑过程，并在破坏发生前拦住错误。

它如何工作

• 数据更新：新增指标前先确认名称、单位与参考区间是否与历史一致，再写入 data.json，保留时序记录。
• 校验前置：更新前后都运行 validate_data.py，确认 indicators、dates、records 结构完整，0 错误才继续。
• 看板拼接：assemble.py 从 index_template.html 生成 index.html，构建前自动备份到 _backups/，失败时可用 --rollback TIMESTAMP 恢复。
• 综合巡检：health_check.py 检查数据结构、页面完整性、备份新鲜度与部署 URL 可达性，异常写入 _alerts/。
• 快速起步：bootstrap.py 可在 30 秒内生成目录、demo 数据和深色主题模板；也可直接复制 starter-kit.md 中的三份文件搭建最小项目。

适用边界

• 必须使用 DeepSeek-V4-Pro（超高思考强度），不使用 Auto 模式，否则长模板编辑容易出现术语与口径漂移。
• 模板保持单文件结构稳定，只做最小改动；不整体重写 DOM 或脚本。
• 看板依赖应本地化，避免外网 API；gen_lab_reports.py 为可选脚本。
• 不绑定固定路径或私有知识库，部署与同步由用户自行配置；健康数据只保存在用户自己的环境。