@lemoncat7/dsh-partner 2.8.0 → 2.8.2

package/resources/skills/story-creation/upstream/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/resources/skills/story-creation/upstream/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/resources/skills/story-creation/upstream/skills/story-long-analyze/references/style-profile-generator.md

@@ -0,0 +1,76 @@
+# 文风档案生成与单独重建
+
+> **何时加载**：story-long-analyze Stage 6。Stage 6 可以在完整管道末尾运行，也可以在已有拆文只缺 `文风.md` 时单独运行；单独运行不得触发 Stage 1–5。
+
+## 原则
+
+1. 文风档案描述作者实际写法，不评价作者水平。
+2. 情绪和节奏意图以 `剧情/情绪模块.md`、`剧情/节奏.md` 为准，文风只管表达层。
+3. 已有完整 `文风.md` 时原样保留；用户明确要求增强时才更新。
+4. Stage 6 不重扫全书。允许使用索引行号定点回读 4–6 段原文，以补齐可验证锚点。
+5. 摘要措辞不能冒充作者原句；缺少原文和有效样本时明确报错。
+
+## 来源顺序
+
+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` 定点读取原文片段。
+
+第 5 项只读取被选章节的局部行段，不允许从头到尾扫描原文。没有索引的旧项目可以仅运行机械索引脚本；这一步不写 `_progress.md`，也不启动其他分析阶段。
+
+## 单独重建文风
+
+当 story-long-write 或用户发现 `文风.md` 缺失时：
+
+1. 运行检查器，确认其他拆文成果可用且 `stage_repairs` 包含 `stage6_style`；
+2. 若 `_style-sample.txt` 有效，直接用它；
+3. 否则确认 `chapter_index.csv` 与原文存在。缺索引时只运行：
+
+   ```text
+   "{PYTHON}" "{story-long-analyze skill 根}/scripts/build_chapter_index.py" --source "{拆文目录}/原文/原文.txt" --output "{拆文目录}/chapter_index.csv" --locator-path "原文/原文.txt"
+   ```
+
+4. 从索引中选择 4–6 章，优先覆盖紧张、轻松、冲突、关系回收、高潮与收束等已有资料能确认的不同基调；按行号只取每章一段 300–500 字连续原句，写入或更新 `_style-sample.txt`；
+5. 按 [style-profile-protocol.md](style-profile-protocol.md) 生成 `文风.md`；
+6. 文件成功落盘后运行：
+
+   ```text
+   "{PYTHON}" "{story-long-analyze skill 根}/scripts/manage_analysis_run.py" mark-stage --root "{拆文目录}" --stage stage6 --output "文风.md"
+   ```
+
+索引、原文和有效样本都不存在时停止，返回“无法取得可验证文风锚点”，不得生成锚点全空的可用文风。
+
+## 档案内容
+
+- 叙述视角、段落推进、对白比例、动作与心理安排；
+- 句长、标点、口吻和角色语气，只从原文锚点归纳；
+- 情绪转场引用三维节奏和篇幅安排，不把剧情强度当文风；
+- 每项标 `high / med / low` 置信度及来源路径；
+- 原文锚点 4–6 段，每段标章节、行号、基调和示范点。
+
+## 字段速查
+
+完整模板见 [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 字 |
+
+**总上限 ~4000 字**。
+
+## 质量检查
+
+- 每条高置信结论都有资料路径或可核原文锚点；
+- 4–6 段锚点覆盖不同基调，且来自索引指定的局部行段；
+- 摘要没有被当成作者原句；
+- `文风.md` 保持现有下游字段，未获增强请求时不覆盖旧文件；
+- Stage 6 失败只报告本阶段缺口，不回头重跑 Stage 1–5。

package/resources/skills/story-creation/upstream/skills/story-long-analyze/references/style-profile-protocol.md

@@ -0,0 +1,133 @@
+# 文风协议
+
+> **何时加载**：story-long-analyze Stage 6 执行前。下游写作 skill 直接读 `文风.md`，不加载本协议。
+
+## 产物定义
+
+`拆文库/{书名}/文风.md` 是整书级写作技法视图，聚合：
+
+- 句长 / 标点 / 段落节奏（从已有样本或按索引定点读取的可验证原句统计）
+- 对话潜台词模式 + 角色语气区分
+- 章内 + 跨章情绪交替周期（看每章基调如何变化）
+- `拆文报告.md` 已有的「写法技巧」「可借鉴套路」
+- 分层模仿建议（基础层 / 进阶层 / 适配层，强调学手法不搬桥段）
+- 4-6 段可验证原文锚点片段（范例片段用；优先已有样本，没有时按索引定点读取，都不可用时明确失败）
+
+## 文件路径
+
+- **写**：`拆文库/{书名}/文风.md`（analyze 独占）
+- **读**：该书被显式选为另一项目的外部对标时，由 story-import 或 story-long-write 首次引用同步到 `{项目}/对标/{书名}/文风.md`；story-long-write 读项目对标视图（回退拆文库）。story-import 正在重建的本书不走这条同步。
+
+## 字数预算
+
+- **硬上限 ~4000 字**
+- 描述部分（整体语感 + 对话技法 + 情绪交替模式 + 可借鉴技巧 + 分层模仿建议）≤ 1800 字
+- 原文锚点片段 4-6 段 × 300-500 字 ≈ 1600-2400 字
+- 不可模仿 + 生成记录 ≤ 100 字
+
+## 模板
+
+```markdown
+# {书名} 文风
+
+## 生成记录
+- 参考资料：拆文报告.md、黄金三章深度拆解、章节摘要
+- 抽样章节：第 {K1}/{K2}/{K3}/{K4}[/{K5}/{K6}] 章（每章取 300-500 字连续行段）
+- 生成时间：{date}
+- 适用对标书路径：拆文库/{书名}/
+- 文风可用：是  # 若原文缺失或锚点不足，写“否：原因”
+
+## 整体语感
+- 句长分布：{在 4-6 段合并样本上确定性测量——短句(<15字)占比 X%、中句(15-30)Y%、长句(>30)Z%、平均句长 N 字、标点密度 M%。一句概括语感。`confidence: high`（数据由机械统计得出，不是模型估计）。}
+  - confidence: high | med | low
+- 标点习惯：{破折号/省略号/句号/感叹号/分号 的高频用法。附 2-3 个原文短片段示例。}
+  - confidence: high | med | low
+- 段落节奏：{平均段长、单段单动作 vs 多动作堆叠、断行习惯。}
+  - confidence: high | med | low
+
+## 对话技法
+- 潜台词模式：{2-3 种典型潜台词手法（问非所答 / 语气反差 / 信息隐瞒等），每种附 1 段原文示例。}
+  - confidence: high | med | low
+- 对话标签习惯：{说话动词多样性、动作替代说话标签的频率、对话与动作的穿插比例。}
+- 角色语气区分：{主角和 1-2 个核心配角的口头禅/句式差异，引用原文样本句。}
+
+## 情绪交替模式
+- 章内基调切换：{统计章节内情节点基调序列——典型章节是否在 紧张↔轻松 或 热血↔温馨 之间切换、切换频率（每章 N 次）。}
+  - confidence: high | med | low
+- 跨章基调周期：{前 20 章「章基调」序列，识别“虐 3 章爽 1 章”之类周期。}
+- 喜剧↔重击的转场手法：{对标书在 轻松→悲伤 锐角转场时用了什么手法，举 1-2 个原文锚点。}
+
+## 可借鉴技巧（从 拆文报告.md 直接引用）
+- 写法技巧 Top 5：
+  1. {技巧名}：{一句话用法说明}
+  2. ...
+- 可借鉴套路 Top 3：
+  1. {套路名}：{适用场景}
+  2. ...
+
+## 分层模仿建议
+- 基础层（必学）：{词汇偏好、句式节奏、对话标签、描写重心中最容易迁移的 3-5 条；只学表达习惯，不复制原句}
+- 进阶层（结构）：{节奏推进、伏笔埋回、视角切换、场景衔接中最值得复用的 3-5 条；替换人物/场景/道具后再使用}
+- 适配层（本书化）：{哪些技法适合当前项目，哪些会导致人设/题材错位；明确不要搬运专名、标志性台词、独特桥段和事件顺序}
+
+## 原文锚点片段
+
+> 每片段 300-500 字，**用于 narrative-writer 写作时的范例片段**。优先复用旧文风、黄金三章或批次中已经保存并带定位的连续原句；没有有效样本时，Stage 6 可按 `chapter_index.csv` 定点读取 4-6 段连续原文。不得重扫全书。模仿手法、不抄字句。
+
+### 片段 A — 基调：紧张
+**出处**：第 {K} 章 第 {段号} 段（行 {L1}-{L2}）
+**示范点**：{句长节奏（该处长短如何分布） / 标点位置 / 一笔两用 等}
+
+```
+{300-500 字原文}
+```
+
+### 片段 B — 基调：悲伤/压抑
+**出处**：第 {K} 章 第 {段号} 段（行 {L1}-{L2}）
+**示范点**：{对话潜台词手法}
+
+```
+{300-500 字原文}
+```
+
+### 片段 C — 基调：轻松/搞笑
+**出处**：第 {K} 章 第 {段号} 段（行 {L1}-{L2}）
+**示范点**：{句子节奏 / 角色语气区分}
+
+```
+{300-500 字原文}
+```
+
+### 片段 D — 基调：热血/爽点
+**出处**：第 {K} 章 第 {段号} 段（行 {L1}-{L2}）
+**示范点**：{爽点铺放比 / 动作描写句长}
+
+```
+{300-500 字原文}
+```
+
+> 优先覆盖项目可能用到、且对标书中样本充足的基调：紧张、悲伤/压抑、轻松/温馨、热血。按拆文里实际分布挑 4-6 段；缺哪个基调就写“本书该基调样本不足，跳过”，不要编造。
+
+## 不可模仿
+- {对标书的明显缺陷或不适合当前项目的技法。可选段落，可空。}
+```
+
+## confidence 字段语义
+
+| 值 | 触发条件 | 下游处理 |
+|---|---|---|
+| `high` | 数据直接可读（如基调序列从摘要 grep 得出） | narrative-writer 优先采纳，覆盖默认 Gate |
+| `med` | 从样本归纳且样本充足（如看章节基调走向、对话潜台词整理） | narrative-writer 参考，与默认 Gate 协商 |
+| `low` | 样本不足/原文缺失 | narrative-writer 让位回默认 Gate（不强制采纳） |
+
+## 可用性语义
+
+- `文风可用：是` → 文风可用于写作，narrative-writer 按 confidence 分级使用。
+- `文风可用：否：{原因}` → 文风质量不足（例如原文缺失、锚点全是占位符）。story-explorer 读取时返回 `gaps.profile_degenerate: true`，narrative-writer 跳过文风，按默认 Gates 写作，避免被误导。
+
+## 覆盖与不可模仿原则
+
+- **覆盖**：文风优先级排在 Gate D（节奏调整）、Gate B（句式去套路）、标点默认习惯之上——这些 Gate 是去 AI 味的**默认值**，文风有更具体的指令时文风赢。
+- **不可覆盖**：细纲事件、信息揭露边界、用户字数范围、文件结构。禁用词、结尾、比喻等表达默认值按 style-resolution 的优先级裁决，对标文风低置信时让位给默认值。
+
+精确决议表见 `.claude/agents/narrative-writer.md` 的“被调用协议”段。

package/resources/skills/story-creation/upstream/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 的质量阈值——阈值查归类质量，它查事实真伪。