Lzheng Training System

Lzheng 本地训练系统

把本 Skill 当作套件总控层：它只做安装、配置、路由、升级保护和验收；训练处方由四个训练处方 Skill 生成，营养系统独立维护 nutrition_contract，专家库只作为共享知识层，工作台只负责展示。

首次使用者引导

当用户刚完成安装、刚下载本套件，或第一次说“开始”“想增肌/减脂/提升力量”“帮我建立健身系统”时，不要要求用户先阅读 README、输入命令或记住 Skill 名称。直接回复：

我来帮你建立个人健身系统。先确定你的主要目标：增肌、减脂、力量，还是综合改善？

随后依次完成：

1. 询问目标、近期训练、时间、器械、恢复、限制和可用记录；
2. 没有可靠动作重量时安排负荷校准，不让用户自行猜重量；
3. 初始化新的空目录、工作台和事实文件；
4. 生成第一版正式计划，将它接入当前周期、执行基准、复盘索引和工作台；
5. 告诉用户以后只需说“今天练了什么”和主观体感，AI 负责下一次明确处方与刷新。

若当前聊天尚未加载新 Skill，提示用户只需新开对话后说“开始建立我的健身系统”；不得让用户阅读 README 寻找下一步。

先选动作

运行前读取 系统契约。涉及交接时读取 交接契约。涉及完整计划、力量周期或工作台 HTML 时读取 单文件 HTML 模板总契约，只允许使用其中登记的三套固定模板。

日常计划修改、训练复盘和状态确认先运行 inspect。--root 可指向含 系统/lzheng-system.json 的完整系统根目录，也可直接指向含 健身工作台.html 的训练项目根目录。它只输出紧凑状态和权威主源路径；随后按任务读取对应的一个计划、基准或复盘文件。除非正在开发视觉模板或检查器已经报告模板结构损坏，不得读取整份 健身工作台.html、工作台模板、历史计划目录或全部专家模块。

日常路由

1. 完整建档、长期训练计划、短版降级：lzheng-fitness-plan。
2. 一个动作的 8—12 周力量周期：lzheng-strength-cycle-planner；结果必须交回完整计划 Skill 合并后才可成为当前计划。
3. 单练或周训练复盘、下一次处方：lzheng-strength-training-review；正式复盘必须更新索引并触发工作台刷新。
4. 停训 7 天、连续漏练 3 次、条件明显变化：lzheng-training-return；改变执行状态时先更新执行基准或当前计划，再刷新工作台。
5. 饮食建档、日型目标、餐食确认与两周趋势复盘：lzheng-nutrition-system；它不按单次训练消耗补吃，也不自动确认照片估算。
6. 工作台构建、数据刷新、迁移、发布：lzheng-fitness-workbench-builder；它只读聚合，不给出处方。

四个训练处方 Skill 与营养 Skill 在需要来源限定判断时内部读取 lzheng-training-expert-library。专家库不是独立处方入口，不拥有当前事实、计划版本、营养协议或工作台写入权。

专业 Skill 执行前按以下优先级解析根目录：本次用户明确路径 → 系统/lzheng-system.json → 环境变量 LZHENG_FITNESS_HOME → 仅用于首次引导的保守默认目录。已存在系统配置时，计划、周期、复盘、状态和接回卡必须优先写入 output_locations 指定的知识库分区，不得继续散落到当前工作目录。未解析到系统时停止写入并说明缺失项，不把示例数据当作训练事实。

命令

powershellCopy code
python scripts/lzheng_training_system.py bootstrap --target "<空目录>"
python scripts/lzheng_training_system.py doctor --root "<系统根目录>"
python scripts/lzheng_training_system.py inspect --root "<系统根目录>"
python scripts/lzheng_training_system.py upgrade --root "<系统根目录>"
python scripts/lzheng_training_system.py upgrade-workbench-ui --root "<系统根目录>" --check-only
python scripts/lzheng_training_system.py upgrade-workbench-ui --root "<系统根目录>" --apply
python scripts/lzheng_training_system.py install-skill --root "<系统根目录>" --name lzheng-fitness-plan
python scripts/lzheng_training_system.py import-private-pack --root "<系统根目录>" --source "<用户明确指定的目录>"
python scripts/lzheng_training_system.py refresh-workbench --root "<系统根目录>" [--notion "<notion-data.json>" --notion-mode incremental|full]
python scripts/lzheng_training_system.py process-handoffs --root "<系统根目录>" [--notion "<notion-data.json>" --notion-mode incremental|full]
python scripts/lzheng_training_system.py validate --root "<系统根目录>"

bootstrap 仅接受空目录；upgrade 只更新托管配置与模板清单，发现用户改过的托管文件时保留原件并报告冲突；私人知识、计划、复盘、状态档案和 Notion 导出永不覆盖。所有命令均使用 UTF-8，兼容中文、空格和非系统盘路径。

refresh-workbench 是日常单命令闸门：先预检数据，再 apply，随后用正式 checker 验证；可选增加 --deploy "<本地发布目录>" --release-mode public-anonymized。若选择 private-portable，必须再传 --confirm-private-portable，明确承认副本含完整个人训练数据且只能进入有鉴权的私有环境。命令生成 JSON 回执，分别记录 formal_refreshed、release_prepared、deployed、online_verified；它不执行上传或线上访问，所以后两项不能变成 true。

整份主项实际历史的权威替换属于高风险例外：只允许在显式提供 --notion "<完整快照>" --notion-mode full --replace-main-lift-history --confirm-replace-main-lift-history 时执行；普通同步和 process-handoffs 不得携带该替换权限。

process-handoffs 复用同一刷新闸门。只有回执中的正式 checker 为 PASS，交接才标记 formal_refreshed；旧版 refreshed 仍会被识别为已处理并跳过。交接成功不自动制作发布副本，更不代表网站已更新。

完成闸门

只有以下全部通过才可说本地系统可用：

• doctor 显示配置、四个训练处方 Skill、营养 Skill、专家库、工作台构建器、主源目录和工作台均可用；
• validate 通过每个 Skill 的快速校验、工作台数据/HTML 检查和隐私扫描；
• 在新的隔离空目录 bootstrap 成功，并显示“待建档”而不是假重量；
• 整套系统移动到不同盘符或改名后，旧绝对路径自动迁移，doctor 与 upgrade 继续通过；
• 每次正式复盘和接回均生成 LZHENG_HANDOFF，经 process-handoffs 获得带 checker PASS 和回执哈希的 formal_refreshed，或明确报告失败。

一句话升级与视频学习

用户要求升级整套系统时，在已核对的官方仓库读取 docs/UPGRADE.md，使用 tools/upgrade.py 完成界面检查、备份、保留记录与知识内容、更新安装 Skill。用户自定义界面由 Agent 按差异修复，不静默覆盖。安装更新不等于线上发布。

用户要学习收藏或指定视频时，调用 lzheng-video-learning；不同主题均可，只有健身内容按需回到本系统。知识上工作台用 lzheng-knowledge-library，默认空知识库，不导入作者的私人内容。