@oh-story/dsh 0.1.10 → 0.1.12

package/lib/oh-story/skills/story-setup/references/agent-references/agent-quality.md

@@ -65,8 +65,8 @@
 
 | 级别 | 判定 | 动作 |
 |---|---|---|
-| blocking / critical | 核心契约、因果或事实无法成立 | 先修再继续下游写作 |
-| high | 会明显损害追读、人物可信度或核心卖点 | 本轮修复 |
-| medium | 局部拖慢、重复或表达不清 | 按收益排序修复 |
-| low / optional | 不影响成立，只是可增强 | 不得包装成硬门槛 |
+| blocking / critical | 核心契约、因果或事实无法成立 | 必须修：先修再继续下游写作 |
+| high | 会明显损害追读、人物可信度或核心卖点 | 必须修：本轮修复 |
+| medium | 局部拖慢、重复或表达不清 | 建议看：按收益排序修复 |
+| low / optional | 不影响成立，只是可增强 | 仅提示：不得包装成硬门槛 |
 

package/lib/oh-story/skills/story-setup/references/agent-references/anti-ai-writing.md

@@ -285,7 +285,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 - 剧透式点破潜台词：「那点笑她看得分明」「谁都看得出他在撒谎」-> 把藏着的挑明了。留着别点破。
 - 定性比喻/盖棺句：「像在宣判一件早已定好的事」「像看一件死物」-> 比喻在替角色下定论。非角色此刻强烈主观感受就删；要留也只能是她带偏见的瞬间感觉，不是客观断言。
 
-自检：每句问一遍——这是"角色在经历"，还是"作者在讲解/安排"？凡作者跳出来讲，删，或改成角色视角内的呈现。根治办法是锁定深度限知视角（见 writing-craft.md「视角姿态：深度限知」），镜头钉死在角色身体里，作者就没位置跳出来了。
+自检：每句问一遍——这是"角色在经历"，还是"作者在讲解/安排"？凡作者跳出来讲，删，或改成角色视角内的呈现。根治办法是锁定深度限知视角：只写视角人物此刻看得见、听得见、想得到的，镜头钉死在角色身体里，作者就没位置跳出来了。
 
 改法优先级：先删或原位替换污染句，不在段尾另补“人味”尾巴。需要补信息时，把原来的总结/动机/评价句改成角色当下能碰到的问题、手续、回信、付款、门外动静等具体压力；已有手机/屏幕/公告/门牌/表单等信息，优先作为角色看见的场内载体保留，不要转写成叙述者解释。具体载体跟剧情走，不套固定清单。
 

package/lib/oh-story/skills/story-setup/references/agent-references/banned-words.md

@@ -6,7 +6,7 @@
 
 ## 默认优先检查的句式（先对照本书文风）
 
-写网文最毒的 AI 句式，作者一旦养成就会反复出现。Gate A 第一遍扫描必须命中：
+写网文最毒的 AI 句式，作者一旦养成就会反复出现。以下是优先检查的句式：
 
 | 毒级 | 句式 | 错误例 | 修法 |
 |------|------|--------|------|
@@ -21,7 +21,7 @@
 | ★★★ | 抽象命运/开端收束："命运……棋局/獠牙" / "这一刻终于明白" / "反击才刚刚开始" | "命运终于露出獠牙；属于他的反击才刚刚开始" | 回到角色当下可见的文件、动作、对话或物理后果 |
 | ★★ | 章末预告 "他不知道的是……" | "他不知道的是，更大的风暴即将来临" | 用具体钩子物件/事件收束，避免空泛预告 |
 
-> 凡命中 ★★★★★ 一处即视为重度AI味的强证据；★★★★ 命中 ≥2 处即触发中度复扫。
+> ★★★★★ 命中一处就要改；轻/中/重分档只按去 AI 味诊断的密度指标定。
 
 `check-ai-patterns.js` 的 `formulaic-parallelism` 还会提示「至于X不X，怎么X」和同动词「不V A，不V B」。这两类可能是功能性口语，因此只做 advisory；Gate B 必须连同台词读语境复核，若只是复述细纲/前文就压成一次判断，不能因 hook 豁免台词而跳过。
 

package/lib/oh-story/skills/story-setup/references/agent-references/benchmark-style-load.md

@@ -0,0 +1,107 @@
+# 对标文风召回（story-explorer · benchmark_style_load）
+
+只在 `query_type` 为 `benchmark_style_load` 时读本文件；其他查询类型不读。输出同样遵守 agent 定义里的「纯 JSON、字符串转义」规则，原文锚点片段尤其要转义。
+
+## 流程
+
+加载对标书的情绪模块 + 节奏索引 + 文风 + 按本章情绪/基调匹配可参考章节 + 原文锚点片段。
+
+1. **解析输入**：项目目录 + 本章情绪/基调 + （可选）本章爽点类型 + （可选）本章目标字数
+2. **主对标书选择**：
+   - 先按项目目录名、`.active-book` 与本书设定识别当前作品；`拆文库/{当前书}/` 是 story-import 的本书分析，不是对标候选。历史误建的 `对标/{当前书}/` 也必须排除，并返回 `gaps.self_benchmark_ignored: true`
+   - `Read 设定/题材定位.md`，提取 `主对标书` 字段
+   - 若有且不是当前作品 → 用该书；若字段指向当前作品 → 忽略该字段并设置 `gaps.self_benchmark_ignored: true`
+   - **路径一律用字段值逐字拼接**：不添加《》等任何装饰、不改一字——拼错时 Glob 只会静默返回空，与「书不存在」无法区分
+   - **登记的主对标按步骤 3 探不到书目录**（目录下探不到任何文件）→ 返回 `gaps.benchmark_book_missing: true` 与 `expected_path`（原样写入实际探测的完整路径，供核对拼写），`results` 置空**停止**；不得改用其他书，也不得走下面的缺失回退。**书目录存在但缺 `文风.md` 不属于本情形**——照常进入步骤 4-6，由步骤 6 归类为 `profile_missing`
+   - 若字段缺失或已忽略 → `Glob 对标/*/**/*`，从命中文件所属的书目录（`对标/` 下的第一层目录，排除当前作品）取字典序第一个，并在 `gaps.main_benchmark_unspecified: true` 提示主对标书未指定；**枚举条件是书目录下有文件，不是有 `文风.md`**——缺文风但资料完整的候选仍算命中
+   - 若排除后无命中，继续向上找工作区根下的 `拆文库/*/**/*`，同样排除当前作品；仍无 → 返回 `gaps.no_benchmark: true`，`results` 置空，**不报错、不继续读文风**
+3. **对标书路径查找（只判书目录有效性，不判文风）**：优先探 `{项目}/对标/{书名}/**/*`，回退探 `拆文库/{书名}/**/*`（向上找到工作区根，再下钻拆文库）；探针是目录下的任意文件——Glob 不接受纯目录模式，`{书名}/` 恒返回空。任一处命中文件即视为书目录有效，进入步骤 4；两处都无命中才是 `benchmark_book_missing`。**不得用 `文风.md` 兼作目录存在性探针**——那会把「书在但缺文风」误判成「书不存在」，吞掉步骤 6 的 `profile_missing` 与调用方的 `custom_style` 降级分支
+4. **主产物探针与资料代际**：
+   - 先探 `{对标书路径}/剧情/情绪模块.md` 和 `{对标书路径}/剧情/节奏.md`，两者都存在才进入当前权威召回。
+   - 任一未命中时直接按下面两项返回并停止准备；`schema_version` 不参与新旧判断。两份老权威产物都存在时正常召回，缺少因果、双时间线或三维节奏等新增内嵌字段不阻断。
+   - 缺 `剧情/情绪模块.md` → `gaps.missing_primary_contract: true`、`gaps.module_missing: true`，`repair_action` 写“重跑 /story-long-analyze Stage 3，补齐情绪模块”。
+   - 缺 `剧情/节奏.md` → `gaps.missing_primary_contract: true`、`gaps.rhythm_missing: true`，`repair_action` 写“重跑 /story-long-analyze Stage 3，补齐节奏索引”。
+5. **当前权威召回**：
+   - 对存在的 `{对标书路径}/剧情/情绪模块.md`，从读者需求、情绪引擎或可复现模块中选择 1 条 `selected_emotion_module`，写入 `module_source_path`。
+   - 对存在的 `{对标书路径}/剧情/节奏.md`，从关键信息推进、情绪触动点、爆发/冷却中选择 1 条 `rhythm_reference`，写入 `rhythm_source_path`。
+   - 若两个权威文件都存在但对同一章节/模块的读者情绪或爆发点描述互相矛盾，保留两条原文摘要，并返回 `gaps.module_rhythm_conflict: true` 与 `gaps.conflict: "..."`；调用方按两个权威文件优先于 `拆文报告.md` / `故事线.md` 的规则处理，禁止自行改写
+6. **读文风**：
+   - `Read {对标书路径}/文风.md`
+   - 不存在 → 返回 `gaps.profile_missing: true, expected_path: "..."`，**不继续后续步骤**；书目录本身有效，不得改填 `benchmark_book_missing`——调用方按 `custom_style` 决定继续或停止
+   - 检查「生成记录」里的 `文风可用：否` → 返回 `gaps.profile_degenerate: true`，后续不把文风作为强约束
+7. **可用性检查（只读可执行）**：
+   - 本 agent 只有 `Read/Glob/Grep`，不能调用 Bash/stat。
+   - 只读取文风文件「生成记录」：若写有 `文风可用：否`、`需重生`、`原文缺失` 等标记 → `gaps.profile_stale: true` 或 `gaps.profile_degenerate: true`，并在 `stale_reason` 写明原因。
+   - 不做文件时间比较；默认 `profile_stale: false`。
+8. **章节基调候选集**：
+   - `Glob {对标书路径}/章节/*_摘要.md`
+   - 对每个文件 `Grep -hE '基调：(紧张|轻松|悲伤|热血|爽|甜|温馨|恐怖|压抑|其他)'`（**全角冒号**，不锚定行首）拿到该章所有情节点基调
+   - 章基调聚合：众数；并列时按 grep 输出顺序取最早
+   - 候选集 = 章基调 == 本章情绪/基调的章节列表
+9. **相近基调兜底**（完全没有同基调章节时）：
+   - 先从本章细纲/查询参数里判断更接近“紧张、热血、爽、甜、轻松、温馨、悲伤、恐怖、压抑”哪一类；不要写死对照表。
+   - 选择一个最接近的基调重新筛候选集，并在结果里说明“使用相近基调兜底”。
+   - 仍空 → `gaps.tone_match_failed: true`，跳过匹配章节读取，但仍返回整书文风、`selected_emotion_module` 和 `rhythm_reference`。
+10. **多候选章节选择规则**（候选集多章时）：
+   - L1 爽点类型最强匹配（调用方提供爽点字段时，对每个候选章读 `_摘要.md` 的「关键事件」判断）
+   - L2 摘要情节点数 / 可读到的原文章节估算长度最接近本章目标字数（如提供）；本 agent 不用 Bash 统计，拿不到原文长度时跳过 L2，不得把摘要文件字数当原文字数
+   - L3 章节号最小
+11. **读匹配章节资料**：
+   - 先 `Read {对标书路径}/章节/第K章_摘要.md`，提取本章基调序列、关键事件、爽点/情绪节点
+   - 新版轻量摘要直接读取「信息变化」「状态变化」「章尾钩子」「三维节奏」字段；旧摘要缺这些字段时再读取「关键信息与扩写技法」表，作为 `matched_chapter_techniques` 的证据/补足；两者都不覆盖 `剧情/节奏.md`
+   - 若 `{对标书路径}/章节/第K章_深度拆解.md` 存在，再读取并提取「可借鉴要素」+ 反应层 + 章尾钩子类型
+   - 若同章深度拆解不存在（常见：只有黄金三章有深度拆解），不要失败；回退读取 `第1章_深度拆解.md`、`第2章_深度拆解.md`、`第3章_深度拆解.md` 中基调最接近的一章，或仅使用文风「可借鉴技巧」
+   - 在 `gaps.matched_deep_dive_missing: true` 标记该回退
+12. **抽取原文锚点片段**（从文风文件里）：
+    - 从文风文件 `## 原文锚点片段` 段读出所有按基调标注的片段
+    - 按本章情绪/基调选 1-2 段（精确匹配优先，无则取相近基调）
+    - 完整传递 300-500 字原文（不要截断/概括）
+13. **返回结构化 JSON**
+
+## 缺失即停与降级
+
+- 缺两个老权威主产物（`剧情/情绪模块.md`、`剧情/节奏.md`）时返回 `missing_primary_contract` 与 `repair_action`，停止准备。
+- 登记的主对标书目录探不到时返回 `benchmark_book_missing` 与 `expected_path`，不换书。
+- 书目录在、缺 `文风.md` 归 `profile_missing`，由调用方按 `custom_style` 决定继续或停止。
+
+## 输出结构
+
+```json
+{
+  "query_type": "benchmark_style_load",
+  "results": {
+    "style_profile_path": "对标/{书名}/文风.md",
+    "style_profile_summary": "<≤200字 提取核心：标点习惯 + 对话技法 + 情绪交替模式>",
+    "selected_emotion_module": "<从 剧情/情绪模块.md 选出的读者需求/触发器/戏剧单元/可复现骨架；缺失时为 null>",
+    "rhythm_reference": "<从 剧情/节奏.md 选出的关键信息推进/情绪触动点/爆发节奏/冷却参考；缺失时为 null>",
+    "module_source_path": "对标/{书名}/剧情/情绪模块.md",
+    "rhythm_source_path": "对标/{书名}/剧情/节奏.md",
+    "matched_chapter_K": 14,
+    "matched_chapter_techniques": "<匹配章摘要 + 深度拆解/黄金三章回退中的可借鉴要素，≤300字>",
+    "anchor_excerpts": [
+      {"tone": "悲伤", "source": "第14章 第7段（行 823-901）", "demo_point": "对话潜台词手法", "text": "<300-500字原文>"},
+      {"tone": "热血", "source": "第8章 第3段（行 401-465）", "demo_point": "爽点铺放比", "text": "<300-500字原文>"}
+    ]
+  },
+  "source_files": ["设定/题材定位.md", "对标/{书名}/剧情/情绪模块.md", "对标/{书名}/剧情/节奏.md", "对标/{书名}/文风.md", "对标/{书名}/拆文报告.md", "对标/{书名}/章节/第14章_深度拆解.md"],
+  "gaps": {
+    "no_benchmark": false,
+    "module_missing": false,
+    "rhythm_missing": false,
+    "module_rhythm_conflict": false,
+    "conflict": null,
+    "missing_primary_contract": false,
+    "repair_action": null,
+    "profile_missing": false,
+    "profile_stale": false,
+    "profile_degenerate": false,
+    "stale_reason": null,
+    "main_benchmark_unspecified": false,
+    "benchmark_book_missing": false,
+    "self_benchmark_ignored": false,
+    "raw_text_unavailable": false,
+    "tone_match_failed": false,
+    "matched_deep_dive_missing": false
+  }
+}
+```

package/lib/oh-story/skills/story-setup/references/agent-references/character-relations.md

@@ -151,7 +151,7 @@
 
 检查角色行为是否只是为了让剧情往某方向发展。如果角色"恰好"做了推进剧情的事但没有自身动机，标记为"人设偏移"，必须为该行为补充角色层面的合理理由。
 
-### 第二步：情绪目标确认
+### 第二步：目标情绪确认
 
 写每段前明确三个要素：
 1. 本段目标情绪：这段剧情要让读者产生什么情绪？
@@ -368,6 +368,54 @@
 
 ---
 
+## 后宫文女主人设设计法
+
+### 核心思路
+后宫文的关键是弱化男主"主动渣"的感觉，让女主自身设定成为推动后宫的主力。
+
+### 设计原则
+1. **女主人设要预设方向**：开书前就设计好每个女主的核心特质
+2. **差异化设计**：不同女主有完全不同的价值观和背景
+3. **同居培养感情**：开局让女主们同住一个屋檐下，彼此成为朋友
+
+### 温水煮青蛙法
+以三个女主为例：
+
+| 角色 | 人设设计 | 在后宫中的作用 |
+|------|----------|---------------|
+| 青梅（正宫） | 传统价值观，占据防守位 | 从小一起长大，天然正宫 |
+| 女主B | 家庭圆满家教开明，理性看待感情 | 不在意名分，只在意快乐 |
+| 女主C | 缺少父爱和社交，爱情观模糊 | 不存在一夫一妻制思想束缚 |
+
+核心逻辑：
+- 青梅占据正宫与防守位
+- 另两个女主不在意后宫，只在意跟主角在一起
+- 把"主角脚踏多条船"的问题转化为"青梅防守 vs 另两人共享"的问题
+- 一点一点突破青梅的防守底线，等反应过来时已经是既成事实
+
+
+## 男频极简爱情线构型
+
+### 核心原则
+男频爱情线不需要复杂的情感博弈，核心是"英雄救美 + 事业舞台 + 对手衬托"三要素。
+
+### 极简构型
+1. **英雄救美**：女主陷入困境 -> 主角用金手指/实力解决 -> 建立初始好感
+2. **事业舞台**：主角在事业上展示金手指 -> 女主在场作为重要观众 -> 好感随事业成就升级
+3. **对手衬托**：情敌/对手同时是事业对手 -> 打败对手既是事业胜利也是感情胜利
+
+### 关键操作
+- 女主的每一次好感升级都绑定在主角的事业成就上，不单独写纯感情戏
+- 女主有自己的事业线/目标，不是花瓶——她的事业目标与主角有交叉但独立
+- 情敌的价值在于他同时威胁主角的事业和感情，打脸时有双重爽感
+- 感情节奏跟着事业节奏走：事业低谷时感情拉扯，事业高峰时感情升温
+
+### 爱情线与事业线融合检查
+- 删掉所有爱情线段落，事业线是否还成立？如果不行 = 爱情线拖后腿了
+- 删掉所有事业线段落，爱情线是否还有看点？如果不行 = 爱情线太弱
+- 理想状态：两条线互相增强，拆开各自能看，合在一起更好看
+
+
 ## 质量检查清单
 
 每次完成角色关系/感情线设计后，逐项核查：

package/lib/oh-story/skills/story-setup/references/agent-references/deslop-gates.md

@@ -8,10 +8,10 @@
 
 1. 删掉后是否丢失伏笔、钩子、角色特征、情节推进、必要信息或必要转折？都不丢则直接删，不进 Gate。
 2. 丢任意一项 → 保留信息进对应 Gate 改写（只删"怎么说"的 AI 味，不删"说什么"）。
-3. 删除服从既有"过度去AI味保护"与「诊断与分级」比例上限：不整段删、不删剧情功能；若删后跌破字数下限，改为降AI重写，不删完再用新废话凑字。
+3. 删除服从过度去AI味保护：不整段删、不删剧情功能；删除比例上限按 AI 味等级，轻度 ≤15%，中度 ≤25%，重度 ≤35%；若删后跌破本次字数范围的下沿，改为降AI重写，不删完再用新废话凑字。
 4. 删完通读：若整段只剩最短句、结构虚词被扫光、每个动作都带「了一下」式尾巴，就是删过头的电报体（见 anti-ai-writing.md 模式 9）——把非峰值叙述句恢复成自然白话，不是接着删。删的是废话，不是中文的自然冗余；这条只调删减的度，禁用词与套路句式的清理力度不因此降低。
 
-以下为各 Gate 的详细规则（删不掉的标记项按此润色；无论 agent 还是主线程执行，均须遵循）：
+以下为各 Gate 的详细规则（删不掉的标记项按此润色；无论 agent 还是主会话执行，均须遵循）：
 
 #### 门禁 A：禁用词替换
 
@@ -125,6 +125,7 @@ AI写作的结尾特征：总想总结、升华、点题。
 - 删掉总结性语句
 - 用动作/场景收尾，不要用感慨收尾
 - 如果结尾有"他知道...""这一刻..."→ 基本可以删
+- 短篇（单个 正文.md）带主角主观情绪的审判句、火葬场预告、心死式章尾是卖点，保留；只删中立、与角色情绪无关的作者讲解。
 
 #### 门禁 G：去解释腔/上帝感/安排感
 
@@ -136,9 +137,25 @@ AI写作的结尾特征：总想总结、升华、点题。
 - 删替读者定性：「演得真好」「这出戏她看过一遍」「他就是这样薄情」→ 删，证据留给读者判断。
 - 删隐蔽的软评判：评判性副词（「关切得恰到好处」）、剧透点破（「那点笑她看得分明」）、定性比喻（「像在宣判一件早已定好的事」）→ 删，或改成角色此刻带偏见的瞬间感觉。
 - 注意：Gate G 删的是"非故事性的作者旁白"，不是删情节。删完若变薄，靠角色动作/对话补，不补叙述者解说。
+- 短篇（单个 正文.md）带主角主观情绪的审判句、火葬场预告、心死式章尾是卖点，保留；只删中立、与角色情绪无关的作者讲解。
 
 **任务卡点修法边界**：任务卡点不是固定公式，也不是通用补流程按钮。原文已有任务、证据、手续、物件缺口时，可以把解释总结压成角色当下要处理的具体卡点；原文没有缺口时，只删解释或改动作/对话，不新造剧情。所有卡点都先做“删掉试试”：删掉后不丢伏笔、钩子、信息、关系变化或必要转折，就压缩或删除。
 
+## 写法抽查（审查侧，只指认已有问题）
+
+对爽点段与检测器标记处逐问。只许指出正文里**已有**的那一处，没有就答「无」，**不许为了让某一问有答案回头补内容**。详写的关键场景里，遮住一处发生、感知或反应后读者什么也没损失，就判为可删并报告位置；套式反应按 `banned-words.md`「套式反应逐处删除测试」逐处过。审稿只报告、不改文件；去味执行者再按删除保护落改，只报告实际删改与保留理由。
+
+| # | 自问 | 不合格的样子 |
+|---|---|---|
+| 1 | 本章最大的那次状态变化，读者看见了几个中间态？ | 只给了"起点"和"终点"；或同一状态换十种说法说十遍 |
+| 2 | 有没有一组同类并列项被平均分配了笔墨？ | 三样物件、四拨人马各给同样的分辨率 |
+| 3 | 本章的设定／能力／威胁，是被说出来的，还是被谁付了代价试出来的？ | 旁白直接给出结论，读者没有自己发现的机会 |
+| 4 | "厉害／难得／要命"这些判断，是谁给出的？他有什么立场？ | 叙述者自己下的判断；结论由旁白先说出来、在场的人只负责吃惊；或标价人就在场却没标价 |
+| 5 | 每个给了镜头的人，此刻在为自己争取什么？ | 遮住名字认不出是谁说的；所有人同向配合主角；用手部／喉部微动作代替立场；或把他的算计写成一段旁白独白 |
+| 6 | 该说出口的话，是写出来了还是被概括了？ | "他吼了一声""他说了句什么""三言两语解释了缘由"；本该来回几轮的交锋压成一次说完 |
+| 7 | 本章最重的那一句，是不是最短的那一段？ | 最重的一拍写成了全章最长的段落 |
+| 8 | 判为"密"的段落里，有没有量词加概括？ | "一连七八下""半晌""众人纷纷"出现在密处 |
+
 ---
 
 ## 写手 A-G 判据
@@ -150,5 +167,5 @@ AI写作的结尾特征：总想总结、升华、点题。
 - **C 情绪**：删空泛 AI 情绪总结句；上下文已成立就删补充说明；不设「情绪词→身体动作」默认转换。
 - **D 节奏**：只拆臃肿修饰、堆叠比喻、信息过载的长句；句长按书级文风带执行，长短随情绪 beat 交错——沉淀放慢、冲突骤短，忌通篇同长度。
 - **E 对话去腔调**：所有角色同一语气→按语言风格档案差异化；犹豫/打断/拖长用动作、短句或换行承担。
-- **F 结尾去升华**：大段抒情收尾→安静细节收尾。
-- **G 去解释腔/上帝感**：先按本书叙述姿态判断；授权的有限全知、评论或旁人内心不因形式删除。删无功能的解释、未经授权的剧透、重复总结和空泛定性（之所以/原来/这意味着/她不知道的是/殊不知/多年以后）；承担锚点或情绪的压成角色白话；已有场内载体（手机/公告/屏幕）优先保留为角色看到的文本。
+- **F 结尾去升华**：大段抒情收尾→安静细节收尾；短篇例外见门禁 F。
+- **G 去解释腔/上帝感**：先按本书叙述姿态判断，短篇例外见门禁 G；授权的有限全知、评论或旁人内心不因形式删除。删无功能的解释、未经授权的剧透、重复总结和空泛定性（之所以/原来/这意味着/她不知道的是/殊不知/多年以后）；承担锚点或情绪的压成角色白话；已有场内载体（手机/公告/屏幕）优先保留为角色看到的文本。

package/lib/oh-story/skills/story-setup/references/agent-references/emotion-on-page.md

@@ -0,0 +1,116 @@
+# 情绪落到纸面：写一章时的情绪执行
+
+> 细纲与单元卡已经定了本章的目标情绪和它在弧线上的位置；本文件只管写这一章时怎么把情绪写出来。选弧线、排节奏、管期待是排纲时的事，见 emotional-arc-design.md。
+
+## 情绪核心公式
+
+写每个场景时分离三层情绪：
+1. 角色自己的情绪（角色感受到的）
+2. 文本传递的情绪（文本要让读者感受的）
+3. 读者实际感受的情绪（读者真正的体验）
+
+同一场景三层可以完全不同：角色在哭，文本在撩，读者在爽。
+
+例：女主当众被退婚，强忍着没掉泪——角色：屈辱；文本写她嘴角还挂着笑（角色：撑）；读者替她憋着、等后面打脸（读者：爽前蓄力）。
+
+---
+
+## 前反应-复现-后反应情绪结构
+
+用于虐/悲壮/遗憾类场景。按顺序执行三步：
+
+1. **前反应**：让读者提前知道坏结果，然后描写美好事物（读者预知法）
+2. **复现**：让坏结果真的发生
+3. **后反应**：主角真情流露，作出改变（愤怒/拼命/振作）
+
+操作示例：知道某人一天后要死 -> 让她经历美好（逛街、看烟花） -> 她真的死了 -> 主角愤怒拼命
+
+---
+
+## 以小搏大情绪结构
+
+用于热血/逆袭类场景。按顺序执行四步：
+
+1. **前反应**：铺垫弱者的苦，用对比强化（现在的弱 vs 以前的强）
+2. **复现**：强者到来，"我知道你们苦，我来了"
+3. **后反应**：弱势方被拯救
+4. **士气如虹**：整体气势转变
+
+---
+
+## 基于不该如此的情绪驱动
+
+- "不该如此"是最根本的情绪驱动力——写诬告、不公、恃强凌弱，读者天生生出"不该如此"的念头
+- 核心情绪逻辑：想要爽，必先不爽；想要公平，必先不公平；想要强大，必先不强大
+- "悬而未决"也是强驱动力
+- 好的题材必须具备勾起人们惋惜、渴望改变的特质
+
+---
+
+## 理念矛盾的情感爆发力
+
+- 理念之争比利益之争更能引发读者深层共鸣
+- 少量关键场景即可，不需要大量笔墨
+- 理想主义与现实的冲突是塑造配角封神级人设的手法
+- 理念认同 = 人设认同 = 读者情感投入
+- 在主线中穿插理念型角色，用他们的追求和牺牲拔高全书情绪上限
+
+---
+
+## 情绪调动的三层方法
+
+三层：**长期感情投入**、**短期事件冲突**、**场景描绘**。三者可叠加，核心是前两层。
+
+### 长期引导三步骤
+
+1. **抛出共鸣炸弹**：找到角色最易引发共鸣的情感锚点（梦想、仇恨、恐惧）
+2. **让读者变见证者**：展示角色付出和挣扎，每一步伴随收获
+3. **让读者变参与者**：通过足够铺垫和细节，产生命运共同体感
+
+### 短期情绪引导
+
+短期靠独立事件冲突。**直白冲突比繁杂情节更容易引起共鸣**。
+
+两种事件类型：
+- **推动情节发展的事件**：让读者对角色处境产生认同
+- **塑造人物性格的事件**：让读者对角色思想性格产生认同
+
+开篇必须选择塑造人物性格的事件——先认同角色这个人才关心角色的事。
+
+### 情绪代入的陷阱
+
+读者未代入主角前：主角弱势可以引起同情，但**敌人弱势也同样引起同情**。读者还没建立认同时，不要把对手写得可怜。
+
+### 情绪文笔技法
+
+- **句长跟着情绪和节奏走**：紧张、决断处用短句提速，铺垫、沉淀处用长句蓄势；短句是提速工具，不是默认底色，别通篇拆短
+- **情绪词**：骤然、猛然、刺眼——制造紧迫感
+- **动作词**：抽、划、留下——画面感强，情绪外化
+- **修饰词**：精准克制地使用形容词，不堆砌
+- **进阶规则**：优先通过角色行为暗示情绪，而非直接描写（非硬性，必要的内心可以直写，别为外化堆无功能的小动作）。**以乐写悲**：角色在最悲伤时表现开心，情绪张力更强（赴死的人很开心，往往比哭更悲）
+
+---
+
+## 情绪调动统一视角
+
+> 写完一段觉得不到位 / 读者反馈平淡时使用。
+
+### 终极公式
+
+**平静 -> 调动 -> 释放 -> 爽**
+
+| 技法 | 调动 | 释放 | 结果 |
+|------|------|------|------|
+| 装逼打脸 | 反派嚣张 | 主角碾压 | 爽 |
+| 拉仇恨 | 负面情绪 | 恶人受罚 | 爽 |
+| 先抑后扬 | 打压 | 爆发 | 爽 |
+| 期待感 | 制造鸿沟 | 弥合鸿沟 | 爽 |
+
+### 实操要点
+
+- 每个场景标注：读者当前情绪在哪个阶段；下一步是调动还是释放。
+- 只有调动没有释放 = 读者憋屈弃书
+- 只有释放没有调动 = 爽感平淡无力
+- 调动程度决定释放爽度：仇恨拉多满，打脸就多爽
+
+---

package/lib/oh-story/skills/story-setup/references/agent-references/emotional-arc-design.md

@@ -1,5 +1,5 @@
 # 情绪弧线操作手册
-> 写故事时选弧线、控制节奏、调动情绪的速查操作手册。
+> 排卷纲、设计剧情单元时选弧线、排节奏、管期待的速查手册。写一章时怎么把情绪落到纸面见 emotion-on-page.md。
 
 ## 决策路由表
 
@@ -197,42 +197,6 @@
 
 ---
 
-## 情绪核心公式
-
-写每个场景时分离三层情绪：
-1. 角色自己的情绪（角色感受到的）
-2. 文本传递的情绪（文本要让读者感受的）
-3. 读者实际感受的情绪（读者真正的体验）
-
-同一场景三层可以完全不同：角色在哭，文本在撩，读者在爽。
-
-例：女主当众被退婚，强忍着没掉泪——角色：屈辱；文本写她嘴角还挂着笑（角色：撑）；读者替她憋着、等后面打脸（读者：爽前蓄力）。
-
----
-
-## 前反应-复现-后反应情绪结构
-
-用于虐/悲壮/遗憾类场景。按顺序执行三步：
-
-1. **前反应**：让读者提前知道坏结果，然后描写美好事物（读者预知法）
-2. **复现**：让坏结果真的发生
-3. **后反应**：主角真情流露，作出改变（愤怒/拼命/振作）
-
-操作示例：知道某人一天后要死 -> 让她经历美好（逛街、看烟花） -> 她真的死了 -> 主角愤怒拼命
-
----
-
-## 以小搏大情绪结构
-
-用于热血/逆袭类场景。按顺序执行四步：
-
-1. **前反应**：铺垫弱者的苦，用对比强化（现在的弱 vs 以前的强）
-2. **复现**：强者到来，"我知道你们苦，我来了"
-3. **后反应**：弱势方被拯救
-4. **士气如虹**：整体气势转变
-
----
-
 ## 冲突中的情绪层次与死亡赌注
 
 ### 选择死亡赌注
@@ -257,59 +221,6 @@
 
 ---
 
-## 基于不该如此的情绪驱动
-
-- "不该如此"是最根本的情绪驱动力——写诬告、不公、恃强凌弱，读者天生生出"不该如此"的念头
-- 核心情绪逻辑：想要爽，必先不爽；想要公平，必先不公平；想要强大，必先不强大
-- "悬而未决"也是强驱动力
-- 好的题材必须具备勾起人们惋惜、渴望改变的特质
-
----
-
-## 理念矛盾的情感爆发力
-
-- 理念之争比利益之争更能引发读者深层共鸣
-- 少量关键场景即可，不需要大量笔墨
-- 理想主义与现实的冲突是塑造配角封神级人设的手法
-- 理念认同 = 人设认同 = 读者情感投入
-- 在主线中穿插理念型角色，用他们的追求和牺牲拔高全书情绪上限
-
----
-
-## 情绪调动的三层方法
-
-三层：**长期感情投入**、**短期事件冲突**、**场景描绘**。三者可叠加，核心是前两层。
-
-### 长期引导三步骤
-
-1. **抛出共鸣炸弹**：找到角色最易引发共鸣的情感锚点（梦想、仇恨、恐惧）
-2. **让读者变见证者**：展示角色付出和挣扎，每一步伴随收获
-3. **让读者变参与者**：通过足够铺垫和细节，产生命运共同体感
-
-### 短期情绪引导
-
-短期靠独立事件冲突。**直白冲突比繁杂情节更容易引起共鸣**。
-
-两种事件类型：
-- **推动情节发展的事件**：让读者对角色处境产生认同
-- **塑造人物性格的事件**：让读者对角色思想性格产生认同
-
-开篇必须选择塑造人物性格的事件——先认同角色这个人才关心角色的事。
-
-### 情绪代入的陷阱
-
-读者未代入主角前：主角弱势可以引起同情，但**敌人弱势也同样引起同情**。读者还没建立认同时，不要把对手写得可怜。
-
-### 情绪文笔技法
-
-- **句长跟着情绪和节奏走**：紧张、决断处用短句提速，铺垫、沉淀处用长句蓄势；短句是提速工具，不是默认底色，别通篇拆短
-- **情绪词**：骤然、猛然、刺眼——制造紧迫感
-- **动作词**：抽、划、留下——画面感强，情绪外化
-- **修饰词**：精准克制地使用形容词，不堆砌
-- **进阶规则**：优先通过角色行为暗示情绪，而非直接描写（非硬性，必要的内心可以直写，别为外化堆无功能的小动作）。**以乐写悲**：角色在最悲伤时表现开心，情绪张力更强（赴死的人很开心，往往比哭更悲）
-
----
-
 ## 男频恋爱文情绪设计
 
 ### 两大核心需求
@@ -339,30 +250,6 @@
 
 ---
 
-## 情绪调动统一视角
-
-> 写完一段觉得不到位 / 读者反馈平淡时使用。
-
-### 终极公式
-
-**平静 -> 调动 -> 释放 -> 爽**
-
-| 技法 | 调动 | 释放 | 结果 |
-|------|------|------|------|
-| 装逼打脸 | 反派嚣张 | 主角碾压 | 爽 |
-| 拉仇恨 | 负面情绪 | 恶人受罚 | 爽 |
-| 先抑后扬 | 打压 | 爆发 | 爽 |
-| 期待感 | 制造鸿沟 | 弥合鸿沟 | 爽 |
-
-### 实操要点
-
-- 每个场景标注：读者当前情绪在哪个阶段；下一步是调动还是释放。
-- 只有调动没有释放 = 读者憋屈弃书
-- 只有释放没有调动 = 爽感平淡无力
-- 调动程度决定释放爽度：仇恨拉多满，打脸就多爽
-
----
-
 ## 期待感维持的底层机制
 
 > 写了目标但读者不关心 / 六法则用了但效果不好时使用。

package/lib/oh-story/skills/story-setup/references/agent-references/format-and-structure.md

@@ -146,7 +146,7 @@
 
 | 平台 | 章节标记 | 对话格式 | 特殊要求 |
 |------|----------|----------|----------|
-| 知乎盐言 | `1.` | `「」` | 导语需单独标注 |
+| 知乎盐言 | `1.` | `「」` | 导语即正文开头几段，不另标 |
 | 番茄 | `###第一章` | `""` | 首段需有吸引力 |
 | 红果 | `###1.` | `""` | 无 |
 

package/lib/oh-story/skills/story-setup/references/agent-references/genre-prose-cards.md

@@ -18,7 +18,7 @@
 1. 先读 `设定/题材定位.md`，确认主题材、目标平台、性向频道、主对标书和核心梗。
 2. 先查本索引匹配题材，再只读取同目录的 `genre-prose-cards/{题材}.md` 这一张卡；不要把整套题材卡全部加载进 prompt。
 3. 跨题材时，主题材读取 1 张完整卡，辅题材读取 1 张并只摘 1-2 条“常见场面/禁止漂移”；不要把两套节奏并行堆满。
-4. 高置信卡可直接用于 Phase 2 `设定/题材正文提示卡.md`；中置信卡需结合本书对标/细纲对照；低置信卡只能兜底，必须标注低置信并优先补同题材对标。
+4. 高置信卡可直接用于写第 1 章前生成的 `设定/题材正文提示卡.md`；中置信卡需结合本书对标/细纲对照；低置信卡只能兜底，必须标注低置信并优先补同题材对标。
 5. 每章传给 narrative-writer 的 `genre_prose_card` 只保留本章相关条目，推荐 120-300 字；包含：题材限制、核心逻辑、读者期待、核心爽点/情绪、正文落点、前中后期打法、场景颗粒、禁止漂移、本章取舍、卡片置信度。
 6. **题材卡只在写手内部校准题材味，绝不出现在正文里**：正文不得写卡名、题材标签、置信度、条目编号或“证据摘要”数据，也不得写“已按题材卡/满足字数/零违规”一类合规自评或写作过程说明——只输出故事本身。
 

package/lib/oh-story/skills/story-setup/references/agent-references/long-genre-catalog.md

@@ -260,7 +260,7 @@
 | 逆向型 | 失去X→获得更强Y | 越惨越强、负债越有钱 |
 
 ### 写长方法
-核心卖点确定后多套路交织循环；单元故事围绕一个套路展开，主线串联；一级结构循环(模式重复但对象/场景/规模升级)
+核心卖点确定后多套路交织循环；单元故事围绕一个套路展开，主线串联；剧情单元循环(模式重复但对象/场景/规模升级)
 
 ### 脑洞四类
 1. 金手指类(聊天群/系统/戒指老爷爷)

package/lib/oh-story/skills/story-setup/references/agent-references/long-genre-mechanics.md

@@ -79,7 +79,7 @@
 **断期待的判断**：某章既无期待点也无爽点，前一爽点已结束，本身没拉起新期待→读者觉得书失去了"灵魂"开始弃书。
 
 **两种运转模式**：
-- 不断循环型：每个一级结构运行一次，变奏场景/对象/条件
+- 不断循环型：每个剧情单元运行一次，变奏场景/对象/条件
 - 只运行一次型：围绕一个核心情绪分阶段推进
 
 ### 检验清单
@@ -95,7 +95,7 @@
 | 误区 | 表现 |
 |------|------|
 | 核心梗太多 | 什么都想写=没有核心梗 |
-| 立意不明确 | 没有情绪目标，文字干巴巴 |
+| 立意不明确 | 没有目标情绪，文字干巴巴 |
 | 纯装逼打脸无主题 | 剧情没有意义 |
 | 核心梗用完不升级 | 生硬重复，审美疲劳 |
 | 挂羊头卖狗肉 | 书名暗示与实际内容不符 |
@@ -297,7 +297,7 @@
 - **关系拉扯**：推进和拉开交替，不能只拉近。扯开可用心有芥蒂/暂时冷静/误会，避免直接分手
 - **英雄救美**：男主事业线行为无意间救女主→女主倒追(非白给)
 - **误会**：制造隔阂延缓推进，也是装逼打脸工具
-- **窗户纸事件**：好感度质变→关系阶段变化，事业线为主的放在一级结构小高潮
+- **窗户纸事件**：好感度质变→关系阶段变化，事业线为主的放在剧情单元小高潮
 
 ### 狗粮文循环
 

package/lib/oh-story/skills/story-setup/references/agent-references/long-quality.md

@@ -19,14 +19,16 @@
 - [ ] 短期、中期、远期期待都有人维护；回收旧期待前已建立下一层期待。
 - [ ] 单章反转改变下一步行动，卷级反转改变对阶段机制的理解，全书真相没有被提前透支。
 
-## 读者契约与终局储备
+## 读者契约与终局储备：契约四问
 
-- [ ] 核心卖点按开篇承诺兑现，收益和高光没有被配角、机构或巧合无交换地拿走。
-- [ ] 主角保有因果权与结算权；配角可以执行局部动作，但不能无声夺走关键选择和结算。
-- [ ] 延期的期待支付了利息，而不是被流程、解释或新设定吞掉。
-- [ ] 本卷没有动用后续阶段才该解锁的宿敌、身份、真相或能力上限。
+- [ ] ①主角靠自己的选择挣到结果：保有因果权与结算权；配角可以执行局部动作，但不能无声夺走关键选择和结算。
+- [ ] ②核心卖点按开篇承诺兑现，收益和高光没有被配角、机构或巧合无交换地拿走。
+- [ ] ③本卷没有动用后续阶段才该解锁的宿敌、身份、真相或能力上限，升级线没有顶到天花板。
+- [ ] ④延期的期待支付了利息，而不是被流程、解释或新设定吞掉；旧期待回收时留下新期待。
 - [ ] 高潮后允许短暂低压和可见奖励，不机械立即追加更大危机。
 
+四问都过＝契约安全；能靠补交换、铺垫或成本补上＝需补强；补不上＝契约破坏，先修纲再写。
+
 ## 长篇反向检查
 
 - 删除“安全解释”后情绪是否更强、因果仍成立？

package/lib/oh-story/skills/story-setup/references/agent-references/opening-design.md

@@ -56,13 +56,13 @@
 | 出场 3 个以上主要角色 | 信息过载 |
 | 序章/楔子/引 | 除非以叙事为主、足够简短且与第一章逻辑紧密 |
 | 插叙/切视角/回忆梦境 | 正叙为主 |
-| 世界观详细解说 | 至少等到第一个一级结构结束 |
+| 世界观详细解说 | 至少等到第一个剧情单元结束 |
 
 ### 冲突节奏
 
 - 背景融入冲突（如用旁人议论同时完成背景和冲突）
 - 两个紧张场景间要有缓和，但缓和 ≠ 无冲突
-- 背景信息分批释放（信息团排版），优先级：危机感 > 人设 > 金手指暗示 > 世界观，每次释放服务于当前情绪目标
+- 背景信息分批释放（信息团排版），优先级：危机感 > 人设 > 金手指暗示 > 世界观，每次释放服务于当前目标情绪
 
 ### 开篇结构范例（鬼灭之刃）