@oh-story/dsh 0.1.9 → 0.1.11

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

@@ -10,7 +10,7 @@
 |---|---|
 | `拆文库/{书名}/角色/{角色名}.md` | 身份、能力、目标、成长弧线、出场记录 |
 | `拆文库/{书名}/角色/角色关系.md` | 截至最后完整章的关键关系 |
-| `拆文库/{书名}/章节/第N章_摘要.md` | 最后位置、最新状态、已知信息与未结事项 |
+| `拆文库/{书名}/章节/第N章_摘要.md` | 从 `涉及` 锁定相关章，从 `状态变化`、`信息变化`、`局面结果` 和 `章尾钩子` 提取最后位置、最新状态、已知信息与未结事项；旧摘要缺字段时回退其关键事件与情节点 |
 | `拆文库/{书名}/剧情/*.md` | 阵营/身份转折、阶段目标和长期冲突 |
 | 初始化事务中的伏笔与时间线候选 | 核对角色未结事项及其可知范围 |
 

package/lib/oh-story/skills/story-import/references/deep-analysis.md

@@ -0,0 +1,47 @@
+# 深度分析时刻：导入场景怎么驱动拆解管道
+
+Phase 2 只读本文件，再按篇幅进入对应 analyze skill；拆书的方法、产物结构、分批、恢复与质量检查全部由 analyze skill 自己的流程负责，本文件只写导入场景的取值。篇幅、原文位置、题材和写作环境都读导入记录（`{书目录}/.story/work/导入记录.md`），不回翻对话、不重新问作者。
+
+| 篇幅 | 进入 | 产物目录 |
+|------|------|---------|
+| 长篇 | `/story-long-analyze` 的统一管道（旧成果直用 / 按需增强 / 全新或部分续跑） | `拆文库/{导入书名}/` |
+| 短篇 | `/story-short-analyze` 的拆解管道（Stage 2-6） | `拆文库/{导入书名}/` |
+
+## 长篇：先兼容识别，再决定是否续跑
+
+先运行 story-long-analyze Phase 1 的只读检查器（`inspect_existing_assets.py`），登记实际文件和覆盖范围；检查建议不能覆盖下列语义规则：
+
+新生成或按当前契约续跑的长篇进度保持 `schema_version: 2`；旧成果直接使用不以缺少该字段为失败。
+
+- **旧成果已完成且足以重建写作工程**：直接进入 Phase 3。旧 `_progress.md` 版本、缺少 `chapter_index.csv`，或缺少本次新增字段，都不能单独成为重拆理由。
+- **旧成果可以导入，但缺少当前写作/对标功能需要的 `剧情/节奏.md`、`剧情/情绪模块.md` 等资料**：先用现有逐章、剧情、关系、报告和文风做 Stage 3+ 按需增强，不回读原文。不得重跑已完成章节，也不得用空壳文件让门禁通过。
+- **只完成一部分或新旧产物混存**：验证并保留已完成部分，从首个缺失的连续章节块续跑，最后统一聚合。进度记录与实际文件冲突时，以可验证文件为准并记录冲突。
+- **全新导入**：运行 Stage 0-6 完整管道。
+
+导入需要自动完成本次判定出的必需范围，不把 Stage 1 停靠询问甩给作者。全新导入命中「完整拆解、一次跑完」路径；旧成果增强或部分续跑只执行缺失 Stage/章节块。原有用途当前不消费新增分析时，缺少新增字段只记录能力限制，不阻断导入。
+
+- 措辞示例（全新）：启动深度分析时声明「以『完整拆解、一次跑完、不要停下询问』模式拆解本书，确保 Stage 2-6 全部产出」。
+- 措辞示例（旧成果）：声明「先复用并校验现有成果，只补当前导入缺失的章节或分析，不覆盖用户原成果」。
+- **兜底**：若全新导入实际仍停在 Stage 1，自动选择继续；若旧成果任务停靠，则按已登记的缺失范围继续，不能扩大成全书重跑。
+- 派发：导入记录写着分析助手可用时，属自动续跑，按 story-long-analyze 的「有限并行」档派 `chapter-extractor`（每轮 3 批），每个连续章节批次只调用一次，同次生成逐章事实与跨章观察；作者明确要求时改用串行或不限批次顺序。作者选了直接导入（或 ZCode）时，Stage 2 由主会话按相同连续章节块契约串行处理，不能退回每章一次独立调用；产物仍完整，仅速度变慢。
+- 超过 200 章的作品按 [import-special-cases.md](import-special-cases.md)「超过 200 章的作品」分批拆解。
+
+## 短篇：单一全量管道
+
+story-short-analyze 的拆解管道（Stage 2-6）本身**无 Stage 1 停靠点**，一次跑完即可。它的 Phase 1 四个 Step 都要跑，按下表的导入场景取值执行，不整段跳过：
+
+| Phase 1 步骤 | 导入场景下的处理 |
+|-------------|----------------|
+| Step 1：拿到原文 | 用导入记录里的源文件，不重新问 |
+| Step 2：字数检查（长短篇路由） | 篇幅已在导入 Phase 1 判定并经作者确认，直接答「按短篇继续」，不重新路由 |
+| Step 3：题材识别 | **照常跑**，题材标尺必须加载；导入记录里已确认的题材类型直接代入，不重复提问 |
+| Step 4：续跑检查（`拆文库/{导入书名}/_meta.json` 已存在时三选一） | 先看旧产出是否可直接复用：`stages_completed` 已含 6 且 `拆文报告.md` / `情节节点.md` / `写作手法.md` / `原文/` 均非空、来源与本次导入源一致 → 直接进 Phase 3，不重跑也不归档。否则本轮首次进入 Phase 2 → 按 (a) 覆盖：先把旧产出归档到 `拆文库/{导入书名}/_archive_{时间戳}/`，再从 Stage 2 重跑；同一轮导入内重试同一本书 → 按 (b) 续跑。不把三选一甩给作者，也不跳过归档 |
+
+`_meta.json` 的 `genre_detected` 由 Step 3 产出，是拆文契约的阻断级必填字段，下游 story-short-write 靠它选题材标尺——**不要跳过 Step 3 直接从原文备份起跑**。
+
+- 措辞示例：启动深度分析时声明「《{导入书名}》篇幅已确认为短篇（题材 {题材类型}，全文约 {N} 字），Step 2 直接按短篇继续，Step 4 按覆盖并归档处理，题材识别照跑，确保 Stage 2-6 全部产出」。
+- **兜底**：若运行环境仍抛出「此文字数 {N} 偏长，建议改用 `/story-long-analyze`」或灰区提问「介于短/长之间，按短篇还是长篇拆？」，一律按导入记录里锁定的判定逐字回「按短篇继续」，**绝不把路由询问甩给作者**。
+
+## 交付
+
+拆解管道自带的质量检查通过、产物落在 `拆文库/{导入书名}/` 后，在导入记录勾「深度分析」。拆书流程自带的完工汇报（长篇「全部拆完」、短篇「可以运行 /story-short-write 写下一篇」）在导入里不用，由这里交代：向作者用一两句故事话说拆到了什么（几章、主要人物、主线一句），末尾按 [SKILL.md 的换上下文规则](../SKILL.md#时刻表与交接) 建议新开对话。拆书中断时不在这里另做恢复：重新进入同一拆解管道，由它按自己的进度文件续跑。

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

@@ -146,7 +146,7 @@
 
 | 平台 | 章节标记 | 对话格式 | 特殊要求 |
 |------|----------|----------|----------|
-| 知乎盐言 | `1.` | `「」` | 导语需单独标注 |
+| 知乎盐言 | `1.` | `「」` | 导语即正文开头几段，不另标 |
 | 番茄 | `###第一章` | `""` | 首段需有吸引力 |
 | 红果 | `###1.` | `""` | 无 |
 

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

@@ -0,0 +1,64 @@
+# 汇报与激活时刻
+
+Phase 5 只读本文件和导入记录（`{书目录}/.story/work/导入记录.md`）。前面每个时刻已按自己的清单验收后才勾进度，这里不重读迁移规则。
+
+## Step 1：收尾自检
+
+这是你自己的自检，不念给作者：全部通过就不提；没通过先回到对应时刻修，修不了才用故事话告诉作者影响和办法。
+
+- 导入记录的进度全部勾上（短篇没有细纲与追踪两项）。
+- **长篇**：`正文/` 章节文件数等于导入范围章数；每章都有 `大纲/细纲_第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` 都在，未误建 `追踪/`、`大纲/`、`正文/`。
+
+## Step 2：导入完成报告
+
+报告写给作者：导进来了什么、哪几处请他核对、要他拍板的事、下一步怎么说。字段名、脚本名、校验结果、字数口径、伏笔/事件编号不进报告；编号只能跟着故事描述出现（如「玉佩的来历（F003）」）。核对项要落到具体人和事，一次最多 5 条。
+
+**长篇**：
+
+<!-- author-report -->
+```md
+=== 《{导入书名}》导入完成 ===
+导进来了：第 1–{N} 章，约 {Y} 万字{；第 {N+1} 章只写了一半，按你的决定{接着残章写 | 先补完}}。项目在 `{项目目录}`。
+
+我整理出了：
+- 人物：{M} 个角色档案，主要人物写到第 {N} 章时的处境已记下（如「{角色}：{一句话现状}」）
+- 大纲：全书大纲、{V} 卷卷纲、每章细纲
+- 还没收的线：{K} 条（如「{伏笔的故事描述}」）
+- 时间线：真相和读者目前知道的分开记，续写时不会提前泄底
+- 设定：{设定文件数} 份世界观资料
+- 对标书：{没有绑定 | 已接入《{对标书名}》 | 没接上：原因和补救}
+
+请你核对：
+1. {最拿不准的一处，写成具体问题，如「第 5 章的黑衣人和第 2 章的车夫是同一人吗？」}
+2. {如「还没收的线里有没有漏的？我列的是：……」}
+
+需要你决定：{仅在有待定事项时写，如「原文没分卷，我按剧情分成 3 卷（1–40 / 41–95 / 96–{N} 章），这样分可以吗？」}
+
+下一步：说「日更」就从第 {N+1} 章接着写；想先检查导入质量，说「审一下」。
+```
+
+**短篇**：
+
+<!-- author-report -->
+```md
+=== 《{短篇标题}》导入完成 ===
+导进来了：全文约 {Y} 字，分成 {N} 个小节。项目在 `{项目目录}`。
+
+我整理出了：
+- 设定：核心框架和续写要守住的人物、情绪基调
+- 小节大纲：{N} 节，每节讲了什么
+- 对标书：{没有绑定 | 已接入《{对标书名}》 | 没接上：原因和补救}
+
+请你核对：
+1. {标了 [待补充] 的地方，写成问题，如「女主最后原谅他了吗？原文没写明」}
+2. {核心反转前埋的线索我找到的是：……，有没有漏的？}
+
+下一步：{没写完：运行 `/story-short-write` 说「接着写」，从第 {N+1} 节往下写 | 已完本：想改稿说「审一下」}。
+```
+
+## Step 3：项目激活
+
+- 设置 `.active-book` 指向导入的书名/标题目录，在导入记录勾「汇报与激活」。
+- 确认项目可以被对应写作 skill 识别（长篇 → story-long-write，短篇 → story-short-write）。
+- 可选验证：如果当前运行时的 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

@@ -0,0 +1,34 @@
+# 导入的特殊情况
+
+只在下面几种情况读；普通导入不读。
+
+## 流程答疑
+
+用户问「导入续写先装环境还是先导入」「已有小说怎么续写」「导入流程」这类问题时，先直接给结论，再继续收集原文——避免用户只想确认流程却被直接要求贴原文：
+
+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` 且进度没勾完时，是上次导入做到一半：从第一个未完成的进度接着做。
+4. **v0.7.2 及更早的旧追踪项目**（有 `追踪/` 和正文，但没有 `追踪/_tracking-state.json`）：日更会停下要求重新导入，但**不需要重跑全书拆解**，只重建追踪，见下一节。
+
+## 旧追踪项目迁移
+
+书名目录下有 `追踪/` 与正文、但没有 `追踪/_tracking-state.json` 时，项目停在 v0.7.2 及更早的追踪结构上。正文和 `设定/`、`大纲/`、`拆文库/` 都不受影响，**只需重建 `追踪/`**，不重跑深度分析、不碰正文：
+
+1. 数清最后一个完整章号 `N`（`正文/第NNN章_*.md` 的最大值）。
+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` 会把旧追踪结构按原样整体移入 `追踪/_旧追踪存档/` 再建当前协议——旧内容不删除、不参与解析，留给作者查阅。
+5. 跑 `tracking_commit.py check` 确认通过，再回 `/story-long-write 日更` 续写。
+
+重建结果以第 2 步的证据为准；拿不准的字段留空或写进 `continuity_risks`，不杜撰。用户明确要求重拆全书时才走完整导入。
+
+## 超过 200 章的作品
+
+仅长篇。短篇为单文件全量迁移，无增量导入需求。拆解可以分批，追踪初始化必须一次覆盖全部已写章节：
+
+1. **拆解分批**：首期只深拆前 50 章 + 全书概要，后续按需补拆更多章节到 `拆文库/`。
+2. **追踪一次到位**：初始化事务的 `last_chapter` 写**最后一个已写完的章号 N**，不是首期拆解的 50。`imported_through_chapter` 由 `init` 一次写定、之后不再推进，逐章事务只接受 N+1 起的章号；第 1..N 章不伪造逐章记录，续写从 N+1 开始。若 init 时误写成 50，第 51..N 章仍可逐章 `append` 补上（一章一份事务，章号必须连续），只是要为已写好的旧章逐章构造事务；不要删 `追踪/` 重来——`_旧追踪存档/` 也在里面。
+3. **简化摘要**：未深拆的章节每章写一份约 200 字的简化摘要（谁做了什么、局面怎么变、章尾留下什么等待），固定落在 `{书目录}/.story/work/简化摘要/第NNN章.md`（三位补零）。细纲任务包在拆文库没有该章摘要时自动取这里；追踪初始化反推当前状态也从这里取证。
+
+首期深拆范围写进导入记录「范围」一行，细纲与追踪时刻据此取证据。

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

@@ -0,0 +1,95 @@
+# 追踪初始化时刻（仅长篇）
+
+Phase 4 只读本文件、[tracking-initialization.md](tracking-initialization.md)（初始化事务的原始 JSON 与导入边界，完整读取）和 [character-state-reverse.md](character-state-reverse.md)（核心角色快照反推）。导入截止章、残稿决定、卷划分读导入记录（`{书目录}/.story/work/导入记录.md`）；证据只取已落盘的 `拆文库/{导入书名}/` 与项目 `大纲/`，不重读原文。续写时的逐章事务与导入无关，不读。
+
+导入项目必须通过本 skill 自带的 `scripts/tracking_commit.py init` 一次性生成追踪状态，禁止模型分别写最终文件。
+
+## 语义准备顺序
+
+1. **导入截止章**：把最后完整章 N 写入初始化事务的 `last_chapter`。工具在 meta 记录 `imported_through_chapter=N`；导入旧章没有日更事务，不得为第 1..N 章伪造逐章增量，也不额外生成一份重复当前状态的叙事基线。
+2. **核心角色当前快照**：从拆书产物反推主角、反派、核心配角的截至 N 章状态，按角色写入 `character_snapshots`，工具生成 `追踪/角色状态/{角色名}.md`；算法见 character-state-reverse.md。
+3. **伏笔当前行**：从有正文证据的铺垫/回收事件生成 `foreshadow`（识别方法见下）。每个 ID 只保留当前状态一行；尚未实际埋设的未来设计留在大纲，不写 `伏笔.md`。
+4. **事实与读者认知**：把关键事件生成到 `timeline_events`（提取方法见下）。同一事件同时写客观事实、读者截至 N 章已知内容和实际揭示状态；未来计划揭示章不得伪装成已发生事实。
+5. **续写状态卡输入**：准备当前位置、长期约束、活跃核心角色、近三章速记、下一章承诺和连贯性风险。`上下文.md` 由工具生成固定 7 栏，不把文风、文件索引、普通待办或质检计数塞进续写状态卡。
+6. **执行初始化**：事务写到 `{书目录}/.story/work/init.json`（成功前保留，不写系统 `/tmp`、书根、`大纲/` 或 `正文/`）。按当前平台探测 Python 3（`python3` → `python` → `py -3`），执行：
+
+   > 项目 `追踪/` 里已有不属于当前协议的早期文件时不必手工清理：`init` 会先把它们按原样整体移入 `追踪/_旧追踪存档/`，再在原地建当前协议。旧内容保留供作者查阅，不参与解析，当前状态完全由本次导入输入决定；校验失败的 `init` 不移动任何文件。`init` 只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
+
+   ```text
+   {PYTHON} {story-import skill 根}/scripts/tracking_commit.py init --project {书目录} --input {书目录}/.story/work/init.json
+   {PYTHON} {story-import skill 根}/scripts/tracking_commit.py check --project {书目录}
+   ```
+
+半成品最后一章为残稿时，`last_chapter`、角色快照和其他当前语义检查点一律截至最后完整章；残稿处理策略（导入记录里作者的决定）写入 `continuity_risks`，不把未完成动作登记成既成事实。
+
+以 demo《让你管账号，你高燃混剪炸全网》导入至第 10 章为例：续写状态卡要写清江晨的手机原版《诸君，且听龙吟》被专业团队高清重拍，但高层看片后认为新版“缺了灵魂”，最终继续采用原版；江晨快照应体现其军宣创作价值已获周薄森、张耀祖确认；读者时间线只写读者已经看到的看片会结论，钟嘉嘉“只猜对了一半”背后的培养安排若尚未揭示，只能出现在作者真相，不能泄露到读者视图。
+
+## 条目形状与容量
+
+在 tracking-initialization.md 的骨架上填条目（导入时 `last_chapter` 写 N）：
+
+```json
+{
+  "foreshadow": [
+    {"id": "F027", "summary": "专业团队仍拍不出江晨原版的灵魂", "planted_chapter": 10,
+     "planned_resolution_chapter": null, "status": "已埋", "importance": "中"}
+  ],
+  "timeline_events": [
+    {"id": "E010", "story_time": "实弹训练两天后",
+     "objective_fact": "文工团高层否决专业重拍版，决定沿用江晨手机拍摄的原版视频",
+     "reader_knowledge": "读者已看到周薄森指出专业版缺了灵魂，张耀祖当场拍板用回原版",
+     "reveal_status": "已揭示", "reveal_chapter": 10, "characters": ["江晨", "周薄森", "张耀祖"]}
+  ],
+  "context": {
+    "recent_chapters": [{"chapter": 10, "summary": "专业重拍版被判缺了灵魂，高层拍板用回手机原版"}]
+  }
+}
+```
+
+- 伏笔 `id` 形如 `F001`，`status` 取 已埋/已回收/已过期/放弃，`importance` 取 高/中/低；`planted_chapter` 不晚于 N。事件 `id` 形如 `E001`，`reveal_status` 取 未揭示/部分揭示/已揭示：`未揭示` 的 `reveal_chapter` 必须为 `null`，部分/完全揭示只能填已经发生的实际章节。
+- `context` 在 init 时收六项：`position`、`long_term_constraints`、`active_character_names`、`continuity_risks`、`recent_chapters`（最多 3 章，按章号升序）、`next_chapter_commitments`。
+- `character_snapshots` 里的角色就是核心角色；四个列表不限条数，单角色文件目标 ≤4096 字节，硬上限 8192 字节，超过在任何写入前拒绝。`active_character_names` 最多 6 人且必须已有快照；`long_term_constraints` 最多 6 条。
+- `上下文.md` ≤12288 字节，只含 7 个顶层区块：当前位置、长期约束、核心角色状态、活跃伏笔（最多 8 条）、近三章速记、下一章承诺、连贯性风险。
+- 报错按提示改事务本身再跑；排查字段全集时才查 [tracking-transaction.md](tracking-transaction.md)。导入后续写时角色状态怎么更新见 [state-tracking.md](state-tracking.md)，本时刻不读。
+
+## 伏笔提取
+
+| 情节点类型 | 伏笔可能性 | 提取方式 |
+|-----------|-----------|---------|
+| 铺垫 | 高 | 直接提取为伏笔 |
+| 信息揭示（部分） | 中 | 检查后续是否有呼应 |
+| 物品首次出现 | 中 | 检查后续是否有使用 |
+| 角色秘密 | 高 | 标记为角色伏笔 |
+| 未解决的悬念 | 高 | 从章尾标记提取 |
+
+状态推断：铺垫点在后续章节有「揭示」或「解决」类情节点 → 已回收；无后续呼应 → 已埋；半成品最后几章的铺垫 → 已埋，摘要里注明「接近断点」。
+
+## 时间线提取
+
+从情节点和时间标记中提取：明确日期（“天元三年春”）直接记录；相对时间（“三日后”）推算；事件间隔（“翌日”）连续标记；季节标记（“入冬”）推断季节。按章节顺序排列，同一章内按情节点序号排列；时间标记缺失时标注 `[推断]`。
+
+## 验收
+
+初始化成功后应得到：
+
+```text
+追踪/
+├── _tracking-state.json
+├── 上下文.md
+├── 逐章记录/                 # 导入旧章不补造文件，续写从第 N+1 章开始
+├── 角色状态/{角色名}.md
+├── 伏笔.md
+├── 时间线/
+│   ├── 作者真相.md
+│   └── 读者已知.md
+```
+
+- [ ] `tracking_commit.py check` 通过，`_tracking-state.json` 与全部派生视图一致
+- [ ] `_tracking-state.json.imported_through_chapter` 等于最后完整导入章
+- [ ] `追踪/伏笔.md` 每个 ID 至多一行，未来尚未埋设的设计没有混入
+- [ ] `_tracking-state.json.timeline` 已登记关键事实与读者认知，`读者已知.md` 无真相泄露
+- [ ] `追踪/角色状态/{角色名}.md` 已覆盖全部核心角色并对齐 character-state-reverse.md
+- [ ] `追踪/逐章记录/` 空目录已创建，且没有为导入章伪造日更记录
+- [ ] `追踪/上下文.md` 顶层恰好固定 7 栏且 ≤12288 字节
+
+通过后在导入记录勾「追踪初始化」，`init.json` 可删除；汇报末尾按 [SKILL.md 的换上下文规则](../SKILL.md#时刻表与交接) 建议新开对话。

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

@@ -85,7 +85,7 @@ Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
 | 用户未声明、全文无章节分隔、单文件单篇，但字数 ≥ 30000 | 复述：「全文无章节分隔，但总字数约 {X} 字，已超过短篇常见上界。按长篇导入建工程，还是仍按短篇处理？」由用户拍板 |
 | 结构信号与字数信号方向相反 | 展示两项信号，请用户决定 |
 
-用户拍板的结果记入 Phase 1 上下文，后续步骤以此为准，不再重新判定。
+用户拍板的结果写进导入记录（`{书目录}/.story/work/导入记录.md` 的「篇幅」），后续时刻以此为准，不再重新判定。
 
 ---
 

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

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

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

@@ -0,0 +1,24 @@
+# 逐批反推细纲（长篇导入）
+
+卷纲写定后，从章节摘要反推每章细纲，一批一个任务包。进度记在导入记录（`{书目录}/.story/work/导入记录.md`）的「细纲：已验收到第 B 章」；续跑从第 B+1 章起整批重做，这一批里已经存在但没验收的细纲文件按新任务包重写覆盖。
+
+## Step 1：生成本批任务包
+
+按当前平台探测 Python 3（`python3` → `python` → `py -3`），请求第 B+1 章起的 20 章（剩下不足 20 章就到最后一章）：
+
+```text
+{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` 为下一批起点。缺摘要的章改用简化摘要或正文，已算进总量。
+
+长度必须由脚本测，不得用模型估算或静默跳过。找不到 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：验收与交接
+
+每批写完由主会话运行 `node {story-import skill 根}/scripts/check-outline-contract.js --json <本批细纲路径...>`：exit 1 时只按报告补缺的字段或小节（有 story-architect 时把报错原样交回同一 agent 修一次）。通过后把导入记录的细纲进度改成「已验收到第 B 章」。还有下一批时，向作者一句话说到第几章了，末尾按 [SKILL.md 的换上下文规则](../SKILL.md#时刻表与交接) 建议新开对话说「继续导入」；没有子代理时每批都这样建议。全部章节细纲写完再进 Phase 4。

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

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