@oh-story/dsh 0.1.15 → 0.1.16

package/lib/oh-story/skills/story-long-analyze/SKILL.md

@@ -8,11 +8,11 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 你是网络小说结构分析师。
 
-**核心原则：机械边界只解析一次；原文按连续章节块读取一次；同次读取产生逐章事实和跨章观察；聚合阶段复用落盘结果，不重新阅读全文。**
+**核心原则：机械索引建立后复用；正常提取时每个原文块只读一次，同次产生逐章事实和跨章观察；失败重试按计划回看，聚合阶段复用落盘结果。**
 
 > Agent 兼容性：只检查当前运行时 canonical 目录。运行时不支持项目 agent 或找不到文件时降级 solo/direct，并报告 `Fallback: project custom agents unavailable -> solo`。ZCode 3.3.4 不提供项目 custom agents，直接按此规则降级，不扫描其他 CLI 的 agent 目录。
 >
-> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 34` 不一致时（标记缺失、字段缺失/非整数、小于或大于 34）照常按文件存在性检查并 spawn，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 34）` 并提示重新运行 `/story-setup` 后新开会话；大于 34 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct。
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 35` 不一致时（标记缺失、字段缺失/非整数、小于或大于 35）照常按文件存在性检查并 spawn，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 35）` 并提示重新运行 `/story-setup` 后新开会话；大于 35 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct。
 
 ## 分析边界
 
@@ -25,11 +25,11 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ## 对作者说话
 
-作者读到的一切——停下来提问、进度、拆完汇报、出错说明，以及 `快速预览.md`、`拆文报告.md`、人物关系图——按 [references/author-facing.md](references/author-facing.md) 写：大白话讲书、讲章、讲读者和作者能怎么用；不出现脚本名、命令、字段名、状态值、批次编号、内部文件名、质量指标名和证据分级字母；编号只和名称一起出现；需要作者拿主意时给一个问题、推荐选项和默认值；工程细节默认不写，确需时只在末尾留一行技术备注。脚本输出带 `author_message` 时转述它，不贴 JSON 或错误码。
+对话回复、`快速预览.md`、`拆文报告.md` 和人物关系图按 [references/author-facing.md](references/author-facing.md) 写，讲清书中情节、阅读感受和可借鉴写法。内部字段、命令与质量指标留在运行资料中；编号带名称。脚本返回 `author_message` 时转述说明与选项。
 
 ## 按时刻读
 
-拆文按阶段分成几个时刻。进入一个时刻只读下表这一行的文件；上一时刻的操作说明不必留在上下文里，时刻之间只靠落盘产物和 `_progress.md` 的阶段状态交接（续跑、换新对话都从这里接上）。[references/author-facing.md](references/author-facing.md) 每个时刻都按需用。
+进入各阶段时只加载下表对应的说明，续跑或新会话通过落盘产物和 `_progress.md` 的阶段状态衔接。[references/author-facing.md](references/author-facing.md) 每个时刻都按需用。
 
 | 时刻 | 读 | 交接 |
 |---|---|---|
@@ -55,8 +55,8 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 | 情况 | 行为 |
 |---|---|
-| 部分完成 | 已完成章只读旧拆文；黄金三章可补缺失摘要；仅缺摘要的章进入原文块 |
-| 已完整拆完 | 默认直接使用；增强只写 `_analysis_cache/` 和 `_progress.md` 状态 |
+| 部分完成 | 已完成章只读旧拆文；黄金三章可补缺失摘要；缺失语义成果的章进入原文块；已有语义但缺摘要时从旧成果补投影 |
+| 已完整拆完 | 默认直接使用；增强复用旧成果，只补所请求的缺失产物、批次缓存与状态，保留既有成果 |
 | 全新小说 | 建索引、完成黄金三章，再把其余正文放入不重叠连续章块 |
 
 检查器只扫描上游 `章节/*_摘要.md` 与黄金三章，逐章报告缺口。新旧投影混存要报告来源，但不要求重拆。
@@ -76,7 +76,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 | 阶段 | 输入 | 主要输出 | 完成判断 |
 |---|---|---|---|
 | 0 机械索引 | 原文 | `chapter_index.csv`、`概要.md` 初稿（Stage 5 覆盖） | 章界、逐章 hash 和全源 hash 有效 |
-| 1 黄金三章 | 前三章原文 | 深度拆解、快速预览、可选 `_style-sample.txt` | 老接口完整；同次阅读保存可用样本 |
+| 1 黄金三章 | 前三章原文 | 深度拆解、快速预览、可选 `_style-sample.txt` | 深度拆解与快速预览完整；同次阅读可保存文风样本 |
 | 2 连续块提取 | 只读计划列出的旧成果或原文块 | 批次缓存；缺失逐章摘要投影 | 缓存完整、摘要存在、状态范围 hash 有效 |
 | 3 剧情与机制 | 批次缓存和可信旧成果 | 剧情单元、故事线、节奏、情绪模块 | 文件存在、阶段状态完成 |
 | 4 角色与设定 | 批次涉及人物、状态变化、关系观察 | 角色、设定、关系图 | 文件存在、阶段状态完成 |
@@ -127,7 +127,7 @@ chapter,source_chapter,volume,title,start_line,end_line,char_count,source_locato
 
 ## Stage 6：文风与单独重建
 
-加载 [references/style-profile-generator.md](references/style-profile-generator.md)。优先使用已有 `文风.md` 和有效 `_style-sample.txt`；样本不足时允许依据索引选择 4–6 章、定点读取原文行段。只缺文风时直接运行 Stage 6，不重跑 Stage 1–5。没有有效样本、索引或原文时明确失败，不生成锚点全空的可用档案。
+加载 [references/style-profile-generator.md](references/style-profile-generator.md)。优先使用已有 `文风.md` 和有效 `_style-sample.txt`；样本不足时允许依据索引选择 4–6 章、定点读取原文行段。只缺文风时直接运行 Stage 6，不重跑 Stage 1–5。没有有效样本，且无法通过索引取得原文片段时明确失败，不生成锚点全空的可用档案。
 
 ## 三层灵感库管道（可选后置）
 

package/lib/oh-story/skills/story-long-analyze/references/author-facing.md

@@ -1,6 +1,6 @@
 # 写给作者看的话
 
-拆文的读者是网文作者，不是工程师。作者会看到的东西有两类：对话里的回复（进度、停下来问、拆完汇报、出错说明），和落盘给人读的文件（`快速预览.md`、`拆文报告.md`、`人物关系图/人物关系图.md`）。这两类都按本文件写；本文件代码块里的内容就是作者会看到的原样，守卫脚本会检查代码块里有没有工程词。
+对话回复（进度、确认、汇报、出错说明）与落盘文件（`快速预览.md`、`拆文报告.md`、`人物关系图/人物关系图.md`）均按本文件写。代码块给出可直接采用的话术。
 
 ## 总规则
 
@@ -8,7 +8,7 @@
 2. **不出现工程痕迹**：脚本名和命令、JSON 字段名（如检查器和计划器输出里的分类、推荐路径、阶段修复、最终状态）、状态值、批次编号、内部文件（运行进度、缓存、机械章节表）、hash、质量指标名（置信度、覆盖率、重叠率）、证据分级字母、「三维」这类内部口径。这些只在你自己的判断里用。
 3. **编号必须带人话名**：情绪模块卡、关系、事件的编号单独出现作者看不懂。要么只写名称，要么写成「退婚当众打脸」（情绪模块卡 EM-003）；关系写成「林远 → 苏晴：由信任到反目（第9章宗门大比）」，不写关系编号。
 4. **证据强弱说人话**：原文直接写了的直接陈述；由几处细节推出来的写「从第3、5章的细节看，大概率……」；证据不够的写「推测，待回原文核实：……」。
-5. **需要作者拿主意时**：问一个具体问题，给出推荐选项和理由，并说明不回答时按哪个默认继续。一次只问一件事。
+5. **需要作者拿主意时**：一次只问一个具体问题，给出推荐选项和理由。推荐不等于授权；需要确认的选择等作者回答，已授权范围内的常规工作按默认做法继续。
 6. **工程细节默认不写**：作者追问或排障确实需要时，放在回复最后单独一行「（技术备注：……）」，不超过一行。
 7. 脚本输出里带 `author_message` 的，按它的意思转述给作者（可润色，不改事实、不删选项），不要贴 JSON、错误码或 `detail`。
 
@@ -23,9 +23,9 @@
 最值得学的一点：{最有借鉴价值的写法，一句}。
 
 要继续把后面 {剩余章数} 章也拆完吗？我建议{继续 / 只拆第 X–Y 章这一段 / 到此为止}，因为{理由}。
-继续的话我每次同时拆三段，比一段段按顺序拆快两三倍，段和段之间的人物称呼、没收尾的剧情在最后汇总时对齐。
+继续的话我每次同时拆三段，减少等待时间；段和段之间的人物称呼、没收尾的剧情在最后汇总时对齐。
 
-不回复的话我按「{推荐选项}」处理。
+如果继续，我会按「{推荐拆法}」执行；是否继续拆，等你决定。
 ```
 
 ### 作者问起怎么拆
@@ -34,9 +34,9 @@
 
 ```text
 有三种拆法：
-1. 一段接一段按顺序拆：前后章的人物称呼、没收尾的剧情都接得最稳；最慢。
-2. 每次同时拆三段（现在用的）：快两三倍；段和段之间偶尔要等全部拆完汇总时再对齐人物和剧情。
-3. 能同时拆多少就拆多少：最快；前后接续全靠最后汇总时对齐，汇总会多花些工夫。电脑或账号扛不住时我会自动放慢。
+1. 一段接一段按顺序拆：前后章的人物称呼、没收尾的剧情能逐段接上；等待较长。
+2. 每次同时拆三段（现在用的）：可减少等待；段和段之间偶尔要等全部拆完汇总时再对齐人物和剧情。
+3. 尽量同时拆更多段：等待更少；前后接续全靠最后汇总时对齐，汇总会多花些工夫。电脑或账号扛不住时我会自动放慢。
 ```
 
 ### 拆的过程中报进度
@@ -180,7 +180,7 @@
 
 ## 黄金三章评分
 
-与 快速预览.md 同一张五项表；「为什么这么打」一栏写一句人话理由。
+沿用 快速预览.md 的五项评分表；「为什么这么打」一栏写一句人话理由。
 
 ## 读者在追什么
 
@@ -241,7 +241,7 @@
 
 ## 文风一句话
 
-{句子长短、对话习惯、情绪起伏的特点}；详细见 文风.md。
+{句子长短、对话习惯、情绪起伏的特点}；详细见 文风.md；若文风尚未生成，写明待补，不先推测。
 
 ## 还不确定的地方
 

package/lib/oh-story/skills/story-long-analyze/references/deconstruction-notes.md

@@ -1,5 +1,5 @@
 # 长篇拆文参考
-拆书方法论、结构设计、卖点循环、题材实战要点的速查手册。配合 SKILL.md 与各 Stage 的规则文件使用。
+结构、卖点循环与题材写法的观察标尺：只识别原文已采用的机制，不要求源文符合某套写法，也不据此补写剧情。Stage 3 按需查「桥段词表」。
 
 ## 管道阶段映射
 
@@ -34,17 +34,17 @@
 | 问题 | 教训 |
 |------|------|
 | 主角独断万古身边人死绝 | 读者代入后"天下无敌啥也得不到"，憋屈 |
-| 换地图杀光所有配角 | 留存/追读风险显著升高，读者难以接受代入资产清零 |
+| 换地图杀光所有配角 | 读者已投入的关系失去后续作用，检查是否影响追读期待 |
 | 所有人牺牲成工具人 | 高开低走，核心情绪崩坏 |
 
-修正：悲情通过创造挫折体现，非杀死重要角色；换地图可让原有人遇险给主角行动理由。
+可借鉴的处理：用挫折制造悲情；换地图时让旧角色的处境继续影响主角行动，维持读者对关系的投入。
 
-### 刀人原则
+### 角色牺牲的观察条件
 
-- 刀人是手段非目的，对笔力要求极高
-- 必须刀人时，埋伏笔留弥补空间
-- 项目没有足够铺垫、补偿机制和后续情绪回收方案时，不要刀重要角色
-- 悲情强度必须由目标平台近期样本校准；默认不让悲情覆盖核心爽感或安全感
+- 角色牺牲改变了什么，是否只为制造悲伤
+- 之前是否有铺垫，之后是否有补偿或情绪回收
+- 重要角色消失后，已建立的关系与读者期待怎样延续
+- 悲情是否符合本书的阅读承诺；判断平台倾向时另核近期样本
 
 ### 强情绪样本校验
 
@@ -54,13 +54,13 @@
 
 ## 题材边界与核心梗
 
-### 核心梗 = 读者需求，偏离 = 抛弃读者
+### 核心梗与读者需求
 
 | 偏离类型 | 后果 |
 |----------|------|
-| 核心对比消失（都市高武→普通） | 在读直降 |
+| 核心对比消失（都市高武→普通） | 原有期待难以继续兑现 |
 | 核心机制不升级（网游困在新手村） | 限制上限 |
-| 题材串味（玄幻混诡异/悬疑跑偏到玄幻） | 两边读者都不讨好 |
+| 题材串味（玄幻混诡异/悬疑跑偏到玄幻） | 检查两类期待能否同时兑现 |
 | 后期三观偏离 | 受众筛选过严重 |
 
 ### 核心梗延伸四维度
@@ -69,7 +69,7 @@
 
 ### 核心梗密度参考
 
-《美食赋我词条》11章内核心梗应用5次，密度极高。
+密度按核心梗实际应用次数 / 已拆章节数记录，并列出对应章节；频繁使用是否有效，要结合每次变化与兑现判断。
 
 ---
 
@@ -77,7 +77,7 @@
 
 ### 六原则
 
-有目的 / 有方法 / 拆出理论 / 摒弃好恶 / 扬长避短 / 拆自己喜欢的书
+明确拆解目的，选用对应方法，归纳可复用规律；区分个人好恶与写法效果，分析作品长短处，并优先选择自己愿意细读的书。
 
 ### 流程
 
@@ -116,9 +116,9 @@
 
 每二三十万字一卷，有明确核心与目标；卷内多线头纠缠打破线性"起承转合"；"起"必须抛钩子；每卷结尾为下卷埋线。
 
-### 时代适应
+### 开篇写法观察
 
-从强冲突开场→人情冷暖+基础需求展开；文风更细腻；画面剪辑感极强；套路熟悉但两三章速战速决。
+可比较两种开篇：用强冲突迅速入局，或从人情冷暖与基础需求展开。拆解时记录细腻描写、画面剪辑感和两三章内完成熟悉套路各自起什么作用，是否适合本书。
 
 ---
 
@@ -130,7 +130,7 @@
 
 ### 信息密集型循环（苟在初圣宗）
 
-按"轮回"拆分，每轮回=完整故事。力量体系不崩即可无限拉长。
+按"轮回"拆分，每轮回=完整故事。循环还需要更新目标、冲突或关系，避免只重复力量升级。
 
 ### 直播流循环
 
@@ -171,11 +171,11 @@
 
 | 错误 | 原因 |
 |------|------|
-| 只拆一本对标书 | 至少5本同网站同题材同类型参考 |
+| 用单书概括市场 | 跨作品判断需另取同平台、同题材与同类型样本；单书结论只对本书负责 |
 | 只拆唯一头部爆款 | 头部作品可能依赖不可复制的作者品牌或历史流量，优先选择同平台同题材、数据稳定、非唯一头部的可复制样本 |
 | 跨网站对标 | 不同网站读者群体不同，写法差异大 |
 
-流程：广泛收集同题材样本→定方向→定参考书5-10本→定对标书
+做跨作品比较时，可先收集同题材样本再定对标书；单书拆解不要求凑足参考书。
 
 ---
 
@@ -194,7 +194,7 @@
 - 人物态度转变=最能体现情绪
 - 打斗间穿插反应但控制字数，否则截断节奏
 - 用情绪展示境况（感叹/震惊/窃喜）表现优劣
-- 每个动作段落要带出情绪变化
+- 观察动作段落是否带出情绪变化，以及未变化的段落承担什么作用
 
 ---
 
@@ -208,7 +208,7 @@
 
 ### 循环层次感
 
-同一框架循环时每次内容必须不同（地图/角色/冲突/情感细节更新）。力量体系不崩可无限拉长。
+同一框架循环时每次内容必须不同（地图/角色/冲突/情感细节更新）。力量体系保持一致，同时检查每轮是否新增目标、冲突或关系变化。
 
 ---
 
@@ -217,11 +217,11 @@
 | 题材 | 核心要点 |
 |------|----------|
 | 历史文 | 本质=类同人写法；书名"朝代+开局事件"；核心梗=先知先觉震惊名人+改变历史 |
-| 军事文 | 卖点=煽情+身临系境；核心矛盾=国与国/信仰/意识形态 |
+| 军事文 | 卖点=煽情+身临其境；核心矛盾=国与国/信仰/意识形态 |
 | 种田/脑洞 | 密集小爽点（收藏/能力/面板/震惊）；面板设定要细致 |
 | 直播流 | 目标（确定性预期）+对抗（短平快）+阶段性+爽点写法：先告诉读者打算怎么装逼，再装个更大的 |
 | 两界穿梭 | 书名即卖点；核心梗=在A世界低调用B世界资源；长生凡人流：时间尺度大+配角代际更替 |
-| 重生流 | 天然期待感；前世被辜负→这一世报复；爽点可重复使用每次形式不同；番茄标准=简单直给打标签 |
+| 重生流 | 天然期待感；前世被辜负→这一世报复；爽点可重复使用每次形式不同；若目标样本采用简单直给的标签写法，记录它怎样帮助读者识别卖点，不扩展为整个平台的固定标准 |
 
 ---
 

package/lib/oh-story/skills/story-long-analyze/references/final-checks.md

@@ -1,14 +1,15 @@
 # 收尾检查与维护者回归
 
-全部拆完（或本次要拆的一段拆完）的时刻读本文件的「收尾检查」；「维护者回归」只在改动本 skill 时用。
+全书或本次指定范围拆完后，执行「收尾检查」；「维护者回归」只在改动本 skill 时用。
 
 ## 收尾检查
 
 检查全部通过后，按 [author-facing.md](author-facing.md)「全部拆完」给作者汇报；下面这些检查结果不写进汇报。
 
-- 再运行检查器和计划器；完整项目应 `direct_use`，继续意图应无待处理批次；
-- 对比受保护路径 hash：旧 `章节/`、`剧情/`、`角色/`、`设定/`、`文风.md`、`拆文报告.md` 不得被增强或恢复流程改写；
-- 允许变化的旧项目文件只有 `_progress.md` 受管状态区和 `_analysis_cache/` 新证据；
+- 再运行检查器和计划器；完整项目应 `direct_use`；`continue` 应在本次指定范围内无待处理批次；
+- 完整管道及其续跑确认「文风一句话」已根据 `文风.md` 补齐；单独补旧项目文风时保留已有报告；
+- 对比受保护路径 hash：旧 `章节/`、`剧情/`、`角色/`、`设定/`、`文风.md` 不得被常规增强或恢复流程改写；明确请求重建文风或主报告时，分别按文风协议或 Stage 5 备份规则处理；
+- 常规增强与恢复只补缺失产物、新证据和 `_progress.md` 受管状态区；已有产物的明确重建按各阶段约定处理；
 - 检查旧 `schema_version` 原值；
 - 检查新投影的情节点序列、主题、基调、类型和“涉及”字段能被导入与写作流程读取。
 

package/lib/oh-story/skills/story-long-analyze/references/index-rebuild.md

@@ -2,10 +2,16 @@
 
 `build_chapter_index.py` 因原文变化非零退出，或返回 `chapter_mapping_ambiguous`、`index_would_shrink` 时读本文件；把脚本的 `author_message` 按 [author-facing.md](author-facing.md)「停下来或出错时」转告作者。
 
-同源索引直接复用且不重写。原文变化时先非零退出；人工确认后加 `--rebuild`。重建沿用已有索引的章号口径：已有索引第 1 章是正式章节、而原文开头有楔子/序章/第0章（即上次用了 `--fold-prologue`），自动照样并入，无需再加参数；重建出的前面各章与已有索引对不上（`chapter_mapping_ambiguous:position=N` 或 `index_would_shrink`）时不写索引，返回 `author_message`。追加新章时旧章 hash 保持稳定，输出仅列出新增或内容变化的 `pending_chapters`。改动已拆章节的原文只会让覆盖它的批次缓存失效、下次计划重读该批；已有摘要不刷新——要刷新哪章就删掉哪章的 `章节/第N章_摘要.md` 和覆盖它的 `_analysis_cache/批次-*.md` 再续跑（只删摘要会从缓存原样补回）。旧成果按旧章号命名，写新索引前逐一核对：旧摘要一律参与；黄金三章在 `_progress.md` 来自旧版（有「章节边界」表，或没有运行状态受管区）时参与，本次 Stage 1 按索引写的不参与。有旧版「章节边界」表时逐章定位：起始行正好是某章标题行就直接认定；否则按标题找（统一全半角，去掉章号前缀和「（求收藏）」「【二合一】」这类尾注，允许包含关系；标题只有章号时比章号），多个候选取离旧起始行最近的；全部对上才放行；没有表时，原文首章不是第 1 章就无法确认。对不上时不写索引，返回 `chapter_mapping_ambiguous` 和 `author_message`；`plan` 遇到已建好的错位索引同样拒绝。作者的三个选择：
+原文未变时直接复用索引。原文变化后脚本先非零退出，作者确认继续后再加 `--rebuild`。重建沿用已有索引的章号口径：已有索引第 1 章是正式章节、而原文开头有楔子/序章/第0章（即上次用了 `--fold-prologue`），自动照样并入，无需再加参数；重建出的前面各章与已有索引对不上（`chapter_mapping_ambiguous:position=N` 或 `index_would_shrink`）时不写索引，返回 `author_message`。追加新章时旧章 hash 保持稳定，输出仅列出新增或内容变化的 `pending_chapters`。
 
-1. **按旧章号继续（推荐）**：`build_chapter_index.py ... --fold-prologue`，开头的楔子/序章/引子/前言/第0章并进第一个正式章节，编号回到旧版口径，旧成果原样复用；输出里的 `folded_into_first_chapter` 列出被并入的章节标签（如「楔子」「第0章」）。楔子内容不会单独拆，要在报告「还不确定的地方」说明。
-2. **楔子单独成章**：把除 `原文/` 外所有按旧章号写的产物——`章节/`、`剧情/`、`角色/`、`设定/`、`人物关系图/`、`快速预览.md`、`概要.md`、`拆文报告.md`、`文风.md`、`_analysis_cache/批次-*.md` 和 `_progress.md`——挪进 `_analysis_cache/legacy/旧章号/`（挪走，不删除），再从 Stage 0 按新章号重拆。旧库只拆到黄金三章时代价最小。
+改动已拆章节的原文只会让覆盖它的批次缓存失效、下次计划重读该批；已有摘要不刷新——要刷新哪章就删掉哪章的 `章节/第N章_摘要.md` 和覆盖它的 `_analysis_cache/批次-*.md` 再续跑（只删摘要会从缓存原样补回）。
+
+旧成果按旧章号命名，写新索引前逐一核对：旧摘要一律参与；黄金三章在 `_progress.md` 来自旧版（有「章节边界」表，或没有运行状态受管区）时参与，本次 Stage 1 按索引写的不参与。有旧版「章节边界」表时逐章定位：起始行正好是某章标题行就直接认定；否则按标题找（统一全半角，去掉章号前缀和「（求收藏）」「【二合一】」这类尾注，允许包含关系；标题只有章号时比章号），多个候选取离旧起始行最近的；全部对上才放行；没有表时，原文首章不是第 1 章就无法确认。对不上时不写索引，返回 `chapter_mapping_ambiguous` 和 `author_message`；`plan` 遇到已建好的错位索引同样拒绝。
+
+原文有楔子且旧章号无法对齐时，给作者三个选择；没有楔子时只提供后两项：
+
+1. **按旧章号继续（推荐）**：`build_chapter_index.py ... --fold-prologue`，开头的楔子/序章/引子/前言/第0章并进第一个正式章节，编号回到旧版口径，旧成果原样复用；输出里的 `folded_into_first_chapter` 列出被并入的章节标签（如「楔子」「第0章」）。楔子内容随第一章读取，不单独生成深拆文件；在报告「还不确定的地方」说明章号处理方式。
+2. **按新章号重拆（有楔子时单独成章）**：把除 `原文/` 外所有按旧章号写的产物——`章节/`、`剧情/`、`角色/`、`设定/`、`人物关系图/`、`快速预览.md`、`概要.md`、`拆文报告.md`、`文风.md`、`_analysis_cache/批次-*.md` 和 `_progress.md`——挪进 `_analysis_cache/legacy/旧章号/`（挪走，不删除），再从 Stage 0 按新章号重拆。旧库只拆到黄金三章时代价最小。
 3. **换一个新目录整本重拆**。
 
 `chapter_index.csv` 已按错误口径建好时，先删掉它（纯机械章节表，可随时重建），再按选择重建；`--rebuild` 只沿用已有索引的口径，不能用来改口径。

package/lib/oh-story/skills/story-long-analyze/references/inspiration-library.md

@@ -1,16 +1,16 @@
 # 三层灵感库管道
 
-story-long-analyze 的可选后置管道：把 Stage 3 已抽象好的 EM 机制卡组织成可跨书检索的机制资产。不重新拆文，不写新故事；**单书拆文不自动入库**——只在用户提出「灵感库 / 提炼灵感 / 跨书灵感聚合 / 更新灵感库」时运行。
+story-long-analyze 的可选后置管道：把 Stage 3 已抽象好的 EM 机制卡组织成可跨书检索的资料。不重新拆文，不写新故事；**单书拆文不自动入库**——只在用户提出「灵感库 / 提炼灵感 / 跨书灵感聚合 / 更新灵感库」时运行。
 
 ## 复用优先（第一原则）
 
-机制与案例分析在拆文主管道已完成一次：`剧情/情绪模块.md` 的 EM 卡是机制全文的**唯一维护点**，剧情单元是案例的唯一维护点。本管道只做登记（IA）、单书归并（NM）、跨书聚合与打标（CBA），任何一层都**不复制** EM 卡正文；卡内引用一律用 `书名/EM-xxx` 式裸 ID，需要读原文时按 ID 经 `灵感索引.csv` 回查（或用 `resolve` 子命令），禁止在卡里堆路径链接——`validate` 会机械拒绝。
+机制与案例分析在拆文主管道已完成一次：`剧情/情绪模块.md` 的 EM 卡是机制全文的**唯一维护位置**，剧情单元是案例的唯一维护位置。本管道只做登记（IA）、单书归并（NM）、跨书聚合与打标（CBA），任何一层都**不复制** EM 卡正文；卡内来源引用使用裸 ID；跨书引用带书名前缀，如 `书名/EM-xxx`，需要读原文时按 ID 经 `灵感索引.csv` 回查（或用 `resolve` 子命令），禁止在卡里堆路径链接——`validate` 会机械拒绝。
 
 ## 输入边界
 
 只读：各书 `剧情/情绪模块.md`（EM 完整卡＋其他机制索引）、按 EM 卡「关联节奏/证据来源」定点查证的 `剧情/节奏.md` 与剧情单元、现有 `灵感库/灵感索引.csv` 与 NM/CBA 卡。
 
-**禁止读取 `原文/`、`chapter_index.csv` 与逐章摘要正文。** 一本书没有 `剧情/情绪模块.md` 或完整卡字段不全时，停止并返回 `repair_action`：先用 `--intent enhance` 补跑 Stage 3+（从既有摘要聚合，原文读取可为 0），不得在灵感层代写机制卡。原文追加或局部变化后，主管道 rebuild 并更新 EM 卡，再重跑登记即可（幂等）；`validate` 的 `ia_em_set_mismatch` 会指出未重登记的书。
+**禁止读取 `原文/`、`chapter_index.csv` 与逐章摘要正文。** 一本书没有 `剧情/情绪模块.md` 或完整卡字段不全时，停止并返回 `repair_action`：先用 `--intent enhance` 补跑 Stage 3+（从既有摘要聚合，原文读取可为 0），不得在灵感层代写机制卡。原文追加或局部变化后，先由主管道重建索引、补齐分析，并按请求更新 EM 卡，再重跑登记；`validate` 的 `ia_em_set_mismatch` 会指出未重登记的书。
 
 ## 公共目录
 
@@ -37,13 +37,13 @@ story-long-analyze 的可选后置管道：把 Stage 3 已抽象好的 EM 机制
 
 - 完整卡（读者想看什么/情绪链/戏剧单元/可替换项/不可照搬 五字段齐）登记为 `grade=full`；「其他机制索引」条目登记为 `grade=index`。
 - 五字段缺失报 `em_fields_missing`，字段在而值空报 `em_field_value_empty`（多行值合法：值可写在字段名行之后、下一个字段/标题之前的列表或段落里）。机制字段（标题/读者想看什么/情绪链/戏剧单元/可替换项）的专名检查分两级：本卡「不可照搬」已点名该词却仍在抽象字段使用、或 `可替换项` 写成「专名→任意X」（报 `replaceable_antipattern`），都是高置信真引用，报 `source_specific_name_in_mechanism` error；仅角色卡文件名子串命中而无佐证的降为 `leak_suspect` warning 并列出命中字段，人工复核。都指回 Stage 3 修复；「不可照搬」字段本身例外——点名原书专名正是它的职责。
-- 泄漏门的角色名单取自工作区 `拆文库/{书}/角色/`。工作区从 `--root` 向上探测含 `拆文库/` 的目录，探测不到报 `workspace_not_located`（可加 `--workspace` 显式指定），不得回退空名单静默通过；输出恒带 `character_roster` 数，书目录在而 `角色/` 缺失报 `character_roster_missing` warning，提示人工确认无专名。
+- 专名检查使用的角色名单取自工作区 `拆文库/{书}/角色/`。工作区从 `--root` 向上探测含 `拆文库/` 的目录，探测不到报 `workspace_not_located`（可加 `--workspace` 显式指定），不得回退空名单静默通过；输出恒带 `character_roster` 数，书目录在而 `角色/` 缺失报 `character_roster_missing` warning，提示人工确认无专名。
 - 所有卡的所有问题一次收集报全（`errors` 数组），有任一 error 即整体不写盘。落盘 `剧情/情绪模块.md` 后先用只读的 `check-atoms`（与 register-atoms 同参数）自检：输出卡数、索引数、名单规模与全部问题，不写任何文件。
 - 一次原子写入、重跑逐字节幂等；多本书逐本串行登记，不要并行跑 `register-atoms`。`--module` 必须是 `拆文库/{--book}/` 下的文件（`module_book_mismatch`）；卡头须为 `### EM-xxx 名称`，缺名称报 `em_title_missing`，认不出的 EM 标题行报 `em_header_unrecognized`，同卡重复字段报 `em_field_duplicate`——三者都意味着卡被截断或并进了上一张。本步不得调用模型重新概括机制。
 
 ### 2. 单小说灵感合并
 
-只在一本书内确有 ≥2 张 EM 卡同构时创建 NM；孤立机制不建 NM。卡内容是**合并增量**，机制链不抄写：
+只在一本书内确有 ≥2 张 EM 卡同构时创建 NM；同构须满足触发、情绪链与兑现机制相同，孤立机制不建 NM。卡内容是**合并增量**，机制链不抄写：
 
 ```markdown
 # NM-001：{簇名}
@@ -57,7 +57,7 @@ story-long-analyze 的可选后置管道：把 Stage 3 已抽象好的 EM 机制
 
 ### 3. 跨书灵感聚合
 
-把各书 IA/NM 与现有 CBA 轻量索引比较，只读可能匹配的 active CBA。已建库后的增量先跑只读的 `coverage`：它列出尚未进入任何 active CBA 闭包的原子与现存单书假设卡——聚合比较只对 uncovered 原子做，顺带复核单书假设卡是否因新证据升级为「跨书重复验证」；uncovered 为空即无事可做，不重读已覆盖的 EM 卡。CBA 是**唯一供写作反复读取的卡**，必须自包含跨书归纳的抽象（聚合新产出，不是 EM 原文复制）：
+把各书 IA/NM 与现有 CBA 索引摘要比较，只读可能匹配的 active CBA。已建库后的增量先跑只读的 `coverage`：它列出尚未进入任何 active CBA 闭包的原子与现存单书假设卡——聚合比较只对 uncovered 原子做，顺带复核单书假设卡是否因新证据升级为「跨书重复验证」；uncovered 为空时不再比较已覆盖的 EM 卡；仍复核已有单书假设卡的验证状态。CBA 是**唯一供写作反复读取的卡**，必须自包含跨书归纳的抽象（聚合新产出，不是 EM 原文复制）：
 
 ```markdown
 # CBA-001：{机制名}
@@ -91,7 +91,7 @@ item_id,layer,title,source_book,path,source_ids,novel_count,atom_count,grade,tag
 - IA 行 `path` 为空、`grade` 取 `full/index`；NM/CBA 行 `grade` 留空；IA/NM 的 `tags` 留空，避免写作绕过聚合层。
 - `source_ids` 来源图：IA 行＝单个 `EM-xxx`；NM 行＝同书 ≥2 个 `EM-xxx`（`|` 分隔）；CBA 行＝`书名/EM-xxx` 与 `书名/NM-xxx` 混合列表（必须带书名前缀）。引用 NM 时其成员 EM 自动并入闭包，**不需要也不应该再展开列出**；`novel_count`＝闭包内不同小说数，`atom_count`＝闭包内不同 EM 数。
 - 标签序列化为 `轴=值1|值2；轴=值`。CBA 必填轴：题材、读者需求、情绪、剧情功能、适用阶段、风险；可选轴：关系动作、节奏位置。同义值先归一；不用「好看/有趣/高级」等不可执行词。
-- **标签值受控于库内 `灵感库/标签词表.md`**（每轴一节 `## 轴`、一行一值 `- 值`）：建库首轮聚合把用到的值落盘成首版，此后打标先读词表。扩表走同义判定——候选新值逐一与该轴现有值语义比对，重合或从属就用现有值，确属新维度才追加一行；词表膨胀就是查询失效的前兆。query 命中靠值的精确匹配，写入侧与查询侧共用这一张表。
+- **标签值受控于库内 `灵感库/标签词表.md`**（每轴一节 `## 轴`、一行一值 `- 值`）：建库首轮聚合把用到的值落盘成首版，此后打标先读词表。扩表走同义判定——候选新值逐一与该轴现有值语义比对，重合或从属就用现有值，确属新维度才追加一行；query 命中靠值的精确匹配，写入侧与查询侧共用这一张表。
 - `validate` 校验：表头、ID 前缀、EM↔IA 集合一致、NM/CBA 闭包与计数、必填标签轴、单书 active CBA ≤3、验证状态标记、**卡内无路径引用**；词表存在时另拒表外值（`tag_value_not_in_vocabulary`）与缺必填轴的词表（`vocabulary_axis_missing`）——词表缺失时这两项不查（旧库兼容），应尽快补建；同义值靠扩表时的人工比对，不做机械子串判定。列数不对的索引行报 `column_count_mismatch`。
 - `query --tag 轴=值 …` 只筛 `layer=跨书灵感聚合` 且 `status=active`，核心轴（题材/读者需求/情绪/剧情功能/适用阶段）2 分、其余 1 分，无核心轴命中不返回，按分数/来源数/ID 稳定排序取 Top 3–8。返回值另带 `unmatched_tags`（请求值在全库该轴零出现）与 `axis_inventory`（所查各轴现存值）：零命中先按它们纠词重查一次，仍零命中才算「库里没有」。
 - `resolve --ref 书名/EM-xxx --ref CBA-001` 把裸 ID 解析为可读位置——需要时才查，不预先展开进任何卡。

package/lib/oh-story/skills/story-long-analyze/references/pipeline-ops.md

@@ -2,7 +2,7 @@
 
 ## 唯一状态与三个脚本
 
-生产运行只使用：
+拆文运行使用三个脚本：
 
 1. `build_chapter_index.py`：建立机械章界和逐章原文 hash；
 2. `inspect_existing_assets.py`：只读识别旧成果、当前成果、缺章和修复阶段；
@@ -12,7 +12,7 @@ Stage 4 另用 `render_relation_chart.py` 从 `角色/角色关系.md` 生成人
 
 脚本输出只给你看。失败或需要作者决定时，脚本会带 `author_message`（大白话说明和选项），按 [author-facing.md](author-facing.md) 转述给作者；不要把 JSON、错误码或下文的分类、路径名原样贴给作者。
 
-`chapter_index.csv` 是机械章节边界唯一真源。批次和阶段状态只写在 `_progress.md` 的
+`chapter_index.csv` 是机械章节边界的唯一依据。批次和阶段状态只写在 `_progress.md` 的
 `story-long-analyze:runtime-state` 受管区。`_analysis_cache/` 保存完整结果和恢复证据，不承担状态库功能。
 
 既有项目中的 `schema_version: 2` 沿用且不修改；该值只供报告，不用于否定旧成果。`_progress.md` 不再保存机械章节边界镜像。
@@ -36,12 +36,11 @@ Stage 4 另用 `render_relation_chart.py` 从 `角色/角色关系.md` 生成人
 - 完整旧项目：`direct_use`，不建索引、不读原文。
 - 部分项目：精确报告 `missing_semantic_chapters` 与 `missing_summary_chapters`。
 - 新旧投影混存：`mixed_sources: true` 并列明逐章来源，仍可直接使用完整项目。
-- `schema_version` 只报告，不参与否定旧项目，也不在检查或复用时改写。
 - `stage_repairs` 中的情绪、节奏和文风修复与 Stage 2 缺章分开处理。
 
 ## 2. 需要原文时建立或校验索引
 
-完整旧成果默认直接使用和纯旧成果增强无需索引。全新或部分完成才运行：
+完整旧成果默认直接使用和纯旧成果增强无需索引。全新或部分完成且仍需读取原文时运行；只补文风时按文风协议单独建索引：
 
 ```text
 "{PYTHON}" "{story-long-analyze skill 根}/scripts/build_chapter_index.py" \
@@ -69,11 +68,11 @@ Stage 4 另用 `render_relation_chart.py` 从 `角色/角色关系.md` 生成人
 
 没有“整本重拆”意图：已有摘要永不覆盖。整本重拆就换一个新目录重新拆。
 
-逐批派发时加 `--next 1` 只取下一批，确认进度用 `--next 0` 只看 `remaining_batches` 与压缩成区间的 `summary_gaps`；全量计划每批约五百字符，整本书反复全量输出会白占主会话上下文。不带 `--next` 时输出全部批次。
+逐批派发时加 `--next 1` 只取下一批，确认进度用 `--next 0` 只看 `remaining_batches` 与压缩成区间的 `summary_gaps`；全量计划每批约五百字符，整本书反复全量输出会占用主会话上下文。不带 `--next` 时输出全部批次。
 
 作者只要拆某一段时加 `--chapters 起-止`（可与 `--next` 同用）：只规划这段里的批次，`remaining_batches` 只数这段，`summary_gaps` 仍是全书。这段拆完即停，不标 `stage2`；按 author-facing「全部拆完」只汇报这一段，再问作者是否接着拆其余章节。
 
-计划只存在内存和标准输出，`state_written` 必须为 `false`。每块最多 3 章、25,000 字符，同一章不能出现在两个原文块；计划原文读取数为 0 时不得派发原文任务；批次 ID 直接使用章节范围。`RAW` 只覆盖缺失章和缓存失效批次，`REUSE` 只读取计划列出的旧成果。黄金三章深拆属于已有语义成果，可以生成缺失摘要，无需再次读取前三章原文。
+计划只存在内存和标准输出，`state_written` 必须为 `false`。每块最多 3 章、25,000 字符，单个超长章允许独占；同一章不能出现在两个原文块；计划原文读取数为 0 时不得派发原文任务；批次 ID 直接使用章节范围。`RAW` 只覆盖缺失章和缓存失效批次，`REUSE` 只读取计划列出的旧成果。黄金三章深拆属于已有语义成果，可以生成缺失摘要，无需再次读取前三章原文。
 
 ## 4. 执行与提交一个批次
 
@@ -81,7 +80,7 @@ Stage 4 另用 `render_relation_chart.py` 从 `角色/角色关系.md` 生成人
 
 - `batch_id`、`input_kind`；
 - `source_files`（原文块是逐章 `source_locator`，子代理自己按行号读原文）、`chapter_chars`（每章字数）和 `min_plot_points`（每章情节点下限，按字数算好）；
-- `input_file`：输出文件 `_analysis_cache/输入-{批次ID}.md`（不写系统 `/tmp`：Windows 没有，多本书同批号会互相覆盖）；
+- `input_file`：子代理的输出路径 `_analysis_cache/输入-{批次ID}.md`，每本书保存在各自拆文目录中；
 - `handoff_cache`：交接缓存，计划算好的「本批起章之前最近的已提交批次」，为空就不给；子代理只读其中 `### 跨批状态`。
 
 子代理把完整输出写进输出文件，只回一行 `BATCH_WRITTEN` 回执。主会话**不 Read 这份输入文件**，直接提交；提交被拒时重新派发同一批：上面的字段原样再给一遍（子代理补内容要按 `source_locator` 回看原文、按 `min_plot_points` 补情节点），再附错误码，让它用 Edit 只改出错处后再提交（结构整体错乱才整份重写）。提交成功后删掉这份输入。不论哪种派发方式，`commit` 都由主会话逐个执行，不并发跑。
@@ -89,8 +88,8 @@ Stage 4 另用 `render_relation_chart.py` 从 `角色/角色关系.md` 生成人
 **派发方式**：默认第 2 档有限并行，不请作者在三档里选。作者问起能不能更快或更稳、或明确要求时，才按 author-facing「作者问起怎么拆」用白话解释并切换。三档都用计划给的 `handoff_cache`，它随提交进度自动落到对应的批次上。
 
 1. **串行**：上一批提交成功再派下一批，交接缓存就是紧邻的前一批。优点：剧情点、未决悬念和已确认别名逐批完整接续，Stage 3 合并最省事。缺点：最慢，墙钟时间随批数线性增长。
-2. **有限并行**：每轮同时派 3 批，同轮的交接缓存都是本轮开始前最近一个已提交批次；整轮提交完再派下一轮。优点：约快两到三倍，接续最多滞后一轮。缺点：同轮批次互相看不到对方新建的剧情点与别名，边界处可能重复建 ID，靠 Stage 3 跨块合并收拢。
-3. **不限批次顺序**：不等前批，同时在跑的子代理最多 12 个（宿主或账号上限更低时以环境为准）；在跑的少于上限一半时，补派到上限。补派用 `plan --next {在跑数＋补派数}`，跳过已在跑的批次号（计划只认已提交）。遇到限流、超时或子代理报错，把上限减半后再补派。优点：最快。缺点：接续最弱，剧情点与别名最依赖 Stage 3 跨块合并和 Stage 4 归并；并发越高，被限流、整批重跑的风险越大。
+2. **有限并行**：每轮同时派 3 批，同轮的交接缓存都是本轮开始前最近一个已提交批次；整轮提交完再派下一轮。优点：并发执行可减少等待，接续最多滞后一轮。缺点：同轮批次互相看不到对方新建的剧情点与别名，边界处可能重复建 ID，靠 Stage 3 跨块合并。
+3. **不限批次顺序**：不等前批，同时在跑的子代理最多 12 个（宿主或账号上限更低时以环境为准）；在跑的少于上限一半时，补派到上限。补派用 `plan --next {在跑数＋补派数}`，跳过已在跑的批次号（计划只认已提交）。遇到限流、超时或子代理报错，把上限减半后再补派。优点：可同时处理更多批次。缺点：接续最弱，剧情点与别名最依赖 Stage 3 跨块合并和 Stage 4 归并；并发越高，被限流、整批重跑的风险越大。
 
 作者没提、要求一次拆完 / 全量拆、多本书一起拆，或由 story-import 自动续跑时，都按第 2 档；第 1、3 档只在作者明确选择时使用。多本书同拆时按书轮流派，第 3 档的总并发也不超过同一上限。第 1、2 档用 `plan --next 1` / `--next 3` 取批。子代理不可用时主会话自己写批次：先读 [stage2-extraction.md](stage2-extraction.md)，提取规则与包裹标记照其中「批次提交格式」：
 

package/lib/oh-story/skills/story-long-analyze/references/semantic-acceptance-fixtures.md

@@ -1,6 +1,6 @@
 # 长篇拆文语义验收样例
 
-这些短文本为本项目自有合成样例，用于 review 和联合测试。每章只有一两句，过不了原文块每章 10 个情节点的提交下限，所以只用于 Stage 3+ 与模型语义评估：测试时让对应 Stage 处理原文，再按“应识别的关系”评估；不得仅以关键词或栏目存在判通过。
+这些短文本为本项目自有合成样例，用于审查和联合测试。这些样例只用于语义评估，不走生产批次提交：直接向待评估模型提供样例文本及分析要求，再按“应识别的关系”评分；不得仅以关键词或栏目存在判通过。
 
 ## 样例一：事件与多次披露
 
@@ -51,7 +51,7 @@
 
 ### 应识别的关系
 
-- 原机制不是抽象的“先压后扬”，而是公开质疑 → 可独立验证的旧证据 → 权威受先前承诺约束 → 公开纠错。
+- 原机制为公开质疑 → 可独立验证的旧证据 → 权威受先前承诺约束 → 公开纠错；“先压后扬”不足以说明成立条件。
 - 成立条件包括核账惯例、多人独立封存、师徒关系仍承认程序、见证者有表达空间。
 - 可替换的是行业、证据载体和具体诬陷；不可随意删掉独立验证与权威自我约束。
 - 变体失效源于证据控制和关系权力不同，不应硬套同一兑现。

package/lib/oh-story/skills/story-long-analyze/references/stage1-golden-chapters.md

@@ -2,9 +2,9 @@
 
 开头时刻（Phase 1 到 Stage 1 停下来问）读本文件。作者读到的 `快速预览.md` 与停下来问的话术见 [author-facing.md](author-facing.md)。
 
-## Stage 0 概要（thin first-pass）
+## Stage 0 概要（概要初稿）
 
-> **范围说明**：Stage 0 只能基于章节标题 + 卷段结构 + 抽样开头/结尾产出 thin first-pass（~200 字）。**禁止**在此阶段写出 500-1000 字 plot-aware 概要——读取范围不足以支撑那个密度。完整版在 Stage 5 落盘覆盖（见 [stage5-report.md](stage5-report.md)「完整概要」）。
+Stage 0 只能基于章节标题 + 卷段结构 + 抽样开头/结尾产出 概要初稿（~200 字）。**禁止**在此阶段写出 500-1000 字 包含主要剧情与因果的 概要——读取范围不足以支撑那个密度。完整版在 Stage 5 落盘覆盖（见 [stage5-report.md](stage5-report.md)「完整概要」）。
 
 输出 `概要.md`：总字数{X}万 | 总章数{N} | 题材{类型}
 
@@ -12,16 +12,16 @@
 |-------|----------|------|----------|
 | {卷名} | 第1-X章 | {N} | {W}万 |
 
-首版概要（~200字，thin first-pass）：{从章节标题 + 第1章+末章抽样归纳出的核心驱动 + 主角名 + 大致设定，不要硬凑剧情转折}
+首版概要（~200字，概要初稿）：{从章节标题 + 第1章+末章抽样归纳出的核心驱动 + 主角名 + 大致设定，不要硬凑剧情转折}
 章节索引：| 章节 | 标题 | 字数 |
 
-> Stage 5 完成后会就地覆盖此文件的「首版概要」段为「全书概要（500-1000字 plot-aware）」。章节索引和卷段表保留不变。
+> Stage 5 完成后会就地覆盖此文件的「首版概要」段为「全书概要（500-1000字 包含主要剧情与因果的）」。章节索引和卷段表保留不变。
 
 ## Stage 1 黄金三章
 
 黄金三章拆为三个单章文件，每章一个：`章节/第1章_深度拆解.md`、`章节/第2章_深度拆解.md`、`章节/第3章_深度拆解.md`。每个文件按以下模板输出。
 
-字数约{X}字 | 核心事件：{一句话}
+字数约{X}字 | 核心事件：{一句话}；原文不足三章时只拆已有章节，不补造缺章。
 
 **开篇钩子**（第1章看前500字）：类型{悬念/冲突/反差/信息差/代入感} | 手法{描述} | 效果{强/中/弱}—{原因}
 
@@ -42,7 +42,7 @@
 | 强者重评 | | | |
 | 扩散传播 | | | |
 
-反应篇幅比{N:1} — 低于1.5 = 爽感不足
+反应篇幅比{N:1}，分母为实力展示篇幅；低于1.5时检查反应是否充分承接爽感
 
 **释放后追证**（如有）：爽点释放后反派真实态度？{行为+原文引用}
 
@@ -101,11 +101,11 @@ Stage 1 停靠点交付物 `拆文库/{书名}/快速预览.md`，模板见 [aut
 
 三层微观循环：
 - **铺垫层（蓄势）**：压抑/困境/信息差制造情绪缺口
-- **释放层（爽感）**：展露实力/打脸/碾压，强度由反应层数和篇幅决定
+- **释放层（爽感）**：展露实力/打脸/碾压，强度结合兑现结果、反应层递进与篇幅判断
 - **衔接层（承转）**：旧循环结束埋新钩子
 
 反应层递进：质疑/轻视 → 震惊/打脸 → 强者重新评价 → 扩散效应
-反应篇幅比 = 反应总字数 / 装逼字数。低于1.5 = 爽感没接住。
+反应篇幅比 = 反应总字数 / 实力展示字数。1.5 是复核反应层的经验参照，最终结合具体反应与题材判断。
 
 ### 衔接过渡模式
 

package/lib/oh-story/skills/story-long-analyze/references/stage2-extraction.md

@@ -53,7 +53,7 @@
 
 ### D. 兼容逐章资料
 
-逐章投影只保留现有导入、写作与查询实际使用的内容：概要、关键事件、因果、局面结果、涉及、信息变化、状态变化、三维节奏、章尾钩子、证据和情节点序列（逐点带基调）。取消逐章重复的长篇写法公式、角色复述和扩写技法长表。写法机制、信息差、关系与节奏集中在剧情点及 Stage 3 权威产物中。
+逐章投影只保留现有导入、写作与查询实际使用的内容：概要、关键事件、因果、局面结果、涉及、信息变化、状态变化、三维节奏、章尾钩子、证据和情节点序列（逐点带基调）。逐章不重复写长篇写法公式、人物小传和扩写技法长表。写法机制、信息差、关系与节奏集中在剧情点及 Stage 3 权威产物中。
 
 ### E. 跨章观察
 
@@ -86,10 +86,10 @@
 
 ## 分块与主会话串行
 
-Stage 2 按运行计划分别建立旧成果批次和缺章原文块，每批调用一次 chapter-extractor；原文块同次返回逐章事实和跨章观察，旧成果批次只返回跨章观察。其他阶段只消费这些结果和可复用旧资料。
+Stage 2 按运行计划分别建立旧成果批次和缺章原文块，每批调用一次 chapter-extractor；原文块返回逐章事实和跨章观察，旧成果批次返回跨章观察，缺摘要时另补紧凑章块。其他阶段消费这些结果和可复用旧资料。
 
-> **先分清两个互不相干的轴**（混在一个「块」字里会让 >500 章出现差 30-100 倍的两套规格）：
-> - **语义分块**＝*在哪里切*。按叙事弧切，产出「块元数据」用于组织分析结果，块可以很大（一个 914 章的书通常 5-10 个弧）。它不决定一次读多少。
+> **区分语义分块与处理批次**：
+> - **语义分块**＝*在哪里切*。按叙事弧切，产出「块元数据」用于组织分析结果，块可以很大。它不决定一次读多少。
 > - **处理批次**＝*一次读多少*。受上下文容量约束，原文块按索引字数切分，旧成果批次按资料体积切分。下表指的是**处理批次**。
 
 | 单章与上下文情况 | 读取批次策略 | 常见章数 |
@@ -113,7 +113,7 @@ Stage 2 按运行计划分别建立旧成果批次和缺章原文块，每批调
 
 ## 输出模板
 
-Stage 2 有两种互斥输入。`raw-original` 只处理运行计划列出的未拆章节块；`existing-results` 只读取旧成果做二次提取。两种结果都形成批次剧情点，只有 `raw-original` 生成新的逐章兼容投影。
+Stage 2 有两种互斥输入。`raw-original` 只处理计划列出的未拆章节块；`existing-results` 只从旧成果二次提取。两者都形成批次剧情点，并按缺口补摘要：前者提取原文，后者投影旧成果。
 
 ### 未拆章节的紧凑语义结果
 
@@ -157,7 +157,7 @@ P{序号+1} ……
 **情节点**是逐章事件序列，下游对标挑章、结构关键点定位和导入反推情绪弧线都按它读：
 
 - 原文块每章一般 10–20 个，按字数调节，最多 30；下限是计划给的 `min_plot_points`（字数÷200 四舍五入，至少 1、至多 10）；旧成果补摘要下限 1 个，按旧资料写到的事件拆，不凑数；编号从 P1 连续。太粗（整段打架）丢细节，太细（举起右手）碎片化，恰当粒度是一个完整戏剧事件。
-- 严格按原文事件时间顺序，不重排、不归纳。标题 ≤15 字，不与白描同句。
+- 按文本披露顺序排列，不把倒叙或回忆移到故事内发生时间的位置；客观发生顺序另记在跨章观察中。标题 ≤15 字，不与白描同句。
 - 白描只写可见事实：不替角色补原文没写的情感、意图，不写“精彩”“气氛紧张”这类评价，不用“通过对话得知”这类叙事框架词；原文明说的起因和内心活动照写。
 - 字段名后不加冒号；`主题标签` 只填一个值；每个情节点紧跟自己的 `主题标签X | 基调：Y` 行，`基调：` 用全角冒号。
 - 引用只给关键转折、关键台词、写法样本，每章至多 8 条，其余情节点不写引用行。
@@ -222,8 +222,8 @@ P{序号+1} ……
 
 ### 已有成果二次提取
 
-`existing-results` 的证据只指向只读计划列出的旧成果文件。完整旧项目增强时用 `<!-- REUSED_CHAPTERS:{起章}-{止章} -->` 声明覆盖，只写批次剧情点及关联观察。计划列出的摘要缺口落在本批时，必须为本批每章从黄金三章生成同一紧凑章块（情节点至少 1 个），否则摘要永远补不上；提交脚本只补缺失文件。旧资料没有的字段写“旧资料未提供”。
+`existing-results` 的证据只指向只读计划列出的旧成果文件。完整旧项目增强时用 `<!-- REUSED_CHAPTERS:{起章}-{止章} -->` 声明覆盖，只写批次剧情点及关联观察。计划列出的摘要缺口落在本批时，必须为本批每章从计划列出的摘要或黄金三章生成同一紧凑章块（情节点至少 1 个），否则摘要永远补不上；提交脚本只补缺失文件。旧资料没有的字段写“旧资料未提供”。
 
-每个成功批次由 `manage_analysis_run.py commit` 先写完整缓存、再补缺失摘要、最后写 `_progress.md` 状态行。没有逐文件收据、checkpoint 账本或 Stage receipt。
+每个成功批次由 `manage_analysis_run.py commit` 先写完整缓存、再补缺失摘要、最后写 `_progress.md` 状态行。
 
-**Stage 2 输出自检**：输入模式与 `manage_analysis_run.py plan` 的内存计划一致｜原文章节块连续、不重叠且不超过3章/25,000字符｜已有成果模式没有读取原文｜每章紧凑字段完整｜情节点不少于 `min_plot_points`、最多 30、按时序、白描客观｜剧情点包含因果与得失｜只保留关键事件/披露候选｜三维节奏分别解释｜跨批状态可继续。
+**Stage 2 输出自检**：输入模式与 `manage_analysis_run.py plan` 的内存计划一致｜原文章节块连续、不重叠且不超过3章/25,000字符（单个超长章可独占）｜已有成果模式没有读取原文｜每章紧凑字段完整｜情节点不少于 `min_plot_points`、最多 30、按文本披露顺序、白描客观｜剧情点包含因果与得失｜只保留关键事件/披露候选｜三维节奏分别解释｜跨批状态可继续。