@oh-story/dsh 0.1.15 → 0.1.17

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

@@ -1,113 +1,105 @@
-# 结构迁移映射规则（短篇）
+# 结构迁移（短篇）
 
-Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-and-structure.md)：将 `拆文库/{导入书名}/` 短篇拆文产物转换为 `{短篇标题}/` 短篇工程结构，供 `story-short-write` Phase 3 无缝接手续写。外部对标与作者交代读导入记录（`{书目录}/.story/work/导入记录.md`）。
+按本文件把 `拆文库/{导入书名}/` 迁成 `{导入书名}/`。书目录名与拆文目录名相同，写正文守卫据此放行正文迁移。
+
+外部对标、目标平台、完本与否和作者交代取自导入记录。`设定.md` 和 `小节大纲.md` 按短篇写作的构思模板写，续写时直接过它的构思检查；原文证据不够、要等构思时定的项写 `[待补充]`，汇报时列给作者。
 
 ## 迁移步骤
 
-目标工程只有 `{短篇标题}/设定.md`（核心框架 + 本书续写基线）、`小节大纲.md`、`正文.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. **外部对标引用视图（可选）**：仅当导入记录已显式绑定外部 `{对标书名}` 时，才把 `拆文库/{对标书名}/` 同步为 `{标题}/对标/{对标书名}/`；没有绑定则跳过。不得把 `拆文库/{导入书名}/` 整体复制进 `对标/`。
+1. **正文迁移**：把 `拆文库/{导入书名}/原文/` 的全文迁成单文件 `{导入书名}/正文.md`，只按下方「正文.md 外壳整理」改格式。原文是作者的成稿，分段、引号、措辞一律不改。
+2. **设定生成**：从 `拆文报告.md`、`写作手法.md`、`情节节点.md` 反推 `{导入书名}/设定.md`，按下方「设定.md 模板」写。
+3. **小节大纲生成**：以 `拆文报告.md`「结构划分」确定各段功能，再从 `情节节点.md` 提取事件，反推 `{导入书名}/小节大纲.md`，填法见下方「小节大纲.md 反推规则」。
+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`「故事核」「题材」「人物分析」「情感曲线」「反转分析」 | `{导入书名}/设定.md` | 反推本书核心框架；不继承报告中可能存在的自对标登记 |
+| `拆文报告.md`「结构划分」 + `情节节点.md` | `{导入书名}/小节大纲.md` | 按结构功能组织事件，无法确认的格子写 `[待补充]` |
+| `写作手法.md` | `{导入书名}/设定.md`「文风约定」「本书续写基线」 | 记下原文已经在用的写法 |
+| `拆文库/{对标书名}/` | `{导入书名}/对标/{对标书名}/` | 可选：仅同步用户显式绑定的外部参考作品 |
 
 ---
 
-## 设定.md 反推规则
-
-目标文件使用本文件定义的当前核心框架模板，分两个区块：
+## 设定.md 模板
 
-### 区块一：核心框架
-
-从 `拆文报告.md` 的故事核、结构划分、人物分析等字段提取，填入以下模板：
+小节和字段名与短篇写作构思时的 `设定.md` 一致，续写构思只补缺项、不重写。目标平台优先采用导入记录；反转类型沿用拆文结果，无反转时不补造反转。情绪名称取自拆文报告「情感曲线」，强度按 1-10 量表重新判断，不照抄曲线的 -9~+9 分值。
 
 ```markdown
 ## 短篇核心框架
 
 ### 基本信息
-- 标题：{导入书名}
-- 目标字数：{原文实际字数} 字
-- 目标平台：{从拆文报告提取，无则填 [待补充]}
-- 目标情绪：{从拆文报告「情感线/爆点分析」提取读者预期感受}
+- 标题（暂定）：{导入书名}
+- 目标字数：{完本：各节字数之和；半成品：作者定的全篇字数，没定写 [待补充]} 字
+- 目标平台：{导入记录里的平台，知乎盐言 / 番茄 / 七猫 / 黑岩 / 红果 / 小程序 / 未定 选一}
+- 平台基调：{原文实际用的小节标记、引号和分段习惯，原样记下，续写沿用；视角、节尾钩子、结局质感从原文归纳}
+- 目标情绪：{从拆文报告「情感曲线」「爆点分析」提取读者读完的感受}
 
 ### 一句话梗概
-{主角 + 困境 + 反转 + 情绪落点（从拆文报告故事核提取）}
+{主角 + 困境 + 反转 + 情绪落点（从拆文报告「故事核」提取）}
 
-### 核心反转
-- 反转类型：{从拆文报告反转分析提取：身份反转/视角反转/动机反转/时间线反转}
-- 反转内容：{一句话描述}
-- 铺垫线索：{从情节节点中的「铺垫」类节点提取，至少 3 个；不足时标 [待补充]}
+### 核心支点
+- 类型：{沿用拆文结果：身份/视角/动机/时间线/信息/认知反转，或无反转}
+- 核心兑现：{一句话写主揭示；无反转时写报应或关系兑现}
+- 铺垫/期待：{从拆文报告「反转分析」和情节节点回查，有几个写几个}
 
 ### 情绪设计
-- 开头情绪：{从情感曲线第一个节点提取}（强度 {1-10}）
+- 开头情绪：{情感曲线第一个节点}（强度 {1-10}）
 - 中段情绪：{中段情感节点}（强度 {1-10}）
 - 反转情绪：{反转节情感峰值}（强度 {1-10}）
-- 结尾情绪：{结尾节情感}（强度 {1-10}）
+- 结尾情绪：{结尾节情感；半成品还没写到写 [待补充]}（强度 {1-10}）
 
 ### 人设速写
-- 主角：{一句话人设，从人物分析提取}
-- 关键角色：{一句话人设}
+- {角色}：{一句话人设}；声线：{从对白归纳}；口头禅：{原文原句，没有写 [待补充]}；禁忌：{原文能看出的，没有写 [待补充]}（每人一行）
 - 关系：{他们之间的关系}
-```
 
-> 不确定字段一律加 `[待补充]` 标记，不留空字段。
+### 题材招式
+- {原文已经在用的招式：落在哪几节；构思时按题材包核对，补到 2-3 条}
 
-### 区块二：本书续写基线
+### 文风约定
+- {原文明显的句子、标点、用词习惯，从写作手法.md 提取；没有写「无」}
 
-从 `拆文库/{导入书名}/拆文报告.md` 和 `写作手法.md` 提取，汇总为本书内部续写基线：
+### 作者已定
+- {导入记录「作者交代」里的偏好、红线、残稿决定，一条一行；没有写「无」}
 
-```markdown
-## 本书续写基线
-
-### 故事结构
-{从拆文报告「功能分段」字段提取，概述各段功能}
-
-### 情绪节奏
-{从情感曲线/爆点分析提取，描述情绪走势与峰值位置}
-
-### 核心反转机制
-{从反转机制分析提取，含铺垫路径}
+### 反转与揭露
+- 揭露方式：{证物/证人/偷听撞见/剥洋葱，原文怎么揭的；还没写到写 [待补充]}
+- 真线索：第 {X} 节 {线索}；假线索：第 {X} 节 {误导}（原文有几条写几条）
 
-### 可复用写作手法
-{从写作手法.md 或拆文报告「可复用结构」字段提取，≥3 条}
+## 本书续写基线
+- 已写到：第 {N} 节，{完本 | 半成品}
+- 故事结构：{从拆文报告「结构划分」概述各段功能}
+- 情绪节奏：{情绪走势与峰值在第几节}
+
+## Phase 2 设计校验
+- 题材参考：[待补充]
+- 核心招式：[待补充]
+- 反派设计：不适用（{原因}）
+- 反转类型：{身份/视角/动机/时间线/信息/认知/无反转}
+- 反转位置：第 {X} 节 ÷ 共 {Y} 节 = {Z}%
+- 付费点：第 {N} 节末
 ```
 
+- 「题材参考」「核心招式」导入一律写 `[待补充]`：题材包由续写构思时选，原文已用的招式先记在「题材招式」。
+- 有反派时按拆文报告「人物分析」把「反派设计：不适用」换成身份、动机、作恶方式、致命弱点、报应五行（一字段一行）；原文证据不够的字段写 `[待补充]`。
+- 无反转篇写 `反转类型：无反转` 和 `反转位置：不适用（{报应兑现/甜度递进等原因}）`。有反转但半成品还没写到，写 `反转位置：[待补充]`。
+- 付费点能从原文认出来（知乎盐言多在全文三到四成处的节末）时写节号，并在小节大纲同一节的「结尾承接/钩子」标「付费点」；认不出写 `付费点：[待补充]`。
+- 绑定了外部对标时，在「作者已定」之后加一节 `### 对标摘要（有对标时）`，表头 `| 书名 | 主/副 | 相关性（同题材/弱相关） | 引用强度（辅/参考） | 可借鉴技法 |`。
+- 证据不够的字段写 `[待补充]`，不留空、不留 `{}`。
+
 ---
 
 ## 小节大纲.md 反推规则
 
-从 `情节节点.md` 的功能分段结构提取，映射到短篇段-小节结构。
+以拆文报告「结构划分」为依据，结合情节节点和原文分节映射到各小节；结构段可包含多个小节，不与自然段混同。行数等于原文小节数，一节一行；半成品只写已写的节，剩下的节由续写构思排。
 
 ### 段级映射
 
@@ -121,7 +113,7 @@ Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-
 
 ### 小节大纲表格
 
-`小节大纲.md` 用 story-short-write 的固定 12 列表格，每节一行，列名和顺序不改：
+用短篇写作的固定 12 列表格，列名和顺序不改：
 
 ```markdown
 | 结构段/五段功能 | 主事件 | 情节推进 | 情绪 | 人物/关系变化 | 因果/逻辑链 | 读者新获知什么 | 结尾承接/钩子 | 伏笔/物件 | 场景形态 | 对白作用 | 目标字数 |
@@ -131,39 +123,33 @@ Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-
 
 - `结构段/五段功能` 填 开头/铺垫/升级/反转/结尾。
 - `情节推进` 每个推进单元带 `{对话}` `{冲突}` `{伏笔}` `{回忆}` `{发现}` `{递进}` 之一，有先后用 `->` 连接，按原文实际发生的写，不为凑数拆分。
-- 从原文判断不出的格子写 `[待补充]`，留给作者或续写时填写；不写 `{}` 模板占位。
-- `目标字数` 写原文该节实际字数，各节之和与 `设定.md` 的目标字数对得上。
-- 付费点在哪一节末能从原文认出来时，在该行 `结尾承接/钩子` 标「付费点」；认不出写 `[待补充]`。
-
-### 小节数量推算
-
-以原文实际的分节标记和转场为准；原文没有显式分节时，按情节阶段和转场切分，`总字数 ÷ 1000` 只作粗略参考，不作为切分依据。小节数与正文实际段落结构一致是质量清单必检项。
+- 从原文判断不出的格子写 `[待补充]`；不写 `{}` 模板占位。
+- `目标字数` 写原文该节的字数（阿拉伯数字）；完本时各节之和就是 `设定.md` 的目标字数。
 
 ---
 
-## 正文.md 格式规范
+## 正文.md 外壳整理
 
-将原文迁移为单文件 `正文.md`，格式按 `format-and-structure.md` 规范化：
+导入的是作者自己的成稿，只整理下表所列格式，供后续交付检查识别小节：
 
-| 规范项 | 要求 |
-|--------|------|
-| 小节标记 | `###1.` `###2.` `###3.`（短篇通用格式；用户指定平台时按 `format-and-structure.md` 平台覆盖表切换） |
-| 段落划分 | 按戏剧单元/镜头/一件事结束自然断段；不按固定字数强拆；完整推理、氛围、情绪链可保留稍长段，避免通篇同长度或碎成提纲 |
-| 段间空行 | 正文相邻段落之间**只允许一个换行符 `\n`**，不得出现空行或 `\n\n` |
-| 对话引号 | 默认 `""` 半角双引号；知乎盐言平台可用 `「」` |
-| 缩进 | 无缩进，不用全角/半角空格 |
-| Markdown | 正文段落中不使用 `**` `*` `#` `---` 等 Markdown 语法（仅小节标记除外） |
+| 项 | 怎么处理 |
+|----|---------|
+| 小节标记 | 原文已用 `###1.`、`###第N章` 或 `1.` 之一，原样保留；用别的分节写法（如「一、」「（1）」「* * *」）时，全文换成目标平台的标记：知乎盐言 `1.`，番茄、七猫 `###第N章`，其余 `###1.`；原文没有分节时按转场补标记 |
+| 段间空行 | 相邻段落之间只留一个换行，删掉空行；段落边界不动 |
+| 缩进 | 去掉段首的全角/半角空格 |
+| Markdown | 去掉正文里的 `**`、`*`、`---` 等标记（小节标记除外） |
+| 分段、引号、标点、措辞 | 原样保留，不合并、不拆分、不统一引号 |
 
-**原文内容不改动**，只做格式规范化（分段、引号统一、小节标记添加）。
+原文用的标记、引号和分段习惯记进 `设定.md`「平台基调」，续写照这个写。
 
 ---
 
 ## 外部对标引用视图（可选）
 
-仅当用户显式绑定独立外部 `{对标书名}` 时，将 `拆文库/{对标书名}/` 复制为 `{标题}/对标/{对标书名}/`（跳过 `_archive_*/`，归档快照不进对标视图），供续写阶段加载：
+仅当用户显式绑定独立外部 `{对标书名}` 时，将 `拆文库/{对标书名}/` 复制为 `{导入书名}/对标/{对标书名}/`（跳过 `_archive_*/`，归档快照不进对标视图），供续写阶段加载：
 
 ```
-{标题}/对标/{对标书名}/
+{导入书名}/对标/{对标书名}/
 ├── 原文/
 ├── 拆文报告.md
 ├── 情节节点.md
@@ -177,11 +163,10 @@ Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-
 
 ## 质量检查清单
 
-Phase 3-S 迁移完成后执行：
+迁移完成后执行（不念给作者，没通过先修）：
 
-- [ ] `正文.md` 单文件存在且格式符合 `format-and-structure.md`（小节标记、段落划分/主语节奏、段间仅单换行、引号格式）
-- [ ] `设定.md` 含核心框架区块 + 本书续写基线区块，且核心框架符合本文件模板
-- [ ] `小节大纲.md` 节数与正文实际段落结构一致
-- [ ] 所有 `[待补充]` 标记已添加（不确定字段不留空）
+- [ ] `正文.md` 单文件存在；小节标记是 `###1.`、`###第N章`、`1.` 之一且全文统一；段间没有空行；分段和引号与原文一致
+- [ ] `设定.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/scripts/build_outline_brief.py

@@ -13,8 +13,9 @@
 - 本批每章：正文路径、按 visible_chars_v1 测好的历史长度（与写作时章节检查同一口径，
   story-architect 不能自己跑测量），以及从拆文库摘要里抽出的、写细纲真正要用的字段
   （关键事件、因果、局面结果、涉及、信息变化、状态变化、章尾钩子，情节点只取「标题｜类型｜基调」）；
-  拆文库没有摘要时改用 `.story/work/简化摘要/第NNN章.md`（超过 200 章的书，未深拆章节的简化摘要）；
-- 卷纲「剧情单元（反推）」表里与本批章节重叠的行（只按表头「章节范围」那一列判断重叠）。
+- 本批第一章另带上一章摘要里的章尾钩子（写章首钩子用）；
+- 卷纲里章节范围与本批重叠的剧情单元卡。单元卡用 outline_view.py 的解析识别（写正文时
+  `outline_view.py --unit` 也用它），任务包取得到的单元，写正文时也取得到。
 本书设定与作者已定的事不进包，执行者按规则定点读项目文件与 `.story/work/导入记录.md`。
 
 批大小按总量定：请求 10–20 章（全书最后一批可以更少）；执行者要读的总量（任务包 + 没有摘要、
@@ -34,11 +35,11 @@ import sys
 from pathlib import Path
 
 sys.path.insert(0, str(Path(__file__).resolve().parent))
+from outline_view import parse as parse_volume, unit_chapter_range  # noqa: E402
 from wordcount_core import METRIC, WordcountError, find_chapter_file, measure_wordcount  # noqa: E402
 
 RULES = Path(__file__).resolve().parent.parent / "references" / "outline-reverse-rules.md"
 WORK_DIR = (".story", "work", "排纲")
-BRIEF_SUMMARY_DIR = (".story", "work", "简化摘要")
 MIN_BATCH, MAX_BATCH = 10, 20
 LOAD_LIMIT = 25000  # 执行者一次要读的量（去空白字数）；再加上 agent 模板或 SKILL 入口仍在 35K 内
 # 摘要里写细纲要用的字段（与 story-long-analyze 摘要投影同名）；旧版摘要的同义标签放在别名里。
@@ -56,10 +57,6 @@ FIELD_NAMES = "|".join(name for field in SUMMARY_FIELDS for name in (field[0], *
 LABEL_RE = re.compile(r"^\s*(?:[-*+]\s*)?(?:\*\*([^*]+?)\*\*|(%s))\s*[：:（(]" % FIELD_NAMES)
 POINT_HEADER_RE = re.compile(r"^P(\d+)\s+\*\*(.+?)\*\*\s*[：:]\s*(.+)$")
 POINT_TAG_RE = re.compile(r"^主题标签\s*[：:]?\s*[^|｜]*?\s*[|｜]\s*基调\s*[：:]?\s*(.*?)\s*$")
-# 「章节范围」单元格的一段：第X章—第Y章 / 第X-Y章 / 第X章 / 章X-Y / X-Y。
-SPAN_CELL_RE = re.compile(
-    r"^\s*(?:第|章)?\s*(\d+)\s*章?\s*(?:(?:-|~|～|—|–|－|至|到)+\s*第?\s*(\d+)\s*章?)?\s*$"
-)
 
 
 def emit(text: str, stream) -> None:
@@ -181,76 +178,56 @@ def summary_lines(text: str) -> list[str]:
     return out
 
 
-def chapter_block(project: Path, analysis: Path, chapter: int) -> tuple[str, int, int, bool]:
+def previous_hook(analysis: Path, chapter: int) -> str | None:
+    """上一章摘要里的章尾钩子：本批第一章写「章首钩子」用，上一章不在本包里。"""
+    summary = analysis / "章节" / f"第{chapter - 1}章_摘要.md"
+    if chapter <= 1 or not summary.is_file():
+        return None
+    blocks = label_blocks(summary.read_text(encoding="utf-8-sig"))
+    keys = ("章尾钩子", *dict(SUMMARY_FIELDS)["章尾钩子"])
+    return next((flatten(blocks[key]) for key in keys if blocks.get(key)), None)
+
+
+def chapter_block(project: Path, analysis: Path, chapter: int, first: int) -> tuple[str, int, int, bool]:
     """返回（本章块、历史长度、执行者还需另读的正文量、是否缺摘要）。"""
     body, body_text, actual = measure(project, chapter)
     head = [f"### 第{chapter}章", "",
             f"- 正文：`{shown_path(body, project.parent)}`；字数目标 {actual}（{METRIC}）"]
+    hook = previous_hook(analysis, chapter) if chapter == first else None
+    if hook:
+        head.append(f"- 上一章（第{chapter - 1}章）章尾钩子：{hook}")
     summary = analysis / "章节" / f"第{chapter}章_摘要.md"
-    brief = project.joinpath(*BRIEF_SUMMARY_DIR) / f"第{chapter:03d}章.md"
     if summary.is_file():
         lines = [f"- 摘要要点（抽自 `{shown_path(summary, project.parent)}`）："] + [
             "  " + line for line in summary_lines(summary.read_text(encoding="utf-8").lstrip(""))]
         return "\n".join(head + lines), actual, 0, False
-    if brief.is_file():
-        text = brief.read_text(encoding="utf-8").lstrip("").strip()
-        return "\n".join(head + ["- 简化摘要（未深拆章节）：", "", text]), actual, 0, False
     note = "- 摘要：未找到，读该章正文反推，证据不足处写 [待补充]"
     return "\n".join(head + [note]), actual, weight(body_text), True
 
 
 # ---------- 卷纲剧情单元 ----------
 
-def parse_span_cell(cell: str) -> list[tuple[int, int]]:
-    """只解析「章节范围」这一格；认不出的写法返回空，不去别的列找数字。"""
-    spans = []
-    for part in re.split(r"[、，,；;/]", cell):
-        match = SPAN_CELL_RE.match(part)
-        if not match:
-            continue
-        start = int(match.group(1))
-        end = int(match.group(2) or start)
-        if start <= end:
-            spans.append((start, end))
-    return spans
-
-
-def split_row(row: str) -> list[str]:
-    return [cell.strip() for cell in row.strip().strip("|").split("|")]
-
-
-def unit_rows(project: Path, first: int, last: int) -> list[str]:
-    """从各卷纲的「剧情单元」表里取与本批章节重叠的行，连同表头。"""
+def unit_cards(project: Path, first: int, last: int) -> list[str]:
+    """从各卷纲取章节范围与本批重叠的剧情单元卡（连同卡下的子段）。"""
     volumes = sorted((project / "大纲").glob("卷纲_第*卷.md"))
     if not volumes:
         raise SystemExit("ERROR: 大纲/ 下没有卷纲，先在结构迁移时刻写定卷纲")
     out: list[str] = []
     for volume in volumes:
-        lines = volume.read_text(encoding="utf-8").splitlines()
-        start = next((i for i, line in enumerate(lines) if re.match(r"^#+\s*剧情单元", line)), None)
-        if start is None:
-            continue
-        table: list[str] = []
-        for line in lines[start + 1:]:
-            if line.lstrip().startswith("|"):
-                table.append(line)
-            elif table or line.strip():
-                break  # 表格结束，或标题下先出现了非表格内容
-        if len(table) < 3:
-            continue
-        column = next((i for i, cell in enumerate(split_row(table[0])) if "章节范围" in cell), None)
-        if column is None:
-            continue
-        hits = []
-        for row in table[2:]:
-            cells = split_row(row)
-            spans = parse_span_cell(cells[column]) if column < len(cells) else []
-            if any(a <= last and b >= first for a, b in spans):
-                hits.append(row)
-        if hits:
-            out += [f"来源：`{project.name}/大纲/{volume.name}`", "", *table[:2], *hits, ""]
+        lines, sections = parse_volume(volume.read_text(encoding="utf-8-sig"))
+        for section in sections:
+            if section.kind != "单元级" or "剧情单元" not in section.title or section.status == "已退役":
+                continue
+            span = unit_chapter_range([section], section.unit)
+            if span is None or span[0] > last or span[1] < first:
+                continue
+            end = next((other.start for other in sections
+                        if other.start > section.start and other.level <= section.level), len(lines))
+            out += [f"来源：`{project.name}/大纲/{volume.name}`", "", *lines[section.start:end], ""]
     if not out:
-        raise SystemExit(f"ERROR: 卷纲「剧情单元」表里找不到覆盖第{first}-{last}章的行（表头要有「章节范围」列，写成「第X-Y章」），先补卷纲")
+        raise SystemExit(f"ERROR: 卷纲里找不到章节范围覆盖第{first}-{last}章的剧情单元卡（卡标题下一行写"
+                         "「> 作用域：单元级 {单元ID}」，卡里写「- 章节范围：第A-B章」），先补卷纲，"
+                         "再用 outline_view.py --check --strict 核对")
     return out
 
 
@@ -265,7 +242,7 @@ def render(project: Path, first: int, last: int, blocks: list[str]) -> str:
             "证据不足标了 [待补充] 的要点（没有写「无」）。\n\n"
             "包里提到的检查由主会话在你交付后跑，你不执行命令；需要的测量结果已放进包里。")
     parts = [head, f"\n## 本批章节\n\n路径相对项目根（`{project.parent}`）。\n\n" + "\n\n".join(blocks),
-             "\n## 卷纲剧情单元（覆盖本批）\n\n" + "\n".join(unit_rows(project, first, last)).rstrip(),
+             "\n## 卷纲剧情单元（覆盖本批）\n\n" + "\n".join(unit_cards(project, first, last)).rstrip(),
              "\n---\n\n<!-- 资料：outline-reverse-rules.md -->\n\n" + RULES.read_text(encoding="utf-8").lstrip("").strip()]
     return "\n".join(parts) + "\n"
 
@@ -273,13 +250,13 @@ def render(project: Path, first: int, last: int, blocks: list[str]) -> str:
 def build(project: Path, analysis: Path, first: int, last: int) -> dict:
     if not RULES.is_file():
         raise SystemExit(f"ERROR: 缺少 reference：{RULES}")
-    fixed = weight(render(project, first, last, []))  # 包头、剧情单元行与规则：章数减少只会更少
+    fixed = weight(render(project, first, last, []))  # 包头、剧情单元卡与规则：章数减少只会更少
     blocks: list[str] = []
     lengths: dict[int, int] = {}
     missing: list[int] = []
     load, extra_reading = fixed, 0
     for chapter in range(first, last + 1):
-        block, actual, extra, absent = chapter_block(project, analysis, chapter)
+        block, actual, extra, absent = chapter_block(project, analysis, chapter, first)
         cost = weight(block) + extra
         if blocks and load + cost > LOAD_LIMIT:
             break  # 包已够大：本章留给下一批

package/lib/oh-story/skills/story-import/scripts/check-outline-contract.js

@@ -111,6 +111,10 @@ function readUtf8(file) {
   }
 }
 
+// 回报里的模板出处只列本 skill 带着的文件：导入的副本没有 workflow-outline.md，细纲写法在 outline-reverse-rules.md
+const TEMPLATE_REFERENCES = ['references/workflow-outline.md', 'references/outline-reverse-rules.md']
+  .filter((rel) => fs.existsSync(path.join(__dirname, '..', rel)))
+
 function makeCheck(id, ok, file, evidence, expected, repair, severity = 'blocking') {
   return {
     id,
@@ -119,7 +123,7 @@ function makeCheck(id, ok, file, evidence, expected, repair, severity = 'blockin
     file,
     evidence,
     expected,
-    references: ['references/workflow-outline.md'],
+    references: TEMPLATE_REFERENCES,
     repair,
   }
 }