@oh-story/dsh 0.1.15 → 0.1.17

package/lib/oh-story/skills/story-import/references/length-routing.md

@@ -6,20 +6,20 @@ Phase 1「基本信息确认」环节使用本规则判定导入书是长篇还
 
 ## 判定优先级
 
-判定按以下顺序执行，命中即停止，不再向下判断。
+作者明确声明篇幅类型时直接锁定；未声明时按以下信号初判，有冲突则在 Phase 1 一次确认，后续不再重判。
 
 | 优先级 | 信号来源 | 判定规则 |
 |--------|---------|---------|
-| 1 | 用户显式声明 | 用户说「这是长篇 / 短篇」→ 以用户为准，直接锁定 |
-| 2 | 结构信号 + 字数校验 | 检测到明确章节分隔符且章节数 ≥ 5 → 长篇；全文无章节分隔、单文件单篇 → 按下方细则表按字数分三档判定（字数阈值沿用优先级 3 的建议值） |
-| 3 | 字数兜底 | 仅在 1、2 均不明确时启用，见下方「字数兜底规则」 |
-| — | 冲突处理 | 信号之间发生矛盾时，不自动决策，回到 Phase 1 向用户复述并请用户拍板 |
+| 1 | 用户显式声明 | 以作者声明直接锁定，不用检测结果推翻 |
+| 2 | 结构信号 + 字数校验 | 结合章节分隔符与字数，按下方细则初判 |
+| 3 | 字数兜底 | 仅在前两项均不明确时启用，见「优先级 3：字数兜底」 |
+| — | 冲突处理 | 作者未声明类型、检测信号矛盾时，在 Phase 1 复述差异并请作者拍板 |
 
 ---
 
 ## 优先级 1：用户显式声明
 
-Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
+Phase 1 尚未明确篇幅时提问：**「这是长篇还是短篇？」**
 
 - 用户明确回答 → 锁定类型，跳过后续检测。
 - 用户未回答或说「不确定」→ 进入优先级 2 结构信号检测。
@@ -30,7 +30,7 @@ Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
 
 ### 章节分隔符识别
 
-复用 `structure-mapping-long.md` 的分隔符识别表：
+按下表识别章节分隔符：
 
 | 分隔符模式 | 示例 |
 |-----------|------|
@@ -42,7 +42,7 @@ Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
 
 | 检测结果 | 判定 |
 |---------|------|
-| 有明确章节分隔符，且识别到章节数 ≥ 5 | 强长篇信号 → 判定为**长篇** |
+| 有明确章节分隔符，且识别到章节数 ≥ 5 | 初判**长篇**；总字数 < 30000 时按「分章短篇连载」提示作者确认 |
 | 全文无任何章节分隔符，单文件单篇，且总字数 < 20000 | 强短篇信号 → 判定为**短篇** |
 | 全文无任何章节分隔符，单文件单篇，20000 ≤ 总字数 < 30000 | 判定为**短篇**，但 Phase 1 复述时告知：已超过短篇拆解管道 20000 字的建议上界，请用户确认仍按短篇导入 |
 | 全文无任何章节分隔符，单文件单篇，但总字数 ≥ 30000 | 结构与字数信号相反 → 不自动判定，见下方「冲突处理」请用户拍板 |
@@ -53,16 +53,12 @@ Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
 
 ## 优先级 3：字数兜底
 
-**仅在优先级 1、2 均无法给出明确判定时使用。** 当前导入契约按短篇通常 8000-20000 字的区间取 30000 字作建议上界，并保留题材差异余量。
+**仅在优先级 1、2 均无法给出明确判定时使用。** 30000 字是本导入流程的建议分界，不代表平台投稿上限。
 
 | 条件 | 判定 | 备注 |
 |------|------|------|
-| 总字数 < 30000 且无章节结构 | **短篇** | — |
+| 总字数 < 30000，章节结构不明确或章节数 < 5 | **短篇** | 统一在 Phase 1 确认 |
 | 总字数 ≥ 30000 | **长篇** | — |
-| 章节数 ≥ 5（任意字数） | **长篇** | — |
-| 总字数 < 30000 但章节数 ≥ 5 | 初判**长篇**，但须提示用户 | 见下方「分章短篇连载」 |
-
-> **建议值说明**：30000 字阈值是估算值，不同平台和题材的短篇上限有差异。执行时列入 open-questions，建议用户复核是否适用于当前导入书。
 
 ### 分章短篇连载
 
@@ -86,49 +82,3 @@ Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
 | 结构信号与字数信号方向相反 | 展示两项信号，请用户决定 |
 
 用户拍板的结果写进导入记录（`{书目录}/.story/work/导入记录.md` 的「篇幅」），后续时刻以此为准，不再重新判定。
-
----
-
-## 判定结果与后续路径
-
-判定完成后，迁移路径按以下对应关系分流：
-
-| 判定结果 | 迁移路径 | 映射规则参考文件 |
-|---------|---------|----------------|
-| **长篇** | 长篇迁移路径（Phase 3-L） | `structure-mapping-long.md` |
-| **短篇** | 短篇迁移路径（Phase 3-S） | `structure-mapping-short.md` |
-
-> 注：`structure-mapping-long.md` 对应长篇迁移映射规则，`structure-mapping-short.md` 对应短篇迁移映射规则。
-
----
-
-## 快速判定流程图
-
-```
-Phase 1 问用户：「长篇还是短篇？」
-         │
-         ├─ 用户明确回答 ──────────────────────────► 锁定类型
-         │
-         └─ 未回答 / 不确定
-                  │
-                  ▼
-         检测章节分隔符
-                  │
-                  ├─ 有分隔符且章节数 ≥ 5 ──────────► 长篇
-                  │
-                  ├─ 无分隔符，单文件单篇，< 20000 ─► 短篇
-                  │
-                  ├─ 无分隔符，单篇，20000 ≤ 字数 < 30000 ─► 短篇（复述时告知超出建议上界）
-                  │
-                  ├─ 无分隔符，单文件单篇，≥ 30000 ─► 提示用户裁定
-                  │
-                  └─ 信号不明确
-                            │
-                            ▼
-                   字数兜底判定（30000 字阈值）
-                            │
-                            ├─ < 30000 且无章节结构 ─► 短篇
-                            ├─ ≥ 30000 ─────────────► 长篇
-                            ├─ 章节数 ≥ 5 ──────────► 长篇
-                            └─ < 30000 但章节数 ≥ 5 ─► 提示用户裁定
-```

package/lib/oh-story/skills/story-import/references/outline-reverse-rules.md

@@ -6,7 +6,7 @@
 
 - 对本批每一章，从任务包里该章的摘要要点反推 `大纲/细纲_第XXX章.md`；要点写「摘要未写」又必须写实际内容时，回看该章正文相关段落补证据，不改正文。
 - 字数目标写任务包里测好的历史长度（`visible_chars_v1` 下的实际长度），不是重新决定创作目标，不自己估算。
-- 单元ID 取任务包附的卷纲「剧情单元（反推）」行里包含本章的单元；单元内第几拍判断不出写 `[待补充]`。
+- 单元ID 取包里「卷纲剧情单元」中章节范围覆盖本章的那张卡；单元内第几拍判断不出写 `[待补充]`。
 - 钩子、人物关系变化、辅线/感情线、行动成本/收益归属等无法由原文摘要稳定判断的字段统一标 `[待补充]`；只反推有证据的蓝图，不为补齐字段编造关系或副线。已写成的历史章「本章禁止提前释放」写「无」；目标情绪与主角目标/关键选择不接受 `[待补充]`。
 
 ## 字段映射
@@ -15,18 +15,18 @@
 |---------|---------|---------|
 | 关键事件 + 局面结果 | 核心事件 | 合并为“谁采取什么行动 → 局面如何变化”；旧摘要没有 `局面结果` 时只用 `关键事件` |
 | 章节字数 | 字数目标 + 字数口径 | 写任务包里测好的 `actual` 与 `visible_chars_v1` |
-| `基调：` + 状态变化 | 目标情绪 | 写成「前状态→后状态」：用基调枚举（紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他）加本章状态变化归纳，不只写一个情绪词；必须写实际内容 |
+| `基调：` + 状态变化 | 目标情绪 | 结合各情节点基调（紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他）与状态变化，归纳为「前状态→后状态」；必须写实际内容 |
 | 关键事件 + 主角行动 | 主角目标/关键选择 | 原文里主角本章要什么、做了什么判断或选择；必须写实际内容 |
-| 所属剧情单元 | 单元ID/位置 | 取反推卷纲「剧情单元」表里包含本章的单元ID；单元内第几拍判断不出写 `[待补充]` |
+| 所属剧情单元 | 单元ID/位置 | 取章节范围包含本章的剧情单元卡的单元ID，对照卡里的单元节拍定第几拍；判断不出写 `[待补充]` |
 | （历史章） | 本章禁止提前释放 | 已写成的章节写「无」 |
-| 章尾钩子 | 章首承接证据 | 作为下一章开篇需要承接的等待；新的章首钩子设计目标仍标 `[待补充]` |
-| 爽点类情节点 | 爽点 | 从情节点类型推断；没有则写“无显性爽点 / [待补充]” |
+| 上一章的章尾钩子 | 章首钩子 | 上一章结尾留下、本章开头接住的等待；本批第一章用包里给的上一章章尾钩子，第 1 章或没有证据写 `[待补充]` |
+| 爽点类情节点 | 爽点 | 从情节点类型推断；本章没有爽点类情节点写「无显性爽点」 |
 | 情节点起承转合 + 因果 | 内容概括（起因/发展/转折/高潮/结尾） | 按情节点顺序归纳，用因果链校正起因与转折；证据不足写 `[待补充]` |
 | 主线/支线/任务线索 | 情节安排（主线/辅线/事件线/感情线/逻辑线） | 从剧情单元索引与摘要反推；无证据的辅线/感情线写“无”或 `[待补充]`，不得杜撰 |
 | 涉及 + 状态变化 | 人物关系和出场顺序 | `涉及` 给出候选人物，`状态变化` 只写有证据的“前 → 后”；关键物件从证据或旧情节点补充，缺失写 `[待补充]` |
-| 全部情节点 | 情节细化 / 情节点序列 | 按表格逐行写（# / 情节点 / 功能标签 / 执行边界）；保持原顺序，功能或边界不明写 `[待补充]`，不反推逐点字数配额 |
+| 全部情节点 | 情节细化 / 情节点序列 | 按任务包中的「标题｜类型｜基调」逐点归纳并填表（# / 情节点 / 功能标签 / 执行边界）；保持原顺序，未知写 `[待补充]`，不反推逐点字数配额 |
 | 胜负/反转/收益损失 | 行动成本（可无）/收益归属 | 有明确证据才填写；行动成本可无、不硬造；否则 `[待补充]` |
-| 章尾钩子 + 局面结果 | 结尾设定和钩子 | 结尾设定写原文落到最后的具体动作或画面，章尾钩子写已存在的等待；未来设计仍标 `[待补充]` |
+| 章尾钩子 + 局面结果 | 结尾设定和钩子 | 结尾设定写原文落到最后的具体动作或画面；章尾钩子写本章结尾已经留下的等待，摘要没写才标 `[待补充]` |
 
 ## 细纲模板
 
@@ -40,8 +40,8 @@
 - 单元ID/位置：{反推卷纲里本章所属剧情单元ID；单元内第几拍，判断不出写 [待补充]}
 - 目标情绪：{前状态→后状态，从基调与状态变化归纳，不只写一个情绪词；必须写实际内容}
 - 主角目标/关键选择：{原文里主角本章要什么、做了什么判断或选择；必须写实际内容}
-- 章首钩子：[待补充]
-- 爽点：{从情节点推断；无明确证据写 [待补充]}
+- 章首钩子：{上一章结尾留下、本章开头接住的等待；第 1 章或没有证据写 [待补充]}
+- 爽点：{从情节点推断；本章没有爽点类情节点写「无显性爽点」}
 - 本章禁止提前释放：无
 
 #### 内容概括（五段式）
@@ -73,7 +73,7 @@
 
 #### 结尾设定和钩子
 - 结尾设定：{原文落到最后的具体动作或画面；未解决问题；下一章推动力；未知写 [待补充]}
-- 章尾钩子：[待补充]
+- 章尾钩子：{本章结尾已经留下的等待；摘要没写写 [待补充]}
 ```
 
 每章一个文件，文件名 `大纲/细纲_第XXX章.md`（三位补零，与 `正文/第XXX章_*.md` 同号）。

package/lib/oh-story/skills/story-import/references/outline-reverse.md

@@ -10,14 +10,14 @@
 {PYTHON} {story-import skill 根}/scripts/build_outline_brief.py --project {书目录} --chapters {A-B}
 ```
 
-脚本把反推规则与模板（[outline-reverse-rules.md](outline-reverse-rules.md) 全文）、每章按 `visible_chars_v1` 测好的历史长度与摘要要点、卷纲里覆盖本批的剧情单元行，拼成 `{书目录}/.story/work/排纲/导入细纲_第AAA-BBB章.md`。执行者要读的总量超过约 25K 字时脚本自动少排几章（可少于 10 章），以 stdout JSON 的 `chapters` 为本批实际范围、`next` 为下一批起点。缺摘要的章改用简化摘要或正文，已算进总量。
+脚本将反推规则与模板（[outline-reverse-rules.md](outline-reverse-rules.md) 全文）、测好的历史长度、摘要要点和覆盖本批的卷纲剧情单元卡，拼成 `{书目录}/.story/work/排纲/导入细纲_第AAA-BBB章.md`。历史长度按 `visible_chars_v1` 计算；执行者要读的总量超过约 25K 字时脚本自动少排几章（可少于 10 章）。以 stdout JSON 的 `chapters` 为实际范围、`next` 为下一批起点，`null` 表示已到最后一章。缺摘要的章改读正文，所需正文量也计入总量。
 
-长度必须由脚本测，不得用模型估算或静默跳过。找不到 Python 3 或脚本报错时停下，用一句话告诉作者卡在哪（如「第 12 章正文读不到，先把正文迁完」），原文报错放技术备注；卷纲缺失时先回结构迁移补卷纲。
+长度必须由脚本测，不得用模型估算或静默跳过。找不到 Python 3 或脚本报错时停下，用一句话告诉作者卡在哪（如「第 12 章正文读不到，先把正文迁完」），原文报错放技术备注；卷纲缺失或找不到覆盖本批的单元卡时，先回结构迁移补卷纲。
 
 ## Step 2：写本批细纲
 
 - **有 story-architect**（导入记录写着可用，按 SKILL.md 顶部的 Agent 兼容性检查 canonical 目录）：主会话只取任务包路径，不读包的内容。Prompt：`项目目录：{dir}\n任务包：{任务包路径}\n先完整读取任务包，按包里的规则与模板完成；作者已定的事在 .story/work/导入记录.md，对话内容不会传给你\n交付后只回任务包开头要求的几项`。Antigravity 用 `invoke_subagent` + `TypeName: "story-architect"`。
-- **没有**：主会话完整读取任务包，自己按包写本批；不另读本文件以外的规则，也不整读拆文库摘要。
+- **没有**：主会话完整读取任务包，按包内规则写本批；不另读包外写作技法，也不整读拆文库摘要。
 
 ## Step 3：验收与交接
 

package/lib/oh-story/skills/story-import/references/structure-mapping-long.md

@@ -1,6 +1,8 @@
 # 结构迁移（长篇）
 
-Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导入书名}/` 分析结果转换为 `{导入书名}/` 长篇项目结构。篇幅、外部对标、目标平台、作者交代读导入记录（`{书目录}/.story/work/导入记录.md`），不回翻对话。追踪（`追踪/`）不在本时刻生成，逐章细纲在最后一步按批另起。
+长篇的结构迁移按本文件把 `拆文库/{导入书名}/` 转成长篇项目 `{导入书名}/`。书目录名与拆文目录名相同，写正文守卫据此放行正文迁移。
+
+外部对标、目标平台与作者交代取自导入记录（`{书目录}/.story/work/导入记录.md`）。本时刻只建追踪目录骨架，状态由 Phase 4 初始化；逐章细纲在最后一步分批反推。
 
 ---
 
@@ -28,18 +30,18 @@ Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导
 
 ### Step 3：角色文件迁移
 
-将 `拆文库/{导入书名}/角色/{角色名}.md` 迁移到 `设定/角色/{角色名}.md`，按下方「角色文件迁移模板」补齐 story-long-write 角色模板字段。角色分级（沿用 story-long-analyze 标准）：
+将 `拆文库/{导入书名}/角色/{角色名}.md` 迁移到 `设定/角色/{角色名}.md`，按下方「角色文件迁移模板」写。角色分级沿用拆文档案里的「定位」：
 
 | 等级 | 标准 | 迁移策略 |
 |------|------|---------|
 | 主角 | 出现章节 ≥50% + 推动主线 + 完整成长轨迹 | 完整迁移 |
 | 反派 | 与主角对立 + 推动核心冲突 + 明确动机 | 完整迁移 |
-| 核心配角 | 出现章节 ≥20% 或推动重要支线 | 完整迁移 |
-| 功能角色 | 出现章节 <20% + 作用有限 | 简化迁移 |
+| 核心配角 | 出现章节 ≥20% 或推动重要支线，或有独立人格和成长 | 完整迁移 |
+| 功能角色 | 出现章节 <20% + 作用有限 | 只填模板里标了「功能角色也填」的项 |
 
 ### Step 4：关系文件迁移
 
-将 `拆文库/{导入书名}/角色/角色关系.md` 转换为 `设定/关系.md`，按下方「关系文件转换规则」的目标格式模板输出。
+将 `拆文库/{导入书名}/角色/角色关系.md` 转换为 `设定/关系.md`，按下方「关系文件转换规则」输出。
 
 ### Step 5：同步世界观设定
 
@@ -47,25 +49,22 @@ Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导
 
 ### Step 6：题材定位生成
 
-从拆文报告中提取核心发现，生成 `设定/题材定位.md`（下方「题材定位生成」模板）。本书题材、核心梗、情绪与节奏摘要来自 `拆文库/{导入书名}/`，但这些字段不是对标登记。只有导入记录已明确绑定外部对标时，才追加「对标书清单 + 主对标书」段；主对标书最多 1 本，副对标 / 参考对标不限制数量。未绑定时省略整个对标登记段，不得用 `{导入书名}` 补位。导入记录里「作者交代」的偏好与红线同步写进模板的「作者已定」小节，续写时才看得到。
-
-后续如需快速概览，可另写「对标分析（派生概要）」表；该表不是权威 registry，不得替代 `主对标书` 与完整 `对标书列表`。所有登记项必须能回溯到对应 `拆文库/{对标书名}/`，不得引用本书根 `设定/`。
-
-### Step 7：对标结构化资产同步
+从拆文报告中提取核心发现，生成 `设定/题材定位.md`（下方「题材定位生成」模板）。本书题材、核心梗、情绪与节奏摘要来自 `拆文库/{导入书名}/`，但这些字段不是对标登记，不得用 `{导入书名}` 填对标。导入记录里「作者交代」的偏好与红线同步写进模板的「作者已定」小节，续写时才看得到。
 
-只处理导入记录里显式绑定的外部参考作品：把 `拆文库/{对标书名}/` 的结构化分析资产同步到项目引用视图 `{项目}/对标/{对标书名}/`，供 story-long-write 优先读取；映射见下方「对标引用视图同步规则」。没有绑定外部对标时跳过本步，不创建空目录；严禁使用 `拆文库/{导入书名}/` 或项目 `设定/` 作为复制源。
+### Step 7：外部对标（只在导入记录绑定了外部对标时）
 
-- 已选外部对标缺 `剧情/节奏.md` 或 `剧情/情绪模块.md` → 导入报告里告诉作者「《{对标书名}》的拆文缺节奏和情绪资料，这本对标暂时用不上；重新拆一次（`/story-long-analyze`）补齐后再接入」，并停止该对标召回；不得用摘要或报告生成空壳。本书核心工程迁移不回滚。两份老权威产物都存在时正常同步，缺少本次新增内嵌字段不阻断。
-- 其它结构化子目录缺失 → 在导入完成报告里用白话提示，不阻塞项目创建。
+导入记录绑定了外部 `{对标书名}` 时，读 [benchmark-sync.md](benchmark-sync.md) 照做：在题材定位追加对标登记，把 `拆文库/{对标书名}/` 的资料和文风同步到 `对标/{对标书名}/`。没有绑定时跳过本步，不创建对标子目录。
 
-### Step 8：文风同步
+### Step 8：本书文风
 
-外部对标已通过 Step 7 校验时，把 `拆文库/{对标书名}/文风.md` 复制到 `{项目}/对标/{对标书名}/文风.md`。纯复制，不重新生成；未绑定外部对标时跳过。拆文库没有文风文件（analyze 未跑 Stage 6）→ 导入报告提示作者重跑 `/story-long-analyze` 后再同步，日更前文风缺失会被 fail-fast 拦截；项目对标已有旧文风文件 → 覆盖（最新拆文产物优先），在导入报告告知。
+项目里还没有 `设定/文风.md`、而 `拆文库/{导入书名}/文风.md` 存在时，问作者：「拆书时整理了这本书自己的文风（句子长短、对话写法、常用手法），要存成本书的文风设定吗？存了以后续写照这个写；不存就按对标或默认写法。」作者同意后复制成 `设定/文风.md`，第一行写 `> 来源：导入时从本书已写章节整理（拆文库/{导入书名}/文风.md）`；不同意就不建。已有 `设定/文风.md` 时不覆盖、不提问。本书文风只放 `设定/`，不复制进 `对标/`。
 
 ### Step 9：大纲与卷纲（作者确认点）
 
 按下方「大纲反推规则」反推 `大纲/大纲.md`：原文有明确卷界直接按卷界分；没有时向作者展示候选卷划分，**等作者确认后**才写定卷级结构和 `大纲/卷纲_第X卷.md`，确认结果（或「按原文卷界」）写进导入记录的「卷划分」。`剧情/散落情节.md` 合并到相关卷纲或大纲附录。
 
+每份卷纲写完，按当前平台探测 Python 3（`python3` → `python` → `py -3`）跑 `{PYTHON} {story-import skill 根}/scripts/outline_view.py --check --strict {书目录}/大纲/卷纲_第X卷.md`，问题数归零才算写定；写正文时用同一个脚本按单元取卷纲，若未通过，续写第一章会停止。
+
 ### Step 10：逐批反推细纲
 
 卷纲写定、本文件末尾的质量清单通过后，在导入记录勾「结构迁移」，再按 [outline-reverse.md](outline-reverse.md) 分批反推细纲。细纲时刻只读任务包，不再读本文件；建议作者新开对话说「继续导入」再开始第一批。
@@ -78,14 +77,15 @@ Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导
 |-----------|---------|---------|
 | `原文/` | `正文/第XXX章_章名.md` | 按章节分割并标准化命名 |
 | `快速预览.md` | — | 参考卷划分候选、剧情走向，不直接迁移 |
-| `角色/{角色名}.md` | `设定/角色/{角色名}.md` | 增加角色模板字段 |
+| `角色/{角色名}.md` | `设定/角色/{角色名}.md` | 按角色卡模板改写 |
 | `角色/角色关系.md` | `设定/关系.md` | 格式转换 |
 | `设定/世界观/*.md` | `设定/世界观/*.md` | 按主题原样同步 |
 | `设定/势力/*.md` | `设定/势力/*.md` | 按势力原样同步 |
 | `剧情/故事线.md` | `大纲/大纲.md` | 反推卷级结构（需用户确认卷划分，见下） |
-| `剧情/{标题}.md` | `大纲/卷纲_第X卷.md` | 聚合为卷纲 |
+| `剧情/{标题}.md` | `大纲/卷纲_第X卷.md` 的剧情单元卡 | 一个剧情文件对应一张单元卡 |
 | `剧情/节奏.md` | `设定/题材定位.md`（节奏摘要） | 提炼已写部分的既有节奏，保留为本书导入基线；不复制到 `对标/` |
-| `剧情/情绪模块.md` | `设定/题材定位.md`（情绪摘要） | 提炼已写部分的读者需求与情绪引擎；不复制到 `对标/` |
+| `剧情/情绪模块.md` | `设定/题材定位.md`（情绪摘要）、单元卡「单元情绪引擎」 | 提炼已写部分的读者需求与情绪引擎；不复制到 `对标/` |
+| `文风.md` | `设定/文风.md` | 作者同意才建（Step 8） |
 | `章节/第N章_摘要.md` | `大纲/细纲_第XXX章.md` | 逐批反推（[outline-reverse.md](outline-reverse.md)） |
 | — | `设定/题材定位.md` | 从拆文报告生成 |
 | `剧情/散落情节.md` | `大纲/大纲.md` 附录或对应卷纲 | 合并到相关卷的大纲 |
@@ -109,7 +109,7 @@ Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导
 
 ### 章节分隔识别
 
-当源为单个大文件时，按以下分隔符切分（与 `length-routing.md` 优先级 2 复用同一识别表）：
+当源为单个大文件时，按以下分隔符切分：
 
 | 分隔符模式 | 示例 |
 |-----------|------|
@@ -119,14 +119,16 @@ Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导
 
 ### 内容处理
 
-- 保留原文内容不变，不做任何修改
+- 保留小说正文，不改写情节、措辞或台词
 - 编码统一为 UTF-8
-- 去除文件头尾无关信息（如广告、声明等）
+- 只移除可确认不属于小说正文的文件头尾信息，如下载广告；无法确认的内容保留
 
 ---
 
 ## 角色文件迁移模板
 
+字段与长篇写作的主角卡、配角卡一致，续写时可直接使用。证据取拆文档案和关键情节；外貌、口头禅、标志动作是读者认人的锚点，从原文找原句填，找不到写 `[待补充]`，不杜撰。
+
 ```markdown
 ---
 name: {角色名}
@@ -134,18 +136,21 @@ name: {角色名}
 
 # {角色名}
 
-## 基本信息
-- 身份：{从拆文库角色文件提取}
-- 核心特质：{}
-- 当前能力：{}
-- 核心动机：{}
-- 弱点/缺陷：{}
-
-## 外在表现
-{身份/言行/外貌}
-
-## 内在分析
-{性格/目标/秘密}
+## 角色卡
+- 角色定位：{主角/反派/核心配角/功能角色；一句话说清在故事里干什么}（功能角色也填）
+- 身份标签：{截至第 N 章的身份}（功能角色也填）
+- 与主角关系：{主角本人写「本人」}（功能角色也填）
+- 外貌特征：{原文写到的 3-5 个记忆点}
+- 性格关键词：{3-5 个，从行为归纳，写出矛盾面}
+- 核心目标：{全书或当前阶段想达成什么}
+- 核心动机：{为什么非要达成}
+- 致命弱点：{会让他犯错的性格缺陷}
+- 口头禅/标志动作：{原文里反复出现的说法或动作，引原句}（功能角色也填）
+- 当前能力与资源：{截至第 N 章}
+- 退场方式：{已退场写在第几章、怎么退的；未退场写 [待补充]}
+
+## 经历与成长
+{拆文档案的核心经历与成长弧线，按时序}
 
 ## 出场记录
 | 章节 | 关键事件 | 状态变化 |
@@ -153,27 +158,21 @@ name: {角色名}
 | 第{N}章 | {事件} | {变化} |
 
 ## 别名
-{如有别名，列出}
+{别名、类型和依据；没有写「无」}
 ```
 
 ---
 
 ## 关系文件转换规则
 
-拆文库格式（角色关系.md）→ 项目格式（设定/关系.md）：
-
-```
-拆文库格式：
-A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
-
-项目格式：
-| 角色 A | 角色 B | 关系类型 | 情感倾向 | 当前状态 | 起始章节 | 变化节点 |
-```
+拆文的 `角色关系.md` 是有向表：`关系ID | 主体 → 客体 | 关系动作/类型 | 表面关系 | 真实关系 | 触发事件 | 双方得失 | 变化后状态 | 证据等级 | 证据`，同一对角色的历史演变按行保留。转成项目格式：
 
-转换规则：
-- 关系类型映射：家人→亲情、恋人→爱情、朋友→友情等
-- 情感倾向直接复用：正面/负面/中性/复杂
-- 演变轨迹提取到「变化节点」列
+- 同一对角色合成一行；两个方向的动作不同时，写进「当前状态」（如「A 护着 B；B 在利用 A」）。
+- 关系类型：家人→亲情、恋人→爱情、朋友→友情、敌人→敌对、师徒→师生、上下级→主从、商业→利益；同事按实际互动归友情或利益。
+- 情感倾向：拆文没有这一列，从关系动作和双方得失判断（保护、依赖多为正面；控制、欺骗、竞争多为负面）；两种都有写「复杂」。
+- 当前状态取这对角色最后一行的「变化后状态」；起始章节取最早一条证据的章；变化节点按时序列各行的「触发事件」。
+- 「真实关系」和「表面关系」不同的，另写进「表面与真实」小节，注明截至第 N 章读者知不知道。续写不能提前说破，必须保留。
+- 证据等级是 C 的关系，在当前状态后标「（只有旁人说法）」。
 
 ### 目标格式模板（设定/关系.md）
 
@@ -186,6 +185,12 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 |--------|--------|---------------------------------------------|-----------------------------|---------|---------|---------|
 | {名} | {名} | {类型} | {倾向} | {描述} | 第{N}章 | {事件} |
 
+## 表面与真实
+
+| 角色 A | 角色 B | 表面关系 | 真实关系 | 读者截至第 N 章知道吗 |
+|--------|--------|---------|---------|---------------------|
+| {名} | {名} | {旁人看到的} | {实际是} | {知道/部分知道/不知道} |
+
 ## 关系演变
 
 {角色A}<->{角色B}：
@@ -198,18 +203,20 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 {列出推动剧情的2-3对核心对立/合作关系}
 ```
 
+没有表面与真实不同的关系时，「表面与真实」小节写「无」。
+
 ---
 
 ## 世界观同步规则
 
-当前 `story-long-analyze` 已输出主题化目录，导入阶段只做 pass-through，不再解析或拆分扁平 `世界观.md`。
+当前 `story-long-analyze` 输出主题化目录，直接原样同步。旧成果已在 Phase 2 确认可用时，按 Step 5 从实际内容转换到目标路径。
 
 | 源路径 | 目标路径 | 当前契约 |
 |---------|---------|---------|
 | `拆文库/{导入书名}/设定/世界观/*.md` | `{项目}/设定/世界观/*.md` | 原样同步；`背景设定.md` 必须存在 |
 | `拆文库/{导入书名}/设定/势力/*.md` | `{项目}/设定/势力/*.md` | 原样同步已独立的势力文件 |
 
-`力量体系.md`、`地理.md` 或小势力资料不足 200 字时，上游会将其并入 `背景设定.md`，因此这些独立文件可省略。如缺少 `背景设定.md`，或当前内容指向独立力量体系却未产出对应文件，停止导入并提示重跑 `story-long-analyze` Stage 4。
+`力量体系.md`、`地理.md` 或小势力资料不足 200 字时，上游并入 `背景设定.md`，独立文件可省略。当前契约产物缺少必要文件时，提示补 `story-long-analyze` Stage 4；已确认可用的旧成果按来源映射转换，不仅因旧文件名而阻断。
 
 ---
 
@@ -250,16 +257,14 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 ```markdown
 # 大纲
 
-## 全书体量与阶段总览
+## 全书概况
 - 已写：第 1–{N} 章，约 {Y} 万字；{完本 | 连载中}
-- 阶段划分 / 全书情绪曲线 / 关键节点与钩子链：{从故事线分段反推；证据不足写 [待补充]}
-
-## 卷级大纲
-### 第一卷：{卷名}（约 {X} 万字，{Y} 章）
-- 功能：{从剧情分析推断}
-- 核心事件：{一句话}
-- 起始状态 → 结束状态：{从角色弧线推断}
-- 卷契约 / 终局储备 / 阶段边界：{有证据才写，否则 [待补充]}
+- 全书主线与终局：{从故事线反推；证据不足写 [待补充]}
+
+## 分卷表
+| 卷 | 卷名 | 字数区间 | 所属阶段 | 功能 | 核心事件 | 起始状态 → 结束状态 | 卷契约 / 终局储备 / 阶段边界 |
+|---|---|---|---|---|---|---|---|
+| 1 | {卷名} | 约 {X} 万字，{Y} 章 | {开篇/发展/高潮/收尾} | {从剧情分析推断} | {一句话} | {从角色弧线推断} | {有证据才写，否则 [待补充]} |
 ```
 
 ### 候选边界检测参考
@@ -276,20 +281,55 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 
 #### 目标格式模板（大纲/卷纲_第X卷.md）
 
-卷纲是大纲的展开——大纲决定方向，卷纲决定节奏。包含本卷全部创作规划。
+卷纲沿用长篇写作的格式：每个 `##`/`###` 标题的下一行写作用域行，全卷有效的段写 `> 作用域：卷级常任`，剧情单元卡写 `> 作用域：单元级 {单元ID}`。写正文时脚本按单元ID 只取卷级段和该单元的卡，所以每张卡都要有单元ID 和章节范围。只反推已写内容，缺证据的字段写 `[待补充]`、不杜撰；续写补纲时由长篇写作按它的单元卡模板补全。
 
 ```markdown
 # {卷名} 卷纲
 
 ## 核心信息
+> 作用域：卷级常任
+
 - 章节范围：第{X}-{Y}章
 - 字数目标：{W}万字
 - 本卷定位：{铺垫/发展/高潮/转折/收尾}
 
+## 卷契约与终局储备（反推）
+> 作用域：卷级常任
+
+- 卷契约：{从本卷剧情归纳读者期待与主角高光；证据不足写 [待补充]}
+- 本卷主推线：{从情节点归纳承担本卷最大高潮的线}
+- 本卷战果：{其余顺带兑现的线；证据不足写 [待补充]}
+- 本卷解锁的终局里程碑：[待补充]
+- 本卷禁碰的终局底牌：[待补充]
+- 契约风险：{契约安全 / 需补强 / 契约破坏；无法判断写 [待补充]}
+
 ## 核心矛盾
+> 作用域：卷级常任
+
 {一句话：本卷要解决什么问题或达到什么目标}
 
+## 剧情单元卡（反推）
+> 作用域：卷级常任
+
+单元ID 按 L{卷号}-{两位序号} 编（L1-01、L1-02…）；各卡章节范围首尾相接，合起来覆盖本卷全部已写章。
+
+### 剧情单元 L1-01
+> 作用域：单元级 L1-01
+
+- 单元ID：L1-01
+- 章节范围：第{A}-{B}章
+- 单元节拍/章功能分配：{建立期待→尝试→加压/转向→决定性行动→兑现→余波，从情节点分布归纳，标对应章范围}
+- 单元情绪引擎：{从 `剧情/情绪模块.md` 里本单元用到的模块归纳：情绪缺口→触发→主角动作→兑现；证据不足写 [待补充]}
+- 主角局部目标：{本单元主角要保住/拿到/证明什么}
+- 核心阻碍：{主要敌意、限制或误判}
+- 关键选择与决定性行动：{主角做了什么不可替代的判断和行动}
+- 兑现方式与归属：{兑现怎么发生，收益归谁}
+- 本单元主推线/战果：{线}
+- 下一单元因果钩子：{怎么推入下一单元；本卷最后一张卡写已留下的悬念}
+
 ## 情绪弧线
+> 作用域：卷级常任
+
 - 模板：{V形/倒V形/W形/渐进形/延迟满足形/急转弯形}
 - 选择理由：{结合题材和本卷定位}
 
@@ -297,32 +337,23 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 |------|-----------------------------------------|-----------|---------|
 | 第{N}章 | {基调} | {N} | {事件} |
 
-## 卷契约与终局储备（反推）
-- 卷契约：{从本卷剧情归纳读者期待与主角高光；证据不足写 `[待补充]`}
-- 本卷主推线：{从情节点归纳承担本卷最大高潮的线}
-- 本卷战果：{其余顺带兑现的线；证据不足写 `[待补充]`}
-- 本卷解锁的终局里程碑：`[待补充]`
-- 本卷禁碰的终局底牌：`[待补充]`
-- 契约风险：{契约安全 / 需补强 / 契约破坏；无法判断写 `[待补充]`}
-
-## 剧情单元（反推）
-| 单元ID | 章节范围 | 单元节拍（建立期待→尝试→加压/转向→决定性行动→兑现→余波） | 主推线/战果 | 下一单元因果钩子 |
-|------|---------|---------|-------|---------|
-| L{卷}-1 | {章X-Y} | {从爽点/情节点分布归纳} | {线} | {方式} |
-
-（导入反推只填有证据的字段，未知写 `[待补充]`、不杜撰；后续补纲/改纲时按 story-long-write 技能的「剧情单元卡」完整字段模板升级。）
-
 ## 人物弧线
+> 作用域：卷级常任
+
 | 角色 | 本卷起点 | 本卷终点 | 关键转变 |
 |------|---------|---------|---------|
 | {名} | {状态} | {状态} | {事件} |
 
 ## 本卷反转（如有）
+> 作用域：卷级常任
+
 | 类型{身份/动机/阵营/信息/命运} | 涉及角色 | 误导路径 | 揭示章节 | 影响范围 |
 |------|---------|---------|---------|---------|
 | {类型} | {名} | {如何误导读者} | 第{N}章 | {影响哪些线} |
 
 ## 本卷伏笔
+> 作用域：卷级常任
+
 | 伏笔 | 埋设章节 | 预计回收 | 类型{短期/中期/长期} |
 |------|---------|---------|---------------------|
 ```
@@ -331,9 +362,13 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 
 从剧情文件提取每卷的：
 - 核心矛盾 → 核心矛盾字段
-- 情节点分布 → 情绪弧线 + 剧情单元（反推）
+- `剧情/{标题}.md` 的结构分布与情节点 → 一张剧情单元卡（节拍、目标、阻碍、关键行动、兑现）
+- 情节点分布 → 情绪弧线
 - 角色出场 → 人物弧线
 - 铺垫类情节点 → 伏笔
+
+半成品最后一张卡的章节范围到第 N 章为止；第 N+1 章以后的单元由续写时的补纲来排，导入不预写。
+
 ---
 
 ## 题材定位生成
@@ -347,7 +382,7 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 
 ## 基本信息
 - 题材类型：{玄幻/都市/系统/...}
-- 目标平台：{Phase 1 向用户采集的目标平台；无则从拆文报告提取，仍无填 [待补充]。story-review 据此选平台 rubric}
+- 目标平台：{Phase 1 向用户采集的目标平台；无则取 `拆文报告.md`「基本信息」的「目标平台」，仍无填 [待补充]。story-review 据此选平台 rubric}
 - 核心梗：{一句话卖点}
 - 微创新点：{与同类题材的差异}
 
@@ -373,76 +408,29 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 |---------|-------------|------------|----------|------|
 | {RH/TR 编号} | {信息如何被扩写} | {触发什么感受} | {铺垫→爆发→冷却} | `[导入分析] 剧情/节奏.md` |
 
-<!-- 仅当用户显式绑定独立外部对标时生成以下两节；未绑定时整段省略。 -->
-## 对标书清单（canonical registry，可选）
-主对标书: {对标书名}  # 最多 1 本；必须是独立外部参考作品
-对标书列表:
-  - 书名: {对标书名}
-    引用强度: 主  # 主 / 辅 / 参考
-    题材类型: {玄幻/都市/系统/...}
-    相关性: 同题材
-    用途: 文风+核心结构
-  - 书名: {书名 B}
-    引用强度: 辅
-    题材类型: {题材}
-    相关性: 同题材/弱相关
-    用途: {补设定/大纲/模块，不进文风}
-  - 书名: {书名 C}
-    引用强度: 参考
-    题材类型: {题材}
-    相关性: 同题材/弱相关
-    用途: {仅按预算召回摘要}
-
-## 对标分析（派生概要）
-> 完整对标数据见 `对标/` 目录；上方 registry 是权威清单。本表仅做快速概览，不可替代 `主对标书` + `对标书列表`。
-
-| 对标书 | 相似点 | 差异点 | 可借鉴 |
-|--------|-------|-------|-------|
-| {对标书名} | {点} | {点} | {点} |
-
 ## 题材框架
-- 八节点位置：{当前处于哪个节点}
 - 关键转折节点：{列出}
 ```
 
 ### 字段映射
 
-- 题材类型、核心梗、微创新点 → 从 `拆文报告.md` 基本信息与核心发现段提取
-- 核心梗三分法 → 从 `拆文报告.md` 表层吸引力、爽点设计、长线悬念段提取
-- 读者需求 / 情绪引擎 → 从 `剧情/情绪模块.md` 提取；缺失时停止导入并给出重跑 Stage 3+ 的修复动作
-- 节奏与触发参考 → 从 `剧情/节奏.md` 提取；缺失时停止导入，不得以 `拆文报告.md`、章节摘要或 `剧情/故事线.md` 代替
-- 对标书清单 → 仅登记用户显式选择、且能回溯到 `拆文库/{对标书名}/` 的外部作品；未绑定时省略，不得用 `{导入书名}` 补位
-- 对标分析（派生概要） → 只总结已登记的外部对标；题材框架仍从本书导入分析生成，不得把两类来源混写
+- 题材类型、核心梗、微创新点 → 从 `拆文报告.md`「基本信息」「核心发现」提取
+- 核心梗三分法 → 表层卖点、深层爽点、长线钩子依次取 `拆文报告.md`「核心发现」「读者在追什么」「伏笔与冲突」
+- 读者需求 / 情绪引擎 → 从 `剧情/情绪模块.md` 提取；当前契约产物缺失时补 Stage 3+，旧成果按「映射总览」的兼容规则处理
+- 节奏与触发参考 → 从 `剧情/节奏.md` 提取；当前契约产物缺失时停止迁移并补齐，不用其他概要冒充；旧成果可标「未知/待增强」继续导入
+- 题材框架 → 从本书导入分析生成；外部对标的登记和概要由 benchmark-sync.md 追加，两类来源不混写
 
 ---
 
-## 对标引用视图同步规则
-
-本节只对用户显式绑定的外部 `{对标书名}` 生效：从 `拆文库/{对标书名}/` 同步到项目 `对标/{对标书名}/`。未绑定时不创建对标子目录；严禁把 `拆文库/{导入书名}/`、项目 `设定/` 或由其生成的文件复制到 `对标/`。
-
-| 源路径 | 目标路径 | 同步语义 |
-|-------|---------|----------|
-| `拆文库/{对标书名}/剧情/节奏.md` | `{项目}/对标/{对标书名}/剧情/节奏.md` | 日更选择 `rhythm_reference` 的必备权威文件；缺失则不登记该对标 |
-| `拆文库/{对标书名}/剧情/情绪模块.md` | `{项目}/对标/{对标书名}/剧情/情绪模块.md` | 日更选择 `selected_emotion_module` 的必备权威文件；缺失则不登记该对标 |
-| `拆文库/{对标书名}/剧情/*.md` | `{项目}/对标/{对标书名}/剧情/*.md` | 剧情单元、故事线、散落情节等剧情资产；与权威节奏/情绪文件冲突时以后者为准 |
-| `拆文库/{对标书名}/章节/*.md`（第N章_摘要.md + 黄金三章 第1-3章_深度拆解.md）| `{项目}/对标/{对标书名}/章节/*.md` | 匹配章证据；摘要读取概要、关键事件、局面结果、涉及、状态变化与情节点序列（含类型、主题标签与基调），黄金三章另含深度写法 |
-| `拆文库/{对标书名}/角色/*.md` | `{项目}/对标/{对标书名}/角色/*.md` | 角色功能位、关系与反应层参考 |
-| `拆文库/{对标书名}/设定/` | `{项目}/对标/{对标书名}/设定/` | 世界观、势力、金手指等设定约束参考 |
-| `拆文库/{对标书名}/拆文报告.md` | `{项目}/对标/{对标书名}/拆文报告.md` | 人类可读摘要投影 |
-| `拆文库/{对标书名}/文风.md` | `{项目}/对标/{对标书名}/文风.md` | 日更文风召回必读 |
-
-冲突规则：已登记外部对标的 `对标/{对标书名}/剧情/情绪模块.md` 和 `对标/{对标书名}/剧情/节奏.md` 是对标召回权威；`拆文报告.md`、`剧情/故事线.md` 只作为摘要投影。若摘要冲突，保留冲突说明并以权威文件为准；缺少任一权威文件时不生成半套对标视图，先修复该外部作品的拆文产物。
-
-
 ## 质量检查清单
 
 迁移完成、进入逐批细纲前执行（不念给作者，没通过先修）：
 
 - [ ] 正文文件数 = 源文件章节数
-- [ ] 主要角色（主角 + 核心配角）文件已创建
-- [ ] 关系.md 非空
-- [ ] 大纲.md 有卷级结构，每卷有卷纲且「剧情单元（反推）」表写了章节范围
+- [ ] 主要角色（主角 + 核心配角）文件已创建，外貌、口头禅有原文依据或标了 [待补充]
+- [ ] 关系.md 非空；拆文里表面关系和真实关系不同的，都进了「表面与真实」
+- [ ] 大纲.md 有卷级结构；每卷卷纲的剧情单元卡章节范围覆盖本卷全部已写章，`outline_view.py --check --strict` 问题数为 0
 - [ ] 散落情节已合并到相关卷纲或大纲附录
 - [ ] 卷划分已经用户确认（原文无明确卷界时必检），确认结果已写进导入记录
 - [ ] `拆文库/{导入书名}/` 未被复制到 `对标/`，本书未登记为自身对标
-- [ ] 若绑定外部对标，`拆文库/{对标书名}/` 与 `对标/{对标书名}/` 名称和来源一致，两个主产物均已同步；否则报告修复动作但不回滚本书工程
+- [ ] 若绑定外部对标，已按 benchmark-sync.md 的清单核过