@lemoncat7/dsh-partner 2.8.0 → 2.8.2

package/resources/skills/story-creation/upstream/skills/story-import/references/structure-mapping-short.md

@@ -0,0 +1,187 @@
+# 结构迁移映射规则（短篇）
+
+Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-and-structure.md)：将 `拆文库/{导入书名}/` 短篇拆文产物转换为 `{短篇标题}/` 短篇工程结构，供 `story-short-write` Phase 3 无缝接手续写。外部对标与作者交代读导入记录（`{书目录}/.story/work/导入记录.md`）。
+
+## 迁移步骤
+
+目标工程只有 `{短篇标题}/设定.md`（核心框架 + 本书续写基线）、`小节大纲.md`、`正文.md` 三个单文件，外加可选的 `对标/{对标书名}/`（仅外部对标引用视图：拆文报告、情节节点、写作手法）。**短篇工程与长篇完全不同**：正文是单文件、不切章，**不产** `追踪/`、`大纲/`、`正文/` 等长篇目录，迁移时严禁误建。
+
+1. **正文迁移**：将 `拆文库/{导入书名}/原文/` 的全文迁移为单文件 `{标题}/正文.md`，按 format-and-structure.md 规范化格式（小节标记 `###1.`、段间仅单换行、对话引号按项目/平台约定统一）。原文已是成稿，不重写内容，只规范格式。
+2. **设定生成**：从 `拆文报告.md`、`写作手法.md` 反推 `{标题}/设定.md`，含核心框架（对齐 story-short-write 核心框架：基本信息、一句话梗概、核心反转、情绪设计、人设速写）与本书续写基线（已写内容的故事结构、情绪节奏、核心反转机制、既有写作手法；这是本书内部上下文，不是对标摘要）两个区块，规则见下方「设定.md 反推规则」。导入记录里作者交代的偏好与红线一并写进续写基线。
+3. **小节大纲生成**：从 `情节节点.md` 的功能分段反推 `{标题}/小节大纲.md`，按开头段/铺垫段/升级段/反转段/结尾段映射，用 story-short-write 的固定 12 列表格，每节一行，填法见下方「小节大纲表格」。相关情节点可由同一动作链或对话同时兑现，不为凑数量拆成多个子事件；原文判断不出的格子写 `[待补充]`，不套用长篇完整章节蓝图。
+4. **外部对标引用视图（可选）**：仅当导入记录已显式绑定外部 `{对标书名}` 时，才把 `拆文库/{对标书名}/` 同步为 `{标题}/对标/{对标书名}/`；没有绑定则跳过。不得把 `拆文库/{导入书名}/` 整体复制进 `对标/`。
+
+迁完按文末质量检查清单自检，在导入记录勾「结构迁移」，直接进入 Phase 5 汇报。
+
+> 长篇迁移规则见 `structure-mapping-long.md`。
+
+> **名称边界**：`{导入书名}` 是用户自己的待续写短篇；`{对标书名}` 是另行选择的外部参考作品。不得把本篇拆文结果复制到本篇 `对标/`，也不得把本篇分析写成“对标摘要”。
+
+---
+
+## 与长篇的关键差异
+
+| 维度 | 短篇 | 长篇 |
+|------|------|------|
+| 正文 | 单文件 `正文.md`，**不切章** | `正文/第XXX章_章名.md` 多文件 |
+| 追踪目录 | **不产** `追踪/` | 产 `追踪/`（`_tracking-state.json`、续写状态卡、逐章记录、角色快照、伏笔视图、双视角时间线） |
+| 角色状态 | **不产**角色追踪 | 核心角色各产 `追踪/角色状态/{角色名}.md`，由 `character-state-reverse.md` 反推 |
+| 大纲体系 | **不产** 卷纲、细纲 | 产 `大纲/卷纲_第X卷.md` + `大纲/细纲_第N章.md` |
+| 大纲目录 | **不产** `大纲/` 目录 | 产 |
+| 续写衔接 | story-short-write Phase 3（逐场景写作） | story-long-write 日更循环 |
+
+---
+
+## 映射总览
+
+| 拆书产物 | 短篇工程文件 | 转换方式 |
+|---------|------------|---------|
+| 原文全文（`拆文库/{导入书名}/原文/`） | `{标题}/正文.md` | 单文件迁移，按下方『正文.md 格式规范』规范化，不重写内容 |
+| `拆文报告.md` 的故事核/题材/结构字段 | `{标题}/设定.md`（核心框架区） | 反推本书核心框架；不继承报告中可能存在的自对标登记 |
+| `情节节点.md` 的功能分段 | `{标题}/小节大纲.md` | 反推小节大纲（按开头段/铺垫段/升级段/反转段/结尾段，钩子字段标 `[待补充]`） |
+| `拆文报告.md` + `写作手法.md` | `{标题}/设定.md`（本书续写基线区） | 把已写内容的结构、情绪、反转和既有写法整理为内部续写上下文 |
+| `拆文库/{对标书名}/` | `{标题}/对标/{对标书名}/` | 可选：仅同步用户显式绑定的外部参考作品 |
+
+---
+
+## 设定.md 反推规则
+
+目标文件使用本文件定义的当前核心框架模板，分两个区块：
+
+### 区块一：核心框架
+
+从 `拆文报告.md` 的故事核、结构划分、人物分析等字段提取，填入以下模板：
+
+```markdown
+## 短篇核心框架
+
+### 基本信息
+- 标题：{导入书名}
+- 目标字数：{原文实际字数} 字
+- 目标平台：{从拆文报告提取，无则填 [待补充]}
+- 目标情绪：{从拆文报告「情感线/爆点分析」提取读者预期感受}
+
+### 一句话梗概
+{主角 + 困境 + 反转 + 情绪落点（从拆文报告故事核提取）}
+
+### 核心反转
+- 反转类型：{从拆文报告反转分析提取：身份反转/视角反转/动机反转/时间线反转}
+- 反转内容：{一句话描述}
+- 铺垫线索：{从情节节点中的「铺垫」类节点提取，至少 3 个；不足时标 [待补充]}
+
+### 情绪设计
+- 开头情绪：{从情感曲线第一个节点提取}（强度 {1-10}）
+- 中段情绪：{中段情感节点}（强度 {1-10}）
+- 反转情绪：{反转节情感峰值}（强度 {1-10}）
+- 结尾情绪：{结尾节情感}（强度 {1-10}）
+
+### 人设速写
+- 主角：{一句话人设，从人物分析提取}
+- 关键角色：{一句话人设}
+- 关系：{他们之间的关系}
+```
+
+> 不确定字段一律加 `[待补充]` 标记，不留空字段。
+
+### 区块二：本书续写基线
+
+从 `拆文库/{导入书名}/拆文报告.md` 和 `写作手法.md` 提取，汇总为本书内部续写基线：
+
+```markdown
+## 本书续写基线
+
+### 故事结构
+{从拆文报告「功能分段」字段提取，概述各段功能}
+
+### 情绪节奏
+{从情感曲线/爆点分析提取，描述情绪走势与峰值位置}
+
+### 核心反转机制
+{从反转机制分析提取，含铺垫路径}
+
+### 可复用写作手法
+{从写作手法.md 或拆文报告「可复用结构」字段提取，≥3 条}
+```
+
+---
+
+## 小节大纲.md 反推规则
+
+从 `情节节点.md` 的功能分段结构提取，映射到短篇段-小节结构。
+
+### 段级映射
+
+| 短篇段名 | 对应情节节点功能段 | 说明 |
+|---------|----------------|------|
+| 开头段 | 开端（引入主角/世界/困境） | 通常 1-2 个小节 |
+| 铺垫段 | 发展前期（冲突积累/伏笔布置） | 通常 2-4 个小节 |
+| 升级段 | 发展后期（冲突升级/误解加深） | 通常 2-3 个小节 |
+| 反转段 | 高潮（核心反转引爆） | 通常 1-2 个小节，情绪峰值 |
+| 结尾段 | 结局（收束/情绪落点） | 通常 1-2 个小节 |
+
+### 小节大纲表格
+
+`小节大纲.md` 用 story-short-write 的固定 12 列表格，每节一行，列名和顺序不改：
+
+```markdown
+| 结构段/五段功能 | 主事件 | 情节推进 | 情绪 | 人物/关系变化 | 因果/逻辑链 | 读者新获知什么 | 结尾承接/钩子 | 伏笔/物件 | 场景形态 | 对白作用 | 目标字数 |
+|---|---|---|---|---|---|---|---|---|---|---|---|
+| 开头 | 从情节节点提取的主要情节点 | 具体发生了什么{发现} -> 具体发生了什么{冲突} | 前状态→后状态 | 本节前后变化，或 无（本节改变：…） | 原因 → 行动 → 结果 → 后果 | [待补充] | [待补充] | [待补充] | [待补充] | [待补充] | 按原文该节实际字数 |
+```
+
+- `结构段/五段功能` 填 开头/铺垫/升级/反转/结尾。
+- `情节推进` 每个推进单元带 `{对话}` `{冲突}` `{伏笔}` `{回忆}` `{发现}` `{递进}` 之一，有先后用 `->` 连接，按原文实际发生的写，不为凑数拆分。
+- 从原文判断不出的格子写 `[待补充]`，留给作者或续写时填写；不写 `{}` 模板占位。
+- `目标字数` 写原文该节实际字数，各节之和与 `设定.md` 的目标字数对得上。
+- 付费点在哪一节末能从原文认出来时，在该行 `结尾承接/钩子` 标「付费点」；认不出写 `[待补充]`。
+
+### 小节数量推算
+
+以原文实际的分节标记和转场为准；原文没有显式分节时，按情节阶段和转场切分，`总字数 ÷ 1000` 只作粗略参考，不作为切分依据。小节数与正文实际段落结构一致是质量清单必检项。
+
+---
+
+## 正文.md 格式规范
+
+将原文迁移为单文件 `正文.md`，格式按 `format-and-structure.md` 规范化：
+
+| 规范项 | 要求 |
+|--------|------|
+| 小节标记 | `###1.` `###2.` `###3.`（短篇通用格式；用户指定平台时按 `format-and-structure.md` 平台覆盖表切换） |
+| 段落划分 | 按戏剧单元/镜头/一件事结束自然断段；不按固定字数强拆；完整推理、氛围、情绪链可保留稍长段，避免通篇同长度或碎成提纲 |
+| 段间空行 | 正文相邻段落之间**只允许一个换行符 `\n`**，不得出现空行或 `\n\n` |
+| 对话引号 | 默认 `""` 半角双引号；知乎盐言平台可用 `「」` |
+| 缩进 | 无缩进，不用全角/半角空格 |
+| Markdown | 正文段落中不使用 `**` `*` `#` `---` 等 Markdown 语法（仅小节标记除外） |
+
+**原文内容不改动**，只做格式规范化（分段、引号统一、小节标记添加）。
+
+---
+
+## 外部对标引用视图（可选）
+
+仅当用户显式绑定独立外部 `{对标书名}` 时，将 `拆文库/{对标书名}/` 复制为 `{标题}/对标/{对标书名}/`（跳过 `_archive_*/`，归档快照不进对标视图），供续写阶段加载：
+
+```
+{标题}/对标/{对标书名}/
+├── 原文/
+├── 拆文报告.md
+├── 情节节点.md
+├── 写作手法.md
+└── _meta.json
+```
+
+此视图为可选项，没有外部对标时不创建。复制前必须确认来源是 `拆文库/{对标书名}/`，不得使用 `拆文库/{导入书名}/` 或本篇 `设定.md` 填充。
+
+---
+
+## 质量检查清单
+
+Phase 3-S 迁移完成后执行：
+
+- [ ] `正文.md` 单文件存在且格式符合 `format-and-structure.md`（小节标记、段落划分/主语节奏、段间仅单换行、引号格式）
+- [ ] `设定.md` 含核心框架区块 + 本书续写基线区块，且核心框架符合本文件模板
+- [ ] `小节大纲.md` 节数与正文实际段落结构一致
+- [ ] 所有 `[待补充]` 标记已添加（不确定字段不留空）
+- [ ] 未误建 `追踪/`、`大纲/`、`正文/` 等长篇专属目录
+- [ ] `拆文库/{导入书名}/` 未被复制到本篇 `对标/`；若绑定外部对标，来源与 `对标/{对标书名}/` 目录名一致

package/resources/skills/story-creation/upstream/skills/story-import/references/tracking-initialization.md

@@ -0,0 +1,31 @@
+# 追踪初始化事务
+
+## 初始化事务
+
+新书从第 0 章初始化：把下面的 JSON 写到 `{书目录}/.story/work/init.json`，跑 `{PYTHON} {skill 根}/scripts/tracking_commit.py init --project {书目录} --input {书目录}/.story/work/init.json`，成功后删掉临时文件。`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 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。

package/resources/skills/story-creation/upstream/skills/story-import/references/tracking-transaction.md

@@ -0,0 +1,146 @@
+# 追踪状态协议
+
+`追踪/` 使用“一个结构化权威状态 + 多个确定性派生视图”。模型只提交一份语义 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 根目录；字数与章节闭环统一使用 `story-long-write` skill 根目录：
+
+```text
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py init   --project {书项目根} --input {书项目根}/.story/work/init.json
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py check  --project {书项目根}
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py draft  --project {书项目根} --chapter {N}
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter check   --project {书项目根} --chapter {N} [--min-chars {下限} --max-chars {上限}]
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter commit  --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter accept-current-length --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
+```
+
+- `init`：只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
+- `draft`：按当前 state 把逐章事务预填到 `.story/work/第NNN章/tracking.json`（修订号、模式、章名、`context` 四项当前值），并输出各文本字段的字数上限与在场核心角色的当前快照。新章（append）调用方只填 `delta` 与有变化角色的快照；已提交章（revision）的 `delta` 与相关角色快照按该章现有逐章记录预填（伏笔、时间线取当前值），调用方在上面改成修订后的完整记录，不清空重写。
+- 作者字数范围：细纲可写一行 `字数范围：2000-2600`（作者明确给了上下限时）；本轮临时给的范围用 `--min-chars` / `--max-chars`（两者同给，优先于细纲）。`wordcount check` / `checkpoint` 与 `chapter check` / `commit` / `accept-current-length` 都认，给了就同时替代默认 ±12% 内部带与 ±15% 用户带，结果里 `band_source` 为 `author`，提交的字数记录多一项 `author_range`。
+- `wordcount measure` / `wordcount checkpoint`：纯测量入口；不写正文、不写 tracking、不做语义判断。长篇正文只在前组写完后由主会话带 `--project` 调用一次 `checkpoint`（目标与字数范围读细纲，见 workflow-chapter 步骤 6），整章长度由 `chapter check` 收口；`remaining_user_range` 按生效区间（作者区间或默认用户带）计算。
+- `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。顶层 `status`：`ready`（可提交，exit 0）/ `needs_decision`（长度带外，按 `available_actions` 交作者，exit 0）/ `blocked`（有 blocking 正文问题，exit 1）/ `invalid`（正文为空等，exit 1）/ `tool_unavailable`（找不到 node 或检测脚本，见 `quality.tool_errors`，不是正文问题，exit 3）。参数错误或文件缺失输出 `story-chapter-error/v1`（`status: error`，exit 2）。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及回到生效区间所需的删除字数。`quality.semantic_advisories` 是语义类 advisory 条数（检测器标 `review: mechanical` 的不计）。
+- `chapter commit`：再次读取当前文件、重新计数并重跑 blocking quality；只接受生效区间内的章节，把简短字数记录与逐章事务一起原子提交。新章与修订都走它。
+- `chapter accept-current-length`：只接受带外但 quality pass 的章节；接受动作发生时重新读取、重新计数并立即原子提交，不保存可陈旧的历史决议。低于字数目标一半（`BELOW_ACCEPT_FLOOR`），或超长却还没做过那一次压缩（`COMPRESSION_REQUIRED`），都拒绝；作者明确拍板时加 `--force`。
+- `check`：严格验证 state schema、逐章记录连续性/规范名/体积、固定 7 栏、角色快照硬上限、派生文件集合，以及所有派生视图与 state 的逐字一致性。
+
+每本书由 `追踪/.tracking-commit.lock` 串行写事务，`expected_state_revision` 再拒绝基于旧状态构造的 stale transaction。两个不同事务并发时至多一个修订成功。字数记录也在锁内对当前正文和目标重新验证，正文或目标变化会让预先构造的记录直接失败。
+
+事务 JSON 是临时输入，不是项目产物：只写在书目录 `.story/work/` 下（逐章事务放 `.story/work/第NNN章/tracking.json`），不写系统 `/tmp`、书根、`大纲/` 或 `正文/`；成功前必须保留，提交成功后即可删除（`storyctl.py chapter commit` / `accept-current-length` 成功时自动删除该章目录；直接调用 `tracking_commit.py commit` 时由调用方删除。已有字数记录的章节正文或目标改过后，`tracking_commit.py commit` 拒绝修订事务，须走 `storyctl.py chapter commit`）——之后 `check` 失败按下文提交 `mode=revision` 新事务修复，不需要原事务。若文件写入失败，`_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` 仍直接拒绝旧结构——它们只在已建协议的项目上运行。
+
+## 初始化事务
+
+仅新书或导入初始化时，执行 `init` 前必须完整读取 [tracking-initialization.md](tracking-initialization.md)，按其中原始 JSON 与导入边界构造事务。已有项目续写直接使用下方逐章事务，不重复读初始化示例。
+
+调用方的逐章 JSON 不写 `wordcount`；正式入口 `chapter commit` 或 `chapter accept-current-length` 在提交当下生成并注入。最终 state 只为已提交章节保留 `metric / target / actual / status / resolution / body_sha256`（生效了作者字数范围时另加 `author_range`），不保存 MEASURE/RESOLVE 事件、ID 链、policy fingerprint 或独立 chapter state。
+
+## 逐章事务
+
+```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` 最多 6 条：要加第 7 条先合并语义重叠项或请作者取舍，不自动删旧约束；永久生效的设定裁定进它，短期强承诺进 `next_chapter_commitments`，过程决策不进续写状态卡。
+- `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` 时，逐章记录必须重算为修订后该章仍然成立的完整连续性记录（用 `draft` 预填的草稿改，漏写的项会从记录里消失，工具在 stderr 警告被清空的栏目；原有的退役登记原样保留）；当前角色、伏笔、时间线和上下文则提交受影响对象截至最新已写章的当前值。
+- 修订导入截止章内的正文时，会新增或覆盖该章的逐章记录；`imported_through_chapter` 不变。
+
+## 续写状态卡固定格式
+
+`上下文.md` ≤12288 字节，由 state 整份生成，只含以下 7 个顶层区块：
+
+1. `## 当前位置`
+2. `## 长期约束`
+3. `## 核心角色状态`
+4. `## 活跃伏笔`
+5. `## 近三章速记`
+6. `## 下一章承诺`
+7. `## 连贯性风险`
+
+其中活跃角色最多 6 人、活跃伏笔确定性选取最多 8 条、近章只保留 3 章。这些是下一章热上下文容量，不是完整角色状态的容量限制。