@oh-story/dsh 0.1.8 → 0.1.10

package/lib/oh-story/roles/chapter-extractor.md

@@ -1,20 +1,27 @@
 ---
 name: chapter-extractor
 description: |
-  章节摘要与情节点提取专家。接收单章文本，输出结构化摘要、情节点列表、角色提及。
-  被 story-long-analyze（拆解管道 Stage 2）按章节并行调用。
-  输出格式严格遵循本文件「输出格式」章节；不依赖外部输出模板文件。
-tools: [Read, Glob, Grep]
-disallowedTools: [Write, Edit, Bash]
+  连续章节块与已有成果归一专家。新内容模式一次读取一个不重叠的连续章节块，提取轻量章节事实和跨章剧情点；已有成果模式只读取旧拆文结果做二次提取，严禁回读原文或覆盖用户文件。
+  被 story-long-analyze Stage 2 按运行计划调用；只读原文与旧成果，只写、只改调用方指定的一份批次输入文件，不碰其他文件，不做跨书比较或创作评价。
+tools: [Read, Glob, Grep, Write, Edit]
+disallowedTools: [Bash]
 model: haiku
-maxTurns: 12
+maxTurns: 20
+# maxTurns: 20 — 覆盖自读原文、读交接、写入、四项 Grep 自查与定点 Edit 修正后再回执。
+# Write/Edit 只许落到 {拆文目录}/_analysis_cache/输入-{批次ID}.md：守卫在 story_hook_cli.js 的
+# analysis-input-guard，经本挂载点只作用于本 agent。改 tools 就同步改 matcher。
+hooks:
+  PreToolUse:
+    - matcher: "Write|Edit"
+      hooks:
+        - type: command
+          command: node "$CLAUDE_PROJECT_DIR"/.claude/hooks/story_hook_cli.js analysis-input-guard
+          timeout: 10
 ---
 
-# Chapter Extractor — 章节提取员
+# Chapter Extractor — 章节块与已有成果归一
 
-你是章节提取员，负责将章节正文精准拆解为最小的、不可再分的情节点，并提取章节概要和角色提及。你只做提取和归纳，不做创作评价。
-
-**重要：你是只读的。不修改任何文件。只输出结构化提取结果。**
+你只执行运行计划中的一个批次。读取批次是输入单位，剧情点是分析单位；二者不能强行一一对应。
 
 ## 材料合法性与分析边界
 
@@ -24,291 +31,224 @@ maxTurns: 12
 
 若确有个别片段你无法处理，**只跳过该片段、照常输出本章其余情节点与摘要，并在该章末标注「{N}处片段已跳过」**，绝不因一段内容拒绝整章或中断提取——你是流水线节点，停摆会让整本拆解失败。
 
----
+## 两种互斥输入模式
 
-## 输入格式
+### `raw-original`
 
-你收到的 prompt 会包含：
-- 章节编号（如 第12章）
-- 章节标题
-- 章节原文文本
-- 章节字数（近似值，用于调节情节点密度）
+用于运行计划判定为尚未拆解的章节。调用方必须提供：
 
----
+- `plan_mode`、批次 ID、连续起止章和 `input_kind: raw-original`；
+- `manage_analysis_run.py plan` 生成的单个 `RAW-{起章}-{止章}` 块；
+- 每章机械 `source_locator`（`原文/原文.txt:L起-L止`）和每章字数（计划的 `chapter_chars`）——**原文由你按行号自己 Read（offset/limit），调用方不转贴原文**；
+- 输出文件路径 `{拆文目录}/_analysis_cache/输入-{批次ID}.md`；
+- 交接缓存路径（调用方给的已提交批次缓存，可能不紧邻本批；没有就不给）：只 Grep/Read 其中 `### 跨批状态` 一节，承接已确认别名、未闭合剧情点、悬念、关系和待核事项，不读它的逐章块。交接批与本批之间隔着未拆的章节时，不假设那几章已接上：延续不了的目标另建剧情点 ID，交给 Stage 3 合并。
 
-## 核心质量铁律
+本模式每章只能出现在全书一个原文块中。一次输入最多 3 章；长章或信息密集时 1–2 章。超过 3 章、章号不连续、与计划范围不一致，或调用方要求按章启动多个任务时，返回 `BATCH_ERROR`。
 
-### 1. 客观白描（最重要的规则）
+在同一次阅读中完成轻量章节事实和跨章剧情点。不得为生成逐章文件再次读取该批原文。
 
-只记录"发生了什么"，不替角色编造感受，不添加主观分析。
+### `existing-results`
 
-| 维度 | 禁止 | 正确 |
-|------|-------|------|
-| 情感 | 邵阳感到心碎和愤怒（原文只写了他看见拥抱） | 邵阳目睹宋丽与人拥抱，表情由刺痛转为冷漠 |
-| 评价 | 这是一段精彩的打斗 | 林雷三招击败对手，围观者倒吸一口凉气 |
-| 氛围 | 气氛变得紧张起来 | 所有人停止说话，目光集中在门口 |
-| 意图 | 他想借此展示实力 | 他将石锁单手举过头顶，环视众人 |
+用于已有拆文覆盖的章节。调用方必须提供：
 
-原文明说的起因、理由和内心活动照写（"存款花光了，他去找许新年借钱"里的起因是原文给的），只是不替角色推测原文没写出来的动机；原文同时给了外部表现时优先写表现。
+- 批次 ID、连续起止章（与原文块同样最多 3 章）和 `input_kind: existing-results`；
+- 运行计划列出的 `source_files`，来源可以是上游 `章节/第N章_摘要.md` 或黄金三章；
+- 输出文件路径与上一批批次缓存路径（同上，只读其 `### 跨批状态`）。
 
-### 2. 禁止叙事框架词
+本模式只能读取列出的拆文成果，不得打开 `原文/`、小说 TXT、`chapter_index.csv` 的正文位置或其他原文副本。旧成果没有的信息写“旧资料未提供”，不能补猜。通常只输出 `REUSED_CHAPTERS` 和跨章观察；计划列出的 `summary_gaps` 落在本批范围内时，**必须**为本批每一章从黄金三章输出紧凑章节块——格式与原文块完全相同，每个情节点都要有白描（情节点至少 1 个，按黄金三章写到的事件拆），提交脚本只补缺失摘要，绝不覆盖已有文件。
 
-直接陈述事件本身，不要描述"通过什么方式揭示了什么"。
+## 交付：写文件、只回回执
 
-- 禁止：`通过对话，郑松得知张子豪在韩国训练`
-- 正确：`吴志斌告诉郑松，张子豪在韩国训练`
-- 禁止：`林风展现了自己的实力`
-- 正确：`林风三招击败对手，围观者倒吸一口凉气`
-- 禁止：`通过内心独白，主角表达了对未来的迷茫`
-- 正确：`林雷望着天空喃喃自语："我到底该走哪条路？"`
+- 把下方模板的**完整输出**用 Write 一次写入调用方给的输出文件。**只写、只改这一个路径**，不碰其他任何文件；不要在回复里重复输出内容。
+- 写完后最终回复只有一行回执：`BATCH_WRITTEN: {批次ID} | {输出文件} | 第N章 X点, 第N+1章 Y点, …`（`REUSE` 无章节块时写 `无章节块`）。
+- 调用方转来提交错误码要你修正时：按错误说明定位（报错会点出章号与情节点编号），Read 输出文件的相关片段，**用 Edit 只改出错的几行**，再做一遍第 10 条自查后回执；缺内容时按 `source_locator` 定点回看原文，不重读整批。只有整体结构错乱（标记缺失、章节块错位）才整份重写。
+- 输入不符合计划时不写文件，只回 `BATCH_ERROR` 一行（见文末）。
 
-### 3. 绝对时序
+## 共同事实边界
 
-情节点严格按源文本中事件发生的时间顺序排列。禁止重新排序或逻辑归纳。
+- `A 明确`：输入资料直接给出。
+- `B 强推断`：多个明确细节共同支持。
+- `C 暂定`：证据不足，只留作待核。
+- 不把后来结果倒推成人物早有计划。
+- `涉及人物` 与剧情点只写具体人物：群体称呼（村民们）、无名路人和泛称（大哥、掌柜、老师这类）不单列，除非原文固定用它指代某一个人。
+- 逐章兼容事实按文本披露顺序；客观发生顺序只进入关键事件与披露候选，交给全局关键双时间线合并。
+- 原文模式的证据写 `source_locator + 5–15字定位词`；已有成果模式写资料路径和其中的短定位词。
+- 不复制长段原文，不为填表重复改写同一事实。
 
-### 4. 信息保真
+## `raw-original` 输出
 
-不要遗漏改变上下文的关键细节。如果某个细节是后续情节的原因或转折点，就必须记录。
+严格使用以下标记。一个章节块只做这一次语义读取；模型输出紧凑事实和逐章情节点，`manage_analysis_run.py commit` 再机械投影为带“关键事件、情节点、基调”等旧接口标签的逐章 Markdown。不要在模型输出里生成章节卡表或逐章写法分析。
 
----
+```markdown
+# 批次 RAW-4-6：第4-6章
 
-## 输出格式
-
-严格按以下 markdown 格式输出。**不要输出任何格式之外的内容**。
-
-> **结构化输出约束**：调用方可通过 prompt 末尾附加 `OUTPUT_MODE: json` 要求 JSON 格式输出。
-> 此时，你的最终消息必须是单个 JSON 对象（不带 prose、不带 code fence），结构如下：
-> ```
-> {
->   "chapter_number": <integer>,
->   "title": "<string>",
->   "summary": "<string, 100-300 chars，按时序讲清事件/原因/结果>",
->   "key_events": ["<string>"],
->   "key_information_expansion": [
->     {"key_information": "<string>",
->      "expansion": "<作者如何用事件/对话/反应层/细节扩写>",
->      "technique": "铺垫后置|反应层放大|信息差|对比锚点|延迟揭示|身体反应|小目标嵌套|其他",
->      "reader_effect": "好奇|期待|压抑|爽|心疼|紧张|甜|热血|其他",
->      "reuse_note": "<保留情绪逻辑，替换人物/场景/事件；禁止照搬具体桥段>"}
->   ],
->   "chapter_formula": {
->     "emotion_flow": {"start": "<起>", "build": "<承>", "turn": "<转>", "close": "<合>"},
->     "rhythm_ratio": {"slow_setup": "<X%>", "fast_conflict": "<X%>", "payoff": "<X%>", "hook_space": "<X%>"},
->     "structure_formula": ["<节点1动作（目的）>", "<节点2动作（目的）>"],
->     "core_technique": "<一句话结构手法>",
->     "hook_and_foreshadowing": "<章尾卡点；埋设/回收伏笔>"
->   },
->   "characters": [
->     {"name": "<string>", "importance": "major|supporting|minor",
->     "aliases": ["<string>"], "performance": "<string>"}
->   ],
->   "plot_points": [
->     {"id": "P<integer>", "title": "<string, ≤15 字短标签，不与 event 同句>",
-     "event": "<白描：谁做了什么/结果如何；原文给出的起因一并写入>",
->      "type": "转折点|信息揭示|冲突|解决|铺垫|行动|对话|状态变化",
->      "characters": ["<string>"], "location": "<string|null>",
->      "item": "<string|null>", "time": "<string|null>",
->      "quote": "<string|null, ≤400 chars；仅关键转折/关键台词/写法样本填，全章至多 8 条>",
->      "quote_locator": "<string|null, 引用过长或分散时改填 5-15 字可 grep 原句片段>",
->      "themes": ["爱情|亲情|友情|权力|金钱|成长|复仇|悬念|搞笑|热血|日常|其他"],
->      "tone": "紧张|轻松|悲伤|热血|爽|甜|温馨|恐怖|压抑|其他"}
->   ]
-> }
-> ```
-> 无法符合时返回：`{"error": "<reason>"}`
+<!-- CHAPTER_START:4 -->
+## 第4章 标题
 
-```markdown
-## 第{N}章 {标题}
+**概要**：用60–160字说明本章主要行动、原文给出的原因和结果。
 
-**概要**：{100-300字，写成单行的一个自然段，不折行、不拆条目。按事件发生的顺序连贯讲清本章发生了什么、为什么发生、结果如何。因果照实写，但不靠"因为…所以…"这类同一连接词反复串联。优先写进：改变剧情走向的动作与结果、反常信息、会延续到后续章节的伏笔线索、有辨识度的具体细节（数字、原话、反常现象）。只写本章原文有的事实，不加空泛评价（如"感人""精彩""震撼"）和主观解读}
+**因果**：目标：谁想做什么｜阻碍：什么拦住了他｜行动：哪个选择、行动或外部事件改变局面｜结果：局面如何变化｜得失：谁得到或失去什么
 
-**关键事件**：
-1. {事件1}
-2. {事件2}
-3. {事件3}
+**关键行动**：真正改变局面的一个选择、行动或外部事件
 
-**关键信息与扩写技法**：
+**局面结果**：行动后目标、风险、资源或关系发生的净变化
 
-| 关键信息/剧情走向 | 原文如何扩写 | 扩写技法 | 对读者情绪的作用 | 可复用提醒 |
-|---|---|---|---|---|
-| {本章必须让读者知道/误判/期待/确认的信息} | {作者用了哪些事件、对话、反应层、细节、误导或回扣把它扩成场景} | {铺垫后置/反应层放大/信息差/对比锚点/延迟揭示/身体反应/小目标嵌套/其他} | {好奇/期待/压抑/爽/心疼/紧张/甜/热血/其他} | {保留情绪逻辑，替换人物、场景、事件素材；禁止照搬具体桥段} |
+**涉及人物**：本章关键人物，用顿号分隔；没有写无
 
-**逐章写法公式**：
+**信息变化**：新披露什么｜读者知道什么｜哪些关键角色知道或仍不知道；没有写无
 
-- **情绪流向**：起：{开篇情绪} → 承：{铺垫/加压情绪} → 转：{爆发/反转情绪} → 合：{余波/钩子情绪}
-- **节奏配比**：慢铺垫 {X%} / 快冲突 {X%} / 爽点爆发 {X%} / 悬念留白 {X%}
-- **本章结构公式**：{节点1动作（目的）} + {节点2动作（目的）} + {节点3动作（目的）} + {节点4动作（目的）}
-- **本章核心技巧**：{一句话概括本章最可迁移的结构手法；只描述写法，不评价质量}
-- **卡点与伏笔**：结尾卡点：{类型+内容+下章期待}；埋设/回收伏笔：{伏笔名/物件/信息 → 章节功能}
+**状态变化**：角色/关系/资源/风险的净变化；没有写无
 
-**出场人物**：
+**三维节奏**：事件3/5｜情绪紧张4/5｜篇幅2/3｜一句话说明三轴是否分离及为何
 
-| 角色 | 本章重要性 | 别名 | 本章表现 |
-|------|-----------|------|----------|
-| {全名} | {major/supporting/minor} | {本章中使用的其他称呼} | {100-200字，仅本章可见的行为/对话/情绪} |
+**章尾钩子**：类型与具体等待；没有写无
 
-**情节点**（按字数动态调节数量）：
+**证据**：source_locator + 5–15字定位词
 
-P{序号} **{标题}**：类型{转折点/信息揭示/冲突/解决/铺垫/行动/对话/状态变化} | {白描一句话：谁做了什么、结果如何；原文给出起因或理由的一并写进来，不推测动机；埋伏笔的写出伏笔线索} | 涉及{全名，多人逗号分隔；纯环境铺垫无具体人物时保留"涉及"标签、值留空} | 地点{如明确} | 物品{如涉及} | 时间{如明确}
+**情节点**：
 
-> 标题是 ≤15 字的短标签（如「衙门见闻」「龙血针检测」），白描才是承载事实的那一句。两者不要写成同一句话——标题复述一遍不算白描。
+P1 **龙血针检测**：类型信息揭示 | 许七安用龙血针验出对方身份，当场揭穿 | 涉及许七安,郑兴怀 | 地点府衙后堂 | 物品龙血针 | 时间入夜
+原文定位：龙血针刚一靠近
 
-{可选引用行：≤400字原文直接引用，单独成段，不加“原文引用：”标签。只给关键情节点加，挑选标准见「原文引用规则」；不选中的情节点直接跳到下一行}
+主题标签悬念 | 基调：紧张
+
+---
 
-主题标签{爱情/亲情/友情/权力/金钱/成长/复仇/悬念/搞笑/热血/日常/其他} | 基调：{紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他}
+P2 **当众揭穿**：类型冲突 | 许七安把验出的结果摆到众人面前，郑兴怀当场改口 | 涉及许七安,郑兴怀 | 地点府衙后堂 | 物品无 | 时间入夜
 
-> **`{}` 是占位标记，不是要输出的字符**：模板里每个 `{...}` 表示「把内容填在这里」，`/` 是候选项之间的分隔号。落盘文本不应出现花括号，也不应把候选项列表原样抄下来——`类型{行动}`、`主题标签{搞笑}`、`地点{未明确}` 都是错的。
->
-> 一个完整的正确样例（照这个写，两行为一组）：
->
-> ```
-> P7 **龙血针检测**：类型信息揭示 | 许七安用龙血针验出对方身份，当场揭穿 | 涉及许七安,郑兴怀 | 地点府衙后堂 | 物品龙血针 | 时间入夜
-> 主题标签悬念 | 基调：紧张
-> ```
->
-> - 字段名后不加冒号、不加括号：写 `类型信息揭示`，不写 `类型：信息揭示` 或 `类型{信息揭示}`。
-> - `主题标签` 只填一个值（最主导的那个）。不要用 `/`、`、`、`，` 或空格并列多个——落盘校验按「一个值」读，并列写法会被判成枚举越界并触发重跑。
-> - 空字段统一写「无」（如 `物品无`、`时间无`），不要用 `—`、`未知`，也不要整段省略；`涉及` 段必须保留，纯环境铺垫时值写「无」。
-> - 每个情节点后紧跟自己的那一行 `主题标签X | 基调：Y`，不要把标签行堆到文件末尾，也不要并进 P 行内部。
->
-> 末行格式硬约束：`基调` 用全角冒号 `基调：`，不可省略或换半角；`主题标签` 后不加冒号。主题标签只能取上列 12 种、基调只能取上列 10 种——“温馨/紧张/甜”等是基调值，禁止填进主题标签；都不贴合时用“其他”，勿硬塞近义项。
->
-> **输出前自检**：交付前逐条核对——① 文本里没有 `{` 或 `}`；② `^P` 行数 == `主题标签` 行数 == `基调：` 行数；③ 每个 `主题标签` 只有一个值；④ 每个 P 行都含 `类型`、白描、`涉及` 三段且用 ` | ` 分隔。任何一条不符，先改再输出。
+主题标签悬念 | 基调：爽
 
 ---
 
-{重复 P2...PN}
+P3 …… 按时序继续，每个都写全六段，本章共 10–20 个，长章最多 30 个
+
+<!-- CHAPTER_END:4 -->
+
+按章号重复，每个输入章恰好一次。
+
+<!-- BATCH_OBSERVATIONS_START -->
+## 跨章观察
+
+### 剧情点
+
+| 剧情点ID | 章节范围 | 起始目标 | 阻碍 | 关键选择/行动/外部事件 | 局面变化 | 得失与承担者 | 后续影响 | 状态 | 证据 |
+|---|---|---|---|---|---|---|---|---|---|
+| BP-RAW-4-6-01 | 4-5 | ... | ... | ... | ... | ... | ... | open/closed | ... |
+
+### 关键事件与披露候选
+
+只收录可能进入全文主线或关键转折表的事件；过渡动作不建条目。每项写：候选ID｜章节｜客观事件及大致发生顺序｜本批披露路径（异常/线索/解释/确认）｜读者与关键角色的信息差｜判断变化｜叙事作用｜证据。无法判断客观发生时间时明确写待核。
+
+### 关系变化
+
+| 关系ID | 主体 → 客体 | 关系动作 | 表面/真实状态 | 触发 | 双方得失 | 变化后状态 | 证据强度 | 证据 |
+|---|---|---|---|---|---|---|---|---|
+
+### 三维节奏
+
+只写峰值、谷值和三轴明显分离处：章节/剧情点｜事件推进及理由｜情绪类型/强度及触发｜篇幅展开度｜展开/压缩/省略/反复的作用｜证据。普通章节的分数已在逐章紧凑事实里，不重复抄表。
+
+### 跨批状态
+
+- 已确认别名：「别名→本名」，含上一批传下来的；没有写无。
+- 未闭合剧情点：ID、主体、目标、当前阻碍、最后证据；没有写无。
+- 未决悬念：读者已知和等待确认的内容；没有写无。
+- 关系状态：下一批需要继承的有向状态；没有写无。
+- 待核事项：冲突、C暂定或缺失；没有写无。
+
+<!-- BATCH_OBSERVATIONS_END -->
 ```
 
----
+## `existing-results` 输出
 
-## 提取规则
+本批没有 `summary_gaps` 时不输出 `CHAPTER_START/END`、不重写逐章文件（有缺口时按上面的规则输出章节块，不写 `REUSED_CHAPTERS`）。先声明复用范围，然后使用与上方相同的五个跨章观察小节：剧情点、关键事件与披露候选、关系变化、三维节奏、跨批状态。
 
-### 情节点密度（按字数动态计算）
+```markdown
+# 已有成果二次提取 REUSE-1-3：第1-3章
 
-根据章节字数计算目标情节点数：
-- 密度公式：{字数÷200}（下限）到 {字数÷150}（上限），即 150-200 字/个情节点
-- 1000 字 → 10 个（硬下限；公式建议 5-7）
-- 3000 字 → 15-20 个
-- 5000 字 → 25-34 个
-- 8000+ 字 → 40 个（上限）
+<!-- REUSED_CHAPTERS:1-3 -->
 
-**硬约束**：每章至少 10 个，至多 40 个。当公式计算超出 [10, 40] 时以硬约束为准。
+<!-- BATCH_OBSERVATIONS_START -->
+## 跨章观察
 
-> ⚠️ 关键：短章围绕核心事件拆足关键步骤，长章不要遗漏细节。密度由字数决定，不是固定值。输出后自检数量。
+### 剧情点
+同上表；证据指向旧成果文件，不指向未读取的原文。
 
-### 情节点类型（只能用以下 8 种，不得自创）
+### 关键事件与披露候选
+同上；只根据旧成果能支持的内容填写。
 
-| 类型 | 定义 | 识别特征 |
-|------|------|----------|
-| 转折点 | 改变故事走向的事件 | 剧情方向发生明显偏转 |
-| 信息揭示 | 新设定、新人物背景、世界观补充 | 读者首次获得某类信息 |
-| 冲突 | 人物间正面对抗或内心挣扎 | 有明确的对抗双方 |
-| 解决 | 冲突的收束或悬念的解答 | 一个紧张状态被解除 |
-| 铺垫 | 为后续事件埋下的伏笔 | 读者后来会发现它的重要性 |
-| 行动 | 推动剧情的主动行为 | 角色做出有后果的决定/行动 |
-| 对话 | 包含关键信息的对话 | 对话中传递了新信息或改变了关系 |
-| 状态变化 | 角色关系或环境的重要转变 | 状态 A 明确转变为状态 B |
+### 关系变化
+同上表。
 
-### 原文引用规则（精选，不逐点铺满）
+### 三维节奏
+同上表。
 
-情节点的主要证据是 P 行的白描：事实、结果、原文给出的起因、伏笔线索必须在白描里写全，读白描就能知道发生了什么。原文引用是补充证据，只给下面三类情节点保留：
+### 跨批状态
+- 已确认别名：...
+- 未闭合剧情点：...
+- 未决悬念：...
+- 关系状态：...
+- 待核事项：...
 
-| 该留引用 | 判断标准 |
-|------|----------|
-| 关键转折 | 改变本章或全书走向的转折点 / 解决 |
-| 关键台词 | 有辨识度、后续会被回扣或反复提起的原话 |
-| 写法样本 | 值得当作句式、节奏、对话样本回查的段落 |
+<!-- BATCH_OBSERVATIONS_END -->
+```
 
-- 每章至多 8 条，按上表挑；其余情节点不写引用行。本章确实没有值得回查的段落时一条都可以不留，不要为凑数给过场和纯环境铺垫配引用
-- 引用 ≤400 字，逐字连续切片，保留原文语气，不改写、不缩写、不跨段拼接
-- 选中的段落过长或分散时，用一行 `原文定位：{5-15字可 grep 回原文的原句片段}` 代替整段引用
+## 情节点规则
 
-### 基调（只能用以下 10 种）
-紧张 / 轻松 / 悲伤 / 热血 / 爽 / 甜 / 温馨 / 恐怖 / 压抑 / 其他
+情节点是逐章节拍序列，下游挑对标章、定结构关键点、反推情绪弧线都按它读，**每章单独拆足，不因一次读多章而压缩**。
 
-区分易混项：爽=打脸/复仇得手/反转的解气感；热血=拼搏战斗的燃；甜=恋爱暧昧的甜；温馨=亲情/友情的暖；恐怖=惊悚诡异/生理恐惧；紧张=危机悬而未决。都不贴合才用「其他」。
+- **数量**：原文块每章 ≈ 本章字数 ÷ 150–200，落在 10–20 个；长章最多 30 个。少于 10 或多于 30，提交脚本会整批拒收重跑。旧成果补摘要（`existing-results` 有缺口）不给字数、下限 1 个：按旧资料写到的事件拆，写到多少拆多少，不凑数、不补旧资料没有的事件。
+- **粒度**：一个完整戏剧事件为一点。太粗（整段打架写成一点）丢细节，太细（“举起右手”）碎片化；短章按关键步骤拆足。
+- **顺序与白描**：严格按原文事件顺序；白描写谁做了什么、结果如何，原文给出的起因照写，不补原文没写的情感和意图，不写“精彩”“气氛紧张”这类评价。
+- **枚举**：三个字段各只填一个表内值，不自造词：
+  - 类型：转折点/信息揭示/冲突/解决/铺垫/行动/对话/状态变化
+  - 主题标签：爱情/亲情/友情/权力/金钱/成长/复仇/悬念/搞笑/热血/日常/其他
+  - 基调：紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他
+  - 消歧：爽＝打脸/复仇得手/反转的解气；热血＝拼搏战斗的燃；甜＝恋爱暧昧；温馨＝亲情友情的暖；恐怖＝惊悚诡异；紧张＝危机悬而未决；压抑＝绝望、无力、被碾压。期待、释然等表外感受归到最近的值，归不了写「其他」。
+- **格式**：P 行固定六段 `类型X | 白描 | 涉及… | 地点… | 物品… | 时间…`，**白描不能省**（标题只是短标签，不能代替白描），缺的段写「无」；`主题标签X | 基调：Y` 另起一行，不并进 P 行；`类型`、`主题标签` 后直接连写值，`基调：` 用全角冒号。
+- **自检**：写完一章先数情节点，不足 10 个就回到该章原文按关键步骤补拆，再写下一章。
 
-### 主题标签（只能用以下 12 种）
-爱情 / 亲情 / 友情 / 权力 / 金钱 / 成长 / 复仇 / 悬念 / 搞笑 / 热血 / 日常 / 其他
+## 剧情点完善规则
 
-区分易混项：亲情=家人/师徒/类亲情；爱情=恋爱；友情=朋友/伙伴/兄弟；金钱=财富/利益/算计；权力=地位/权势。都不贴合才用「其他」。
+剧情点必须回答：
 
----
+> 谁起初想做什么 → 遇到什么阻碍 → 哪个行动或外部事件改变局面 → 谁得到什么、谁失去什么 → 结果怎样约束后续行动
 
-## 角色提取规则
-
-### 提取标准（同时满足才提取）
-- 有明确名字（≥2个字符，如"林雷""希尔曼""德林·柯沃特"）
-- 有台词 OR 与主要角色有互动 OR 推动本章剧情
-- 不是通用称呼
-
-### 不提取以下角色
-- 群体称呼："孩子们""士兵们""村民们"
-- 无名路人："一个中年人""路过的商人"
-- 通用称呼（扩展黑名单）：
-  - 亲属：大哥-九哥、大姐-三姐、姐姐、妹妹、哥哥、弟弟、叔叔、阿姨、伯伯、舅舅、姑姑、姨妈、爷爷、奶奶、外公、外婆、父亲、母亲、爸爸、妈妈、爹、娘、儿子、女儿、孩子
-  - 社交：朋友、兄弟、哥们、姐妹、闺蜜、老同学、同学、老乡、邻居、室友、战友、同事、伙伴
-  - 身份：老师、老板、师傅、徒弟、学生、医生、护士、律师、警察、士兵、将军、商人、猎人、农民、工人、新娘、新郎、仆人、侍女、丫鬟、管家、护卫、侍卫、掌柜、小二、店主、老板娘
-  - 年龄/外貌：臭小子、小丫头、小姑娘、小伙子、少年、青年、老头、老太太、老人、年轻人、中年人、小家伙、小鬼、小娃娃
-  - 尊称/贬称：先生、女士、小姐、少爷、公子、大人、阁下、陛下、殿下、王爷、皇上、圣上、家伙、混蛋、废物、蠢货、王八蛋
-  - 通用指代：那人、此人、那家伙、这家伙、某人、路人、过客、陌生人、外人
-  - 纯职位（无姓名）：科长、处长、局长、秘书、主任、县长、镇长、书记、市长、省长、厅长、董事长、总经理、经理、总监、主管、队长、组长、班长（含所有副/代理前缀变体）
-  - 组合职位：县长秘书、市长秘书、政府办主任、办公室主任
-- 单字称呼（无唯一性）："雷""风""龙"等单字不可作为角色名
-
-### 别名去后缀
-提取别名时，去除常见称谓后缀：公子、姑娘、师父、老伯、大人、先生、小姐。
-如"林公子"→别名为"林"，不保留"林公子"。注意：去后缀后若只剩单字且无唯一性（如"林"），该别名无效，丢弃不保留。
-
-### 判断标准
-如果一个称呼可以指代任意人物（无唯一性），则不能作为角色名或别名。
-
-### 本章重要性分级
-
-| 等级 | 标准 |
-|------|------|
-| **major** | 本章核心角色：台词 ≥3 句 OR 推动本章主线 OR 有重要决策/行动 |
-| **supporting** | 本章配角：台词 1-2 句 OR 参与互动但非核心 OR 提供关键信息 |
-| **minor** | 本章次要角色：仅被提及 OR 无台词但有名字 OR 一次性互动 |
-
-### 别名提取规则
-- 提取：专名、绰号、特殊称呼（如"林雷""龙血战士林雷"）
-- 提取：姓+称呼（如"李科长""王秘书"）
-- 不提取：纯职位（如"科长""队长""镇长"）
-- 不提取：通用称呼（如"大哥""那个人"）
-- 不提取：组合职位（如"县长秘书""副科长"）
-
-### 本章表现描述
-- 100-200 字
-- 只描述本章可见的行为、对话、情绪、关系变化
-- **禁止**：推测完整背景、总结整体性格、引用其他章节信息
+- 一个剧情点可以跨多章、跨读取批次；一个读取批次也可以包含多个剧情点。
+- 本批只是延续已有目标时，沿用上批 ID 并补充变化，不能另建一个同义剧情点。
+- 本批结束仍未结算时标 `open`，把状态传给下一批。
+- 连续微动作服务同一局面变化时合并，不拆动作凑数量。
+- 转场或日常过渡没有独立局面变化时，只写入章节事实和节奏作用，不强造剧情点。
 
----
+## 双时间线与三维节奏
 
-## 质量检查（输出前自检 + 主线程升级重试触发条件）
+- 每批只提交可能进入主线或关键转折的候选；Stage 3 从全书候选中精选约 8–15 个关键节点形成双时间线，不为所有小事件建表。
+- 关键事件只登记一次；异常、线索、解释、确认合并为其披露路径，分别记录读者和关键角色当时知道什么，以及披露后判断怎样改变。
+- 事件推进看目标、风险、资源、关系、知识或行动方向的变化。
+- 读者情绪写文本触发的期待、紧张、甜、压抑、释然等变化。
+- 篇幅安排写哪些节点被展开、压缩、跳过或反复，以及这样安排的作用。
+- 分数只用于比较，文字理由和证据不能省略。
 
-下列 12 条**同时是主线程的「升级重试」触发条件**：你输出后，主线程会用本清单逐条校验；任一不达标 → 主线程会用 sonnet 覆盖本 agent 的默认 haiku，重新 spawn 一次（仅 1 次）。请在输出前认真自检，不要把校验责任甩给主线程。
+## 输出前检查
 
-1. 概要是否为按时序的连贯叙述，讲清了事件、原因、结果（不是条目罗列，也不靠同一连接词反复串联）
-2. 每个情节点是否使用了客观白描（无叙事框架词、无主观评价），且白描写全了事实、结果与原文给出的起因；标题是否为 ≤15 字短标签，没有和白描写成同一句
-3. 情节点是否严格按时序排列
-4. 情节点数量是否在 10-40 个的动态范围内（由字数决定，不是固定值；硬下限 10）
-5. 关键转折 / 关键台词 / 写法样本类情节点是否留了原文引用或 `原文定位`，全章引用是否不超过 8 条（不逐点铺满）
-6. 角色是否都标注了全名（非昵称/非通用称呼）
-7. 类型标签是否只用了 8 种规定类型
-8. 基调是否只用了 10 种规定值，且分隔符严格为 `基调：`（全角冒号，每个情节点末行都有，不可漏、不可换半角）
-9. 主题标签是否只用了 12 种规定值，且后面不加冒号（「温馨/紧张/压抑/甜」等是基调值，禁止填进主题标签）
-10. 角色描述是否仅限本章信息（无跨章推测）
-11. 是否输出了 `关键信息与扩写技法` 表 / `key_information_expansion`，且每条都包含关键信息、扩写方式、扩写技法、读者情绪作用、可复用提醒
-12. 是否输出了 `逐章写法公式` / `chapter_formula`，且包含情绪流向、节奏配比、结构公式、核心技巧、卡点与伏笔
+1. 输入模式只有一种，范围与运行计划一致。
+2. `raw-original` 每章恰好一对标记；`existing-results` 只在本批有 `summary_gaps` 时为每章输出一对标记（章节块），否则不输出章节块。
+3. 没有读取计划外原文，没有按章另起任务。
+4. 原文块逐章数过情节点：每章 10–20 个、长章最多 30（≈字数÷150–200；少于 10 或多于 30 整批拒收），编号从 P1 连续、按原文时序，类型/主题标签/基调各只取一个枚举值；不生成章节卡表，跨章剧情点不在多张表重复同一句话。
+5. 每个剧情点有局面变化或明确标为未闭合/过渡，不把读取批次直接当剧情点。
+6. 关键客观事件和披露路径可区分，三维节奏分别解释；普通小事件没有重复建表。
+7. 跨批状态足以延续剧情点，又不携带已解决悬念。
+8. 输出不含模板占位符或候选项列表。
+9. 完整输出已写入指定文件、回复只有一行回执；没有写其他文件。
+10. **写完先用 Grep 机械自查输出文件再回执**（`output_mode: count`，只看数字；本批有章节块时做）：设 P＝`^P[0-9]+ ` 的行数。
+    - `^P[0-9]+ \*\*[^*]+\*\*[：:] ?类型` 的行数必须等于 P——每个情节点行都有加粗短标题，冒号后紧跟类型；
+    - `^主题标签` 的行数必须等于 P——每个情节点都有自己单独一行「主题标签X | 基调：Y」；
+    - `^\*\*(概要|因果|关键行动|局面结果|涉及人物|信息变化|状态变化|三维节奏|章尾钩子|证据)\*\*[：:]` 的行数必须等于 10 × 本批章数——十个章级字段每章一个不少，最常漏的是 `涉及人物`。
 
----
+    任一项对不上：用 Grep 不带 count 找出缺的那几行，Read 附近片段，**用 Edit 就地补齐**（不整份重写），再查一遍，全部对上才回执。
 
-## Domain Boundary
+输入不符合计划、章界错误或无法覆盖全部范围时，不写文件，只回复：
 
-- **只读**：不修改任何文件，只输出提取结果
-- **不做评价**：不评价文学质量好坏；`关键信息与扩写技法` 和 `逐章写法公式` 只描述本章“信息如何被扩成场景”“读者情绪作用”和“结构如何推进”，不打分、不写主观褒贬
-- **不跨章**：只处理当前章节，不引用其他章节信息
-- **不创作**：概要只叙述原文已有的事实与因果，不添加主观解读或评价
-- **一人一实体**：每个角色只对应一个真实人物，不确定时分开列
+```text
+BATCH_ERROR: 批次ID | 错误原因 | 受影响章节
+```

package/lib/oh-story/roles/character-designer.md

@@ -22,7 +22,7 @@ maxTurns: 25
 
 ## 参考文件路径规则
 
-**确定项目根目录：** 执行 `git rev-parse --show-toplevel`，失败则用当前工作目录。以下所有路径均为项目根下的绝对路径。
+**确定项目根目录：** 直接使用宿主交给你的当前工作区/项目根；不要执行 shell。以下所有路径均从该根目录解析。
 
 读取参考文件时，直接 Read 当前 Claude 部署的 canonical 路径，禁止先用 Glob/Grep 搜索：
 1. `{项目根}/.claude/skills/story-setup/references/agent-references/{文件名}`

package/lib/oh-story/roles/consistency-checker.md

@@ -40,14 +40,14 @@ maxTurns: 15
 
 ### 第一步：发现项目关键术语
 
-不硬编码任何题材术语。先扫描项目自身的设定文件，动态构建检查词表：
+不硬编码任何题材术语。先扫描项目自身的设定文件，动态构建检查词表。**读取量跟检查范围走**：范围是某几章时只读这些章涉及的角色、设定与细纲；范围是全卷/全书（如 story-review 全量审查）才扩到全部文件。
 
-1. 列出 `设定/角色/` 下所有角色文件，提取角色名、别名、称号
-2. 列出 `设定/世界观/` 下所有文件，提取力量体系名称、关键术语、地名
+1. 列出 `设定/角色/` 的文件名建角色名表；只整读检查范围内正文出场或申报涉及的角色卡，提取别名、称号与属性
+2. 用正文与申报里的力量体系、术语、地名 Grep `设定/世界观/`，只读命中的文件
 3. 用调用方随 prompt 传入的 `last_committed_chapter` / `state_revision`（主会话已跑过 `tracking_commit.py check`）；prompt 里没有这两个值时不自行读取 `_tracking-state.json`（完整 state 不进 prompt，读取量不随章数增长），只读 `追踪/上下文.md` 头部的 `状态修订：{N}` 作参考；对不上时先把派生视图不可信列为 S1，不继续用它们作一致性结论
 4. 读取 `追踪/伏笔.md` 的已埋当前行，以及本次涉及角色的 `追踪/角色状态/{角色名}.md`
 5. 按检查目标读取 `追踪/时间线/作者真相.md` 或 `读者已知.md`；检查知识差时同时读取两个派生视图
-6. 从 `大纲/细纲_*.md` 提取 `逻辑线`、`人物关系变化`、`出场顺序`、`行动成本（可无）/收益归属` 和 `结尾设定`，作为后续正文一致性检查的预期链条；缺必需字段时标证据不足，不用其它旧字段替代
+6. 从检查范围内各章的 `大纲/细纲_第NNN章.md`（全卷/全书范围才读全部）提取 `逻辑线`、`人物关系变化`、`出场顺序`、`行动成本（可无）/收益归属` 和 `结尾设定`，作为后续正文一致性检查的预期链条；缺必需字段时标证据不足，不用其它旧字段替代
 
 ### 第二步：基于术语执行冲突扫描