@oh-story/dsh 0.1.0

package/lib/oh-story/skills/story-review/references/quality-checklist.md

@@ -0,0 +1,250 @@
+
+# 网文质量检查清单
+
+## 目录
+
+- [一、通用检查](#一通用检查)
+- [二、长篇专项](#二长篇专项)
+- [三、短篇专项](#三短篇专项)
+
+## 一、通用检查
+
+### 章节结构
+- [ ] 开头有钩子（不是天气/风景/日常开场）
+- [ ] 中段有推进（快节奏题材要有可见事件；慢热题材状态变化即可）
+- [ ] 局势有变化（读完这章，世界跟之前不一样了）
+- [ ] 结尾落在变化上（不是总结）
+
+### 开篇检查（前 300-500 字）
+- [ ] 有钩子，能抓住注意力
+- [ ] 不从天气/风景/日常开始
+- [ ] 主角快速出场
+- [ ] 卖点或危机可见
+- [ ] 开局不与同题材默认套路撞车（有钩子≠不同质；能整体换到任意同类书就是同质化）
+
+### 章节推进
+- [ ] 本章至少改变目标 / 风险 / 信息 / 关系 / 资源 / 身份 / 情绪立场七类状态之一；快节奏（番茄/爽文）应有可见事件或爽点，慢热/情感文才可只靠低压小变化达标，不强求每章高潮
+- [ ] 不是水字数（删掉这章会损失哪项状态变化？答不出才需压缩）
+- [ ] 任务卡点有用：卡住之后是否带来上述状态变化？
+- [ ] 推进强弱是否符合本书已建立的题材、兑现节奏与对标，而非套固定通用字数
+
+### 信息传递
+- [ ] 没有大段设定说明文
+- [ ] 信息跟着冲突走（通过事件传递设定）
+- [ ] 设定量可控（一章不超 3 个新概念）
+
+### 场景检查
+- [ ] 场景有目标（人物要什么）
+- [ ] 场景有阻碍（什么挡着）
+- [ ] 场景有变化（结束后跟之前不同）
+- [ ] 人物在做事情，不是在感觉事情
+- [ ] 没有可删除的段落
+
+### 章尾
+- [ ] 结尾落在变化上
+- [ ] 有危机/决定/发现/反转中的至少一个
+- [ ] 不是总结式结尾
+- [ ] 拉住读者翻下一页
+
+### 语言
+- [ ] 没有空洞的抒情段落
+- [ ] 没有连续多段同一情绪
+- [ ] 对话符合人物身份（不同人说话方式不同）
+- [ ] 标点节奏符合语气和人物声线：没有通篇句号化，也没有随机堆砌问号/感叹号；正文（含对话）不残留 `……`/`——`，迟疑或打断已改为动作、短句、逗号或句号
+- [ ] 情绪通过动作落地（不是直接说"他很难过"）
+- [ ] 标题行以外没有章节/写作元信息：不得出现 `第[一二三四五六七八九十百千万两0-9]+章|上一章|上章|前一章|本章|这一章|前文|后文|伏笔|细纲|读者` 这类词；需要承接前文时改成角色能感知的事件锚点或相对时间；故事内真实阅读/讨论“第X章”或真实读者身份语境除外
+
+### 连载连续性
+- [ ] 没有遗忘之前的承诺/伏笔
+- [ ] 没有突然塞入大量新设定
+- [ ] 伏笔有推进
+- [ ] 故事引擎还在运转
+
+### 水（filler）检测
+以下信号出现 = 可能水了：
+- 全章对话没有任何新信息
+- 同一个情绪写了 3 段以上
+- 场景描写超过 500 字但不推进剧情
+- 角色回忆之前发生的事但没有任何新视角
+- 连续 2 章以上没有冲突
+- 删掉无损的流程细节 / 任务卡点 = 水；压缩或删除
+
+---
+
+## 二、长篇专项
+
+### 黄金三章检查
+- [ ] 第一章前 500 字有钩子？
+- [ ] 主角第一章就出场？
+- [ ] 第一章有事件（不是纯铺垫）
+- [ ] 第二章有升级（矛盾加深）
+- [ ] 第三章有追读理由（给出继续看的动力）
+- [ ] 前三章有至少 2 个爽点？
+- [ ] 世界观没有大段说明文？
+- [ ] 每章结尾有往下看的理由？（低压/过场章弱钩子或阶段目标即可，不强求强悬念）
+
+### 节奏检查
+- [ ] 最近 5 章是否有明确进展？
+- [ ] 爽点间隔是否超过 5000 字？（按章节定位：高压/推进章查间隔；低压/关系/信息整理章不计入）
+- [ ] 有没有连续 2 章以上没有冲突？（呼吸章正常；红线是连续两章压力级≤1 或相邻章情绪趋同）
+- [ ] 一卷是否有章节定位高低层次，没有全程同一力度？低压+过场是否克制（合计不超约 15%）？
+
+### 人物检查
+- [ ] 主角行为符合人设？
+- [ ] 配角是否有存在感？
+- [ ] 反派逼格是否匹配当前阶段？
+
+### 五维评分标准
+
+每个维度 0-100 分，根据评分结果选择精修策略。
+
+### 维度 1：核心一致度
+检查：关键冲突、关键行动、人物动机是否前后一致。
+
+| 问题 | 严重度 | 修复 |
+|------|--------|------|
+| 人物动机突然改变无铺垫 | critical | 补充动机转变的触发事件 |
+| 核心冲突前后不一致 | high | 回溯修改冲突设定 |
+| 关键行动与人物性格矛盾 | high | 调整行动或补充解释 |
+| 次要矛盾遗忘 | medium | 回收或弱化 |
+
+### 维度 2：表层重写度
+检查：句式与措辞是否足够原创，避免套路化表达。
+
+| 问题 | 严重度 | 修复 |
+|------|--------|------|
+| 照搬原句导致语气不自然 | medium | 只在确有 AI 腔时改写，正常原句可保留 |
+| 大量使用 AI 标志词 | high | 替换为具体描述 |
+| 同一句式重复出现 | medium | 变换表达方式 |
+| 描写过于文学化（辞藻堆砌、书面腔、比喻成串） | medium | 改为口语化/动作化；动作化不是切成三五字短句串，改写后叙述仍以逗号长句为主 |
+
+### 维度 3：格式一致度
+检查：段落是否按戏剧单元/镜头自然断开，主语/角色名节奏是否自然，开头结尾格式是否统一。
+
+| 问题 | 严重度 | 修复 |
+|------|--------|------|
+| 机械按字数切段或主语过密 | medium | 按戏剧单元重排段落，段首点名、段中代词/省略、关键转折再点名 |
+| 章节字数偏离目标 | **high** | 写作/大纲修复时先回到细纲补足计划内情节点，再展开；去AI味已有正文时不得新增剧情 |
+| 格式混乱（对话/描写不统一）| low | 统一格式 |
+
+### 维度 4：可读性
+检查：是否有啰嗦、AI 腔、空泛总结、套路修辞。
+
+| AI 腔特征 | 如何识别 | 如何修复 |
+|-----------|----------|----------|
+| 空泛总结 | 「他终于明白了」「一切尽在不言中」 | 删掉，用行动代替 |
+| 套路修辞 | 「命运仿佛在和他开玩笑」 | 删掉或换成具体描述 |
+| 比喻堆叠 | 连续多处「像/好像/仿佛/如同」，每个画面都靠比喻解释 | 只留最有叙事功能的少数比喻，其余改成动作、物件、声音或后果 |
+| 情绪标签 | 「他感到一阵悲伤」 | 改为行为表现 |
+| 心理描写空转 | 内心独白无新信息、重复同一情绪或复述读者已知 | 只压缩空转部分；带新信息、决断或情绪转折的独白不按句数压缩 |
+
+### 维度 5：逻辑连贯
+检查：句间/段间是否通顺，有无设定冲突。
+
+| 问题 | 严重度 | 修复 |
+|------|--------|------|
+| 设定前后矛盾 | critical | 查找并统一设定 |
+| 时间线错误 | high | 标记时间线并修正 |
+| 角色信息不一致 | high | 建立角色档案对照 |
+| 因果链断裂 | medium | 补充过渡 |
+
+### 精修策略
+
+根据五维评分结果，选择精修策略：
+
+| 主要问题 | 策略 | 说明 |
+|----------|------|------|
+| 核心一致度低 | rewrite | 围绕核心冲突重写相关段落 |
+| 字数超标 | compress | 删减不推动剧情的内容 |
+| 无意义卡点 | compress | 保留卡出的变化，压掉流程 |
+| AI 腔重 | de_ai | 替换禁用词、改写句式 |
+| 小问题多 | polish | 打磨语言细节 |
+
+### 读者契约与终局储备双向审查
+
+审稿先问“无毒吗”，再问“好看吗”：**无毒不等于好看**，没有 契约破坏 只代表不踩雷，还要确认情绪兑现足够强。风险标记三档：契约安全（与开篇承诺一致、主角保有关键选择、收益归属清楚）/ 需补强（可能稀释高光或推进过快，但能靠铺垫、交换、代价修复）/ 契约破坏（核心卖点被没收或无关角色夺走期待所有权，需修纲）。
+
+- [ ] 读者契约：本章/本卷是否兑现开篇承诺，还是把核心卖点交给机构、配角或偶然性？风险标记：契约安全 / 需补强 / 契约破坏。
+- [ ] 主角代理权：按因果权 + 结算权审查，而非按出场时长；关键节点核对四问——谁决定事情为什么发生、谁作出不可替代的选择、谁承担或选择关键后果、核心收益/认可/权力结算给谁。配角可执行局部动作，但不能无声夺走期待所有权。
+- [ ] 期待债：承诺是否被偿还、延期并支付利息，还是被解释/流程/设定吞掉？
+- [ ] 终局储备：本单元是否动用了本阶段还不该解锁的终局底牌（宿敌/真相/身份/金手指上限）？是否让某条升级线逼近天花板、后面没台阶接？两问皆否即放行——单章一战多得（多线齐涨）是好设计，不算超速。
+- [ ] 兑现归属：期待所有权是否按承诺结算；自愿让渡只有在“长期净收益为负 + 控制/因果权下降”同时出现时亮红灯，战略性让步的更大控制/未来收益/权力/信息交换是否可见？
+- [ ] 节奏续接：高潮/兑现后是否允许短暂低压和小而可见的收益/奖励，而非机械立即加危机？新元素是否支付换书债、没有逃避旧承诺？
+- [ ] 题材特定风险：履约爽文/能力幻想中，主角是否反复以愚蠢或可避免的无能制造灾难并由他人收拾，损害因果权与结算信任？
+- [ ] 反向审查：若删除“安全解释”，情绪是否更强？若保留风险情节，是否带来更强期待、代价或爽点？
+- [ ] 综合线：契约、主角代理权、期待债、终局储备是否互相支撑，而不是只做到“无毒”。
+
+---
+
+## 三、短篇专项
+
+### 虐爽节奏检查
+
+短篇特有的检查项——虐点和爽点的分布是否合理：
+
+```
+理想分布：虐1 → 虐2 → 虐3 → 爽1(小) → 虐4 → 爽2(大)
+禁忌分布：虐1 → 虐2 → 虐3 → 虐4 → 虐5（无爽点，读者流失）
+禁忌分布：爽1 → 爽2 → 爽3 → 爽4（无铺垫，爽感疲劳）
+```
+
+检查规则：
+- 每 300 字至少 1 个小冲突
+- 虐点间隔不超过全文的 30%
+- 最大爽点必须出现在全文的 70-85% 位置
+- 结尾必须有情绪落点
+
+### 对话密度检查
+
+| 指标 | 合格标准 | 警戒线 |
+|------|----------|--------|
+| 对话占全文比 | 45-65% | <30%（太干）或>75%（太水） |
+| 每章对话条数 | 12-18条/千字 | <8条（缺交互）或>25条（碎片化） |
+| 伤人性对话占比 | 35-45%（虐文）/ 20-30%（爽文） | 虐文<20%（不够痛）/ 爽文>40%（太压抑） |
+
+### 主角冷静度检查（打脸/复仇文专用）
+
+| 检查项 | 标准 |
+|--------|------|
+| 主角是否有标志性冷静动作？ | 必须有（端水杯/整理西装/转笔等） |
+| 主角是否有情绪失控场面？ | 复仇文最多1次，且必须在前30% |
+| 反派是否比主角更歇斯底里？ | 必须是——反差是爽感来源 |
+| 主角台词是否短于反派？ | 平均短30-50%——越短越有力 |
+| 是否有"审判式对话"？ | 至少2处（主角提问→对方自爆） |
+
+### 证据链完整性检查（复仇/打脸文专用）
+
+| 检查项 | 标准 |
+|--------|------|
+| 证据是否分章释放？ | 至少分3次揭露，不能一次全给 |
+| 每个证据是否有铺垫？ | 前文必须埋过线索 |
+| 反派是否每次都先得意再被打脸？ | 必须是——先扬后抑 |
+| 最终证据是否最致命？ | 最后一个证据要改变全局认知 |
+| 是否有"定时炸弹"证据？ | 至少1个主角提前布局的证据 |
+
+### 毒点/代入感/震惊/开头/结尾/情绪/期待感速查
+
+> 详细的毒点分类、识别方法和修复方案见 `anti-ai-writing.md`。
+
+| 检查项 | 标准 |
+|--------|------|
+| 爽文不爽 | 金手指效果必须展示清楚 |
+| 压制无目的 | 每次压制必须服务于后续爆发 |
+| 反派结局与主角无关 | 反派之死必须因主角行动导致 |
+| 经济/战力崩坏 | 设定前后一致，以普通人为锚点 |
+| 女主/女配降智 | 人设正常可写，老套路别写 |
+| 读者期待长时间不满足 | 适时满足或引入新期待 |
+| 主角行为不可理解 | 必须能理解、能共鸣 |
+| 氛围被突兀梗破坏 | 氛围 > 突兀梗（乐子文除外） |
+| 钩子不回收 | 钩子不回收 = 烂尾 |
+| 震惊分层 | 点→网→深度，不能只写点震惊 |
+| 震惊阶梯递进 | 阶梯式上升，非直线 |
+| 震惊有广度 | 关系网都要有反应 |
+| 前50字有冲突/异常 | 不能是背景铺垫 |
+| 前100字知核心矛盾 | 必须知道 |
+| 开头情绪强度 | ≥7（1-10） |
+| 结尾是具体的 | 动作/对话/画面，禁止总结/反思 |
+| 结尾有余韵 | 读者还想往下看 |
+| 结尾情绪强度 | 虐≥8，爽≥7，治愈≥6 |
+| 情绪对等释放 | 虐多少补多少，反派结局关联主角 |
+| 期待管理 | 两长一短不断，核心卖点贯穿 |

package/lib/oh-story/skills/story-review/references/quality-rubric.md

@@ -0,0 +1,55 @@
+# 通用网文内容审查 Rubric
+
+> 用途：当用户未指定番茄、起点、知乎盐言等目标平台时，作为 `/story-review` 的默认小说内容评分标准。它评估的是**故事文本质量**，不是 skill/plugin 实现质量。
+
+## 评分方法
+
+每项按 PASS / WARN / FAIL 标记，并把 FAIL/WARN 转成统一 Findings Schema：
+- 影响主线、角色动机、世界规则或读者信任 → S1
+- 明显影响留存、节奏、章节效果或人物可信度 → S2
+- 局部质量、格式、措辞、轻微节奏问题 → S3
+- 风格建议或可选增强 → S4
+
+## 核心维度
+
+| 维度 | PASS | WARN | FAIL |
+|---|---|---|---|
+| 核心卖点 | 章节围绕明确卖点推进，读者知道为什么继续看 | 卖点存在但表达弱或被支线稀释 | 看不出本章服务什么卖点或主线 |
+| 冲突推进 | 本章有明确冲突、阻碍、选择或代价 | 冲突较轻，推进感不足 | 主要是解释/闲聊/总结，无实际推进 |
+| 任务卡点 | 角色办事被卡住，并卡出信息、关系、代价、选择或伏笔变化 | 有卡点但变化偏弱，可压缩 | 卡点只是流程细节，删掉不影响故事 |
+| 情绪曲线 | 有铺垫、升温、释放或反转 | 情绪有变化但节点不清 | 情绪平直或突兀转向 |
+| 钩子与期待 | 开头/结尾至少一处建立期待 | 钩子弱但仍有后续问题 | 没有悬念、目标或未完成期待 |
+| 开头新鲜度（仅开篇/前 3 章） | 开局有具体人物/处境切口，不是同题材默认套路 | 有钩子但开局形状与同题材撞车 | 开局是题材默认模板，可整体换到任意同类书（同质化） |
+| 角色动机 | 行为符合目标、性格、处境和关系压力 | 局部行为缺少铺垫 | 角色为推动剧情而失真 |
+| 对话质量 | 对话有潜台词、信息控制和角色差异 | 有信息堆叠或声音略同质 | 对话像说明书，人人同腔 |
+| 设定一致性 | 不违背既有规则、时间线和角色属性 | 有轻微模糊点需补证据 | 与已写设定或前文事实冲突 |
+| 文字自然度 | 具体、可感、动作承载信息 | 偶有套话或抽象总结 | AI 腔、陈词滥调、总结体明显 |
+| 句长节奏 | 叙述默认是逗号长句，短句只作偶尔的孤立重拍、用完回到逗号长句 | 局部碎句或电报体，或偶发机械长短交替 | 逗号之间连着都是 ≤5 字、通篇超短句像提纲，或审改把逗号长句拆碎 |
+| 标点节奏 | 标点跟语气、人物声线和情绪功能匹配 | 局部标点单调或略有堆砌 | 通篇句号化、随机堆砌问号/感叹号，或用 `……`/`——` 硬造停顿 |
+| 具体字数表达校验 | 「这五个字」「短短四字」类表达的字数经核对属实，且有叙事必要 | 字数属实但换成「那几个字」更自然 | 字数与实际不符，或无法确认统计口径 |
+| 格式可读性 | 段落按戏剧单元/镜头自然断开，对话独立，无多余空行，主语节奏自然 | 局部段落偏长/偏碎或主语重复略多 | 大段堆叠、机械切段、对话/叙述难读、主语过密 |
+| 剧情循环 | 目标→阻碍→行动→代价/反馈→新期待闭环清晰 | 有循环但缺一环或反馈偏弱 | 无目标、无阻碍或无反馈，读者不知道局势如何变化 |
+| 高潮构建 | 蓄能→假胜→崩解→反转/兑现有层次 | 有爆点但蓄能或兑现不足 | 平铺直给、无代价、无兑现或情绪落空 |
+| 关系进展 | 互动尺度匹配关系阶段，越界有铺垫 | 局部推进略快但可补证据 | 突然亲密/信任/敌对，角色关系跳变 |
+| 伏笔状态 | 伏笔埋设、状态和回收路径可追踪 | 伏笔偏密/偏疏但不影响理解 | 伏笔与设定冲突、断线或造成主线理解混乱 |
+
+## 黄金三问
+
+1. **读者为什么翻下一页？** 如果答不出，至少 S2。
+2. **本章改变了什么？** 情节、关系、信息、情绪至少改变一项；否则至少 S2。
+3. **哪个证据支持你的判断？** 没有原文证据的 finding 不输出，改为“证据不足”。
+
+## 发布建议门槛
+
+| 综合情况 | Verdict |
+|---|---|
+| 无 S1/S2，S3 可快速处理 | APPROVE |
+| 有 S2，或 S3 数量多影响阅读 | CONCERNS |
+| 有 S1，或核心卖点/动机/规则崩坏 | REJECT |
+
+## 输出要求
+
+- 所有问题必须包含 severity、category、location、evidence、issue、fix。
+- 先列 S1/S2，再列 S3/S4。
+- 不要只给泛泛评价；每条 finding 必须能指导下一轮修改。
+- `consistency` / `factual` 类 finding 的 fix 只写事实统一方向，不写文学创作建议。

package/lib/oh-story/skills/story-review/references/rubrics/fanqie.md

@@ -0,0 +1,18 @@
+# 番茄小说 Quality Rubric
+
+## 评分标准
+
+| 指标 | PASS 标准 | FAIL 标准 |
+|------|----------|----------|
+| 开头吸引力 | 前 3 段包含冲突/悬念/钩子 | 前 3 段纯描写/背景介绍 |
+| 读者留存 | 每章结尾有"翻页动力"（悬念/反转/新信息） | 连续 3 章结尾无翻页动力 |
+| 题材匹配 | 内容符合标签类型（如甜宠/逆袭/重生） | 偏离标签类型超过 3 章 |
+| 算法友好 | 短段落、快节奏、高信息密度 | 大段落、慢节奏、低信息密度 |
+| 情绪节点 | 每 1000 字有情绪起伏 | 连续 2000 字情绪平直 |
+| 完读率预估 | 3 章 Hook 有效 + 节奏不拖 → 预估完读 >40% | 前 3 章无 Hook 或连续拖沓 → 预估完读 <20% |
+
+## 使用方式
+
+- story-review 的 story-architect 视角引用此标准
+- advisory only，不 blocking
+- 番茄算法偏好快节奏、强情绪

package/lib/oh-story/skills/story-review/references/rubrics/qidian.md

@@ -0,0 +1,19 @@
+# 起点中文网 Quality Rubric
+
+## 评分标准
+
+| 指标 | PASS 标准 | FAIL 标准 |
+|------|----------|----------|
+| 爽点密度 | 每 3000 字 ≥1 情绪节点（升级/打脸/获宝） | 连续 5000 字无情绪节点 |
+| 升级节奏 | 每 50 章有等级/实力突破 | 100 章无任何升级 |
+| 金手指使用 | 每章提及或使用金手指（系统/戒指/功法） | 连续 5 章未提及金手指 |
+| 日更支持 | 大纲支持 4000 字/天节奏（每章 2000 字，每天 2 章） | 无日更计划，章节长度不规律 |
+| 钩子密度 | 每章结尾有悬念/钩子 | 连续 3 章结尾无钩子 |
+| 角色存在感 | 主角每章出场并推进 | 连续 2 章主角不出场或无推进 |
+| 追读比 | 章尾钩子 + 情绪连续性 → 追读比预估 >30% | 连续 3 章无钩子或情绪断裂 → 追读比预估 <15% |
+
+## 使用方式
+
+- story-review 的 story-architect 视角引用此标准
+- advisory only，不 blocking
+- 用户可自定义阈值

package/lib/oh-story/skills/story-review/references/rubrics/zhihu.md

@@ -0,0 +1,20 @@
+# 知乎盐言故事 Quality Rubric
+
+## 评分标准
+
+| 指标 | PASS 标准 | FAIL 标准 |
+|------|----------|----------|
+| 第一人称 | 全文使用「我」视角 | 使用第三人称（除非多视角设计） |
+| 情绪拉扯 | 每段有情绪变化（期待→失望→惊喜等） | 连续 3 段情绪无变化 |
+| 反转设计 | 至少 1 个有效反转（前文有伏笔） | 无反转或反转无伏笔支撑 |
+| 结尾余韵 | 结尾留有思考空间/情感余韵 | 结尾完全封闭无回味 |
+| 格式合规 | 段落以短为主（有长短/疏密变化）、无空行、对话格式正确 | 通篇同长度或连续超长段落/空行/对话标签 |
+| 开头钩子 | 第一句话包含信息量（动作/冲突/悬念） | 第一句话纯描写/背景 |
+| 字数控制 | 8000-13000 字（盐言标准） | 超出或不足 |
+| 开头跳失率 | 第一句包含动作/冲突/悬念 → 跳失率预估 <30% | 第一句纯描写/背景 → 跳失率预估 >50% |
+
+## 使用方式
+
+- story-review 的 story-architect 和 character-designer 视角引用此标准
+- advisory only，不 blocking
+- 盐言故事注重第一人称代入感和情绪拉扯

package/lib/oh-story/skills/story-review/references/tracking-transaction.md

@@ -0,0 +1,161 @@
+# 追踪状态协议
+
+`追踪/` 使用“一个结构化权威状态 + 多个确定性派生视图”。模型只提交一份语义 JSON，不分别 `Write/Edit/echo >>` 多个追踪文件。
+
+## 权威层与派生层
+
+| 层级 | 文件 | 语义 |
+|---|---|---|
+| 唯一权威 | `_tracking-state.json` | schema、最后提交章、导入截止章、状态修订号、上下文结构、全部当前角色/伏笔/时间线状态 |
+| 章节记录 | `逐章记录/第NNN章.md` | 本章对未来连续性有用的紧凑变化；目标 ≤1536 字节，硬上限 3072 字节；导入范围内修订写成覆盖记录 |
+| 派生视图 | `上下文.md`、`角色状态/{角色名}.md`、`伏笔.md`、`时间线/作者真相.md`、`时间线/读者已知.md` | 完全从 `_tracking-state.json` 生成；禁止手改，不作为程序输入 |
+
+Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown。`check` 直接从 `_tracking-state.json` 重渲染并逐文件比较。未来“第几章揭示”的计划写在卷纲/细纲，不写成时间线既成事实。
+逐章记录只是便于人阅读的紧凑变化记录，不承诺单独无损重建全部当前状态；完整当前语义以 `_tracking-state.json` 为准。
+
+## 运行工具
+
+先按运行环境探测 Python 3 解释器（依次尝试 `python3`、`python`、`py -3`），再用当前 skill 根目录执行：
+
+```text
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py init   --project {书项目根} --input {初始化事务.json}
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py commit --project {书项目根} --input {逐章事务.json}
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py check  --project {书项目根}
+```
+
+- `init`：只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
+- `commit`：读取唯一权威状态，在内存中完成合并、引用检查、全部视图渲染和容量检查；随后写逐章记录与派生视图，最后原子替换 `_tracking-state.json` 作为唯一提交点。
+- `check`：严格验证 state schema、逐章记录连续性/规范名/体积、固定 7 栏、角色快照硬上限、派生文件集合，以及所有派生视图与 state 的逐字一致性。
+
+同一本书只允许工作流串行提交，不支持多个 Agent 或终端并发写。`expected_state_revision` 用于拒绝基于旧状态构造的顺序 stale transaction，不是并发锁。
+
+事务 JSON 在成功前必须保留。若文件写入失败，`_tracking-state.json` 尚未推进；修正环境后直接重跑**同一份** `commit`。append 重跑只接受内容完全相同的既有逐章记录，不维护 `dirty/pending/repair` 状态机。
+
+校验失败与写入失败处理方式不同：校验失败（字段非法、退役结构、容量超限）要按报错改事务本身，重跑同一份结果不变。派生视图被手改或外部改动导致 `check` 报 `derived view differs from _tracking-state.json` 时，重新提交**该章**的 `mode=revision` 事务让工具整份重建，`expected_state_revision` 取 `追踪/_tracking-state.json` 的 `state_revision` 字段——`check` 失败时只往 stderr 打 ERROR，不输出 JSON；不手改派生文件，也不删 `_tracking-state.json` 重来。手写出的逐章记录会让同章 `append` 永久报 `chapter delta N already exists with different content`——删掉那个手写文件后重跑原事务即可。
+
+本工具不解析旧 `_tracking-meta.json`、`时间线/事件库.json` 或更早追踪结构，不提供语义兼容层。`init` 遇到这类旧文件时，先把它们按原样整体移入 `追踪/_旧追踪存档/`，再在原地建当前协议：旧内容留给作者查阅，不参与解析，当前状态完全以 init 输入为准。校验失败的 `init` 不移动任何文件。`commit` 与 `check` 仍直接拒绝旧结构——它们只在已建协议的项目上运行。
+
+## 初始化事务
+
+新书从第 0 章初始化。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
+
+```json
+{
+  "schema_version": 1,
+  "book_title": "让你管账号，你高燃混剪炸全网",
+  "last_chapter": 0,
+  "context": {
+    "position": {
+      "volume": "第一卷·军宣整顿",
+      "volume_start_chapter": 1,
+      "story_time": "江晨到火箭军文工团报到前",
+      "scene": "火箭军文工团"
+    },
+    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
+    "active_character_names": [],
+    "continuity_risks": [],
+    "recent_chapters": [],
+    "next_chapter_commitments": ["让江晨报到，并落下五天百万粉的新手任务"]
+  },
+  "character_snapshots": {},
+  "foreshadow": [],
+  "timeline_events": []
+}
+```
+
+导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。
+
+## 逐章事务
+
+```json
+{
+  "schema_version": 1,
+  "mode": "append",
+  "chapter": 10,
+  "chapter_title": "专业团队拍得还不如他拍的好？",
+  "expected_state_revision": 9,
+  "delta": {
+    "result": "专业团队重拍的高清版在高层看片会上被判定缺了灵魂，张耀祖拍板继续采用江晨的手机原版。",
+    "character_changes": [
+      {"name": "江晨", "change": "作品价值获军内高层确认，从爆款新人升为不可替代的军宣创作者"}
+    ],
+    "foreshadow_changes": [
+      {
+        "action": "upsert",
+        "id": "F027",
+        "summary": "专业团队仍拍不出江晨原版的灵魂，继续验证其创作能力不可复制",
+        "planted_chapter": 10,
+        "planned_resolution_chapter": null,
+        "status": "已埋",
+        "importance": "中"
+      }
+    ],
+    "timeline_events": [
+      {
+        "action": "upsert",
+        "id": "E010",
+        "story_time": "实弹训练两天后",
+        "objective_fact": "文工团高层否决专业重拍版，决定沿用江晨手机拍摄的原版视频",
+        "reader_knowledge": "读者已看到周薄森指出专业版缺了灵魂，张耀祖当场拍板用回原版",
+        "reveal_status": "已揭示",
+        "reveal_chapter": 10,
+        "characters": ["江晨", "周薄森", "张耀祖"]
+      }
+    ],
+    "constraints": ["后续继续用作品落地效果和围观反应放大江晨的高光，不能只写系统奖励数字"],
+    "next_chapter_commitments": ["结算五天百万粉任务，并承接老兵主题的新任务"]
+  },
+  "context": {
+    "position": {
+      "volume": "第一卷·军宣整顿",
+      "volume_start_chapter": 1,
+      "story_time": "实弹训练两天后",
+      "scene": "火箭军文工团高层看片会"
+    },
+    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
+    "active_character_names": ["江晨"],
+    "continuity_risks": ["钟嘉嘉说江晨只猜对一半，未公开的培养安排不能被当成读者已知事实"]
+  },
+  "character_snapshots": {
+    "江晨": {
+      "identity": "火箭军文工团宣传兵；军宣爆款创作者",
+      "location": "火箭军文工团高层看片会",
+      "goal": "完成五天百万粉任务，持续做出真正能打的军宣内容",
+      "state": "专业团队反向验证原版价值，军内认可继续抬升",
+      "abilities_resources": ["前世MCN爆款运营经验", "《中国军魂》伴奏", "大师级导演能力"],
+      "relationships": ["钟嘉嘉持续提供军报资源", "周薄森和张耀祖已明确认可其创作能力"],
+      "knowledge": ["《军报》采访稿已经过审", "原版视频将继续作为正式军宣内容"],
+      "open_threads": ["五天百万粉任务尚未结算", "钟嘉嘉所谓只猜对一半仍未解释"]
+    }
+  }
+}
+```
+
+约束：
+
+- 构造事务前运行 `check`，把当前 `state_revision` 原样写入 `expected_state_revision`；若状态已经变化，重新读取 state 并重构事务。
+- `context` 的允许字段随子命令不同：`init` 收 `position`、`long_term_constraints`、`active_character_names`、`continuity_risks`、`recent_chapters`、`next_chapter_commitments` 六项；`commit` 只收前四项。`recent_chapters` 与 `next_chapter_commitments` 在 commit 时由工具从当前视图和本章 `delta` 派生，手填会在任何写入前被拒（`context contains unsupported fields: ...`，exit 2）。照 init 示例套 commit 事务是最容易踩的一处。
+- `character_snapshots` 中出现的角色视为核心复用角色，必须同时出现在 `character_changes`；已经建立快照的核心角色再次变化时必须提交新快照。
+- 角色快照的四个列表不限制条数，只限制单项长度和最终文件总字节：目标 ≤4096 字节，超过警告；硬上限 8192 字节，超过则在任何写入前拒绝。
+- 没有快照的角色变化视为临时角色，不建立状态文件；`context.active_character_names` 最多 6 人且必须已有当前快照。
+- `context.long_term_constraints` 和 `context.continuity_risks` 是整份提交的当前值。凡是上一版有、本次没有的条目，必须逐条列进 `delta.retired_context_items`，否则工具在任何写入前拒绝——漏写不会被当成删除。实际退役的条目由工具写进本章逐章记录的 `## 本章退役登记`，随后仍可回查。
+- 不再复用的核心角色写进 `delta.retired_characters`：工具删除其当前快照与 `角色状态/{角色名}.md`，并在逐章记录留档。同一事务里不能既退役又提交快照，也不能退役仍列在 `context.active_character_names` 的角色。角色阵亡/退场这一章，把变化照写进 `character_changes` 即可，本章退役的角色不必再交一份马上要删的快照，逐章记录仍按核心角色标注。退役只表示不再进入热上下文，正文与逐章记录不受影响。
+- 两类退役都只能在 `mode=append` 提交。退役表示「从此刻起离开当前状态」，而修订事务的逐章记录属于被改写的旧章，落在那里会谎报退役发生的章节；`mode=revision` 必须原样重交当前全部上下文条目，需要退役就放到下一次 append。
+- `伏笔.md` 只呈现已经埋设过的当前状态。未来规划仍留在大纲。
+- `timeline_events.action` 可为 `upsert/delete`。`未揭示` 的 `reveal_chapter` 必须为 `null`；部分/完全揭示只能填写已经发生的实际章节。
+- `mode=revision` 时，逐章记录必须重算为修订后该章仍然成立的完整连续性记录；当前角色、伏笔、时间线和上下文则提交受影响对象截至最新已写章的当前值。
+- 修订导入截止章内的正文时，会新增或覆盖该章的逐章记录；`imported_through_chapter` 不变。
+
+## 续写状态卡固定格式
+
+`上下文.md` ≤12288 字节，由 state 整份生成，只含以下 7 个顶层区块：
+
+1. `## 当前位置`
+2. `## 长期约束`
+3. `## 核心角色状态`
+4. `## 活跃伏笔`
+5. `## 近三章速记`
+6. `## 下一章承诺`
+7. `## 连贯性风险`
+
+其中活跃角色最多 6 人、活跃伏笔确定性选取最多 8 条、近章只保留 3 章。这些是下一章热上下文容量，不是完整角色状态的容量限制。