@oh-story/dsh 0.1.14 → 0.1.16

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

@@ -1,6 +1,6 @@
 # 正文格式与小节结构
 
-> 写作前必读。以下格式是当前仓库约定的默认正文交付格式；用户或目标平台有明确要求时，以用户/平台要求覆盖。
+> 本文件规定默认正文交付格式；用户或目标平台的明确要求优先。
 >
 > **适用范围**：段落格式（戏剧单元/镜头优先，短段为底色，长段用于完整推理、氛围和情绪链）和对话格式适用于所有体裁。小节(beat)结构仅适用于短篇；小节不设统一最低字数。长篇按 `visible_chars_v1` 测量同口径细纲 `字数目标`：内部带 ±12%，用户带 ±15%。
 
@@ -8,7 +8,7 @@
 
 ## 章节标记
 
-默认格式（按灵活度排序）：
+按目标平台选择，未指定时用短篇默认格式：
 
 | 格式 | 平台适用 | 示例 |
 |------|----------|------|
@@ -36,8 +36,8 @@
 
 短段快读，是网文手机阅读的底色；长段负责承载完整推理、氛围和情绪沉淀。**忌通篇同长度**，也忌把每段按同一字数阈值切开：
 
-- **长短交错**：高潮、打脸、反转压到最短（单句成段）；推理链、环境压迫、情绪沉淀、章节收束可保留较长段，让读者读完一个完整变化。
-- **疏密有别（详略）**：爽点、转折 beat 写密（感知、动作、细节铺满）；过场、连接 beat 写疏（1-2 句带过，不平均用力）。每个 beat 一样长、一样细，正是 AI 腔的来源。
+- **长短交错**：高潮、打脸和反转的关键落点可单句成段；推理、环境压迫、情绪沉淀与收束可保留较长段，让读者读完完整变化。
+- **疏密有别（详略）**：爽点、转折 beat（节拍）按需要展开感知、动作与细节，过场简写；详略取决于叙事职责，不把每个 beat 写成同样长度。
 - **不过度碎片化**：连续多个极短段若仍属于同一镜头/同一件事，应合并成自然段，避免像提纲或诗行。
 
 ### 主语与角色名节奏
@@ -67,8 +67,8 @@
 ### 对话规则
 
 1. 对话**独立成行**，不嵌在叙述段落中
-2. 对话标签按需：高频或公式化的「他说」「她道」「他笑了笑说」用动作描写替代；普通「说」低频使用可保留（与「8 条绝对禁止」中「避免对话标签机械化」一条一致）
-3. 两人对话连续出现时，省略标签，靠内容区分说话人
+2. 对话标签按辨识需要使用：高频或公式化的「他说」「她道」「他笑了笑说」可用动作或上下文替代，普通「说」可保留
+3. 两人连续对话且说话人清楚时，可省略标签；可能混淆时补明说话人
 
 **正确示例**：
 ```
@@ -102,8 +102,8 @@
 | 压迫 / 冷静 / 克制 | 短句、逗号、句号，必要时用冒号压出判断落点 | 不人工加感叹号；克制不是每句都平铺句号 |
 | 质问 / 试探 / 反问 | 问号 + 短促追问片段，配合动作停顿 | 避免每句话都以 `？` 结尾 |
 | 惊讶 / 爆发 / 打脸 | 真正爆点可用 1 个感叹号，连续爆发最多 1-2 处 | 禁止 `!!!`、整段喊叫式感叹 |
-| 犹豫 / 吞咽 / 未说完 | 逗号、句号、短句断开、动作 beat | 不用 `……` 制造停顿；优先用动作和句长变化 |
-| 被打断 / 拖长音 | 不使用 `——`；改用动作打断、换行、短句或未完成动作 | 正文和对话都禁止 `——` / `—` / `--` |
+| 犹豫 / 吞咽 / 未说完 | 默认用逗号、句号、句长变化或动作 beat | 省略号的功能性用法按本书文风约定 |
+| 被打断 / 拖长音 | 默认用动作打断、换行、短句或未完成动作 | 破折号的功能性用法按本书文风约定 |
 | 信息揭示 / 判断落点 | 冒号、分号或单句成段制造落点 | 保持手机阅读友好，不写论文式分号串 |
 
 执行规则：
@@ -138,7 +138,7 @@
 
 - 小节结尾留一个钩子（悬念/未解决的情绪/新问题）
 - 下一节开头快速接续，不要重新铺垫
-- 情绪跨节递进：每一节的情绪强度 ≥ 上一节。例外：峰值情绪（反转节）后允许维持 1 节不降，但不允许骤降
+- 情绪跨节衔接：升温、缓冲与回落均须承接前一节的行动和后果，不要求强度逐节上升
 
 ---
 
@@ -154,9 +154,9 @@
 
 ---
 
-## 8 条绝对禁止
+## 8 条格式规则
 
-以下规则在写作全程执行，不因题材或风格而变：
+以下规则按文件开头的优先级执行；其中标点默认可由本书明确的文风约定覆盖：
 
 1. **禁止机械按字数分段**：不要因为超过某个字数就强拆；先判断段落是否仍是一个完整戏剧单元。若混入多个动作/信息/视线切换才拆，完整推理、氛围、情绪链可保留稍长段
 2. **禁止段间空行**：正文相邻段落之间只允许一个换行符 `\n`，不得出现空行或连续换行 `\n\n`

package/lib/oh-story/skills/story-import/references/import-report.md

@@ -4,9 +4,9 @@ Phase 5 只读本文件和导入记录（`{书目录}/.story/work/导入记录.m
 
 ## Step 1：收尾自检
 
-这是你自己的自检，不念给作者：全部通过就不提；没通过先回到对应时刻修，修不了才用故事话告诉作者影响和办法。
+先完成内部自检；未通过时回到对应时刻修复，仍无法完成才向作者说明影响和办法。
 
-- 导入记录的进度全部勾上（短篇没有细纲与追踪两项）。
+- 导入记录中此前各项进度已勾上（短篇跳过细纲与追踪）；「汇报与激活」在本时刻 Step 3 完成后再勾。
 - **长篇**：`正文/` 章节文件数等于导入范围章数；每章都有 `大纲/细纲_第XXX章.md`，且对全部细纲再跑一次 `node {story-import skill 根}/scripts/check-outline-contract.js --json {书目录}/大纲/细纲_第*.md` 通过；再跑一次 `{PYTHON} {story-import skill 根}/scripts/tracking_commit.py check --project {书目录}`（按 `python3` → `python` → `py -3` 探测）通过；原文没分卷时卷划分已经作者确认；`拆文库/{导入书名}/` 未被复制到 `对标/`。
 - **短篇**：`正文.md`、`设定.md`、`小节大纲.md` 都在，未误建 `追踪/`、`大纲/`、`正文/`。
 
@@ -33,9 +33,9 @@ Phase 5 只读本文件和导入记录（`{书目录}/.story/work/导入记录.m
 1. {最拿不准的一处，写成具体问题，如「第 5 章的黑衣人和第 2 章的车夫是同一人吗？」}
 2. {如「还没收的线里有没有漏的？我列的是：……」}
 
-需要你决定：{仅在有待定事项时写，如「原文没分卷，我按剧情分成 3 卷（1–40 / 41–95 / 96–{N} 章），这样分可以吗？」}
+需要你决定：{仅列尚未确认的事项；已确认的卷划分和残稿决定不再询问}
 
-下一步：说「日更」就从第 {N+1} 章接着写；想先检查导入质量，说「审一下」。
+下一步：{未完本：说「日更」从第 {N+1} 章接着写 | 已完本：想改稿说「审一下」}。
 ```
 
 **短篇**：
@@ -60,5 +60,5 @@ Phase 5 只读本文件和导入记录（`{书目录}/.story/work/导入记录.m
 ## Step 3：项目激活
 
 - 设置 `.active-book` 指向导入的书名/标题目录，在导入记录勾「汇报与激活」。
-- 确认项目可以被对应写作 skill 识别（长篇 → story-long-write，短篇 → story-short-write）。
+- 确认目录符合对应写作 skill 的识别规则：长篇为 `正文/` 与 `大纲/`，短篇为 `正文.md`、`设定.md` 与 `小节大纲.md`。
 - 可选验证：如果当前运行时的 canonical 目录已部署 story-explorer agent，可 spawn 交叉验证迁移数据完整性；Antigravity 检查 `.agents/agents/story-explorer/agent.md` 并用 `invoke_subagent` + `TypeName: "story-explorer"`。Prompt：`项目目录：{dir}\n查询类型：progress\n查询参数：导入验证`

package/lib/oh-story/skills/story-import/references/import-special-cases.md

@@ -1,6 +1,6 @@
 # 导入的特殊情况
 
-只在下面几种情况读；普通导入不读。
+遇到流程答疑、旧追踪迁移或超过 200 章的长篇时读取。
 
 ## 流程答疑
 
@@ -8,14 +8,14 @@
 
 1. **推荐顺序**：先 `/story-setup` 装好写作环境，新开或刷新会话后运行 `/story-import`，最后用 `/story-long-write 日更` 或 `写第N章` 续写。
 2. **也可以直接 `/story-import`**：导入会在深度分析前检查写作环境；没装时给「先去装」或「直接导入，慢一点」两种选择。
-3. **已导入过的当前协议项目**（书名目录下有 `追踪/_tracking-state.json`）：不要重复跑完整导入；直接进入书名目录，确认 `.active-book` 指向正确书目，再用 `/story-long-write 日更` 或 `/story-long-write 写第N章`。书目录下有 `{书目录}/.story/work/导入记录.md` 且进度没勾完时，是上次导入做到一半：从第一个未完成的进度接着做。
+3. **当前协议项目**（书名目录下有 `追踪/_tracking-state.json`）：先查导入记录；若仍有未完成项，从该项续跑。已完成导入时，确认项目根 `.active-book` 指向正确书目，再用 `/story-long-write 日更` 或 `/story-long-write 写第N章`，不重复导入。
 4. **v0.7.2 及更早的旧追踪项目**（有 `追踪/` 和正文，但没有 `追踪/_tracking-state.json`）：日更会停下要求重新导入，但**不需要重跑全书拆解**，只重建追踪，见下一节。
 
 ## 旧追踪项目迁移
 
 书名目录下有 `追踪/` 与正文、但没有 `追踪/_tracking-state.json` 时，项目停在 v0.7.2 及更早的追踪结构上。正文和 `设定/`、`大纲/`、`拆文库/` 都不受影响，**只需重建 `追踪/`**，不重跑深度分析、不碰正文：
 
-1. 数清最后一个完整章号 `N`（`正文/第NNN章_*.md` 的最大值）。
+1. 检查章号最大的 `正文/第NNN章_*.md` 是否完整，确定最后完整章号 `N`；不能仅凭最大文件名判定。
 2. 从旧 `追踪/` 现有文件（角色状态、伏笔、时间线等，文件名按项目实际情况）和最近 3-5 章正文，重建当前状态：核心角色快照、未回收伏笔、已揭示时间线事件、长期约束、下一章承诺。角色快照的反推方法见 [character-state-reverse.md](character-state-reverse.md)。
 3. 按 [import-tracking.md](import-tracking.md) 构造初始化事务（其中点名的 tracking-initialization.md 完整读取），`last_chapter` 写 `N`（第 1..N 章不伪造逐章记录），执行 `tracking_commit.py init`。
 4. `init` 会把旧追踪结构按原样整体移入 `追踪/_旧追踪存档/` 再建当前协议——旧内容不删除、不参与解析，留给作者查阅。
@@ -25,7 +25,7 @@
 
 ## 超过 200 章的作品
 
-仅长篇。短篇为单文件全量迁移，无增量导入需求。拆解可以分批，追踪初始化必须一次覆盖全部已写章节：
+此规则仅用于长篇。拆解可以分批，追踪初始化一次覆盖确认范围内的全部完整章节；短篇按单文件迁移：
 
 1. **拆解分批**：首期只深拆前 50 章 + 全书概要，后续按需补拆更多章节到 `拆文库/`。
 2. **追踪一次到位**：初始化事务的 `last_chapter` 写**最后一个已写完的章号 N**，不是首期拆解的 50。`imported_through_chapter` 由 `init` 一次写定、之后不再推进，逐章事务只接受 N+1 起的章号；第 1..N 章不伪造逐章记录，续写从 N+1 开始。若 init 时误写成 50，第 51..N 章仍可逐章 `append` 补上（一章一份事务，章号必须连续），只是要为已写好的旧章逐章构造事务；不要删 `追踪/` 重来——`_旧追踪存档/` 也在里面。

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

@@ -1,12 +1,12 @@
 # 追踪初始化时刻（仅长篇）
 
-Phase 4 只读本文件、[tracking-initialization.md](tracking-initialization.md)（初始化事务的原始 JSON 与导入边界，完整读取）和 [character-state-reverse.md](character-state-reverse.md)（核心角色快照反推）。导入截止章、残稿决定、卷划分读导入记录（`{书目录}/.story/work/导入记录.md`）；证据只取已落盘的 `拆文库/{导入书名}/` 与项目 `大纲/`，不重读原文。续写时的逐章事务与导入无关，不读。
+Phase 4 完整读取本文件、[tracking-initialization.md](tracking-initialization.md) 的事务骨架与 [character-state-reverse.md](character-state-reverse.md) 的快照规则。截止章、残稿决定与卷划分取自导入记录；证据取自已落盘的拆文库、项目 `大纲/`，以及未深拆章节的 `.story/work/简化摘要/`，不重读原文。
 
 导入项目必须通过本 skill 自带的 `scripts/tracking_commit.py init` 一次性生成追踪状态，禁止模型分别写最终文件。
 
 ## 语义准备顺序
 
-1. **导入截止章**：把最后完整章 N 写入初始化事务的 `last_chapter`。工具在 meta 记录 `imported_through_chapter=N`；导入旧章没有日更事务，不得为第 1..N 章伪造逐章增量，也不额外生成一份重复当前状态的叙事基线。
+1. **导入截止章**：将最后完整章 N 写入 `last_chapter`，工具在 `_tracking-state.json` 写入 `imported_through_chapter=N`。第 1..N 章不伪造日更事务，也不另写一份重复当前状态的叙事基线。
 2. **核心角色当前快照**：从拆书产物反推主角、反派、核心配角的截至 N 章状态，按角色写入 `character_snapshots`，工具生成 `追踪/角色状态/{角色名}.md`；算法见 character-state-reverse.md。
 3. **伏笔当前行**：从有正文证据的铺垫/回收事件生成 `foreshadow`（识别方法见下）。每个 ID 只保留当前状态一行；尚未实际埋设的未来设计留在大纲，不写 `伏笔.md`。
 4. **事实与读者认知**：把关键事件生成到 `timeline_events`（提取方法见下）。同一事件同时写客观事实、读者截至 N 章已知内容和实际揭示状态；未来计划揭示章不得伪装成已发生事实。
@@ -26,7 +26,7 @@ Phase 4 只读本文件、[tracking-initialization.md](tracking-initialization.m
 
 ## 条目形状与容量
 
-在 tracking-initialization.md 的骨架上填条目（导入时 `last_chapter` 写 N）：
+在 tracking-initialization.md 的事务骨架上填条目，`last_chapter` 写 N；下面只展示伏笔、时间线与近章速记，不能替代完整初始化事务：
 
 ```json
 {
@@ -62,11 +62,11 @@ Phase 4 只读本文件、[tracking-initialization.md](tracking-initialization.m
 | 角色秘密 | 高 | 标记为角色伏笔 |
 | 未解决的悬念 | 高 | 从章尾标记提取 |
 
-状态推断：铺垫点在后续章节有「揭示」或「解决」类情节点 → 已回收；无后续呼应 → 已埋；半成品最后几章的铺垫 → 已埋，摘要里注明「接近断点」。
+状态推断：后续情节点实际回应了同一伏笔 → 已回收；尚未回应 → 已埋。不能只凭节点叫“揭示”或“解决”就判回收；半成品末尾尚未回应的铺垫可注明“接近断点”。
 
 ## 时间线提取
 
-从情节点和时间标记中提取：明确日期（“天元三年春”）直接记录；相对时间（“三日后”）推算；事件间隔（“翌日”）连续标记；季节标记（“入冬”）推断季节。按章节顺序排列，同一章内按情节点序号排列；时间标记缺失时标注 `[推断]`。
+从情节点和时间标记提取：明确日期直接记录；相对时间有可靠参照点时推算，季节只能确定到季节。按章节、章内情节点序号整理；缺少参照时写“时间未明”，有依据的推断标 `[推断]`。
 
 ## 验收
 

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

@@ -6,20 +6,20 @@ Phase 1「基本信息确认」环节使用本规则判定导入书是长篇还
 
 ## 判定优先级
 
-判定按以下顺序执行，命中即停止，不再向下判断。
+作者明确声明篇幅类型时直接锁定；未声明时按以下信号初判，有冲突则在 Phase 1 一次确认，后续不再重判。
 
 | 优先级 | 信号来源 | 判定规则 |
 |--------|---------|---------|
-| 1 | 用户显式声明 | 用户说「这是长篇 / 短篇」→ 以用户为准，直接锁定 |
-| 2 | 结构信号 + 字数校验 | 检测到明确章节分隔符且章节数 ≥ 5 → 长篇；全文无章节分隔、单文件单篇 → 按下方细则表按字数分三档判定（字数阈值沿用优先级 3 的建议值） |
-| 3 | 字数兜底 | 仅在 1、2 均不明确时启用，见下方「字数兜底规则」 |
-| — | 冲突处理 | 信号之间发生矛盾时，不自动决策，回到 Phase 1 向用户复述并请用户拍板 |
+| 1 | 用户显式声明 | 以作者声明直接锁定，不用检测结果推翻 |
+| 2 | 结构信号 + 字数校验 | 结合章节分隔符与字数，按下方细则初判 |
+| 3 | 字数兜底 | 仅在前两项均不明确时启用，见「优先级 3：字数兜底」 |
+| — | 冲突处理 | 作者未声明类型、检测信号矛盾时，在 Phase 1 复述差异并请作者拍板 |
 
 ---
 
 ## 优先级 1：用户显式声明
 
-Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
+Phase 1 尚未明确篇幅时提问：**「这是长篇还是短篇？」**
 
 - 用户明确回答 → 锁定类型，跳过后续检测。
 - 用户未回答或说「不确定」→ 进入优先级 2 结构信号检测。
@@ -42,7 +42,7 @@ Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
 
 | 检测结果 | 判定 |
 |---------|------|
-| 有明确章节分隔符，且识别到章节数 ≥ 5 | 强长篇信号 → 判定为**长篇** |
+| 有明确章节分隔符，且识别到章节数 ≥ 5 | 初判**长篇**；总字数 < 30000 时按「分章短篇连载」提示作者确认 |
 | 全文无任何章节分隔符，单文件单篇，且总字数 < 20000 | 强短篇信号 → 判定为**短篇** |
 | 全文无任何章节分隔符，单文件单篇，20000 ≤ 总字数 < 30000 | 判定为**短篇**，但 Phase 1 复述时告知：已超过短篇拆解管道 20000 字的建议上界，请用户确认仍按短篇导入 |
 | 全文无任何章节分隔符，单文件单篇，但总字数 ≥ 30000 | 结构与字数信号相反 → 不自动判定，见下方「冲突处理」请用户拍板 |
@@ -53,16 +53,12 @@ Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
 
 ## 优先级 3：字数兜底
 
-**仅在优先级 1、2 均无法给出明确判定时使用。** 当前导入契约按短篇通常 8000-20000 字的区间取 30000 字作建议上界，并保留题材差异余量。
+**仅在优先级 1、2 均无法给出明确判定时使用。** 30000 字是本导入流程的建议分界，不代表平台投稿上限。
 
 | 条件 | 判定 | 备注 |
 |------|------|------|
-| 总字数 < 30000 且无章节结构 | **短篇** | — |
+| 总字数 < 30000，章节结构不明确或章节数 < 5 | **短篇** | 统一在 Phase 1 确认 |
 | 总字数 ≥ 30000 | **长篇** | — |
-| 章节数 ≥ 5（任意字数） | **长篇** | — |
-| 总字数 < 30000 但章节数 ≥ 5 | 初判**长篇**，但须提示用户 | 见下方「分章短篇连载」 |
-
-> **建议值说明**：30000 字阈值是估算值，不同平台和题材的短篇上限有差异。执行时列入 open-questions，建议用户复核是否适用于当前导入书。
 
 ### 分章短篇连载
 
@@ -98,8 +94,6 @@ Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
 | **长篇** | 长篇迁移路径（Phase 3-L） | `structure-mapping-long.md` |
 | **短篇** | 短篇迁移路径（Phase 3-S） | `structure-mapping-short.md` |
 
-> 注：`structure-mapping-long.md` 对应长篇迁移映射规则，`structure-mapping-short.md` 对应短篇迁移映射规则。
-
 ---
 
 ## 快速判定流程图
@@ -114,7 +108,7 @@ Phase 1 问用户：「长篇还是短篇？」
                   ▼
          检测章节分隔符
                   │
-                  ├─ 有分隔符且章节数 ≥ 5 ──────────► 长篇
+                  ├─ 有分隔符且章节数 ≥ 5 ──────────► 初判长篇（< 30000 时提示确认）
                   │
                   ├─ 无分隔符，单文件单篇，< 20000 ─► 短篇
                   │
@@ -127,8 +121,6 @@ Phase 1 问用户：「长篇还是短篇？」
                             ▼
                    字数兜底判定（30000 字阈值）
                             │
-                            ├─ < 30000 且无章节结构 ─► 短篇
-                            ├─ ≥ 30000 ─────────────► 长篇
-                            ├─ 章节数 ≥ 5 ──────────► 长篇
-                            └─ < 30000 但章节数 ≥ 5 ─► 提示用户裁定
+                            ├─ < 30000，结构不明或 < 5 章 ─► 短篇
+                            └─ ≥ 30000 ──────────────────► 长篇
 ```

package/lib/oh-story/skills/story-import/references/outline-reverse-rules.md

@@ -6,7 +6,7 @@
 
 - 对本批每一章，从任务包里该章的摘要要点反推 `大纲/细纲_第XXX章.md`；要点写「摘要未写」又必须写实际内容时，回看该章正文相关段落补证据，不改正文。
 - 字数目标写任务包里测好的历史长度（`visible_chars_v1` 下的实际长度），不是重新决定创作目标，不自己估算。
-- 单元ID 取任务包附的卷纲「剧情单元（反推）」行里包含本章的单元；单元内第几拍判断不出写 `[待补充]`。
+- 单元ID 取附表「章节范围」覆盖本章的单元；单元内第几拍判断不出写 `[待补充]`。
 - 钩子、人物关系变化、辅线/感情线、行动成本/收益归属等无法由原文摘要稳定判断的字段统一标 `[待补充]`；只反推有证据的蓝图，不为补齐字段编造关系或副线。已写成的历史章「本章禁止提前释放」写「无」；目标情绪与主角目标/关键选择不接受 `[待补充]`。
 
 ## 字段映射
@@ -15,7 +15,7 @@
 |---------|---------|---------|
 | 关键事件 + 局面结果 | 核心事件 | 合并为“谁采取什么行动 → 局面如何变化”；旧摘要没有 `局面结果` 时只用 `关键事件` |
 | 章节字数 | 字数目标 + 字数口径 | 写任务包里测好的 `actual` 与 `visible_chars_v1` |
-| `基调：` + 状态变化 | 目标情绪 | 写成「前状态→后状态」：用基调枚举（紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他）加本章状态变化归纳，不只写一个情绪词；必须写实际内容 |
+| `基调：` + 状态变化 | 目标情绪 | 结合各情节点基调（紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他）与状态变化，归纳为「前状态→后状态」；必须写实际内容 |
 | 关键事件 + 主角行动 | 主角目标/关键选择 | 原文里主角本章要什么、做了什么判断或选择；必须写实际内容 |
 | 所属剧情单元 | 单元ID/位置 | 取反推卷纲「剧情单元」表里包含本章的单元ID；单元内第几拍判断不出写 `[待补充]` |
 | （历史章） | 本章禁止提前释放 | 已写成的章节写「无」 |
@@ -24,7 +24,7 @@
 | 情节点起承转合 + 因果 | 内容概括（起因/发展/转折/高潮/结尾） | 按情节点顺序归纳，用因果链校正起因与转折；证据不足写 `[待补充]` |
 | 主线/支线/任务线索 | 情节安排（主线/辅线/事件线/感情线/逻辑线） | 从剧情单元索引与摘要反推；无证据的辅线/感情线写“无”或 `[待补充]`，不得杜撰 |
 | 涉及 + 状态变化 | 人物关系和出场顺序 | `涉及` 给出候选人物，`状态变化` 只写有证据的“前 → 后”；关键物件从证据或旧情节点补充，缺失写 `[待补充]` |
-| 全部情节点 | 情节细化 / 情节点序列 | 按表格逐行写（# / 情节点 / 功能标签 / 执行边界）；保持原顺序，功能或边界不明写 `[待补充]`，不反推逐点字数配额 |
+| 全部情节点 | 情节细化 / 情节点序列 | 按任务包中的「标题｜类型｜基调」逐点归纳并填表（# / 情节点 / 功能标签 / 执行边界）；保持原顺序，未知写 `[待补充]`，不反推逐点字数配额 |
 | 胜负/反转/收益损失 | 行动成本（可无）/收益归属 | 有明确证据才填写；行动成本可无、不硬造；否则 `[待补充]` |
 | 章尾钩子 + 局面结果 | 结尾设定和钩子 | 结尾设定写原文落到最后的具体动作或画面，章尾钩子写已存在的等待；未来设计仍标 `[待补充]` |
 

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

@@ -10,14 +10,14 @@
 {PYTHON} {story-import skill 根}/scripts/build_outline_brief.py --project {书目录} --chapters {A-B}
 ```
 
-脚本把反推规则与模板（[outline-reverse-rules.md](outline-reverse-rules.md) 全文）、每章按 `visible_chars_v1` 测好的历史长度与摘要要点、卷纲里覆盖本批的剧情单元行，拼成 `{书目录}/.story/work/排纲/导入细纲_第AAA-BBB章.md`。执行者要读的总量超过约 25K 字时脚本自动少排几章（可少于 10 章），以 stdout JSON 的 `chapters` 为本批实际范围、`next` 为下一批起点。缺摘要的章改用简化摘要或正文，已算进总量。
+脚本将反推规则与模板（[outline-reverse-rules.md](outline-reverse-rules.md) 全文）、测好的历史长度、摘要要点和覆盖本批的卷纲剧情单元行，拼成 `{书目录}/.story/work/排纲/导入细纲_第AAA-BBB章.md`。历史长度按 `visible_chars_v1` 计算；执行者要读的总量超过约 25K 字时脚本自动少排几章（可少于 10 章）。以 stdout JSON 的 `chapters` 为实际范围、`next` 为下一批起点，`null` 表示已到最后一章。缺摘要时先取简化摘要，再回退正文，所需正文量也计入总量。
 
 长度必须由脚本测，不得用模型估算或静默跳过。找不到 Python 3 或脚本报错时停下，用一句话告诉作者卡在哪（如「第 12 章正文读不到，先把正文迁完」），原文报错放技术备注；卷纲缺失时先回结构迁移补卷纲。
 
 ## Step 2：写本批细纲
 
 - **有 story-architect**（导入记录写着可用，按 SKILL.md 顶部的 Agent 兼容性检查 canonical 目录）：主会话只取任务包路径，不读包的内容。Prompt：`项目目录：{dir}\n任务包：{任务包路径}\n先完整读取任务包，按包里的规则与模板完成；作者已定的事在 .story/work/导入记录.md，对话内容不会传给你\n交付后只回任务包开头要求的几项`。Antigravity 用 `invoke_subagent` + `TypeName: "story-architect"`。
-- **没有**：主会话完整读取任务包，自己按包写本批；不另读本文件以外的规则，也不整读拆文库摘要。
+- **没有**：主会话完整读取任务包，按包内规则写本批；不另读包外写作技法，也不整读拆文库摘要。
 
 ## Step 3：验收与交接
 

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

@@ -1,11 +1,13 @@
 # 角色状态记录格式
 
-> story-import 反推角色状态（character-state-reverse.md）时按本格式写 `追踪/角色状态/{角色名}.md`。
+> `追踪/角色状态/{角色名}.md` 是工具生成的视图；导入时按 character-state-reverse.md 填事务，不直接写此文件。
 
-动态状态按核心角色拆成 `追踪/角色状态/{角色名}.md`，由 `tracking_commit.py` 根据事务 JSON 整份覆盖；静态原始人设仍在 `设定/角色/{角色名}.md`。只为后续会复用的主角、反派、核心配角建快照，不为路人、一次性功能角色建文件。
+动态状态按核心角色分文件，由 `tracking_commit.py` 根据事务整份覆盖；静态人设留在 `设定/角色/{角色名}.md`。只为后续会复用的主角、反派、核心配角建快照。
 
 ## 格式
 
+下例展示语义内容；实际文件还由工具写入「状态修订」，用于与当前追踪状态核对。
+
 ```markdown
 # 江晨｜当前状态
 
@@ -35,7 +37,7 @@
 
 ## 更新规则
 
-1. 每章只记录身份、位置、目标、身心状态、能力资源、关系、已知信息、未结事项中真正发生变化的内容。
+1. 下列规则用于导入后的续写。每章增量只记录身份、位置、目标、身心状态、能力资源、关系、已知信息、未结事项中实际发生的变化。
 2. 核心复用角色发生变化时，在同一事务的 `character_changes` 写变化，并在 `character_snapshots` 提交其**截至当前已写最后一章**的完整快照；工具以快照是否存在判断核心/临时角色，整份覆盖核心角色小文件，不追加历史。
 3. 修订旧章时，从修订章检查到最后已写章，按各维度和各关系对象重算当前状态，再提交完整快照；不得把最后一条单维度变化当成角色全状态。
 4. 无变化可不提交快照；核心角色重新进入当前场景时直接读取其已有小文件，并由事务工具把必要信息带入续写状态卡。

package/lib/oh-story/skills/story-import/references/structure-mapping-long.md

@@ -1,6 +1,6 @@
 # 结构迁移（长篇）
 
-Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导入书名}/` 分析结果转换为 `{导入书名}/` 长篇项目结构。篇幅、外部对标、目标平台、作者交代读导入记录（`{书目录}/.story/work/导入记录.md`），不回翻对话。追踪（`追踪/`）不在本时刻生成，逐章细纲在最后一步按批另起。
+Phase 3-L 按本文件将 `拆文库/{导入书名}/` 转为长篇项目结构。篇幅、外部对标、目标平台与作者交代取自导入记录（`{书目录}/.story/work/导入记录.md`）。本时刻只建追踪目录骨架，状态由 Phase 4 初始化；逐章细纲在最后一步分批反推。
 
 ---
 
@@ -34,7 +34,7 @@ Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导
 |------|------|---------|
 | 主角 | 出现章节 ≥50% + 推动主线 + 完整成长轨迹 | 完整迁移 |
 | 反派 | 与主角对立 + 推动核心冲突 + 明确动机 | 完整迁移 |
-| 核心配角 | 出现章节 ≥20% 或推动重要支线 | 完整迁移 |
+| 核心配角 | 出现章节 ≥20% 或推动重要支线，或有独立人格和成长 | 完整迁移 |
 | 功能角色 | 出现章节 <20% + 作用有限 | 简化迁移 |
 
 ### Step 4：关系文件迁移
@@ -49,18 +49,18 @@ Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导
 
 从拆文报告中提取核心发现，生成 `设定/题材定位.md`（下方「题材定位生成」模板）。本书题材、核心梗、情绪与节奏摘要来自 `拆文库/{导入书名}/`，但这些字段不是对标登记。只有导入记录已明确绑定外部对标时，才追加「对标书清单 + 主对标书」段；主对标书最多 1 本，副对标 / 参考对标不限制数量。未绑定时省略整个对标登记段，不得用 `{导入书名}` 补位。导入记录里「作者交代」的偏好与红线同步写进模板的「作者已定」小节，续写时才看得到。
 
-后续如需快速概览，可另写「对标分析（派生概要）」表；该表不是权威 registry，不得替代 `主对标书` 与完整 `对标书列表`。所有登记项必须能回溯到对应 `拆文库/{对标书名}/`，不得引用本书根 `设定/`。
+需要快速概览时可另写「对标分析（派生概要）」表，正式登记仍以 `主对标书` 和完整 `对标书列表` 为准。登记项须能回溯到 `拆文库/{对标书名}/`。
 
 ### Step 7：对标结构化资产同步
 
 只处理导入记录里显式绑定的外部参考作品：把 `拆文库/{对标书名}/` 的结构化分析资产同步到项目引用视图 `{项目}/对标/{对标书名}/`，供 story-long-write 优先读取；映射见下方「对标引用视图同步规则」。没有绑定外部对标时跳过本步，不创建空目录；严禁使用 `拆文库/{导入书名}/` 或项目 `设定/` 作为复制源。
 
-- 已选外部对标缺 `剧情/节奏.md` 或 `剧情/情绪模块.md` → 导入报告里告诉作者「《{对标书名}》的拆文缺节奏和情绪资料，这本对标暂时用不上；重新拆一次（`/story-long-analyze`）补齐后再接入」，并停止该对标召回；不得用摘要或报告生成空壳。本书核心工程迁移不回滚。两份老权威产物都存在时正常同步，缺少本次新增内嵌字段不阻断。
+- 已选外部对标缺 `剧情/节奏.md` 或 `剧情/情绪模块.md` → 暂停该对标召回，报告缺少哪份资料，建议用 `/story-long-analyze` 按需增强后再接入；不以空壳补齐，也不回滚本书工程。两份产物均存在时，缺少新增内嵌字段不阻断同步。
 - 其它结构化子目录缺失 → 在导入完成报告里用白话提示，不阻塞项目创建。
 
 ### Step 8：文风同步
 
-外部对标已通过 Step 7 校验时，把 `拆文库/{对标书名}/文风.md` 复制到 `{项目}/对标/{对标书名}/文风.md`。纯复制，不重新生成；未绑定外部对标时跳过。拆文库没有文风文件（analyze 未跑 Stage 6）→ 导入报告提示作者重跑 `/story-long-analyze` 后再同步，日更前文风缺失会被 fail-fast 拦截；项目对标已有旧文风文件 → 覆盖（最新拆文产物优先），在导入报告告知。
+外部对标通过 Step 7 校验后，将其 `文风.md` 复制到 `{项目}/对标/{对标书名}/文风.md`；未绑定时跳过。缺少文风时提示用 `/story-long-analyze` 补 Stage 6 后再同步，日更写前检查会拦截缺失项。已有旧文风时，以最新拆文产物覆盖，并在报告中告知。
 
 ### Step 9：大纲与卷纲（作者确认点）
 
@@ -119,9 +119,9 @@ Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导
 
 ### 内容处理
 
-- 保留原文内容不变，不做任何修改
+- 保留小说正文，不改写情节、措辞或台词
 - 编码统一为 UTF-8
-- 去除文件头尾无关信息（如广告、声明等）
+- 只移除可确认不属于小说正文的文件头尾信息，如下载广告；无法确认的内容保留
 
 ---
 
@@ -202,14 +202,14 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 
 ## 世界观同步规则
 
-当前 `story-long-analyze` 已输出主题化目录，导入阶段只做 pass-through，不再解析或拆分扁平 `世界观.md`。
+当前 `story-long-analyze` 输出主题化目录，直接原样同步。旧成果已在 Phase 2 确认可用时，按 Step 5 从实际内容转换到目标路径。
 
 | 源路径 | 目标路径 | 当前契约 |
 |---------|---------|---------|
 | `拆文库/{导入书名}/设定/世界观/*.md` | `{项目}/设定/世界观/*.md` | 原样同步；`背景设定.md` 必须存在 |
 | `拆文库/{导入书名}/设定/势力/*.md` | `{项目}/设定/势力/*.md` | 原样同步已独立的势力文件 |
 
-`力量体系.md`、`地理.md` 或小势力资料不足 200 字时，上游会将其并入 `背景设定.md`，因此这些独立文件可省略。如缺少 `背景设定.md`，或当前内容指向独立力量体系却未产出对应文件，停止导入并提示重跑 `story-long-analyze` Stage 4。
+`力量体系.md`、`地理.md` 或小势力资料不足 200 字时，上游并入 `背景设定.md`，独立文件可省略。当前契约产物缺少必要文件时，提示补 `story-long-analyze` Stage 4；已确认可用的旧成果按来源映射转换，不仅因旧文件名而阻断。
 
 ---
 
@@ -276,7 +276,7 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 
 #### 目标格式模板（大纲/卷纲_第X卷.md）
 
-卷纲是大纲的展开——大纲决定方向，卷纲决定节奏。包含本卷全部创作规划。
+卷纲展开大纲的方向与节奏。导入时只反推已写内容，未来规划缺证据的字段保留 `[待补充]`。
 
 ```markdown
 # {卷名} 卷纲
@@ -409,8 +409,8 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 
 - 题材类型、核心梗、微创新点 → 从 `拆文报告.md` 基本信息与核心发现段提取
 - 核心梗三分法 → 从 `拆文报告.md` 表层吸引力、爽点设计、长线悬念段提取
-- 读者需求 / 情绪引擎 → 从 `剧情/情绪模块.md` 提取；缺失时停止导入并给出重跑 Stage 3+ 的修复动作
-- 节奏与触发参考 → 从 `剧情/节奏.md` 提取；缺失时停止导入，不得以 `拆文报告.md`、章节摘要或 `剧情/故事线.md` 代替
+- 读者需求 / 情绪引擎 → 从 `剧情/情绪模块.md` 提取；当前契约产物缺失时补 Stage 3+，旧成果按「映射总览」的兼容规则处理
+- 节奏与触发参考 → 从 `剧情/节奏.md` 提取；当前契约产物缺失时停止迁移并补齐，不用其他概要冒充；旧成果可标「未知/待增强」继续导入
 - 对标书清单 → 仅登记用户显式选择、且能回溯到 `拆文库/{对标书名}/` 的外部作品；未绑定时省略，不得用 `{导入书名}` 补位
 - 对标分析（派生概要） → 只总结已登记的外部对标；题材框架仍从本书导入分析生成，不得把两类来源混写
 
@@ -428,7 +428,7 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 | `拆文库/{对标书名}/章节/*.md`（第N章_摘要.md + 黄金三章 第1-3章_深度拆解.md）| `{项目}/对标/{对标书名}/章节/*.md` | 匹配章证据；摘要读取概要、关键事件、局面结果、涉及、状态变化与情节点序列（含类型、主题标签与基调），黄金三章另含深度写法 |
 | `拆文库/{对标书名}/角色/*.md` | `{项目}/对标/{对标书名}/角色/*.md` | 角色功能位、关系与反应层参考 |
 | `拆文库/{对标书名}/设定/` | `{项目}/对标/{对标书名}/设定/` | 世界观、势力、金手指等设定约束参考 |
-| `拆文库/{对标书名}/拆文报告.md` | `{项目}/对标/{对标书名}/拆文报告.md` | 人类可读摘要投影 |
+| `拆文库/{对标书名}/拆文报告.md` | `{项目}/对标/{对标书名}/拆文报告.md` | 供人快速浏览的综合报告 |
 | `拆文库/{对标书名}/文风.md` | `{项目}/对标/{对标书名}/文风.md` | 日更文风召回必读 |
 
 冲突规则：已登记外部对标的 `对标/{对标书名}/剧情/情绪模块.md` 和 `对标/{对标书名}/剧情/节奏.md` 是对标召回权威；`拆文报告.md`、`剧情/故事线.md` 只作为摘要投影。若摘要冲突，保留冲突说明并以权威文件为准；缺少任一权威文件时不生成半套对标视图，先修复该外部作品的拆文产物。

package/lib/oh-story/skills/story-import/references/structure-mapping-short.md

@@ -1,6 +1,6 @@
 # 结构迁移映射规则（短篇）
 
-Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-and-structure.md)：将 `拆文库/{导入书名}/` 短篇拆文产物转换为 `{短篇标题}/` 短篇工程结构，供 `story-short-write` Phase 3 无缝接手续写。外部对标与作者交代读导入记录（`{书目录}/.story/work/导入记录.md`）。
+Phase 3-S 读取本文件和 [format-and-structure.md](format-and-structure.md)，将拆文产物迁为 `{短篇标题}/`，保存已写内容与续写基线。外部对标、目标平台与作者交代取自导入记录。继续创作时由 `story-short-write` 执行现有构思完成检查，导入不等于补完未来设计。
 
 ## 迁移步骤
 
@@ -8,15 +8,11 @@ Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-
 
 1. **正文迁移**：将 `拆文库/{导入书名}/原文/` 的全文迁移为单文件 `{标题}/正文.md`，按 format-and-structure.md 规范化格式（小节标记 `###1.`、段间仅单换行、对话引号按项目/平台约定统一）。原文已是成稿，不重写内容，只规范格式。
 2. **设定生成**：从 `拆文报告.md`、`写作手法.md` 反推 `{标题}/设定.md`，含核心框架（对齐 story-short-write 核心框架：基本信息、一句话梗概、核心反转、情绪设计、人设速写）与本书续写基线（已写内容的故事结构、情绪节奏、核心反转机制、既有写作手法；这是本书内部上下文，不是对标摘要）两个区块，规则见下方「设定.md 反推规则」。导入记录里作者交代的偏好与红线一并写进续写基线。
-3. **小节大纲生成**：从 `情节节点.md` 的功能分段反推 `{标题}/小节大纲.md`，按开头段/铺垫段/升级段/反转段/结尾段映射，用 story-short-write 的固定 12 列表格，每节一行，填法见下方「小节大纲表格」。相关情节点可由同一动作链或对话同时兑现，不为凑数量拆成多个子事件；原文判断不出的格子写 `[待补充]`，不套用长篇完整章节蓝图。
+3. **小节大纲生成**：以 `拆文报告.md` 的结构划分确定各段功能，再从 `情节节点.md` 提取事件，反推 `{标题}/小节大纲.md`。使用固定 12 列表格，每节一行；同一动作链可兑现多个功能，不为凑数拆分。无法判断的格子写 `[待补充]`，填法见下方「小节大纲表格」。
 4. **外部对标引用视图（可选）**：仅当导入记录已显式绑定外部 `{对标书名}` 时，才把 `拆文库/{对标书名}/` 同步为 `{标题}/对标/{对标书名}/`；没有绑定则跳过。不得把 `拆文库/{导入书名}/` 整体复制进 `对标/`。
 
 迁完按文末质量检查清单自检，在导入记录勾「结构迁移」，直接进入 Phase 5 汇报。
 
-> 长篇迁移规则见 `structure-mapping-long.md`。
-
-> **名称边界**：`{导入书名}` 是用户自己的待续写短篇；`{对标书名}` 是另行选择的外部参考作品。不得把本篇拆文结果复制到本篇 `对标/`，也不得把本篇分析写成“对标摘要”。
-
 ---
 
 ## 与长篇的关键差异
@@ -38,7 +34,7 @@ Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-
 |---------|------------|---------|
 | 原文全文（`拆文库/{导入书名}/原文/`） | `{标题}/正文.md` | 单文件迁移，按下方『正文.md 格式规范』规范化，不重写内容 |
 | `拆文报告.md` 的故事核/题材/结构字段 | `{标题}/设定.md`（核心框架区） | 反推本书核心框架；不继承报告中可能存在的自对标登记 |
-| `情节节点.md` 的功能分段 | `{标题}/小节大纲.md` | 反推小节大纲（按开头段/铺垫段/升级段/反转段/结尾段，钩子字段标 `[待补充]`） |
+| `拆文报告.md` 的结构划分 + `情节节点.md` | `{标题}/小节大纲.md` | 按结构功能组织事件，无法确认的钩子写 `[待补充]` |
 | `拆文报告.md` + `写作手法.md` | `{标题}/设定.md`（本书续写基线区） | 把已写内容的结构、情绪、反转和既有写法整理为内部续写上下文 |
 | `拆文库/{对标书名}/` | `{标题}/对标/{对标书名}/` | 可选：仅同步用户显式绑定的外部参考作品 |
 
@@ -50,7 +46,7 @@ Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-
 
 ### 区块一：核心框架
 
-从 `拆文报告.md` 的故事核、结构划分、人物分析等字段提取，填入以下模板：
+从 `拆文报告.md` 的故事核、结构划分、人物分析等部分提取。目标平台优先采用导入记录；反转类型沿用拆文结果，无反转时不补造反转。情绪名称取自情感曲线，强度按 1-10 量表重新判断，不照抄曲线的 -9~+9 分值。
 
 ```markdown
 ## 短篇核心框架
@@ -58,16 +54,16 @@ Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-
 ### 基本信息
 - 标题：{导入书名}
 - 目标字数：{原文实际字数} 字
-- 目标平台：{从拆文报告提取，无则填 [待补充]}
+- 目标平台：{优先采用导入记录，无则从拆文报告提取，仍无填 [待补充]}
 - 目标情绪：{从拆文报告「情感线/爆点分析」提取读者预期感受}
 
 ### 一句话梗概
 {主角 + 困境 + 反转 + 情绪落点（从拆文报告故事核提取）}
 
 ### 核心反转
-- 反转类型：{从拆文报告反转分析提取：身份反转/视角反转/动机反转/时间线反转}
+- 反转类型：{沿用拆文结果：身份/视角/动机/时间线/信息/认知反转，或无反转}
 - 反转内容：{一句话描述}
-- 铺垫线索：{从情节节点中的「铺垫」类节点提取，至少 3 个；不足时标 [待补充]}
+- 铺垫线索：{从拆文报告反转分析提取，回查相关情节节点，至少 3 个；不足时标 [待补充]；无反转时写“不适用”}
 
 ### 情绪设计
 - 开头情绪：{从情感曲线第一个节点提取}（强度 {1-10}）
@@ -107,7 +103,7 @@ Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-
 
 ## 小节大纲.md 反推规则
 
-从 `情节节点.md` 的功能分段结构提取，映射到短篇段-小节结构。
+以拆文报告的结构划分为依据，结合情节节点和原文分节映射到各小节；结构段可包含多个小节，不与自然段混同。
 
 ### 段级映射
 
@@ -137,7 +133,7 @@ Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-
 
 ### 小节数量推算
 
-以原文实际的分节标记和转场为准；原文没有显式分节时，按情节阶段和转场切分，`总字数 ÷ 1000` 只作粗略参考，不作为切分依据。小节数与正文实际段落结构一致是质量清单必检项。
+以原文分节标记和转场为准；没有显式分节时，按情节阶段和转场划分。大纲行数须与迁移后正文的小节数一致，不按自然段数或平均字数推算。
 
 ---
 
@@ -181,7 +177,7 @@ Phase 3-S 迁移完成后执行：
 
 - [ ] `正文.md` 单文件存在且格式符合 `format-and-structure.md`（小节标记、段落划分/主语节奏、段间仅单换行、引号格式）
 - [ ] `设定.md` 含核心框架区块 + 本书续写基线区块，且核心框架符合本文件模板
-- [ ] `小节大纲.md` 节数与正文实际段落结构一致
+- [ ] `小节大纲.md` 数据行数与 `正文.md` 的小节数一致
 - [ ] 所有 `[待补充]` 标记已添加（不确定字段不留空）
 - [ ] 未误建 `追踪/`、`大纲/`、`正文/` 等长篇专属目录
 - [ ] `拆文库/{导入书名}/` 未被复制到本篇 `对标/`；若绑定外部对标，来源与 `对标/{对标书名}/` 目录名一致

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

@@ -2,7 +2,7 @@
 
 ## 初始化事务
 
-新书从第 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 章开始。
+仅尚无追踪状态时初始化。新书从第 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
 {
@@ -28,4 +28,4 @@
 }
 ```
 
-导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。
+导入示例须按已读正文改写当前状态，不能照用第 0 章内容；全部导入批次完成后初始化一次，不重置已有 state。传入当前核心角色快照、伏笔当前行、时间线事件与 JSON 中六项 context 输入，由脚本生成七栏 `追踪/上下文.md`。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。

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

@@ -1,6 +1,6 @@
 # 追踪状态协议
 
-`追踪/` 使用“一个结构化权威状态 + 多个确定性派生视图”。模型只提交一份语义 JSON，不分别 `Write/Edit/echo >>` 多个追踪文件。
+`追踪/` 以结构化 state 为权威，由脚本生成各 Markdown 视图。模型只提交一份语义 JSON，不分别 `Write/Edit/echo >>` 多个追踪文件。
 
 ## 权威层与派生层
 
@@ -118,7 +118,7 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 约束：
 
 - 构造事务前运行 `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 事务是最容易踩的一处。
+- `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）。commit 事务须使用自身允许字段，不能照搬 init 示例。
 - `character_snapshots` 中出现的角色视为核心复用角色，必须同时出现在 `character_changes`；已经建立快照的核心角色再次变化时必须提交新快照。
 - 角色快照的四个列表不限制条数，只限制单项长度和最终文件总字节：目标 ≤4096 字节，超过警告；硬上限 8192 字节，超过则在任何写入前拒绝。
 - 没有快照的角色变化视为临时角色，不建立状态文件；`context.active_character_names` 最多 6 人且必须已有当前快照。