LZheng0411 Lzheng 本地训练系统
把本 Skill 当作套件总控层：它只做安装、配置、路由、升级保护和验收；训练处方由四个训练处方 Skill 生成，营养系统独立维护 nutrition_contract，专家库只作为共享知识层，工作台只负责展示。
首次使用者引导
当用户刚完成安装、刚下载本套件，或第一次说“开始”“想增肌/减脂/提升力量”“帮我建立健身系统”时，不要要求用户先阅读 README、输入命令或记住 Skill 名称。直接回复：
我来帮你建立个人健身系统。先确定你的主要目标：增肌、减脂、力量，还是综合改善？
随后依次完成：
- 询问目标、近期训练、时间、器械、恢复、限制和可用记录；
- 没有可靠动作重量时安排负荷校准，不让用户自行猜重量；
- 初始化新的空目录、工作台和事实文件；
- 生成第一版正式计划，将它接入当前周期、执行基准、复盘索引和工作台；
- 告诉用户以后只需说“今天练了什么”和主观体感，AI 负责下一次明确处方与刷新。
若当前聊天尚未加载新 Skill，提示用户只需新开对话后说“开始建立我的健身系统”；不得让用户阅读 README 寻找下一步。
先选动作
| 用户意图 | 动作 |
|---|---|
| 新电脑、空文件夹、从零搭建 | bootstrap |
| 检查路径、数据主源、Skill、工作台或链接 | doctor |
| 日常任务读取当前状态，不加载整份工作台 HTML | inspect |
| 升级系统配置并检查界面状态 | upgrade（仅配置；需要界面升级时退出码 2） |
| 修复侧栏或升级已有工作台界面，保留事实和壁纸 | upgrade-workbench-ui |
| 只装/检查某个专业 Skill | install-skill |
| 导入用户自己的知识、书摘或资料包 | import-private-pack |
| 刷新正式工作台并生成可审计回执，可选准备本地发布副本 | refresh-workbench |
| 消费正式计划、复盘或接回后的交接并刷新工作台 | process-handoffs |
| 升级后或发布前做完整回归 | validate |
| 日常训练任务 | 按下方路由转交专业 Skill |
运行前读取 系统契约。涉及交接时读取 交接契约。涉及完整计划、力量周期或工作台 HTML 时读取 单文件 HTML 模板总契约，只允许使用其中登记的三套固定模板。
日常计划修改、训练复盘和状态确认先运行 inspect。--root 可指向含 系统/lzheng-system.json 的完整系统根目录，也可直接指向含 健身工作台.html 的训练项目根目录。它只输出紧凑状态和权威主源路径；随后按任务读取对应的一个计划、基准或复盘文件。除非正在开发视觉模板或检查器已经报告模板结构损坏，不得读取整份 健身工作台.html、工作台模板、历史计划目录或全部专家模块。
日常路由
- 完整建档、长期训练计划、短版降级：
lzheng-fitness-plan。 - 一个动作的 8—12 周力量周期：
lzheng-strength-cycle-planner；结果必须交回完整计划 Skill 合并后才可成为当前计划。 - 单练或周训练复盘、下一次处方：
lzheng-strength-training-review；正式复盘必须更新索引并触发工作台刷新。 - 停训 7 天、连续漏练 3 次、条件明显变化：
lzheng-training-return；改变执行状态时先更新执行基准或当前计划，再刷新工作台。 - 饮食建档、日型目标、餐食确认与两周趋势复盘：
lzheng-nutrition-system；它不按单次训练消耗补吃，也不自动确认照片估算。 - 工作台构建、数据刷新、迁移、发布：
lzheng-fitness-workbench-builder；它只读聚合，不给出处方。
四个训练处方 Skill 与营养 Skill 在需要来源限定判断时内部读取 lzheng-training-expert-library。专家库不是独立处方入口，不拥有当前事实、计划版本、营养协议或工作台写入权。
专业 Skill 执行前按以下优先级解析根目录：本次用户明确路径 → 系统/lzheng-system.json → 环境变量 LZHENG_FITNESS_HOME → 仅用于首次引导的保守默认目录。已存在系统配置时，计划、周期、复盘、状态和接回卡必须优先写入 output_locations 指定的知识库分区，不得继续散落到当前工作目录。未解析到系统时停止写入并说明缺失项，不把示例数据当作训练事实。
命令
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，默认空知识库，不导入作者的私人内容。