@oh-story/dsh 0.1.0

package/lib/oh-story/skills/story-long-analyze/references/output-templates.md

@@ -0,0 +1,559 @@
+# 拆文输出模板
+按需加载，配合 SKILL.md 和 material-decomposition.md 使用。
+
+本文件按 story-long-analyze 唯一管道的阶段编号组织：Stage 0-5 各阶段输出模板 + 停靠点「快速预览报告」模板 + 跨阶段通用速查。
+
+---
+
+## 通用速查
+
+### 爽点类型
+
+| 类型 | 定义 | 例子 |
+|------|------|------|
+| 装逼打脸 | 实力碾压被轻视的人 | 「你也配？」 |
+| 逆袭反转 | 绝境翻盘 | 废材觉醒 |
+| 获得机缘 | 得到别人没有的 | 捡到神器 |
+| 信息差碾压 | 读者和主角知道别人不知道的 | 重生先知优势 |
+| 情感满足 | 人物关系发展 | 告白/团聚/认可 |
+| 扮猪吃虎 | 隐藏实力突然展露 | 弱者实则是强者 |
+
+### 钩子类型
+
+| 类型 | 定义 | 示例 |
+|------|------|------|
+| 悬念钩 | 未解之谜 | 「剑为什么认他为主？」 |
+| 冲突钩 | 直接对抗 | 开篇追杀 |
+| 反差钩 | 违反常识 | 「穿越第一天就破产」 |
+| 代入钩 | 读者共鸣 | 相似困境 |
+| 信息差钩 | 读者知道角色不知道的 | 「他还不知道面前是……」 |
+
+### 爽点循环结构
+
+三层微观循环：
+- **铺垫层（蓄势）**：压抑/困境/信息差制造情绪缺口
+- **释放层（爽感）**：展露实力/打脸/碾压，强度由反应层数和篇幅决定
+- **衔接层（承转）**：旧循环结束埋新钩子
+
+反应层递进：质疑/轻视 → 震惊/打脸 → 强者重新评价 → 扩散效应
+反应篇幅比 = 反应总字数 / 装逼字数。低于1.5 = 爽感没接住。
+
+### 衔接过渡模式
+
+| 模式 | 机制 | 示例 |
+|------|------|------|
+| 打完小的来大的 | 释放层对手引出更强对手 | 打败弟子→师父找上门 |
+| 胜利发现隐患 | 释放成功暴露新问题 | 赢了比赛→发现中毒 |
+| 身份暴露/反转 | 释放中身份被识破 | 打脸后被认出真实身份 |
+| 利益升级 | 成果指向更大目标 | 线索→更深层宝藏 |
+| 关系突变 | 释放改变关系格局 | 救的人变仇家后代 |
+
+### 题材爽点形态
+
+| 题材 | 释放层形态 | 反应层来源 | 铺垫层缺口 |
+|------|-----------|-----------|-----------|
+| 玄幻/修仙 | 实力碾压/境界突破 | 同门/对手/长老震惊 | 功法残缺/资源匮乏/血脉压制 |
+| 都市 | 预测准确/身份揭露 | 商业对手/前女友/权贵 | 破产/被辞/被退婚 |
+| 系统文 | 解锁稀有技能/任务奖励 | 系统稀有度标注 | 任务失败惩罚/技能冷却 |
+| 历史 | 以弱胜强/先知优势 | 谋士/帝王/敌将震惊 | 信息不对称/身份低微 |
+| 悬疑 | 真相揭露/反杀 | 被揭穿者崩溃/读者恍然 | 线索误导/嫌疑人洗白 |
+
+---
+
+## 快速预览报告
+
+Stage 1 停靠点交付物，输出 `拆文库/{书名}/快速预览.md`。**字段全部取自 Stage 0/1 已产出数据**（概要.md + 黄金三章深度拆解），不引入需 Stage 2-6 才能算出的字段。与终态 `拆文报告.md` 向上兼容——「基本信息」「黄金三章评分」两节同名同结构，全量拆完后 `拆文报告.md` 是 `快速预览.md` 的超集。
+
+```markdown
+# 快速预览：{书名}
+
+> 基于黄金三章 + 全书概要的早期判断。完整拆解见后续 Stage 2-6。
+> 状态：已完成 Stage 0-1，{已暂停 / 已继续全量拆解}
+
+## 基本信息
+
+书名 | 题材 | 总章数 | 总字数 | 目标平台（源书所在平台，拆解时识别，无则留空）
+
+## 黄金三章评分
+
+直接复用 Stage 1 三章深度拆解结论，5 维评分表：
+
+| 维度 | 评分 | 说明 |
+|------|------|------|
+| 开篇钩子 | 1-5 | |
+| 主角塑造 | 1-5 | |
+| 爽点设计 | 1-5 | |
+| 世界观铺设 | 1-5 | |
+| 章尾悬念 | 1-5 | |
+
+## 开篇判断
+
+- 开篇钩子类型与效果（来自 Stage 1 第1章「开篇钩子」）
+- 主角立人设手法
+- 世界观铺设方式
+- 黄金三章节奏：三章各自功能
+
+## 早期可借鉴点
+
+来自 Stage 1 各章「可借鉴要素」的汇总，3-5 条。
+
+## 是否值得全量拆解 — 建议
+
+一句话结论：基于黄金三章质量，建议{继续全量拆解 / 重点拆解某部分 / 此书参考价值有限}。
+
+## 下一步
+
+继续全量拆解将产出：逐章摘要、剧情聚合、角色档案、世界观设定、完整拆文报告。
+```
+
+> `快速预览.md` 与 `拆文报告.md` 并存：前者是停靠点快照，后者是终态。终态生成后不删除 `快速预览.md`，保留早期判断痕迹。
+
+---
+
+## Stage 0 概要（thin first-pass）
+
+> **范围说明**：Stage 0 只能基于章节标题 + 卷段结构 + 抽样开头/结尾产出 thin first-pass（~200 字）。**禁止**在此阶段写出 500-1000 字 plot-aware 概要——读取范围不足以支撑那个密度。完整版在 Stage 5 落盘覆盖（见本文件「Stage 5 拆文报告 + 全书概要」节）。
+
+输出 `概要.md`：总字数{X}万 | 总章数{N} | 题材{类型}
+
+| 卷/段 | 章节范围 | 章数 | 预估字数 |
+|-------|----------|------|----------|
+| {卷名} | 第1-X章 | {N} | {W}万 |
+
+首版概要（~200字，thin first-pass）：{从章节标题 + 第1章+末章抽样归纳出的核心驱动 + 主角名 + 大致设定，不要硬凑剧情转折}
+章节索引：| 章节 | 标题 | 字数 |
+
+> Stage 5 完成后会就地覆盖此文件的「首版概要」段为「全书概要（500-1000字 plot-aware）」。章节索引和卷段表保留不变。
+
+## Stage 1 黄金三章
+
+黄金三章拆为三个单章文件，每章一个：`章节/第1章_深度拆解.md`、`章节/第2章_深度拆解.md`、`章节/第3章_深度拆解.md`。每个文件按以下模板输出。
+
+字数约{X}字 | 核心事件：{一句话}
+
+**开篇钩子**（第1章看前500字）：类型{悬念/冲突/反差/信息差/代入感} | 手法{描述} | 效果{强/中/弱}—{原因}
+
+**人物出场**：{列表} | 主角塑造{直接描写/对话/行为/他人评价} | 第一印象{描述}
+
+**世界观铺设**：透露{信息} | 隐藏{信息} | 方式{对话/旁白/事件}
+
+**结构拆解**：| 段落范围 | 功能{铺垫/冲突/爽点/收尾} | 字数 |
+
+**爽点分析**：类型{装逼打脸/逆袭反转/获得机缘/信息差碾压/情感满足} | 铺垫{X}字 / 释放{Y}字 / 铺放比{Z:1} | 情绪曲线
+
+**反应层拆解**（如有）：
+
+| 层级 | 角色 | 反应 | 篇幅 |
+|------|------|------|------|
+| 质疑/轻视 | | | |
+| 震惊/打脸 | | | |
+| 强者重评 | | | |
+| 扩散传播 | | | |
+
+反应篇幅比{N:1} — 低于1.5 = 爽感不足
+
+**释放后追证**（如有）：爽点释放后反派真实态度？{行为+原文引用}
+
+**冲突升级**（如有）：{行为} | 升级层级{口头→经济→暴力} | 对角色画像影响
+
+**背景信息揭示**（如有）：揭示{什么} | 叙事功能{推翻预设/重新解读/铺垫新线/认知偏差} | 对主线影响
+
+**章尾钩子**：类型{悬念/反转/新信息/新角色} | 内容{描述} | 期待度{强/中/弱}
+
+**可借鉴要素**：{可复用技巧}
+
+> 第二、三章额外关注：信息密度 / 冲突升级(vs上章) / 节奏变化 / 爽点间隔字数。
+> 反派若为非人形（灵气复苏/末世/国运等抽象对抗型），在「爽点分析」处改用抽象对抗型路由：核心对抗面{描述} | 紧迫感来源{描述} | 升级机制{描述} | 叙事替代{用什么替代传统打脸}。
+
+## Stage 2 章节摘要+情节点
+
+输出 `章节/第{N}章_摘要.md`：
+
+**概要**：{100-300字，写成单行的一个自然段，不折行、不拆条目。按事件发生的顺序连贯讲清本章发生了什么、为什么发生、结果如何。因果照实写，但不靠"因为…所以…"这类同一连接词反复串联。优先写进：改变剧情走向的动作与结果、反常信息、会延续到后续章节的伏笔线索、有辨识度的具体细节（数字、原话、反常现象）。只写本章原文有的事实，不加空泛评价（如"感人""精彩""震撼"）和主观解读}
+**关键事件**：1.{事件} 2.{事件} 3.{事件}
+
+**关键信息与扩写技法**：
+
+| 关键信息/剧情走向 | 原文如何扩写 | 扩写技法 | 对读者情绪的作用 | 可复用提醒 |
+|---|---|---|---|---|
+| {本章必须让读者知道/误判/期待/确认的信息} | {作者用了哪些事件、对话、反应层、细节、误导或回扣把它扩成场景} | {铺垫后置/反应层放大/信息差/对比锚点/延迟揭示/身体反应/小目标嵌套/其他} | {好奇/期待/压抑/爽/心疼/紧张/甜/热血/其他} | {保留情绪逻辑，替换人物、场景、事件素材；禁止照搬具体桥段} |
+
+**逐章写法公式**：
+
+- **情绪流向**：起：{开篇情绪} → 承：{铺垫/加压情绪} → 转：{爆发/反转情绪} → 合：{余波/钩子情绪}
+- **节奏配比**：慢铺垫 {X%} / 快冲突 {X%} / 爽点爆发 {X%} / 悬念留白 {X%}
+- **本章结构公式**：{节点1动作（目的）} + {节点2动作（目的）} + {节点3动作（目的）} + {节点4动作（目的）}
+- **本章核心技巧**：{一句话概括本章最可迁移的结构手法，如用反应层放大信息差、用小目标承接大矛盾；只描述写法，不评价质量}
+- **卡点与伏笔**：结尾卡点：{类型+内容+下章期待}；埋设/回收伏笔：{伏笔名/物件/信息 → 章节功能}
+
+**出场人物**：| 角色 | 本章重要性 | 别名 | 本章表现 |
+
+**情节点**（每章10-40个，按字数动态调节，150-200字/个；硬下限10——短章按关键步骤拆足）：
+
+太粗（整段打架）→丢细节；太细（举起右手）→碎片化。恰当：完整戏剧事件（"主角三招击败反派，围观者震惊"）。
+
+P{序号} **{标题}**：类型{转折点/信息揭示/冲突/解决/铺垫/行动/对话/状态变化} | {白描一句话：谁做了什么、结果如何；原文给出起因或理由的一并写进来，不推测动机；埋伏笔的写出伏笔线索} | 涉及{全名，多人逗号分隔；纯环境铺垫无具体人物时保留"涉及"标签、值留空} | 地点{如明确} | 物品{如涉及} | 时间{如明确}
+
+> 标题是 ≤15 字的短标签（如「衙门见闻」「龙血针检测」），白描才是承载事实的那一句。两者不要写成同一句话——标题复述一遍不算白描。
+
+{可选引用行：≤400字原文直接引用，不加“原文引用：”标签。只给关键情节点加，挑选标准见下；不选中的情节点直接跳到下一行}
+主题标签{爱情/亲情/友情/权力/金钱/成长/复仇/悬念/搞笑/热血/日常/其他} | 基调：{紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他}
+
+> **`{}` 是占位标记，不是要输出的字符**：上面每个 `{...}` 都表示「把内容填在这里」，`/` 是候选项之间的分隔号。落盘文本里不应出现花括号，也不应把候选项列表原样抄下来。照抄成 `类型{行动}`、`主题标签{搞笑}`、`地点{未明确}` 都是错的。
+>
+> 一个完整的正确样例（照这个写，两行为一组）：
+>
+> ```
+> P7 **龙血针检测**：类型信息揭示 | 许七安用龙血针验出对方身份，当场揭穿 | 涉及许七安,郑兴怀 | 地点府衙后堂 | 物品龙血针 | 时间入夜
+> 主题标签悬念 | 基调：紧张
+> ```
+>
+> - **字段名后不加冒号、不加括号**：写 `类型信息揭示`，不写 `类型：信息揭示` 或 `类型{信息揭示}`。
+> - **`主题标签` 只填一个值**：本章该情节点最主导的那一个。不要用 `/`、`、`、`，` 或空格并列多个——落盘校验按「一个值」读，并列写法会被判成枚举越界而触发重跑。
+> - **空字段统一写「无」**：如 `物品无`、`时间无`。不要用 `—`、`未知`，也不要整段省略（`涉及` 段必须保留，纯环境铺垫时值写「无」）。
+> - **每个情节点后紧跟自己的那一行 `主题标签X | 基调：Y`**，不要把所有标签行堆到文件末尾，也不要把它并进 P 行内部。
+>
+> 末行硬约束：`基调：` 全角冒号不可省略（Stage 6 文风按它 grep）；`主题标签` 不加冒号；两者各取上列枚举、勿混（温馨/紧张/甜是基调、非主题）；都不贴合用「其他」。
+>
+> 枚举消歧：爽=打脸/复仇得手/反转的解气感；热血=拼搏战斗的燃；甜=恋爱暧昧的甜；温馨=亲情/友情的暖；恐怖=惊悚诡异/生理恐惧；紧张=危机悬而未决。主题里，亲情=家人/师徒/类亲情；爱情=恋爱；友情=朋友/伙伴/兄弟；金钱=财富/利益/算计；权力=地位/权势。都不贴合才用「其他」，勿硬塞近义项。
+
+**白描铁律**（P 行的白描是情节点的主要证据，写不准下游全歪）：
+
+| 维度 | 禁止 | 正确 |
+|------|------|------|
+| 情感 | 邵阳感到心碎和愤怒（原文只写了他看见拥抱） | 邵阳目睹宋丽与人拥抱，表情由刺痛转为冷漠 |
+| 评价 | 这是一段精彩的打斗 | 林雷三招击败对手，围观者倒吸一口凉气 |
+| 氛围 | 气氛变得紧张起来 | 所有人停止说话，目光集中在门口 |
+| 意图 | 他想借此展示实力 | 他将石锁单手举过头顶，环视众人 |
+| 叙事框架词 | 通过对话，郑松得知张子豪在韩国训练 | 吴志斌告诉郑松，张子豪在韩国训练 |
+
+原文明说的起因、理由和内心活动照写（"存款花光了，他去找许新年借钱"里的起因是原文给的），只是不替角色推测原文没写出来的动机；原文同时给了外部表现时优先写表现。情节点严格按原文事件的时间顺序排列，不重排、不逻辑归纳。
+
+**原文引用规则（精选，不逐点铺满）**：情节点的主要证据是 P 行的白描——事实、结果、原文给出的起因、伏笔线索必须在白描里写全。引用是补充证据，只给三类情节点保留：关键转折（改变本章或全书走向的转折点/解决）、关键台词（有辨识度、后续会被回扣的原话）、写法样本（值得当句式/节奏/对话样本回查的段落）。
+
+- 每章至多 8 条；其余情节点不写引用行。本章确实没有值得回查的段落时一条都可以不留，不要为凑数给过场和纯环境铺垫配引用
+- 引用 ≤400 字，逐字连续切片，保留原文语气，不改写、不缩写、不跨段拼接
+- 选中的段落过长或分散时，用一行 `原文定位：{5-15字可 grep 回原文的原句片段}` 代替整段引用
+
+**Stage 2 输出自检**（并行 agent 与 solo/direct 串行两条路径同一份要求）：概要为按时序的连贯叙述（非条目罗列、非同一连接词反复串联）｜每个情节点白描客观且写全事实/结果/原文给出的起因｜标题为 ≤15 字短标签且不与白描同句｜情节点严格按时序｜情节点数 10-40（按字数动态调节，硬下限 10）｜关键转折/关键台词/写法样本类情节点留了引用或 `原文定位`，全章不超过 8 条｜角色用全名｜类型/基调/主题标签只取规定枚举｜角色描述不跨章｜`关键信息与扩写技法` 与 `逐章写法公式` 齐全。
+
+## Stage 2 角色过滤
+
+| 分类 | 标准 | 提取深度 |
+|------|------|----------|
+| 不提取 | 出场1次且无台词（通用路人） | 跳过 |
+| 简化提取 | 出场2-3次且单一功能 | 功能标签+首次章节 |
+| 完整提取 | 出场3次以上/有台词且推动剧情/与主角直接互动 | 完整档案 |
+
+别名合并：主条目用首次正式名，别名列于 `aliases: []`。
+
+## Stage 3 聚合分析
+
+### Stage 3 前置：故事框架识别
+
+输出写入 `剧情/故事线.md` 顶部：
+
+```markdown
+## 故事框架
+
+| 项目 | 内容 |
+|------|------|
+| 框架类型 | {升级流/复仇线/日常单元/多线交织/蜕变成长/混合} |
+| 核心驱动 | {一句话描述全书的核心叙事引擎} |
+| 主轴矛盾 | {贯穿全书的根本矛盾} |
+| 升级机制 | {力量/地位/关系的递进方式，如无则填"—"} |
+| 叙事节奏模式 | {铺垫→冲突→爽点→新悬念 的典型周期} |
+| 判断依据 | {哪些章节/情节点支撑此判断} |
+| 预期剧情数 | {基于总章数的预期范围，参考 material-decomposition.md 预期数量引导表} |
+```
+
+**框架识别后自检**（写入 `剧情/故事线.md` 框架部分之后）：
+
+```markdown
+## 框架识别自检
+
+| 检查项 | 结果 | 说明 |
+|--------|------|------|
+| 覆盖率 | {X%} | {已覆盖章节数/总章节数} |
+| 粒度检查 | {通过/不通过} | {如不通过，说明哪个剧情过细/过粗} |
+| 独立性检查 | {通过/不通过} | {如不通过，说明哪个剧情不满足哪项标准} |
+| 数量检查 | {通过/不通过} | {实际剧情数 vs 预期范围} |
+```
+
+### Stage 3 权威产物分工
+
+Stage 3 除剧情文件外，必须写一个轻量索引 `剧情/README.md`，再分别写两个权威文件：
+
+```markdown
+# 剧情目录索引
+
+| 文件 | 权威范围 | 下游用法 |
+|---|---|---|
+| `节奏.md` | 关键信息推进、爽点循环、情绪触动点、爆发节奏 | 产出 `rhythm_reference` |
+| `情绪模块.md` | 读者需求、情绪引擎、套路框架、可复现模块卡 | 产出 `selected_emotion_module` |
+| `故事线.md` | 故事框架与故事线摘要 | 投影摘要，不覆盖权威文件 |
+| `拆文报告.md` | 人类阅读报告 | 投影摘要，不覆盖权威文件 |
+
+冲突时以 `节奏.md` / `情绪模块.md` 为准；两个文件用 EM/RH/TR ID 互相引用。
+
+## 剧情单元清单
+
+| 剧情单元 | 类型 | 桥段标签 | 章节范围 | 体量 |
+|---|---|---|---|---|
+| `{标题}.md` | {类型} | {桥段标签} | 第{X}-{Y}章 | 共{N}章，约{M}万字 |
+
+清单仅是检索索引投影（各列取剧情单元既有字段），剧情定义权威在各剧情单元文件；节奏/情绪权威仍在 `节奏.md` / `情绪模块.md`。
+```
+
+- `剧情/节奏.md` 是**节奏与触发点权威索引**：关键信息推进、爽点循环、情绪触动点、爆发节奏、长间隔风险都在这里落盘。
+- `剧情/情绪模块.md` 是**读者需求与可复现模块权威索引**：读者为什么爱看、情绪引擎如何运转、爽文套路如何嵌进故事框架、如何重组复现都在这里落盘。
+- `剧情/故事线.md` 和 `拆文报告.md` 只写摘要和引用，不复制完整模块定义；冲突时以下游写作读取 `剧情/节奏.md` / `剧情/情绪模块.md` 为准。
+
+### Stage 3 剧情
+
+输出 `剧情/{标题}.md`：
+
+| 项目 | 内容 |
+|------|------|
+| 标题 | 简洁有力，15字以内 |
+| 类型 | {主线/爱情/成长/复仇/寻宝/悬疑/战斗/权谋/修炼/危机/谜团/日常/其他} — 悬疑=主动推理调查，谜团=世界观/身世等未解之谜 |
+| 概要 | {150-300字，按时序连贯叙述这条剧情线的起承转合与因果，不靠同一连接词反复串联；含核心角色及定位、关键地点、关键道具（如有）、对主角/世界的影响} |
+| 核心目标 | {具体、可衡量的戏剧目标，如"赢得大比冠军"} |
+| 核心冲突 | {具体冲突对象+冲突事件} |
+| 关键信息功能 | {这条剧情负责让读者获得/等待/误判/确认什么信息} |
+| 读者需求 | {满足安全感/优越感/期待感/情感补偿/认知反转/陪伴感等哪类需求} |
+| 情绪模块ID | {引用 `剧情/情绪模块.md` 中的 EM-001 等，不在此重复完整卡片} |
+| 套路框架位置 | {退婚打脸/迟来追悔/升级试炼/掉马震惊/以小搏大/其他；说明它如何在本故事框架内运转} |
+| 桥段标签 | 从桥段词表选命中项，逗号分隔；可补表外确有桥段；无匹配留空，不硬凑（词表见 references/deconstruction-notes.md） |
+| 章节范围 | 第{X}-{Y}章（共{N}章，约{M}万字） |
+
+结构分布：铺垫期 | 发展期 | 高潮期 | 收尾期（各含章节范围）
+
+情节点索引：| 序号 | 章节 | 描述 | 归属置信度 |
+
+### Stage 3 故事线
+
+输出 `剧情/故事线.md`（在框架识别之后）：
+
+每条故事线：
+
+| 项目 | 内容 |
+|------|------|
+| 标题 | 简洁有力，15字以内 |
+| 类型 | {主线/感情线/成长线/复仇线/夺宝线/冲突线/谜团线/其他} |
+| 描述 | {300-600字，划分3-8个发展阶段，每个阶段含：核心冲突、关键角色及作用、能力/资源/地位演进、主题母题。追踪伏笔与回收关系链。标注与其他故事线的交织关系} |
+| 情绪引擎摘要 | {1-2句概述这条线如何制造缺口、延迟满足、释放和余波；详情指向 `剧情/情绪模块.md`} |
+| 套路运行方式 | {爽文/情感/悬疑等套路如何嵌入故事框架而不是孤立桥段；详情指向模块ID} |
+| 主题 | {不超过3个} |
+| 包含剧情 | {剧情标题列表，按时序排列。每条故事线至少包含1个剧情} |
+| 模块引用 | {EM-001, EM-002；只写引用，不复制完整卡片} |
+
+故事线关系：并行 / 交织 / 依赖
+
+### Stage 3 节奏.md（权威索引）
+
+输出 `剧情/节奏.md`：
+
+```markdown
+# 节奏索引：{书名}
+
+> 权威范围：关键信息推进、爽点循环、情绪触动点、爆发节奏。`拆文报告.md` 只引用本文件摘要。
+
+## 全书情绪节奏总览
+
+- 情绪折线：{压抑/期待 → 紧张/加压 → 爽感/反转 → 余波/新危机；标注关键章节区间}
+- 爽点频率：{每 N 章一次小爽点；每 M 章一次中高潮；大高潮位置}
+- 高潮分布：小高潮：第 {X/Y/Z} 章；中高潮：第 {X/Y} 章；大高潮：第 {X} 章
+- 冲突升级路径：{低级矛盾 → 中级矛盾 → 高级矛盾 → 终局矛盾；标注触发章节}
+- 伏笔跨章地图：{伏笔内容 | 第X章埋入方式 → 第Y章回收效果；仅列跨度超过2章或影响主线的伏笔}
+
+## 循环单元
+
+- 小循环（约 3 章）：{缺口/误判 → 加压/试探 → 释放/新钩子；可变项是什么}
+- 中循环（约 7 章）：{阶段目标 → 多轮阻碍 → 中段反转 → 阶段爽点 → 更大问题}
+- 大循环（约 15 章）：{卷内目标 → 资源/关系/敌手升级 → 核心冲突爆发 → 余波与转场}
+
+## 关键信息推进表
+
+| 章节/范围 | 关键信息 | 扩写方式 | 推进功能 | 节奏效果 | 关联剧情/模块 |
+|---|---|---|---|---|---|
+| 第{N}章 | {读者必须获得/误判/等待的信息} | {对话铺垫/事件验证/反应层/延迟揭示/多段回扣} | {立目标/加压/释放/转场/埋钩} | {加速/减速/蓄力/爆发/冷却} | {剧情标题 / EM-001} |
+
+## 爽点循环索引
+
+| 循环ID | 章节范围 | 铺垫层 | 释放层 | 反应层 | 衔接层/新钩子 | 强度递进 |
+|---|---|---|---|---|---|---|
+| RH-001 | 第{X}-{Y}章 | {压抑/误判/期待缺口} | {打脸/掉马/目标达成/情感满足} | {谁震惊/后悔/重新评价} | {旧爽点后立起的新期待} | {比上一轮强/弱在哪里} |
+
+## 情绪触动点索引
+
+| 触动点ID | 章节 | 触发事件 | 目标读者情绪 | 爆发点 | 余波/冷却 | 复现提示 |
+|---|---|---|---|---|---|---|
+| TR-001 | 第{N}章 | {触发读者情绪的具体情节} | {期待/心疼/愤怒/爽/甜/热血/恐惧} | {情绪最高句/段或事件} | {角色反应/关系变化/新悬念} | {保留情绪链，不搬运具体事件} |
+
+## 爆发节奏总结
+
+- 爆发密度：{每N章一次 / 每N字一次 / 卷内峰值位置}
+- 爆发形态：{递进 / 延迟满足 / W形 / 阶梯 / 单元循环}
+- 长间隔风险：{哪些区间触动点过稀，作者如何用小钩子维持}
+- 下游写作提醒：{新书复现时每章/每卷如何安排触动点}
+```
+
+### Stage 3 情绪模块.md（权威索引）
+
+输出 `剧情/情绪模块.md`：
+
+```markdown
+# 情绪模块：{书名}
+
+> 权威范围：读者需求 / 情绪引擎 / 套路框架运转 / 可复现模块。禁止把原文具体桥段当模板照搬。
+
+## 读者需求 / 情绪引擎
+
+| 读者需求 | 本书满足方式 | 证据章节/情节点 | 持续追读机制 | 可迁移边界 |
+|---|---|---|---|---|
+| {优越感/安全感/被理解/替代性复仇/关系补偿/认知惊喜等} | {故事如何持续交付} | {第N章/Px} | {下一层期待如何被立起} | {可保留情绪逻辑；必须替换具体设定/人物/事件} |
+
+## 故事框架与套路运行图
+
+| 框架/套路 | 在本书中的位置 | 运行方式 | 为什么有效 | 失效风险 |
+|---|---|---|---|---|
+| {退婚打脸/升级流/迟来追悔/掉马/以小搏大/修罗场/其他} | {章节/剧情单元} | {铺垫→延迟→释放→余波} | {对应读者需求} | {照搬会雷同/人设不适配/铺垫不足} |
+
+## 可复现模块卡
+
+### EM-001 {模块名}
+
+| 字段 | 内容 |
+|---|---|
+| 读者想看什么 | {一句话抽象需求} |
+| 情绪链 | {缺口 → 加压 → 触发 → 爆发 → 余波} |
+| 戏剧单元 | {去素材后的结构，如“被轻视者在公开场合用结果反证”} |
+| 关键触发物 | {可替换功能位：误判者/见证者/代价/证据/奖励} |
+| 复现步骤 | {1. 建缺口 2. 加反应层 3. 控制爆发点 4. 立新钩子} |
+| 可替换项 | {角色身份、场景、道具、对手类型、目标结果} |
+| 不可照搬 | {原文专名、具体事件顺序、标志性台词、独特设定} |
+| 关联节奏 | {`剧情/节奏.md` RH-001 / TR-001} |
+
+## 重组与复现指南
+
+1. 先选读者需求，再选模块卡，不要从原文桥段倒抄。
+2. 保留情绪链和功能位，替换人物、场景、动机、道具、事件素材。
+3. 复现到新书大纲时，至少改变：冲突对象、公开/私密场景、触发证据、余波方向中的三项。
+4. 若人设与模块冲突，以人设驱动重构模块；不要为了套套路扭曲角色。
+```
+
+### Stage 3 角色操作
+
+**合并**：
+1. 收集所有章节的角色提及数据
+2. 别名匹配（仅 proper_name 和 nickname，置信度 ≥0.85）
+3. descriptor/title 永不触发合并
+4. 确认后保留首次正式名
+
+**分级**：
+
+| 等级 | 标准 | 提取深度 |
+|------|------|----------|
+| 主角 | 出现章节 ≥50% + 推动主线 + 完整成长轨迹 | 完整档案+弧线+动机链 |
+| 反派 | 与主角对立 + 推动核心冲突 + 明确动机 | 完整档案+动机链 |
+| 核心配角 | 出现章节 ≥20% 或推动重要支线 | 完整档案+关系 |
+| 功能角色 | 出现章节 <20% + 作用有限 | 简化档案 |
+
+边界模糊优先归入更低等级。
+
+### Stage 3 散落情节兜底
+
+1. 计算孤立比例，<5% 直接跳过（少量散落写入散落情节.md）
+2. 列出未分配情节点
+3. 按角色重叠、地点重叠、因果关系计算相关性（三层置信度）
+   - 强相关（0.8-1.0）：归入现有条，标`[孤立情节归入]`
+   - 中等相关（0.5-0.8）：标`[低置信归入]`，待复核
+   - 弱相关（<0.5）：不强行分配，宁可放入未分配
+4. <0.5 按主题聚类，标`[聚类生成]`（≥5个才建条）
+5. 无法归类写入`散落情节.md`，不要强行分配到不相关的剧情
+6. 覆盖率验证：目标阈值见 [material-decomposition.md 质量阈值体系](material-decomposition.md)，不达标回到步骤3降低阈值重试
+
+### Stage 3 覆盖率
+
+覆盖率 = 已归类数 / 总数 x 100%，目标阈值见 [material-decomposition.md 质量阈值体系](material-decomposition.md)。
+
+## Stage 4 设定+关系
+
+> **Stage 4 直接按主题拆分输出多个文件**（与当前导入、长篇写作项目结构对齐）。下游不再现场拆分扁平文件。
+> **事实保真**：等级/数值/距离/属性/势力数等硬事实回原文核对，原文未给的写「原文未明确」、禁编造填空（见 material-decomposition.md「合成阶段事实保真」）。
+
+`设定/世界观/力量体系.md`：
+- 文本描述，含等级、晋升条件。长篇注意多层级力量体系
+- 内容 < 200 字且不构成独立体系 → 合并到 `设定/世界观/背景设定.md`，本文件可省略
+
+`设定/世界观/地理.md`：
+- 分布、主要区域、关键地点（文本描述）
+- 内容 < 200 字 → 合并到 `背景设定.md`，本文件可省略
+
+`设定/世界观/背景设定.md`：
+- 核心规则 + 特殊设定
+- 内容不足独立成文件的「力量体系 / 地理 / 势力」也合并到这里
+- 无特殊世界观时：本文件输出 "本书为现实题材，无特殊世界观设定"
+
+`设定/世界观/金手指.md`：
+- 类型{system/space/rebirth/transmigration/special_physique/artifact/bloodline/other} | 名称 | 描述（300-600字，含能力/获取/机制/进化史/多重能力演化）| 核心机制 | 当前能力
+- 合并规则见 material-decomposition.md「金手指合并规则」。
+- 无金手指时：输出空文件，注明"本书无明显金手指设定"
+
+`设定/势力/{势力名}.md`（每个核心势力一个文件）：
+- 名称 / 类型（门派/组织/家族/国家）/ 核心人物 / 立场倾向 / 与其他势力关系 / 关键事件
+- 内容 >= 200 字时独立；不足合并到 `设定/世界观/背景设定.md`（不丢失信息）
+
+`角色/{角色名}.md`（每角色）：
+- 200-500字档案（身份背景→核心经历→性格特质→能力特长→人际关系→成长轨迹）
+- archetype：protagonist/antagonist/supporting/minor
+- 关键情节（3-5个转折点，按时序排列）
+- 成长弧线（character_arc：如有明显变化则总结，如"从普通少年成长为觉醒血脉的强者"）
+- 别名列表（标注类型和置信度）
+
+`角色/角色关系.md`（每5章批量，从情节点提取）：A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹。同一对角色保留最新状态，历史变化写入演变轨迹。
+
+## Stage 5 汇总报告
+
+输出 `拆文报告.md`（`快速预览.md` 的超集，两节同名同结构，见「快速预览报告」节）。
+
+报告章节：
+
+- **基本信息**：书名 | 题材 | 总章数 | 总字数 | 目标平台（与 `快速预览.md` 同结构）
+- **黄金三章评分**：5 维评分表（开篇钩子/主角塑造/爽点设计/世界观铺设/章尾悬念，与 `快速预览.md` 同结构）
+- **读者需求 / 情绪引擎**：摘要 `剧情/情绪模块.md` 的核心读者需求、情绪缺口、持续追读机制（报告只写摘要，详情以模块文件为准）
+- **结构分析**：主线 / 副线 / 剧情单元 / 覆盖率
+- **关键信息与扩写技法总览**：按章节/剧情单元汇总关键剧情信息如何被扩写（详情以 `章节/*_摘要.md` 与 `剧情/节奏.md` 为准）
+- **全书情绪节奏总览**：摘要 `剧情/节奏.md` 的情绪折线、爽点频率、小/中/大高潮分布、循环单元
+- **爽点密度**：{N}个循环/{M}章 | 完成率{X%} | 密度{高≥70%/中50-70%/低<50%}
+- **节奏与情绪触动点**：摘要 `剧情/节奏.md` 的爆发密度、触动点分布、长间隔风险、爆发节奏
+- **伏笔与冲突网络**：跨章伏笔地图（仅列跨度超过2章或影响主线的伏笔）+ 冲突升级路径（低级→中级→高级→终局）
+- **核心机制**：爽点类型 | 节奏模式 | 更新策略
+- **角色体系**：主角/反派/核心配角/功能角色分级概览
+- **质量评估**：置信度 / 覆盖率 / 重叠率
+- **可借鉴套路**：1.{套路+场景} 2.{...} 3.{...}，必须标注对应 `EM-*` 模块ID
+- **可复现模块**：列出 `剧情/情绪模块.md` Top 3 模块的读者需求、情绪链、替换项、不可照搬项
+- **写法技巧**：1.{技巧名+用法} 2.{...}——覆盖一笔两用、延迟揭示、视角欺骗、对比锚点、行为循环、身体反应替代心理描写、**跨章回扣**（物品/意象在不同章节承担不同功能）
+- **不建议模仿**：1.{问题+原因}
+
+## Stage 6 文风
+
+输出 `拆文库/{书名}/文风.md`。整书级写作技法视图，供 story-long-write 日更循环喂给 narrative-writer。
+
+**字段速查**：
+
+| 段落 | 内容 | 必标可信度 | 上限 |
+|---|---|---|---|
+| 生成记录 | 参考了哪些资料 + 抽样看了哪几章 + 文风是否可用 | 否 | <100 字 |
+| 整体语感 | 句长分布 / 标点习惯 / 段落节奏 | 是（每子项一标） | ~500 字 |
+| 对话技法 | 潜台词模式 / 对话标签 / 角色语气区分 | 是（潜台词必标） | ~400 字 |
+| 情绪交替模式 | 章内基调切换 / 跨章基调周期 / 喜剧↔重击转场 | 是（章内切换必标） | ~400 字 |
+| 可借鉴技巧 | 写法技巧 Top 5 + 可借鉴套路 Top 3（从拆文报告引用；情绪/节奏意图只引用 `剧情/情绪模块.md` / `剧情/节奏.md`，不在文风中重定义） | 否 | ~300 字 |
+| 分层模仿建议 | 基础层 / 进阶层 / 适配层，各写可执行边界 | 否 | ~350 字 |
+| **原文锚点片段** | **4-6 段 × 300-500 字**，按基调分类，标"出处 + 行号 + 示范点" | 否 | ~2400 字 |
+| 不可模仿 | 对标书缺陷或不适合本项目的技法 | 否 | <100 字 |
+
+**总上限 ~4000 字**。
+
+完整模板与生成方法见 [style-profile-protocol.md](style-profile-protocol.md) + [style-profile-generator.md](style-profile-generator.md)。

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

@@ -0,0 +1,80 @@
+# 管道运维参考
+
+story-long-analyze 拆解管道的运维工具文档：`_progress.md` 模板、错误处理、恢复机制操作步骤。
+
+> 质量阈值（置信度 / 覆盖率 / 重叠率）见 [material-decomposition.md 质量阈值体系](material-decomposition.md)。
+
+---
+
+## _progress.md 模板
+
+```markdown
+# 深度拆解进度：{书名}
+- 小说：{标题} | 总章数：{N} | 输出目录：{路径} | 开始：{日期}
+- 最终状态：{pending/paused_after_stage1/completed/completed_with_errors}
+- schema_version: 2
+## 管道进度
+| 阶段 | 状态 | 进度 | 备注 |
+|------|------|------|------|
+## 章节边界（Stage 0 章节边界子步骤产物，唯一权威）
+| 章号 | 标题 | 起始行 | 字数 |
+|------|------|--------|------|
+## 分块进度
+| 块 | 章节 | 状态 |
+## 失败记录
+| 类型 | 章节/阶段 | 错误信息 | 重试状态 |
+|------|----------|---------|---------|
+## 质量检查
+| 检查项 | 阶段 | 结果 | 修正 |
+## 角色合并
+| 合并前 | 合并后 | 依据 | 确认 |
+## 断点
+- 最后处理：第{N}章 | 当前阶段 | 下一操作
+```
+
+**schema_version 说明**：
+
+| 版本 | 含义 |
+|------|------|
+| 2 | 当前契约：含「章节边界」表（Stage 0 章节边界子步骤产物）。Stage 1/2/6 全部以该表为切片真值，不再各自跑 regex |
+
+缺少 `schema_version: 2` 或「章节边界」表时不得续跑；从 Stage 0 章节边界子步骤重建 `_progress.md` 后再恢复。
+
+**最终状态值说明**：
+
+| 状态值 | 含义 |
+|--------|------|
+| `pending` | 管道进行中，尚未跑完 |
+| `paused_after_stage1` | Stage 1 停靠点暂停——Stage 0/1 已完成，已产出 `快速预览.md`，等待用户决定是否继续 Stage 2-6。续跑时跳过 Stage 0/1，从 Stage 2 开始 |
+| `completed` | 全管道 Stage 0-6 完成 |
+| `completed_with_errors` | 全管道完成，但有单章/单阶段失败（详见「失败记录」表，拆文报告中注明） |
+
+---
+
+## 剧情单元清单补建（存量书）
+
+触发：用户说「补剧情单元清单」，或写作侧检索发现 `剧情/README.md` 无「剧情单元清单」表。
+
+动作：读存量 `拆文库/{书名}/剧情/*.md`（或 `对标/{书名}/剧情/*.md`）各剧情单元表头的 标题 / 类型 / 桥段标签 / 章节范围 字段，按 output-templates.md「剧情单元清单」表模板机械重建 `剧情/README.md` 的清单表；项目 `对标/{书名}/` 视图存在时同步一份。不读原文、不重跑任何 Stage、不改剧情单元内容、不动 `节奏.md` / `情绪模块.md`。旧剧情单元「章节范围」行没有字数信息时，体量列只写「共{N}章」、字数记「未知」，不得编造。
+
+写作侧消费点对无清单的书自动回退逐文件检索（见 story-long-write 的 outline-structure-theory.md「对标节奏迁移」步骤 1），补建只是加速，不是阻塞项。
+
+## 错误处理
+
+| 场景 | 处理 |
+|------|------|
+| 章节识别失败 | 提示确认格式；支持自定义正则 |
+| 分块中断 | 读 _progress.md 断点恢复 |
+| 聚合质量不达标 | 孤立情节二次分类；阈值放宽至 0.5 |
+| 角色合并冲突 | 记录待确认列表 |
+| 输出目录冲突 | 追加不覆盖；冲突标 `[重新分析]` |
+
+---
+
+## 恢复机制操作步骤
+
+1. 管道启动时检查输出目录是否已有 `_progress.md`
+2. 校验 `schema_version: 2` 与「章节边界」表；任一缺失即停止，并提示从 Stage 0 章节边界子步骤重建进度文件
+3. 读取断点信息（最后处理章节 + 当前阶段 + 最终状态）
+4. **断点状态为 `paused_after_stage1`**（Stage 1 停靠点）→ 跳过 Stage 0/1，直接从 Stage 2 续跑逐章摘要，不重跑已完成的概要与黄金三章
+5. 其他断点状态 → 从断点所在块的起始章节恢复，覆盖该块已有输出