@oh-story/dsh 0.1.9 → 0.1.11

package/lib/oh-story/skills/story-long-analyze/references/stage4-characters-settings.md

@@ -0,0 +1,195 @@
+# Stage 4：角色、设定与关系
+
+Stage 4 时刻读本文件与 [synthesis-inputs.md](synthesis-inputs.md)（取料与事实保真）。
+
+## 核心规则
+
+从 Stage 2 的 `涉及人物`、状态变化和批次关系观察归一实体，再结合 Stage 3 剧情单元生成角色档案与设定。关系记录动作方向、触发、双方得失、表面/真实状态、阶段变化和证据；“甲保护乙”与“乙依赖甲”分别记录。
+
+关系图只从 `角色/角色关系.md` 生成：`"{PYTHON}" "{story-long-analyze skill 根}/scripts/render_relation_chart.py" --root "{拆文目录}" --png`。主产物是 `人物关系图/人物关系图.md`（Mermaid + 文字清单，任何 Markdown 查看器都显示中文）；PNG 只在找到能显示图中全部文字的字体时生成（表情等符号不画进图片）。字体不够就不出图，不得自行改画拼音或首字母版，把脚本的 `author_message` 转告作者。
+
+至少一份角色档案和一份设定文件落盘后运行 `manage_analysis_run.py mark-stage --stage stage4`；缺任一类文件时不得标完成。
+
+## 角色过滤来源
+
+Stage 4 从紧凑章块的 `涉及人物`、`状态变化` 和批次 `关系变化` 汇总角色提及，再应用下表过滤；不依赖已删除的独立“出场人物表”。
+
+| 分类 | 标准 | 提取深度 |
+|------|------|----------|
+| 不提取 | 出场1次且无台词（通用路人） | 跳过 |
+| 简化提取 | 出场2-3次且单一功能 | 功能标签+首次章节 |
+| 完整提取 | 出场3次以上/有台词且推动剧情/与主角直接互动 | 完整档案 |
+
+别名合并：主条目用首次正式名，别名列于 `aliases: []`。
+
+## 角色合并
+
+**合并**：
+1. 收集所有章节的角色提及数据
+2. 别名匹配（仅 proper_name 和 nickname，置信度 ≥0.85）
+3. descriptor/title 永不触发合并
+4. 确认后保留首次正式名
+
+## 角色与设定提取
+
+Stage 2 紧凑事实中的 `涉及人物`、`状态变化` 与批次 `关系变化` 在此阶段归一为完整档案。
+
+### 角色两阶段模型
+
+**阶段 A：轻量提及（Stage 2 输出）**
+- 每章 `涉及人物` 记录关键人物，`状态变化` 记录本章可见净变化；
+- 批次 `关系变化` 补充有方向的动作、触发与得失；
+- 不另建出场人物表，不在单章内完成跨章人物定型。
+
+**阶段 B：完整档案（Stage 4 构建）**
+- 合并逐章 `涉及人物`、`状态变化` 和批次关系观察
+- 跨章节别名解析（批次 `跨批状态` 的「已确认别名」是现成线索）
+- 群体称呼、无名路人和泛称（亲属、社交、身份、年龄外貌类称呼，如大哥、掌柜、老师、小伙子）不建档，除非原文固定用它指代某一个人
+- 构建完整角色档案
+
+### 一人一实体原则
+
+- **绝对禁止**将不同人物的信息合并到同一个实体中
+- 每个角色实体必须对应唯一的一个人物
+- 如果无法确定两个称呼是否指向同一人物，必须分开创建实体
+
+### 别名解析规则
+
+**别名类型**：
+
+| 类型 | 定义 | 可合并 | 示例 |
+|------|------|--------|------|
+| proper_name | 专名/全名/常用名 | 是 | "希尔曼""林雷·巴鲁克" |
+| nickname | 绰号/外号，须有同指证据 | 是（置信度≥0.85） | "龙血战士林雷" |
+| descriptor | 描述性称谓 | 否 | "红发壮汉""随从""队长" |
+| title | 头衔/职务 | 否 | "护卫队长""家主""族长" |
+
+**合并约束**：
+- 仅 proper_name 和 nickname（置信度 ≥0.85）可用于合并
+- descriptor 和 title **永不**触发实体合并
+- nickname 须提供同指证据：同位说明、括号别名、上下文指代、明确改名
+
+**Archetype 量化判断**：
+
+| 类型 | 标准 | 提取深度 |
+|------|------|----------|
+| **主角** | 出现章节 ≥50% 总章节 + 推动主线 + 有完整成长轨迹 | 完整档案+弧线+动机链 |
+| **反派** | 与主角对立 + 推动核心冲突 + 有明确动机 | 完整档案+动机链 |
+| **核心配角** | 出现章节 ≥20% OR 推动重要支线 OR 有独立人格和成长 | 完整档案+关系 |
+| **功能角色** | 出现章节 <20% + 作用有限（提供信息/道具/一次性互动） | 简化档案 |
+
+边界模糊优先归入更低等级。**特殊**：前期 minor 后期 supporting → 判为 supporting。重要导师/伙伴即使出现少也可判为 supporting。
+
+**角色档案结构**（200-500字）：
+1. 身份背景（1-2句）
+2. 核心经历（3-5句，按时序）
+3. 性格特质（1-2句，从行为归纳）
+4. 能力特长（1-2句）
+5. 人际关系（1-2句）
+6. 成长轨迹（如有，1句）
+
+### 金手指合并规则
+
+- 相互关联、共同作用的元素**合并为一个**（如"戒指+导师灵魂"是一个整体）
+- 同一事物的不同描述角度**不拆分**
+- 只有完全独立、互不依赖的能力来源才拆分为多个
+- 长篇特点：金手指可能复杂多样，需详尽描述演化过程和多重能力
+- 无金手指时注明
+
+**金手指类型**：system（系统）/ space（空间）/ rebirth（重生）/ transmigration（穿越）/ special_physique（特殊体质）/ artifact（神器）/ bloodline（血脉）/ other（其他）
+
+### 世界观（按主题拆分到多个文件）
+
+字段与落盘位置：
+
+| 字段 | 说明 | 落盘文件 |
+|------|------|----------|
+| 类型 | 奇幻/现实/平行世界 | 各文件 frontmatter 或开头注明 |
+| 力量体系 | 名称、等级、晋升方式（文本描述） | `设定/世界观/力量体系.md`（>=200字独立，否则并入 背景设定） |
+| 地理 | 分布、主要区域、关键地点（文本描述） | `设定/世界观/地理.md`（同上，>=200字独立） |
+| 势力 | 门派/组织/家族/国家 | **每个势力一个文件** `设定/势力/{势力名}.md`（>=200字独立；不足合并到 `设定/世界观/背景设定.md`） |
+| 核心规则 | 世界运转的基本规则 | `设定/世界观/背景设定.md` |
+| 特殊设定 | 区别于现实的独特设定 | `设定/世界观/背景设定.md`（与核心规则同文件） |
+| 金手指 | 见上方「金手指合并规则」 | `设定/世界观/金手指.md`（统一在 `设定/世界观/` 子目录下，不放扁平 `设定/金手指.md`） |
+
+> 模板见下方「输出模板」。下游导入只原样同步当前主题文件，不再现场拆分扁平文件。
+
+## 人物关系提取
+
+每对关系：
+
+| 字段 | 说明 |
+|------|------|
+| 主体 → 客体 | 有向关系；反向动作存在时另记一条 |
+| 关系动作/类型 | 保护、依赖、控制、服从、欺骗、竞争等动作及家人/师徒/朋友/敌人/恋人/同事/上下级/商业/其他类型 |
+| 表面/真实状态 | 文本允许区分时分别记录；未证实的真实状态标推断等级 |
+| 触发事件 | 导致关系建立或变化的具体行动/事件 |
+| 双方得失 | 信任、资源、地位、行动空间、风险、债务、暴露或失控 |
+| 变化后状态 | 本阶段结束时的状态及后续约束 |
+| 证据 | A/B/C 强度、章节、情节点或 source locator |
+
+### 关系提取策略
+
+**数据源**：从已提取的情节点描述中提取关系（不从原文提取），更高效、更聚焦。
+
+**批量提取**：复用 Stage 2 每个连续章节批次的关系观察，只记录新关系或关系变化；不为了固定章数单独重读原文。
+
+**关系演变追踪**：当同一对角色关系发生变化时，记录演变轨迹：
+```
+第{N}章：{关系状态A} → 第{M}章：{关系状态B}
+触发事件：{具体事件}
+情感转变：{正面→负面/负面→正面/中立→复杂 等}
+```
+
+**最终状态合并**：同一有向关系的多阶段状态保留最新状态作为主记录，历史变化写入演变轨迹。反向关系动作不能因角色对相同而被去重。
+
+**隐含关系推断**：当角色间没有直接互动但有间接证据时：
+- 通过第三方的评价/描述推断（置信度标 0.7）
+- 通过共同出现的频率和场合推断（置信度标 0.6）
+- 推断关系标记 `[推断]`，与直接证据关系区分
+
+**关系网络密度**：
+- 统计主要角色（主角+核心配角）的关系数量
+- 关系数 < 3 → 关系网偏薄，检查是否有遗漏
+- 关系数 > 10 → 关系网过密，检查是否有误合并
+
+## 输出模板
+
+> **Stage 4 直接按主题拆分输出多个文件**（与当前导入、长篇写作项目结构对齐）。下游不再现场拆分扁平文件。
+> **事实保真**：等级/数值/距离/属性/势力数等硬事实回原文核对，原文未给的写「原文未明确」、禁编造填空（见 [synthesis-inputs.md](synthesis-inputs.md)「合成阶段事实保真」）。
+
+`设定/世界观/力量体系.md`：
+- 文本描述，含等级、晋升条件。长篇注意多层级力量体系
+- 内容 < 200 字且不构成独立体系 → 合并到 `设定/世界观/背景设定.md`，本文件可省略
+
+`设定/世界观/地理.md`：
+- 分布、主要区域、关键地点（文本描述）
+- 内容 < 200 字 → 合并到 `背景设定.md`，本文件可省略
+
+`设定/世界观/背景设定.md`：
+- 核心规则 + 特殊设定
+- 内容不足独立成文件的「力量体系 / 地理 / 势力」也合并到这里
+- 无特殊世界观时：本文件输出 "本书为现实题材，无特殊世界观设定"
+
+`设定/世界观/金手指.md`：
+- 类型{system/space/rebirth/transmigration/special_physique/artifact/bloodline/other} | 名称 | 描述（300-600字，含能力/获取/机制/进化史/多重能力演化）| 核心机制 | 当前能力
+- 合并规则见上方「金手指合并规则」。
+- 无金手指时：输出空文件，注明"本书无明显金手指设定"
+
+`设定/势力/{势力名}.md`（每个核心势力一个文件）：
+- 名称 / 类型（门派/组织/家族/国家）/ 核心人物 / 立场倾向 / 与其他势力关系 / 关键事件
+- 内容 >= 200 字时独立；不足合并到 `设定/世界观/背景设定.md`（不丢失信息）
+
+`角色/{角色名}.md`（每角色）：
+- 200-500字档案（身份背景→核心经历→性格特质→能力特长→人际关系→成长轨迹）
+- archetype：protagonist/antagonist/supporting/minor
+- 关键情节（3-5个转折点，按时序排列）
+- 成长弧线（character_arc：如有明显变化则总结，如"从普通少年成长为觉醒血脉的强者"）
+- 别名列表（标注类型和置信度）
+
+`角色/角色关系.md` 从逐章事实和批次观察聚合，不重新读整本原文：
+
+| 关系ID | 主体 → 客体 | 关系动作/类型 | 表面关系 | 真实关系 | 触发事件 | 双方得失 | 变化后状态 | 证据强度 | 证据 |
+|---|---|---|---|---|---|---|---|---|---|
+
+同一对角色的最新状态和历史演变都保留；“甲保护乙”与“乙依赖甲”分别记录。关系图只由此文件生成，不手画、不另建关系事实，命令见上方「核心规则」。它总是写出 `人物关系图/人物关系图.md`（Mermaid 图 + 文字清单，任何 Markdown 查看器都显示中文，作为主产物）；只有装了 matplotlib 且找到能显示图中全部文字的字体（不算 LastResort 这类只画方框的兜底字体）时，才另画 `核心人物关系.png` 与 `关键关系演变.png`，表情等符号不画进图片。字体不够就不出图，绝不改用拼音或首字母，并把脚本返回的说明转告作者。

package/lib/oh-story/skills/story-long-analyze/references/stage5-report.md

@@ -0,0 +1,33 @@
+# Stage 5：主报告与完整概要
+
+Stage 5 时刻读本文件与 [synthesis-inputs.md](synthesis-inputs.md)。`拆文报告.md` 的模板与写法在 [author-facing.md](author-facing.md)「拆文报告.md」。
+
+## 备份与标记
+
+生成新的 `拆文报告.md` 前先执行：
+
+```text
+"{PYTHON}" "{story-long-analyze skill 根}/scripts/manage_analysis_run.py" mark-stage --root "{拆文目录}" --stage stage5 --prepare
+```
+
+若旧报告存在，命令会完整复制到 `_analysis_cache/legacy/拆文报告.md`；已存在的首份备份不覆盖。当前旧报告与首份备份不同时，另存一份带内容 hash 的历史备份。其他旧产物与已有摘要不得覆盖。新报告落盘后再用不带 `--prepare` 的 `mark-stage` 标记完成。
+
+## 完整概要
+
+整体故事框架识别 + 500-1000字高密度全书概要（涵盖主要剧情线阶段性发展、核心人物作用、关键转折点、因果关系）。
+
+> **怎么来**：Stage 5 从已落盘的 `剧情/故事线.md`（含故事框架识别）与各剧情单元文件自行生成概要，写入 `概要.md`，不等前面时刻交来文本。覆盖 Stage 0 的 thin first-pass 段，章节索引和卷段表保留。
+
+## 报告写法
+
+输出 `拆文报告.md`，模板与写法规则见 [author-facing.md](author-facing.md)「拆文报告.md」。它是 `快速预览.md` 的超集（「基本信息」「黄金三章评分」两节同名同结构），面向作者阅读：不出现脚本名、字段名、状态值、批次编号、质量指标名和证据分级字母；情绪模块卡、事件、披露、节奏节点的编号只在带名称时出现（如「退婚当众打脸」（EM-003）），关系写成「甲 → 乙：由……到……」。
+
+报告只综合权威底层结果，不为写总报告重新阅读全文，也不复制所有逐章摘要。每条结论写一句人话，再指向对应文件和章节；机械可追溯信息（`source_locator`、证据强度、`EV/RV/AX/EM` 全量编号）留在 `剧情/节奏.md`、`剧情/情绪模块.md`、剧情单元和 `角色/角色关系.md` 里。
+
+### 三层灵感库最小消费契约
+
+- 单书案例以 `剧情/*.md` 的剧情单元为准，可迁移机制以 `剧情/情绪模块.md` 的 `EM-*` 为准；主报告是阅读入口，不作为第二份结构化真源。
+- 客观事件、披露节点和三维节奏分别使用 `EV-*`、`RV-*`、`AX-*`；披露必须引用事件；机制卡通过 ID 引用，报告只用「名称（ID）」的带名引用，避免跨层复制全文。
+- 每条可检索结论保留剧情单元/章节、`source_locator` 或定位词及证据强度；`chapter_index.csv` 的逐章 hash 和 `_progress.md` 批次范围 hash 用于判断原文范围是否变化。
+- 下游先运行兼容检查器读取 `classification`、`current_capabilities`、`conflicts` 和覆盖范围。缺项时请求长篇拆文的定点增强；不得把旧资料概括成伪造的当前主产物，也不得为入库重新阅读全文。
+- 是否进入灵感库、跨书归并、差异保留和检索策略由三层灵感库能力决定；单书拆文不自动入库。

package/lib/oh-story/skills/story-long-analyze/references/style-profile-generator.md

@@ -1,149 +1,76 @@
-# 文风生成 SOP
+# 文风档案生成与单独重建
 
-> **何时加载**：story-long-analyze Stage 6 执行时。`拆文报告.md` 是阻断级前置依赖；`章节/*_摘要.md`、`章节/第1-3章_深度拆解.md` 与 `原文/原文.txt`（或 `.md`）是质量输入，缺失时严格按下方「失败模式与降级」逐项处理。
->
-> **输出**：`拆文库/{书名}/文风.md`（模板见 [style-profile-protocol.md](style-profile-protocol.md)）。
+> **何时加载**：story-long-analyze Stage 6。Stage 6 可以在完整管道末尾运行，也可以在已有拆文只缺 `文风.md` 时单独运行；单独运行不得触发 Stage 1–5。
 
-## 6 步流程
+## 原则
 
-### Step 1: 读拆文报告核心字段
+1. 文风档案描述作者实际写法，不评价作者水平。
+2. 情绪和节奏意图以 `剧情/情绪模块.md`、`剧情/节奏.md` 为准，文风只管表达层。
+3. 已有完整 `文风.md` 时原样保留；用户明确要求增强时才更新。
+4. Stage 6 不重扫全书。允许使用索引行号定点回读 4–6 段原文，以补齐可验证锚点。
+5. 摘要措辞不能冒充作者原句；缺少原文和有效样本时明确报错。
 
-读 `拆文库/{书名}/拆文报告.md`，提取：
+## 来源顺序
 
-- **「写法技巧」段** → 用于填文风「可借鉴技巧」的「写法技巧 Top 5」
-- **「可借鉴套路」段** → 用于填文风「可借鉴技巧」的「可借鉴套路 Top 3」
-- **「全书情绪节奏总览 / 伏笔与冲突网络」段** → 用于填文风「分层模仿建议」的进阶层与适配层，只抽象节奏和手法，不搬运具体桥段
-- **基本信息**（书名、题材、总章数）→ 填写文风标题与「生成记录」
-- 「生成记录」只写作者能看懂的信息：参考了哪些资料、抽样看了哪几章、生成时间、文风是否可用；不要写文件时间戳或内部降级标记这类实现术语。
+1. 既有 `文风.md`；
+2. 项目内非空且含连续原文的 `_style-sample.txt`；
+3. `章节/第1-3章_深度拆解.md` 中带定位的短引和写法证据；
+4. `_analysis_cache/批次-*.md`、`章节/*_摘要.md` 与 `拆文报告.md` 的结构层观察；
+5. 仍缺锚点时，读取 `chapter_index.csv`，按旧版“覆盖主要基调”的方式选择 4–6 章，再按 `start_line/end_line` 定点读取原文片段。
 
-### Step 2: 读黄金三章深度拆解
+第 5 项只读取被选章节的局部行段，不允许从头到尾扫描原文。没有索引的旧项目可以仅运行机械索引脚本；这一步不写 `_progress.md`，也不启动其他分析阶段。
 
-读 `章节/第1章_深度拆解.md`、`第2章_深度拆解.md`、`第3章_深度拆解.md`，提取：
-
-- **开篇钩子类型 + 手法**
-- **反应层拆解表**（对话潜台词样本）
-- **爽点铺放比**（情绪交替节奏样本）
-- **可借鉴要素**（与 Step 1 合并去重，喂「写法技巧 Top 5」）
-
-### Step 3: 提取章节基调/主题标签序列
-
-用 Grep 读所有 `章节/*_摘要.md`：
-
-```bash
-grep -hE '基调：(紧张|轻松|悲伤|热血|爽|甜|温馨|恐怖|压抑|其他)' 章节/*_摘要.md
-```
-
-**关键格式注意**：`章节/*_摘要.md` 的实际格式是 `主题标签X | 基调：Y` 单独成行、跟在每个情节点后（一章 10-40 行）。`基调` 用**全角冒号**，`主题标签` 后**不带冒号**，两者都**不在行首**。grep 模式不能用 `^基调:` 这种锚定。
-
-**章基调聚合规则**（每章一个章基调，写入文风「情绪交替模式」）：
-
-- 对该章所有情节点的「基调」字段做众数统计
-- 并列时（如 5 紧张 vs 5 热血）取章节内**最早出现**的基调（按 `_摘要.md` 中行号）
-- 输出格式：`第N章: {章基调}`，连成全书序列
-
-**章内情节点基调序列**（用于「章内基调切换」分析）：
-
-- 不做聚合，按 `_摘要.md` 中情节点出现顺序保留
-- 用于统计切换频率：相邻情节点基调不同的次数 / 总情节点数
-
-### Step 4: 原文采样
-
-`原文/` 下**只有一个全书单文件** `原文.txt`（或 `.md`），**不是按章拆分**。Stage 0 已把校验通过的章节起止行写入 `拆文库/{书名}/_progress.md`，该表是 Stage 1/2/6 共用的唯一切片真值。
-
-**Stage 6 只读 `_progress.md` 里的「章节边界」表，不重新搜索章节标题、不另行推断边界，也不自行修正规则。** 如果表缺失、目标章缺边界、边界不连续或指向原文范围之外，立即停止 Stage 6，提示重新执行 Stage 0 重建进度文件；不得用临时切片继续生成文风。
-
-**采样切片**：
-
-- 从 `_progress.md` 的章节边界表选第 1 章、第 10 章、第 20 章（如总章数 <20，按 1/3、2/3、收尾比例挑）
-- 每章用 `Read offset={该章起始行} limit=50` 切出约 1000 字
-- 把 3 段拼接写入 `拆文库/{书名}/_style-sample.txt`（固定这个文件名，不要换）：**第一段用 `>` 覆盖写，后两段才用 `>>` 追加**。全程用 `>>` 会让重跑 Stage 6 时把上一轮的样本累积进来，统计出的句长分布是两轮混合的结果
-
-**确定性句长/标点统计**（替代主观「眼测」）：
-
-Stage 6 由**主线程**执行，Bash 工具可用。把上一步拼好的 `_style-sample.txt` 喂给下面的脚本（heredoc 作 Python 源，样本路径按 argv 传入，避免 stdin heredoc 与 `< file` 双重重定向冲突）。先探测可用解释器再跑——**勿直接用 `python3`**，Windows 上它会触发 Microsoft Store 占位程序、exit 49 失败。
-
-样本路径**必须用项目内相对路径**，不要写 `/tmp/...`：下面探测到的解释器可能是 Windows 原生 python（`py` 启动器），它把 `/tmp/x.txt` 解析成 `C:\tmp\x.txt`，和 Git Bash 写入的位置不是同一个文件，脚本会直接 FileNotFoundError。
-
-```bash
-SAMPLE="拆文库/{书名}/_style-sample.txt"   # {书名} 换成实际书名，别照抄占位符
-for PYBIN in python3 python py; do "$PYBIN" -c "" 2>/dev/null && break; done
-"$PYBIN" - "$SAMPLE" <<'PYEOF'
-import re
-import sys
-with open(sys.argv[1], 'r', encoding='utf-8') as f:
-    text = f.read()
-sents = [s for s in re.split(r'[。！？]+', text) if s.strip()]
-total = max(len(sents), 1)
-short = sum(1 for s in sents if len(s) < 15)
-mid   = sum(1 for s in sents if 15 <= len(s) <= 30)
-lng   = sum(1 for s in sents if len(s) > 30)
-chars = max(sum(1 for c in text if not c.isspace()), 1)
-puncts = sum(1 for c in text if c in '，。！？；：、…—""\'\'')
-avg = sum(len(s) for s in sents) // total
-print(f'sentences={total}; short_lt15={100*short//total}%; mid_15to30={100*mid//total}%; long_gt30={100*lng//total}%; avg_len={avg}; punct_density={100*puncts//chars}%')
-PYEOF
-```
-
-实测输出形如 `sentences=6; short_lt15=66%; mid_15to30=33%; long_gt30=0%; avg_len=12; punct_density=15%`。
-
-把输出的 `short_lt15 / mid_15to30 / long_gt30 / avg_len / punct_density` 数值直接填进 `style-profile-protocol.md` 模板第 40 行的 `{...X% / Y% / Z%}` 占位符——`confidence: high`，因为是确定性测量，不是抽样估计。
-
-**Bash 不可用时的降级**（仅子代理上下文等极端情况，主线程不会触发）：
-
-- 跳过本步骤；句长段写「Bash 工具不可用，跳过确定性统计」
-- `confidence: low`，narrative-writer 让位回默认 Gate D（按句长标准校准）
-
-### Step 5: 选原文锚点片段 (4-6 段)
-
-从 Step 3 输出的章节基调里挑覆盖度最高、且项目可能需要的 4-6 类基调（优先覆盖：紧张/悲伤或压抑/轻松或温馨/热血）。若某类基调在对标书中少于 3 章，不强行编造；在文风文件中说明跳过。每类基调选 1 章作为锚点章。
-
-**同基调多章时的选择规则**：
-
-1. **L1 爽点类型最强匹配**：参考该章 `_摘要.md` 的「关键事件」+ 基调序列，挑爽点最突出的章节
-2. **L2 原文章节长度最接近日更目标**：若 Step 4 已切出章节边界，用原文章节切片估算字数；若无法切原文，只用 `_摘要.md` 的情节点数量近似复杂度，不把摘要文件长度当作原文章节字数
-3. **L3 章节号最小**：最早期的章节 = 作者最 canonical 的 voice（未受连载漂移影响）
+## 单独重建文风
 
-锚点切片：
+当 story-long-write 或用户发现 `文风.md` 缺失时：
 
-- 用 Step 4 从 `_progress.md` 读取的章节起止行
-- 该章原文从中选 1 段 300-500 字（优先选对话+动作交织的段落，纯独白/纯设定段不选）
-- 用 `Read offset limit` 切出，保留原标点和段落断行
-- **锚点必须逐字连续切片，禁止改写/缩写/跳段/拼接**：narrative-writer 拿锚点当 few-shot 直接学，标注的行号要能回查原文。落盘前逐段抽 1-2 句 `grep -F` 回 `原文/原文.txt`，grep 不到即说明被改写或拼接——重切为忠实连续片段。确需跳过中间过渡段时，分别标各自真实行号（如「行264-267 + 行269-270」）并在引用块内用「（……中略……）」显式断开，不得用一个连续行号区间假装连续
+1. 运行检查器，确认其他拆文成果可用且 `stage_repairs` 包含 `stage6_style`；
+2. 若 `_style-sample.txt` 有效，直接用它；
+3. 否则确认 `chapter_index.csv` 与原文存在。缺索引时只运行：
 
-### Step 6: 落盘
+   ```text
+   "{PYTHON}" "{story-long-analyze skill 根}/scripts/build_chapter_index.py" --source "{拆文目录}/原文/原文.txt" --output "{拆文目录}/chapter_index.csv" --locator-path "原文/原文.txt"
+   ```
 
-按 [style-profile-protocol.md](style-profile-protocol.md) 模板填写 `拆文库/{书名}/文风.md`：
+4. 从索引中选择 4–6 章，优先覆盖紧张、轻松、冲突、关系回收、高潮与收束等已有资料能确认的不同基调；按行号只取每章一段 300–500 字连续原句，写入或更新 `_style-sample.txt`；
+5. 按 [style-profile-protocol.md](style-profile-protocol.md) 生成 `文风.md`；
+6. 文件成功落盘后运行：
 
-- **文风文件必须留在拆文库**（`拆文库/{书名}/文风.md`），**永不由 analyze 直接写入** `对标/` 或写作项目目录——拆文库是数据源；只有该书被明确选为另一项目的外部对标时，才由 story-import 或 story-long-write 首次引用同步到 `对标/{书名}/`
-- 每段标 `confidence: high/med/low`（内部给写作 agent 判断强弱，普通用户可忽略）：
-  - `high`：数据直接来自拆文产物（如「写法技巧」直接引用拆文报告）
-  - `med`：从样本归纳且样本充足（如基调序列从 ≥10 章摘要统计）
-  - `low`：样本不足或采样失败（如锚点缺失、Bash 不可用导致 Step 4 句长统计跳过）
-- 「分层模仿建议」必须分基础层 / 进阶层 / 适配层；基础层只写词汇、句式、描写和对话习惯，进阶层写节奏、伏笔、视角和场景衔接，适配层写哪些可用、哪些容易让本项目错位；明确不复制专名、标志性台词、独特桥段和事件顺序
-- 字数预算：硬上限 ~4000 字。**描述段 ≤ 1800 字 + 锚点 4-6 段 × 300-500 字**
-- 如果 Step 4 失败（章节分隔符识别不出）→ 「生成记录」写 `文风可用：否：无法识别章节分隔符`；原文锚点段全填占位符 "原文缺失，需手动补充"，confidence 全 low
+   ```text
+   "{PYTHON}" "{story-long-analyze skill 根}/scripts/manage_analysis_run.py" mark-stage --root "{拆文目录}" --stage stage6 --output "文风.md"
+   ```
 
-## 失败模式与降级
+索引、原文和有效样本都不存在时停止，返回“无法取得可验证文风锚点”，不得生成锚点全空的可用文风。
 
-| 场景 | 降级策略 |
-|---|---|
-| `原文/原文.txt` 不存在 | 跳过 Step 4-5；文风文件仅含描述段；「生成记录」写 `文风可用：否：原文缺失` |
-| `章节/*_摘要.md` 数量 <3 | 跳过 Step 3 基调序列；情绪交替段标 confidence: low |
-| `章节/第1-3章_深度拆解.md` 缺失 | 跳过 Step 2；对话潜台词段从拆文报告兜底；confidence: low |
-| `拆文报告.md` 不存在 | **停止 Stage 6**，提示用户拆文未完成，先跑完 Stage 5 |
+## 档案内容
 
-## 与 chapter-extractor 的关系
+- 叙述视角、段落推进、对白比例、动作与心理安排；
+- 句长、标点、口吻和角色语气，只从原文锚点归纳；
+- 情绪转场引用三维节奏和篇幅安排，不把剧情强度当文风；
+- 每项标 `high / med / low` 置信度及来源路径；
+- 原文锚点 4–6 段，每段标章节、行号、基调和示范点。
 
-**不修改 chapter-extractor**。文风直接从既有字段（基调/主题标签/可借鉴要素）整理生成即可。
+## 字段速查
 
-句长 / 标点密度由 Step 4 的跨平台 Python 1-liner 在 Stage 6 主线程直接算出，不依赖 chapter-extractor。
+完整模板见 [style-profile-protocol.md](style-profile-protocol.md)。
 
-## 与写作端的关系
+| 段落 | 内容 | 必标可信度 | 上限 |
+|---|---|---|---|
+| 生成记录 | 参考了哪些资料 + 抽样看了哪几章 + 文风是否可用 | 否 | <100 字 |
+| 整体语感 | 句长分布 / 标点习惯 / 段落节奏 | 是（每子项一标） | ~500 字 |
+| 对话技法 | 潜台词模式 / 对话标签 / 角色语气区分 | 是（潜台词必标） | ~400 字 |
+| 情绪交替模式 | 章内基调切换 / 跨章基调周期 / 喜剧↔重击转场 | 是（章内切换必标） | ~400 字 |
+| 可借鉴技巧 | 写法技巧 Top 5 + 可借鉴套路 Top 3（从拆文报告引用；情绪/节奏意图只引用 `剧情/情绪模块.md` / `剧情/节奏.md`，不在文风中重定义） | 否 | ~300 字 |
+| 分层模仿建议 | 基础层 / 进阶层 / 适配层，各写可执行边界 | 否 | ~350 字 |
+| **原文锚点片段** | **4-6 段 × 300-500 字**，按基调分类，标"出处 + 行号 + 示范点" | 否 | ~2400 字 |
+| 不可模仿 | 对标书缺陷或不适合本项目的技法 | 否 | <100 字 |
 
-- analyze Stage 6 写 `拆文库/{书名}/文风.md`
-- story-import 显式绑定外部对标或 story-long-write 首次引用 `拆文库/{书名}/` 时，同步到项目 `{项目}/对标/{书名}/` 并**包含**文风（与拆文报告同等待遇）；不得把正在导入的本书自身作为该外部对标
-- 写作端（story-long-write）的日更循环读 `{项目}/对标/{书名}/文风.md`（按对标书路径查找规则，回退 `拆文库/{书名}/`）
+**总上限 ~4000 字**。
 
-## 单独重建文风
+## 质量检查
 
-当前拆文产物仅缺 `文风.md` 时，可直接按本 SOP 跑 6 步（仅 Stage 6），无需重跑 Stage 0-5；前提是 `_progress.md` 满足当前章节边界契约。触发：用户直接说 "为对标书 X 生成文风" 或 "重生 文风"。
+- 每条高置信结论都有资料路径或可核原文锚点；
+- 4–6 段锚点覆盖不同基调，且来自索引指定的局部行段；
+- 摘要没有被当成作者原句；
+- `文风.md` 保持现有下游字段，未获增强请求时不覆盖旧文件；
+- Stage 6 失败只报告本阶段缺口，不回头重跑 Stage 1–5。

package/lib/oh-story/skills/story-long-analyze/references/style-profile-protocol.md

@@ -6,12 +6,12 @@
 
 `拆文库/{书名}/文风.md` 是整书级写作技法视图，聚合：
 
-- 句长 / 标点 / 段落节奏（从原文采样统计）
+- 句长 / 标点 / 段落节奏（从已有样本或按索引定点读取的可验证原句统计）
 - 对话潜台词模式 + 角色语气区分
 - 章内 + 跨章情绪交替周期（看每章基调如何变化）
 - `拆文报告.md` 已有的「写法技巧」「可借鉴套路」
 - 分层模仿建议（基础层 / 进阶层 / 适配层，强调学手法不搬桥段）
-- 4-6 段 300-500 字原文锚点片段（范例片段用）
+- 4-6 段可验证原文锚点片段（范例片段用；优先已有样本，没有时按索引定点读取，都不可用时明确失败）
 
 ## 文件路径
 
@@ -32,13 +32,13 @@
 
 ## 生成记录
 - 参考资料：拆文报告.md、黄金三章深度拆解、章节摘要
-- 抽样章节：第 {K1}/{K10}/{K20} 章（每章约 1000 字）
+- 抽样章节：第 {K1}/{K2}/{K3}/{K4}[/{K5}/{K6}] 章（每章取 300-500 字连续行段）
 - 生成时间：{date}
 - 适用对标书路径：拆文库/{书名}/
 - 文风可用：是  # 若原文缺失或锚点不足，写“否：原因”
 
 ## 整体语感
-- 句长分布：{由 `style-profile-generator.md` Step 4 的跨平台 Python 1-liner 在 3 章拼接样本上确定性测量——短句(<15字)占比 X%、中句(15-30)Y%、长句(>30)Z%、平均句长 N 字、标点密度 M%。一句概括语感。`confidence: high`（数据由脚本算出，不是抽样估计）。}
+- 句长分布：{在 4-6 段合并样本上确定性测量——短句(<15字)占比 X%、中句(15-30)Y%、长句(>30)Z%、平均句长 N 字、标点密度 M%。一句概括语感。`confidence: high`（数据由机械统计得出，不是模型估计）。}
   - confidence: high | med | low
 - 标点习惯：{破折号/省略号/句号/感叹号/分号 的高频用法。附 2-3 个原文短片段示例。}
   - confidence: high | med | low
@@ -72,7 +72,7 @@
 
 ## 原文锚点片段
 
-> 每片段 300-500 字，**用于 narrative-writer 写作时的范例片段**。从 `原文/原文.txt` 按章节分隔符切片。模仿手法、不抄字句。
+> 每片段 300-500 字，**用于 narrative-writer 写作时的范例片段**。优先复用旧文风、黄金三章或批次中已经保存并带定位的连续原句；没有有效样本时，Stage 6 可按 `chapter_index.csv` 定点读取 4-6 段连续原文。不得重扫全书。模仿手法、不抄字句。
 
 ### 片段 A — 基调：紧张
 **出处**：第 {K} 章 第 {段号} 段（行 {L1}-{L2}）
@@ -128,6 +128,6 @@
 ## 覆盖与不可模仿原则
 
 - **覆盖**：文风优先级排在 Gate D（节奏调整）、Gate B（句式去套路）、标点默认习惯之上——这些 Gate 是去 AI 味的**默认值**，文风有更具体的指令时文风赢。
-- **不可覆盖（硬约束）**：banned-words / Gate F 章末禁升华 / 禁止万能/堆叠比喻 / 禁止章末预告 / 字数下限——这些硬约束永远赢，即使文风示范了相反的用法。
+- **不可覆盖**：细纲事件、信息揭露边界、用户字数范围、文件结构。禁用词、结尾、比喻等表达默认值按 style-resolution 的优先级裁决，对标文风低置信时让位给默认值。
 
 精确决议表见 `.claude/agents/narrative-writer.md` 的“被调用协议”段。

package/lib/oh-story/skills/story-long-analyze/references/synthesis-inputs.md

@@ -0,0 +1,39 @@
+# Stage 3–5：取料与事实保真
+
+Stage 3、4、5 各自的时刻都读本文件。
+
+## 取料
+
+不整份 Read 批次缓存（每批约七成是和逐章摘要重复的章节块），改用只读的 `digest` 按需取料，输出是 Markdown：
+
+```text
+"{PYTHON}" "{story-long-analyze skill 根}/scripts/manage_analysis_run.py" digest --root "{拆文目录}" --part observations [--chapters 1-60]
+"{PYTHON}" "{story-long-analyze skill 根}/scripts/manage_analysis_run.py" digest --root "{拆文目录}" --part chapters --chapters 1-60 --fields 三维节奏,涉及,状态变化 --points brief
+```
+
+- `observations`：按章序汇总已提交批次的跨章观察（剧情点、关键事件与披露候选、关系变化、三维峰谷、跨批状态），是 Stage 3–4 的主语料；
+- `chapters`：从逐章摘要抽字段（概要、关键事件、因果、局面结果、涉及、信息变化、状态变化、三维节奏、章尾钩子、证据），`--points brief` 给每点「标题｜类型｜基调」，`full` 另带白描；
+- 全书放不进一次上下文时按 `--chapters` 分窗口取、分组合并，窗口间只带剧情状态、关键候选与证据引用，不扩写内容；只有关键证据冲突才定点 Read 单章 `章节/第N章_摘要.md`，最多增加一次定点核验；
+- 旧项目没有批次缓存时，直接复用现有剧情、节奏、情绪、关系和逐章资料，不要为了统一格式先把旧摘要重新压缩一遍；证据不足或冲突时标未知或待核；
+- Stage 3–5 不回读原文，也不各自重读同一批原文；Stage 6 可以按索引定点读取 4–6 段文风锚点，但不得重新扫描整本原文。
+
+## 阶段标记
+
+Stage 1 黄金三章与快速预览落盘后标 `stage1`；计划不再有批次时标 `stage2`。Stage 3–6 各运行一次。文件成功原子落盘后再标记：
+
+```text
+"{PYTHON}" "{story-long-analyze skill 根}/scripts/manage_analysis_run.py" mark-stage \
+  --root "{拆文目录}" --stage stage3 --output "剧情/节奏.md"
+```
+
+阶段完成只看约定产物存在且进度行完成；没有依赖 hash 或 Stage receipt。`mark-stage` 会按阶段检查：Stage 1 的黄金三章与快速预览、Stage 2 的全部摘要、Stage 3 的情绪模块与节奏、Stage 4 的角色与设定、Stage 5 的报告、Stage 6 的文风。Stage 6 的单独重建见 [style-profile-generator.md](style-profile-generator.md)，允许按索引定点读取 4–6 段原文，不重扫全书，也不触发其他阶段。
+
+## 合成阶段事实保真（阶段 3-5：剧情/设定/角色/报告）
+
+阶段 3-5 从章节摘要二次合成，离原文已两跳，最易把「摘要没说的」用合理推断补成「看似坐实的事实」——这是拆文事实错误的最大来源（典型：给「双系魔法师」凭空补第二系、把坐骑等级安到骑手头上、给原文没给的字段编一个数值、把出场区间填成连续跨度含没出场的章）。强模型也照样漂移，因为越远离原文，模型越靠世界知识与"合理性"填空。三条硬约束：
+
+1. **硬事实必须可溯源**：力量等级、数值、距离、属性、势力数量、谁对谁说了什么、角色出场章节——先检查批次证据或已有事实的章节和定位；命中不到就改写为“资料未明确”或删除，不为聚合二次读取原文。
+2. **缺失写「原文未明确」，禁编造填空**：原文没给的字段，写「原文未明确/节选未涉及」，绝不用近义项、别处的范例或惯例补一个看似合理的值。
+3. **跨指代不串**：相邻实体的属性不互相挪用——坐骑等级≠骑手等级、A 的台词≠B 的台词、本章统计数字≠相邻章数字。
+
+落盘后做一次**事实可溯源自检**：抽查设定、角色和报告里的硬事实，逐条核对到本次允许使用的证据源。`raw-original` 可按 `source_locator` 机械定位原文，`existing-results` 只能核对计划列出的旧成果文件；旧成果没有的细节改写为「旧资料未提供」或删除，不借核证之名回读已覆盖章节原文。此自检独立于 Stage 3 的质量阈值——阈值查归类质量，它查事实真伪。