@oh-story/dsh 0.1.0

package/lib/oh-story/skills/story-import/references/character-state-reverse.md

@@ -0,0 +1,82 @@
+# 核心角色当前快照反推规则（长篇导入）
+
+> 仅用于 `story-import` 导入长篇。输出不是一份不断追加的角色历史，而是初始化事务里的 `character_snapshots`；`tracking_commit.py init` 会为每个核心角色生成 `追踪/角色状态/{角色名}.md`。
+
+## 一、输入来源
+
+只从已经落盘的拆书产物反推，不重读 `原文/`：
+
+| 输入 | 用途 |
+|---|---|
+| `拆文库/{书名}/角色/{角色名}.md` | 身份、能力、目标、成长弧线、出场记录 |
+| `拆文库/{书名}/角色/角色关系.md` | 截至最后完整章的关键关系 |
+| `拆文库/{书名}/章节/第N章_摘要.md` | 最后位置、最新状态、已知信息与未结事项 |
+| `拆文库/{书名}/剧情/*.md` | 阵营/身份转折、阶段目标和长期冲突 |
+| 初始化事务中的伏笔与时间线候选 | 核对角色未结事项及其可知范围 |
+
+## 二、追踪对象
+
+只为主角、反派、核心配角建立独立快照。临时路人和只承担一次功能的角色不建文件。边界不清时优先不建，后续角色真正进入复用状态时再由逐章事务创建。
+
+## 三、反推方法
+
+对每个核心角色，以最后完整导入章 N 为截面，分别确定：
+
+1. `identity`：截至 N 章实际成立的身份/职业，不写未来晋升计划。
+2. `location`：最后落点或下一章开始前可确定的位置。
+3. `goal`：角色当前正在追求的具体目标。
+4. `state`：身体、情绪、名望、立场中会影响续写的当前状态；只写必要信息。
+5. `abilities_resources`：当前确实掌握的能力、物品、权限、作品或人脉，最多 8 条。
+6. `relationships`：与后续会复用角色的当前关系，最多 8 条。
+7. `knowledge`：角色本人已经知道、且会影响其行为的信息，最多 8 条。作者真相不能误写成角色已知。
+8. `open_threads`：角色相关的未结事项，最多 8 条；必须有已写正文证据，纯未来设计留在大纲。
+
+若同一字段有多次变化，只取截至 N 章的当前值，不把变化史塞进快照。历史变化由后续 `逐章记录/第NNN章.md` 承担；导入旧章不补造这些记录。
+
+## 四、初始化 JSON 形状
+
+以下示例来自 demo《让你管账号，你高燃混剪炸全网》第 10 章：
+
+```json
+{
+  "江晨": {
+    "identity": "火箭军文工团宣传兵；军宣爆款创作者",
+    "location": "火箭军文工团高层看片会",
+    "goal": "完成五天百万粉任务，继续做出真正能打的军宣内容",
+    "state": "专业团队重拍版反向坐实手机原版的价值，军内认可继续抬升",
+    "abilities_resources": [
+      "前世 MCN 爆款运营经验",
+      "《中国军魂》伴奏",
+      "大师级导演能力"
+    ],
+    "relationships": [
+      "钟嘉嘉持续提供军报资源",
+      "周薄森和张耀祖已明确认可其创作能力"
+    ],
+    "knowledge": [
+      "《军报》采访稿已经过审",
+      "高层决定继续采用《诸君，且听龙吟》手机原版"
+    ],
+    "open_threads": [
+      "五天百万粉任务尚未结算",
+      "钟嘉嘉所谓只猜对一半仍未解释"
+    ]
+  }
+}
+```
+
+工具据此生成的文件固定包含：截至章节、身份、位置、当前目标、身心状态、能力与资源、关键关系、已知信息、未结事项。模型不得另写一套 Markdown 模板。
+
+## 五、残稿与分批导入
+
+- 最后一章是残稿：所有快照截至残稿之前的最后完整章；残稿中的动作、获得物、关系变化不得提前生效。
+- 分批导入：快照只表示本次已导入范围的当前状态；扩大导入范围时重新执行一次完整导入，不在旧快照上追加历史段落。
+
+## 六、质量检查
+
+- [ ] 每个文件对应一个核心角色，无功能角色堆积
+- [ ] 所有字段都是截至最后完整章的当前值
+- [ ] 角色已知信息没有混入作者真相
+- [ ] 未结事项都有正文证据，未来设计仍在大纲
+- [ ] 单角色快照目标不超过 4096 字节；确有必要可放宽，但不得超过 8192 字节硬上限
+- [ ] `tracking_commit.py check` 通过

package/lib/oh-story/skills/story-import/references/format-and-structure.md

@@ -0,0 +1,169 @@
+# 正文格式与小节结构
+
+> 写作前必读。以下格式是当前仓库约定的默认正文交付格式；用户或目标平台有明确要求时，以用户/平台要求覆盖。
+>
+> **适用范围**：段落格式（戏剧单元/镜头优先，短段为底色，长段用于完整推理、氛围和情绪链）和对话格式适用于所有体裁。小节(beat)结构和字数标准仅适用于短篇。长篇小说字数以本章细纲的 `字数目标` 与统一 90% 放行下限为准。
+
+---
+
+## 章节标记
+
+默认格式（按灵活度排序）：
+
+| 格式 | 平台适用 | 示例 |
+|------|----------|------|
+| `###1.` | 短篇默认 | `###1.` `###2.` `###3.` |
+| `###第一章` | 部分平台 | `###第一章` `###第二章` |
+| `1.`（纯数字） | 知乎 | `1.` `2.` `3.`（无 ### 前缀） |
+
+**规则**：全文统一一种格式，不要混用。短篇推荐 `###1.` 或纯数字，简洁高效。
+
+---
+
+## 段落格式
+
+### 核心规则：戏剧单元优先
+
+默认交付排版是**按戏剧单元/镜头自然断段，段落紧密排列**。不要把固定字数当成强制切刀；先判断“一件事/一个推理链/一个情绪变化”是否完成。
+
+- 一段承载一个戏剧单元：一个动作链、一个线索发现、一次视线切换、一轮心理判断，或一条连续的氛围/推理/情绪链。
+- 场景结束、一件事结束、新动作、新物件、新信息、新对话另起一段；同一瞬间的发生、感知、反应应织在一起，不拆成动作层/感知层/反应层。
+- 正文相邻段落之间**只允许一个换行符 `\n`**；不得出现空行或连续换行 `\n\n`（紧密排列）。
+- 无缩进（平台渲染器自行处理，不需要 `　　` 或空格）。
+- 长度只作诊断：读起来拥挤、混入多个拍点、或手机屏上难以跟读时才拆；完整推理、氛围铺陈、情绪递进未结束时，允许稍长段保留连贯性。
+
+### 段落节奏（长短交错 + 疏密有别）
+
+短段快读，是网文手机阅读的底色；长段负责承载完整推理、氛围和情绪沉淀。**忌通篇同长度**，也忌把每段按同一字数阈值切开：
+
+- **长短交错**：高潮、打脸、反转压到最短（单句成段）；推理链、环境压迫、情绪沉淀、章节收束可保留较长段，让读者读完一个完整变化。
+- **疏密有别（详略）**：爽点、转折 beat 写密（感知、动作、细节铺满）；过场、连接 beat 写疏（1-2 句带过，不平均用力）。每个 beat 一样长、一样细，正是 AI 腔的来源。
+- **不过度碎片化**：连续多个极短段若仍属于同一镜头/同一件事，应合并成自然段，避免像提纲或诗行。
+
+### 主语与角色名节奏
+
+角色名不宜一味省略，也别每句都点名。按“主语重置”使用：
+
+- 段首、场景切换、多人同场、或主语可能混淆时，用主角名/角色名建立视角。
+- 同一段或同一动作链内，优先混用代词、动作承接和合理省略，避免每句都以同一角色名开头。
+- 关键转折、情绪爆点、身份反差或读者需要重新盯住主角时，可以再次点名强化。
+- 审查主语节奏看“读起来是否打磕巴”，不按全章出现次数一刀切；只有连续句/连续段无主语重置却反复点名，才算主语过密。
+
+---
+
+## 对话格式
+
+### 对话标记
+
+按目标平台/用户要求选择；未指定时使用默认格式：
+
+| 优先级 | 格式 | 适用平台 |
+|--------|------|----------|
+| 首选 | `"说话内容"` | 短篇默认、番茄 |
+| 平台/项目指定 | `「说话内容」` | 知乎盐言短篇、部分古言、日式或用户指定 |
+
+**默认用 `""`**；用户或平台指定盐言风格时改为 `「」`，不要把 `「」` 视为错误。
+
+### 对话规则
+
+1. 对话**独立成行**，不嵌在叙述段落中
+2. 对话标签按需：高频或公式化的「他说」「她道」「他笑了笑说」用动作描写替代；普通「说」低频使用可保留（与「8 条绝对禁止」中「避免对话标签机械化」一条一致）
+3. 两人对话连续出现时，省略标签，靠内容区分说话人
+
+**正确示例**：
+```
+她把杯子放下。
+"你走吧。"
+他没有动。
+"我说，你走吧。"
+```
+
+**也合法（普通「说」低频使用）**：
+```
+她把杯子放下。
+"你走吧。"她说。
+他没有动。
+"我说，你走吧。"
+```
+
+**错误示例**：
+```
+她把杯子放下，说道："你走吧。"他没有动，她又说："我说，你走吧。"
+```
+
+---
+
+## 语气标点谱系
+
+标点服务语气、人物声线和情绪节奏，不能通篇句号化，也不能为了“丰富”随机堆砌符号。先判断当前句子的功能，再选择标点：
+
+| 语气 / 功能 | 标点策略 | 防线 |
+|---|---|---|
+| 压迫 / 冷静 / 克制 | 短句、逗号、句号，必要时用冒号压出判断落点 | 不人工加感叹号；克制不是每句都平铺句号 |
+| 质问 / 试探 / 反问 | 问号 + 短促追问片段，配合动作停顿 | 避免每句话都以 `？` 结尾 |
+| 惊讶 / 爆发 / 打脸 | 真正爆点可用 1 个感叹号，连续爆发最多 1-2 处 | 禁止 `!!!`、整段喊叫式感叹 |
+| 犹豫 / 吞咽 / 未说完 | 逗号、句号、短句断开、动作 beat | 不用 `……` 制造停顿；优先用动作和句长变化 |
+| 被打断 / 拖长音 | 不使用 `——`；改用动作打断、换行、短句或未完成动作 | 正文和对话都禁止 `——` / `—` / `--` |
+| 信息揭示 / 判断落点 | 冒号、分号或单句成段制造落点 | 保持手机阅读友好，不写论文式分号串 |
+
+执行规则：
+- 写对话时先看角色关系和权力位置：强势角色常短句收束，试探角色多问号和半句，崩溃角色才允许少量感叹/省略。
+- 写叙述时用句长、逗号停顿和单句成段制造节奏；不要把破折号当节奏工具，对话里也不要用。
+- 精修时检查两类问题：**通篇句号化**（语气全被压平）与**随机标点堆砌**（问号/感叹号不承载情绪功能，或用省略号/破折号硬造停顿）。
+- 引号风格按项目/平台约定；知乎盐言的 `「」` 是合法对话格式，`quote-mode keep` 时不得擅自改掉。
+
+---
+
+## 小节（beat）结构
+
+### 基本规则
+
+- 用数字编号（`1` `2` `3`）分割小节，每个小节是一个完整的叙事 beat
+- 每小节 800-1500 字（爽文可压缩至 500-800 字/节，见 genre-writing-formulas.md）
+- 8-15 个小节覆盖全文（按目标字数反推；8000÷1000≈8节，12000÷800≈15节）
+- 每小节推进一个明确的情节点
+
+### 小节内部结构
+
+每个小节应该有：
+
+1. **一个主事件** + **3-5 个子事件**（主事件推进核心情节，子事件丰富层次；初稿偏短时先回到小节/细纲补足计划内子事件、对话或冲突，再写正文；去AI味已有正文时不得新增剧情）
+2. **一个情绪变化**（读者的感受如何变化）
+3. **一条读者新获知的信息**
+4. **3-5 轮对话交锋**（揭示关系/升级冲突，参考 writing-craft.md 对话权力博弈。特定场景如独自发现/翻阅日记可标零，按当前 skill 的细纲/设计任务要求执行）
+5. **每个子事件三维度揉进**：发生+感知+反应揉进同一段正文（参考 writing-craft.md 场景写法）
+
+
+### 小节之间的衔接
+
+- 小节结尾留一个钩子（悬念/未解决的情绪/新问题）
+- 下一节开头快速接续，不要重新铺垫
+- 情绪跨节递进：每一节的情绪强度 ≥ 上一节。例外：峰值情绪（反转节）后允许维持 1 节不降，但不允许骤降
+
+---
+
+## 平台对话格式覆盖表
+
+| 平台 | 章节标记 | 对话格式 | 特殊要求 |
+|------|----------|----------|----------|
+| 知乎盐言 | `1.` | `「」` | 导语需单独标注 |
+| 番茄 | `###第一章` | `""` | 首段需有吸引力 |
+| 红果 | `###1.` | `""` | 无 |
+
+**通用原则**：用户未指定平台时，默认使用短篇通用格式（`###1.` + `""`）；用户或平台指定盐言风格时，`「」` 是允许的。
+
+---
+
+## 8 条绝对禁止
+
+以下规则在写作全程执行，不因题材或风格而变：
+
+1. **禁止机械按字数分段**：不要因为超过某个字数就强拆；先判断段落是否仍是一个完整戏剧单元。若混入多个动作/信息/视线切换才拆，完整推理、氛围、情绪链可保留稍长段
+2. **禁止段间空行**：正文相邻段落之间只允许一个换行符 `\n`，不得出现空行或连续换行 `\n\n`
+3. **避免对话标签机械化**：高频或公式化的「他说」「她道」「他笑了笑说」用动作/上下文替代；普通“说”可保留
+4. **禁止缩进**：不使用 `　　`（全角空格）或半角空格缩进
+5. **禁止正文段落 Markdown 渲染**：除统一的小节/章节标记（如 `###1.`）外，正文段落中不使用加粗 `**`、斜体 `*`、标题 `#`、分隔线 `---` 等 Markdown 语法
+6. **正文不使用破折号**：正文（含叙述、对话、心理描写）不使用破折号 `——`/`—` 或双连字符 `--`，改用句号、逗号、换行、动作 beat 或短句断开；不再设置“对话例外”
+7. **禁止通篇句号化或随机标点堆砌**：标点必须跟语气/人物声线/情绪功能匹配；该质问时用问号，该爆发时少量感叹；犹豫、吞咽、未说完用动作或句长变化表达，不用 `……` / `——` 硬造停顿，也不得无功能地乱撒 `？`/`！`
+8. **禁止正文混入章节元信息**：章节号只允许出现在标题/小节标记/文件名/追踪记录中。正文叙述、对话、心理描写里不得出现 `第[一二三四五六七八九十百千万两0-9]+章|上一章|上章|前一章|本章|这一章|前文|后文|伏笔|细纲|读者` 这类写作工程词；要改成角色能感知的事件锚点或相对时间，例如把“比第一章那三秒开火更疼”改成“比那三秒开火更疼”。例外：角色在故事世界内真实阅读/讨论“第X章”文本，或真实身为作者/读者并谈论读者身份时，可保留相应词。
+

package/lib/oh-story/skills/story-import/references/length-routing.md

@@ -0,0 +1,134 @@
+# 篇幅分流判断规则
+
+Phase 1「基本信息确认」环节使用本规则判定导入书是长篇还是短篇，判定结果决定后续走哪条迁移路径。
+
+---
+
+## 判定优先级
+
+判定按以下顺序执行，命中即停止，不再向下判断。
+
+| 优先级 | 信号来源 | 判定规则 |
+|--------|---------|---------|
+| 1 | 用户显式声明 | 用户说「这是长篇 / 短篇」→ 以用户为准，直接锁定 |
+| 2 | 结构信号 + 字数校验 | 检测到明确章节分隔符且章节数 ≥ 5 → 长篇；全文无章节分隔、单文件单篇 → 按下方细则表按字数分三档判定（字数阈值沿用优先级 3 的建议值） |
+| 3 | 字数兜底 | 仅在 1、2 均不明确时启用，见下方「字数兜底规则」 |
+| — | 冲突处理 | 信号之间发生矛盾时，不自动决策，回到 Phase 1 向用户复述并请用户拍板 |
+
+---
+
+## 优先级 1：用户显式声明
+
+Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
+
+- 用户明确回答 → 锁定类型，跳过后续检测。
+- 用户未回答或说「不确定」→ 进入优先级 2 结构信号检测。
+
+---
+
+## 优先级 2：结构信号 + 字数校验
+
+### 章节分隔符识别
+
+复用 `structure-mapping-long.md` 的分隔符识别表：
+
+| 分隔符模式 | 示例 |
+|-----------|------|
+| `第X章` / `第X章 ` / `第X章：` / `第X章 XXX` | 第1章 初入江湖 |
+| `Chapter X` | Chapter 1 |
+| 纯数字编号 + 标题 | 1. 觉醒 |
+
+### 判定规则
+
+| 检测结果 | 判定 |
+|---------|------|
+| 有明确章节分隔符，且识别到章节数 ≥ 5 | 强长篇信号 → 判定为**长篇** |
+| 全文无任何章节分隔符，单文件单篇，且总字数 < 20000 | 强短篇信号 → 判定为**短篇** |
+| 全文无任何章节分隔符，单文件单篇，20000 ≤ 总字数 < 30000 | 判定为**短篇**，但 Phase 1 复述时告知：已超过短篇拆解管道 20000 字的建议上界，请用户确认仍按短篇导入 |
+| 全文无任何章节分隔符，单文件单篇，但总字数 ≥ 30000 | 结构与字数信号相反 → 不自动判定，见下方「冲突处理」请用户拍板 |
+| 有章节分隔符，但章节数 < 5 | 结构信号不明确 → 进入优先级 3 字数兜底 |
+| 分隔符模式模糊（如仅有单个标题行） | 结构信号不明确 → 进入优先级 3 字数兜底 |
+
+---
+
+## 优先级 3：字数兜底
+
+**仅在优先级 1、2 均无法给出明确判定时使用。** 当前导入契约按短篇通常 8000-20000 字的区间取 30000 字作建议上界，并保留题材差异余量。
+
+| 条件 | 判定 | 备注 |
+|------|------|------|
+| 总字数 < 30000 且无章节结构 | **短篇** | — |
+| 总字数 ≥ 30000 | **长篇** | — |
+| 章节数 ≥ 5（任意字数） | **长篇** | — |
+| 总字数 < 30000 但章节数 ≥ 5 | 初判**长篇**，但须提示用户 | 见下方「分章短篇连载」 |
+
+> **建议值说明**：30000 字阈值是估算值，不同平台和题材的短篇上限有差异。执行时列入 open-questions，建议用户复核是否适用于当前导入书。
+
+### 分章短篇连载
+
+检测到总字数 < 30000 但章节数 ≥ 5 时，在确认环节提示用户：
+
+> 「检测到分章结构（共 {N} 章），但总字数约 {X} 字，低于 30000 字。可能是分章短篇连载。确认按长篇导入，还是按短篇处理？」
+
+用户拍板后锁定类型。
+
+---
+
+## 冲突处理
+
+当不同信号之间出现矛盾时，**不自动决策**，回到 Phase 1 向用户复述检测结果：
+
+| 典型冲突场景 | 处理方式 |
+|------------|---------|
+| 用户说「短篇」但检测到 20 章 | 复述：「检测到 20 章章节结构，通常属于长篇。确认按短篇导入？」由用户拍板 |
+| 用户说「长篇」但全文无章节分隔且字数 < 30000 | 复述：「全文无章节分隔，总字数约 {X} 字，通常属于短篇。确认按长篇导入？」由用户拍板 |
+| 用户未声明、全文无章节分隔、单文件单篇，但字数 ≥ 30000 | 复述：「全文无章节分隔，但总字数约 {X} 字，已超过短篇常见上界。按长篇导入建工程，还是仍按短篇处理？」由用户拍板 |
+| 结构信号与字数信号方向相反 | 展示两项信号，请用户决定 |
+
+用户拍板的结果记入 Phase 1 上下文，后续步骤以此为准，不再重新判定。
+
+---
+
+## 判定结果与后续路径
+
+判定完成后，迁移路径按以下对应关系分流：
+
+| 判定结果 | 迁移路径 | 映射规则参考文件 |
+|---------|---------|----------------|
+| **长篇** | 长篇迁移路径（Phase 3-L） | `structure-mapping-long.md` |
+| **短篇** | 短篇迁移路径（Phase 3-S） | `structure-mapping-short.md` |
+
+> 注：`structure-mapping-long.md` 对应长篇迁移映射规则，`structure-mapping-short.md` 对应短篇迁移映射规则。
+
+---
+
+## 快速判定流程图
+
+```
+Phase 1 问用户：「长篇还是短篇？」
+         │
+         ├─ 用户明确回答 ──────────────────────────► 锁定类型
+         │
+         └─ 未回答 / 不确定
+                  │
+                  ▼
+         检测章节分隔符
+                  │
+                  ├─ 有分隔符且章节数 ≥ 5 ──────────► 长篇
+                  │
+                  ├─ 无分隔符，单文件单篇，< 20000 ─► 短篇
+                  │
+                  ├─ 无分隔符，单篇，20000 ≤ 字数 < 30000 ─► 短篇（复述时告知超出建议上界）
+                  │
+                  ├─ 无分隔符，单文件单篇，≥ 30000 ─► 提示用户裁定
+                  │
+                  └─ 信号不明确
+                            │
+                            ▼
+                   字数兜底判定（30000 字阈值）
+                            │
+                            ├─ < 30000 且无章节结构 ─► 短篇
+                            ├─ ≥ 30000 ─────────────► 长篇
+                            ├─ 章节数 ≥ 5 ──────────► 长篇
+                            └─ < 30000 但章节数 ≥ 5 ─► 提示用户裁定
+```

package/lib/oh-story/skills/story-import/references/state-tracking.md

@@ -0,0 +1,108 @@
+# 状态追踪协议
+
+> 本文件定义"本节速记"的提取逻辑和"角色状态记录"的格式。写作 skill 在写前准备的状态筛选步骤中加载此文件。
+
+---
+
+## 本节速记
+
+写作每一章/每一节前，从所有已加载的上下文中筛选出只与本节相关的信息。目的是避免全量加载导致 LLM 上下文被无关信息稀释。
+
+### 筛选逻辑
+
+从上下文中提取三类信息：
+
+1. **当前状态**：本章涉及角色的最新能力、关系变化、公众形象
+2. **历史因果**：与本章事件直接相关的伏笔成因、前史事件
+3. **世界约束**：本章涉及的世界观规则（力量体系、社会规则、地理限制）
+
+### 筛选标准
+
+**只保留"如果不知道这个，本章会写错"的信息。**
+
+具体判断方法：
+- 本章细纲中提到了某个角色 → 保留该角色的当前状态
+- 本章有伏笔回收 → 保留伏笔的埋设细节和前文铺垫
+- 本章涉及特定地点/能力/规则 → 保留相关世界观约束
+- 纯背景知识（与本章事件无因果关联） → 丢弃
+
+### 输出格式
+
+筛选后输出一个简洁的"本节速记"：
+
+```
+## 本节速记（第{N}章）
+
+### 角色状态
+{角色A}：{一句话当前状态，含最近变化}
+{角色B}：{一句话当前状态}
+
+### 相关伏笔/前史
+{伏笔1}：{埋设细节，{埋设章节}}，本章需要{回收/推进}
+
+### 世界约束
+{约束1}：{与本章相关的规则/设定}
+```
+
+**示例（demo《让你管账号，你高燃混剪炸全网》第 10 章）：**
+```
+## 本节速记（第10章）
+
+### 角色状态
+江晨：火箭军文工团宣传兵，《诸君，且听龙吟》已爆红，正从军宣新人升为军内认可的创作者
+钟嘉嘉：军报记者，采访稿已经过审，与江晨从采访关系转为稳定合作
+周薄森：文工团副团长，已从担心江晨惹事转为认可其创作能力
+
+### 相关伏笔/前史
+五天百万粉任务：第1章发布，第10章仍未结算；本章只推进声量，留到第11章结算
+专业团队重拍：本章用高清专业版“缺了灵魂”反衬江晨手机原版不可替代
+
+### 世界约束
+军宣作品采用要经过组织决策；江晨可以靠作品效果赢得认可，不能跳过军内流程直接拍板
+```
+
+---
+
+## 角色状态记录格式
+
+> ⚠️ **本节仅适用于长篇写作。** 短篇通常不需要独立角色状态追踪。
+
+动态状态按核心角色拆成 `追踪/角色状态/{角色名}.md`，由 `tracking_commit.py` 根据事务 JSON 整份覆盖；静态原始人设仍在 `设定/角色/{角色名}.md`。只为后续会复用的主角、反派、核心配角建快照，不为路人、一次性功能角色建文件。
+
+### 格式
+
+```markdown
+# 江晨｜当前状态
+
+- 截至章节：第10章
+- 身份：火箭军文工团宣传兵；军宣爆款创作者
+- 位置：火箭军文工团高层看片会
+- 当前目标：完成五天百万粉任务，持续做出真正能打的军宣内容
+- 身心状态：专业团队反向验证原版价值，军内认可继续抬升
+
+## 能力与资源
+- 前世 MCN 爆款运营经验
+- 《中国军魂》伴奏
+- 大师级导演能力
+
+## 关键关系
+- 钟嘉嘉持续提供军报资源
+- 周薄森和张耀祖已明确认可其创作能力
+
+## 已知信息
+- 《军报》采访稿已经过审
+- 原版视频将继续作为正式军宣内容
+
+## 未结事项
+- 五天百万粉任务尚未结算
+- 钟嘉嘉所谓“只猜对一半”仍未解释
+```
+
+### 更新规则
+
+1. 每章只记录身份、位置、目标、身心状态、能力资源、关系、已知信息、未结事项中真正发生变化的内容。
+2. 核心复用角色发生变化时，在同一事务的 `character_changes` 写变化，并在 `character_snapshots` 提交其**截至当前已写最后一章**的完整快照；工具以快照是否存在判断核心/临时角色，整份覆盖核心角色小文件，不追加历史。
+3. 修订旧章时，从修订章检查到最后已写章，按各维度和各关系对象重算当前状态，再提交完整快照；不得把最后一条单维度变化当成角色全状态。
+4. 无变化可不提交快照；核心角色重新进入当前场景时直接读取其已有小文件，并由事务工具把必要信息带入续写状态卡。
+5. 角色变化历史属于 `逐章记录/第NNN章.md`，当前快照不重复保存逐章履历。
+6. 完整 JSON 字段、4096 字节目标与 8192 字节硬上限见 [tracking-transaction.md](tracking-transaction.md)。