@oh-story/dsh 0.1.3 → 0.1.5

package/lib/oh-story/skills/{story-short-analyze/references/hooks-chapter.md → story-setup/references/agent-references/long-chapter-hooks.md}

@@ -1,6 +1,6 @@
-# 章级钩子：章首/章尾钩子选择与写作
+# 长篇章级钩子：章首/章尾选择与跨章期待
 
-> 写每章开头或结尾时加载。先看决策路由，选对钩子类型，再套模板。
+> 写长篇章首或章尾时加载。先按章节功能和跨章期待选类型，再决定落点与篇幅。
 
 ---
 
@@ -210,7 +210,7 @@
 - 前置小无敌：打脸前必须把道具/人物/实力准备好，没有则读者担惊受怕，嘲讽变虐主
 - 铺垫比打脸重要：铺垫到位后主角站着不说话都能装逼
 - 打脸对象层级决定爽感层级：路人甲震惊不叫爽，有分量的人震惊才叫爽
-- 章末钩子约 100 字即可显著提升完读率
+- 章末钩子只写到期待成立为止；篇幅服从信息复杂度，不设固定百字配额
 
 ---
 
@@ -218,8 +218,8 @@
 
 写完章首/章尾后对照：
 
-- [ ] 章首前 100 字有钩子（不是风景/天气开头）
+- [ ] 章首尽早出现可识别的行动、异常或未闭合期待；不按固定百字位置机械卡点
 - [ ] 章尾有让读者想翻下一页的东西
 - [ ] 钩子强度与章节阶段匹配（日常章不必强钩子）
 - [ ] 连续两章不用同一种钩子
-- [ ] 钩子约 100 字，点到即止，不拖沓
+- [ ] 钩子没有为凑长度重复解释，落点与本章功能、下一章承接一致

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

@@ -0,0 +1,209 @@
+# 长篇情感设计：单元情绪引擎 + 三板斧 + 失败模式
+
+> 设计情感桥段时加载。先用下方通用长篇单元情绪引擎规划因果链；三板斧只在适用场景中作为可选技法。
+
+---
+
+## 长篇单元情绪引擎（通用正向框架）
+
+每个剧情单元先设计能制造情绪与兑现的**正向发动机**，再做安全审查：
+
+> **核心情绪命题 → 承载对象/情绪缺口 → 受阻或缺口维持原因 → 本轮触发 → 主角不可替代的点火/转化动作 → 意义变化或可见兑现 → 题材/契约兑现**
+
+这条因果链适用于爽、燃、甜、虐、恐、治愈等不同核心情绪。承载对象可以是人物、关系、目标、规则或场景；不适用的环节可写“无/即时”，但必须保持因果闭合。它不要求每个题材都有长期受阻、最终画面或克制反应，也不规定单一机制：误解、物件、反转、死亡等都不是必备项。下文“情感虐心三板斧”是适合部分情感题材的**可选技法**，不是通用引擎的硬模板。
+
+### 正向发动机与负向护栏的顺序
+
+1. **先设计正向发动机**：明确读者会为什么投入，本轮如何让这份投入改变意义并得到可见兑现。
+2. **后用项目读者契约做负向护栏诊断**：检查因果权 + 结算权、期待所有权与终局储备，排查契约/推进失败。“安全”只代表没踩红线，不代表好看；护栏不能代替情绪发动机。
+
+### 合理性五问
+
+1. 为何是该承载对象？
+2. 为何是现在？
+3. 为什么没有被直接解决 / 为何此前仍悬置？
+4. 主角凭什么介入/转化？
+5. 现实/设定边界如何约束？
+
+五问用来截住巧合式工具人、为推情节而突然变蠢的机构，以及事后补一段说明的解释补丁。
+
+### 强度原则
+
+强情绪来自**具体投入、受阻/延迟、意义变化、可信反应等机制按题材组合**，不要求全部出现，也不来自堆叠死亡、疾病和哭喊。克制反应只是部分情绪的可选放大器。物件、对话、动作、身份、规则、关系都可作为可选锚点；锚点频率随篇幅和读者记忆需求调整，从不强制重复三次。集体或价值抬升也是可选的；只在题材需要时，才由个体兑现扩展到题材核心情绪。
+
+---
+
+## 决策路由
+
+| 你的情感设计场景是 | 用这个策略 | 跳转到 |
+|---------------|-----------|----------|
+| 规划长篇剧情单元的情绪引擎 | 通用长篇单元情绪引擎 | 长篇单元情绪引擎 |
+| 建立角色羁绊（让读者相信关系） | 羁绊铺设（第一斧） | 三板斧 §1 |
+| 制造情感撕裂（反差/错位/背叛） | 情感撕裂（第二斧） | 三板斧 §2 |
+| 写结尾余韵（安静细节击穿读者） | 余韵钝痛（第三斧） | 三板斧 §3 |
+| 规划整体情感节奏曲线 | 拉扯节奏设计 | 拉扯节奏 |
+| 不同题材的情感策略选择 | 题材策略差异 | 按题材 |
+| 检查情感设计是否有效 | 失败模式排查 + 快速自查 | 底部清单 |
+
+---
+
+## 情感虐心三板斧
+
+### 第一斧：羁绊铺设（前 1/3）
+
+**目标**：用具体物件/数字/细节建立关系质感，让读者相信这段关系是真实的。
+
+**方法**：
+- 用具体数字建立时间感：「相恋八年」「昏迷五年」「七年光景」
+- 用具体物件承载感情：金锁（姐姐的生日礼物）、账本数字（还债记录）、木头小马（父王磨的）
+- 用重复动作建立习惯：每天一碗粥、每两周来看一次、每年冬天冻得睡不着
+
+**案例**：
+- 《迟来二十年》：用二十年的账本数字（八万块）建立母女关系的重量
+- 《我在佛前求你》：昏迷五年、求神拜佛的细节、从初中开始的暗恋
+- 《皇弟欺负幼子》：七年质子生涯的具体苦难（跪雪地、挨巴掌、吃馊饭）
+
+**核心**：羁绊越具体，后面的撕裂越痛。不要用「他们很相爱」这种抽象描述。
+
+---
+
+### 第二斧：情感撕裂（中后段）
+
+**目标**：制造反差，让读者以为恨对了 → 发现恨错了（或反过来）。
+
+**方法**：
+- **反差法**：先展示温暖一面，再用残酷真相击碎
+- **错位法**：角色 A 以为在保护角色 B，实际上在伤害
+- **延迟真相法**：关键信息在读者最不期待的时候揭示
+
+**案例**：
+- 《姐夫捎路要奶粉钱》：妈妈表面软弱可怜，实际一直操控姐姐索取钱财 → 金锁是假的（金包铜）→ 反差撕裂
+- 《皇弟欺负幼子》：王氏表面温柔（送手炉、煎汤药）→ 实际下药逼疯先皇后 → 用诛心话逼死
+- 《重生弟弟》：弟弟深爱女友 → 女友是诈骗犯 → 怀孕是假的 → 被骗到电诈园区
+
+**核心**：撕裂的力度取决于铺垫的厚度。没有好的羁绊铺设，撕裂就是无根之木。
+
+---
+
+### 第三斧：余韵钝痛（结尾）
+
+**目标**：不用大哭大闹，用安静细节击穿读者防线。
+
+**方法**：
+- 用日常动作承载巨大情感：继续喂粥、把衣服叠好、不回头
+- 用物件细节制造余韵：坏掉的金锁、木头小马、沾血的戒指
+- 用「不」制造留白：不解释、不回头、不流泪
+
+**案例**：
+- 《皇弟欺负幼子》：「他拿着那匹被我磨得很光滑的木头小马……他握着正好。」
+- 《姐夫捎路要奶粉钱》：「我的手机清净了不少。那些困扰我很久的麻烦，在一瞬间变得很小很小。」
+- 《准儿媳打分》：「办了收养手续后，她第一次踏进这个陌生的家……我知道，这一次我没选错。」
+
+**核心**：最好的余韵不靠大哭，靠「看完之后很久都忘不掉」。
+
+---
+
+## 情感拉扯节奏设计
+
+### 基本节奏曲线
+
+```
+温暖 → 残忍 → 善意 → 真相 → 原谅 → 来不及 → 释然 → 细节暴击
+```
+
+不是所有故事都走完整曲线。按题材选择子集：
+
+| 题材 | 典型节奏 | 核心拉扯 |
+|------|----------|----------|
+| 世情/爽文 | 欺压 → 忍耐 → 爆发 → 打脸 | 情绪反弹快、打脸密度高 |
+| 情感/虐心 | 甜蜜 → 破碎 → 挽回 → 错过 | 慢铺垫、后劲大 |
+| 古言/复仇 | 隐忍 → 布局 → 揭穿 → 报应 | 设定简洁、暴力美学 |
+| 悬疑/推理 | 平静 → 不安 → 真相 → 震惊 | 信息差制造不安 |
+| 年代/亲情 | 误解 → 冲突 → 真相 → 和解 | 代际冲突、时代质感 |
+
+### 拉扯原则
+
+1. **情绪转向频率是题材与篇幅经验法则**：结合题材、篇幅和既有兑现节奏调整，不固定要求每 3-5 个小节转向
+2. **每次转向都要有触发事件**（不能无理由地改变情绪）
+3. **最后一次转向决定结尾余韵的基调**
+4. **爽文允许快速反弹，虐文需要更长铺垫**
+
+---
+
+## 按题材的情感策略差异
+
+### 世情/爽文
+
+- 情绪反弹速度：快（受辱后 2-3 节内打脸）
+- 打脸密度：每 3-5 节一次
+- 反派嚣张度：递增（第一次小嚣张，最后一次大嚣张）
+- 结尾基调：痛快、解气
+- 案例：《准儿媳打分》— 打分制反制、铁盒零分、断绝关系
+
+### 情感/虐心
+
+- 羁绊细节密度：高（前 1/3 必须建立深厚羁绊）
+- 反差设计：先暖后冷，先甜后苦
+- 余韵技法：安静结尾 + 物件细节
+- 结尾基调：意难平、释然
+- 案例：《姐夫捎路要奶粉钱》— 金锁真相 → 假爱 → 独立
+
+### 古言/复仇
+
+- 设定简洁原则：人物关系清晰，不搞复杂世界观
+- 暴力美学写法：打脸要直接，不拖泥带水
+- 底牌时机：最后 1/4 揭示最大底牌
+- 结尾基调：大快人心、因果报应
+- 案例：《皇弟欺负幼子》— 一声令下打二十棍 → 查出真相 → 废后
+
+### 悬疑/推理
+
+- 信息差布局：读者知道角色不知道，或反过来
+- 排除法结构：逐步排除可能性，最后只剩真相
+- 动机揭示节奏：先揭示做了什么，再揭示为什么做
+- 结尾基调：细思极恐、原来如此
+- 案例：《重生弟弟》— 重生设定 + 诈骗犯身份 + 电诈园区
+
+### 年代/亲情
+
+- 代际冲突处理：不站队，展示双方的苦
+- 时代细节质感：用时代特有的物件/习俗建立质感
+- 和解节奏：不急和解，先让双方充分受伤
+- 结尾基调：温暖中带着遗憾
+- 案例：《姐夫捎路要奶粉钱》— 亲子关系 → 金锁真相 → 断裂
+
+---
+
+## 常见失败模式
+
+| 失败模式 | 识别方法 | 修正方向 |
+|----------|----------|----------|
+| **太平** | 连续 5+ 节没有情绪转折 | 插入意外事件或新信息 |
+| **太赶** | 重大转折缺少可辨认的铺垫 | 按转折重量与篇幅给予足够且可辨认的铺垫，不固定三节 |
+| **假虐** | 读者不心疼，只是看着难受 | 检查羁绊铺设是否具体 |
+| **割裂** | 前半部分和后半部分像两篇不同的故事 | 用伏笔/物件/主题贯穿 |
+| **烂尾** | 反转后仍长时间重复交代 | 按题材与篇幅适配的速度收束或冷却，不固定五百字 |
+| **人设崩** | 角色在关键时刻的行为不符合前面的人设 | 回顾人设，确保行为逻辑一致 |
+
+---
+
+## 快速自查
+
+设计情感时，用这个清单：
+
+- [ ] 前 1/3 有具体羁绊细节（不是抽象描述）？
+- [ ] 中段有反差/撕裂（读者以为 A → 实际是 B）？
+- [ ] 结尾有安静细节（不是大段抒情）？
+- [ ] 情绪转向频率是否按题材、篇幅和既有兑现节奏调整，而非固定密度？
+- [ ] 反派行为符合其人设逻辑？
+- [ ] 不存在上述 6 种失败模式？
+
+---
+
+## 三板斧与 SKILL.md 五段结构映射
+
+| 三板斧 | 对应 SKILL.md 五段 | 说明 |
+|--------|-------------------|------|
+| 第一斧：羁绊铺设（前 1/3） | 铺垫段（第二段，占 30-40%） | 用物件/数字/习惯建立关系质感 |
+| 第二斧：情感撕裂（中后段） | 升级段（第三段）+ 反转段（第四段） | 反差/错位/延迟真相制造撕裂 |
+| 第三斧：余韵钝痛（结尾） | 结尾段（第五段，占 5-10%） | 安静细节收尾，不写大段抒情 |

package/lib/oh-story/skills/{story-long-write/references/genre-catalog.md → story-setup/references/agent-references/long-genre-catalog.md}

@@ -1,6 +1,6 @@
-# 题材框架速查
+# 长篇题材框架速查
 
-> **用途**：拆文和写大纲时对照使用。你是一个熟练的网文结构分析师，按照下方路由表选择对应框架，严格执行结构比例和情绪节拍。
+> **用途**：长篇选题和大纲设计时对照使用。节点占比用于检查整卷/全书功能分配，不是每章硬配额；短篇结构转交 `story-short-write`。
 
 ---
 
@@ -31,9 +31,9 @@
 
 | 还需要什么 | 加载 |
 |-----------|------|
-| 核心梗设计与循环机制 | `genre-core-mechanics.md` |
+| 核心梗设计与循环机制 | `long-genre-mechanics.md` |
 | 读者心理与期待管理 | `genre-readers.md` |
-| 对应题材写作公式 | `genre-writing-formulas.md` |
+| 对应长篇题材卡 | `genre-prose-cards.md` 索引及 `genre-prose-cards/` 对应题材卡 |
 
 ---
 
@@ -62,18 +62,6 @@
 | 7.反复拉扯 | 多次求复合被拒 | 20% | 爽(打脸) |
 | 8.结局 | 开放/回头/悲剧 | 15% | 释放 |
 
-### 短篇（压缩三幕）
-
-**核心**：先虐后爽，后悔的男人+不回头的女人
-
-| 幕 | 占比 | 内容要点 |
-|----|------|----------|
-| 建压 | 40% | 冷暴力/出轨(具体事件)→最后忍让→平静离开 |
-| 爆点 | 35% | 丈夫后悔→妻子新生活→追妻被拒→信息差释放 |
-| 落定 | 25% | 火葬场→妻子最终选择→一句话定调 |
-
-**技法**：前期虐越狠后期越爽；妻子至少被拒绝两次；丈夫视角悔恨比妻子视角坚强更有冲击；钩子=信息差+打脸
-
 ---
 
 ## 重生复仇
@@ -101,16 +89,6 @@
 | 7.反派下场 | 逐一报应 | 10% | 爽(宣泄) |
 | 8.新生活 | 选择新方向 | 10% | 治愈/释然 |
 
-### 短篇（压缩三幕）
-
-| 幕 | 占比 | 内容要点 |
-|----|------|----------|
-| 建压 | 35% | 重生节点→前世闪回→第一个不同选择→信息差建优势 |
-| 爆点 | 40% | 逐步拆解仇人→两个打脸名场面→仇人反击落空→前世未知真相 |
-| 落定 | 25% | 终极复仇→弥补遗憾→新生开始 |
-
-**技法**：不能太顺利要有变数；打脸分层递进；前世闪回有选择不倒完；钩子=信息差+暗牌+打脸
-
 ---
 
 ## 小三/婚恋
@@ -133,16 +111,6 @@
 | 7.报应 | 10% | 爽(宣泄) |
 | 8.新生活 | 10% | 治愈 |
 
-### 短篇（压缩三幕）
-
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 40% | 暗示裂痕→蛛丝马迹→确认→冷静(不是崩溃) |
-| 爆点 | 35% | 暗中布局→表面周旋(戏剧张力)→摊牌 |
-| 落定 | 25% | 法律/揭露/经济独立→渣男下场→新生 |
-
-**技法**：发现过程要有悬念；妻子要有策略不是傻白甜；钩子=信息差+暗牌+倒计时
-
 ---
 
 ## 世情
@@ -165,16 +133,6 @@
 | 7.报应 | 15% | 爽(宣泄) |
 | 8.善有善报 | 10% | 治愈 |
 
-### 短篇（压缩三幕）
-
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 40% | 困境→暴露事件→周围人态度→忍还是争 |
-| 爆点 | 35% | 冲突升级→背叛/落井下石→反击→反转 |
-| 落定 | 25% | 解决→人心揭示→成长→留白 |
-
-**技法**：靠细节不靠大事件；人物不能非黑即白；钩子=代价+弱者+反转
-
 ---
 
 ## 仙侠/玄幻
@@ -199,16 +157,6 @@
 
 **关键维度**：力量体系清晰不崩 | 金手指独特有限制随成长 | 战斗有策略非纯数值 | 地图逐层展开 | 升级节奏均匀
 
-### 短篇（压缩三幕）
-
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 35% | 世界规则+主角位置→困境→核心设定→人物出场 |
-| 爆点 | 40% | 修炼转折→正面交锋→大阴谋→关键反转 |
-| 落定 | 25% | 终极对决(有策略有代价)→矛盾解决→仙侠留白 |
-
-**技法**：世界观压缩到最少用事件带出；等级/功法3-5个概念足矣；冲突落在"情"非"力"；钩子=暗牌+反转+代价
-
 ---
 
 ## 死人文学
@@ -231,16 +179,6 @@
 | 7.因果终结 | 10% | 释放 |
 | 8.余韵结局 | 10% | 意难平 |
 
-### 短篇（压缩三幕）
-
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 35% | 死亡事实→死者视角→最放不下的事→生者状态 |
-| 爆点 | 40% | 回忆现实交叉→真相→反转→最扎心时刻 |
-| 落定 | 25% | 放手或执念→生者继续或崩塌→安静画面→一句话/意象 |
-
-**技法**：核心是"来不及"；死者第一人称最有冲击；情绪克制越克制越扎心；钩子=代价+信息差+弱者
-
 ---
 
 ## 都市高武
@@ -263,14 +201,6 @@
 
 **关键**：金钱驱动反复挂钩 | 换地图用过渡人物连接 | 10万字前数据偏弱是常态 | 前三章=底层处境→金手指→第一次展示
 
-### 短篇（压缩三幕）
-
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 35% | 经济困境→被压制→金手指触发 |
-| 爆点 | 40% | 实力提升→碾压→更强对手出现但不惧 |
-| 落定 | 25% | 解决对手→阶段性胜利→暗示更大世界 |
-
 ---
 
 ## 霸总/甜宠
@@ -292,14 +222,6 @@
 
 **关键**：甜的密度决定粘性 | 宠要"别人做不到的方式" | 阻力不能太强(虐就跑偏)不能太弱(没张力) | 女主要独立闪光点
 
-### 短篇（压缩三幕）
-
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 30% | 女主困境→相遇→男主展露兴趣 |
-| 爆点 | 40% | 宠溺(闺蜜震惊标配)→超出预期→危机轻松化解 |
-| 落定 | 30% | 感情确认→极致甜场景→暗示幸福 |
-
 ---
 
 ## 同人流派
@@ -388,14 +310,6 @@
 
 **关键**：大部分读者是"云爱好者"爽感优先于还原度 | 现代认知信息差=最大金手指 | 架空可降低门槛 | 盘点+历史共鸣感强
 
-### 短篇（压缩三幕）
-
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 30% | 穿越到关键时刻→面临危机 |
-| 爆点 | 45% | 利用现代知识/信息差解决→打脸质疑者 |
-| 落定 | 25% | 历史轨迹改变→获得新地位 |
-
 ---
 
 ## 文娱/娱乐圈
@@ -449,14 +363,14 @@
 
 ---
 
-## 通用拆文提醒
+## 长篇设计提醒
 
 | 检查项 | 说明 |
 |--------|------|
 | 题材识别 | 属于哪个框架？有无跨框架混搭？ |
-| 节奏比例 | 长篇：实际vs推荐8节点占比差多少？短篇：三幕占比差多少？ |
-| 反转位置 | 在百分之多少出现？ |
-| 钩子密度 | 每2000字至少一个？ |
+| 节奏比例 | 节点功能是否在对应卷/全书阶段出现，偏移是否有题材或人物因果支持？ |
+| 反转位置 | 是否在阶段旧认知已经支撑过行动、且揭示后仍有后果空间时出现？ |
+| 钩子密度 | 高压、推进、低压章节是否形成张弛，期待链有没有断？ |
 | 字数效率 | 有无废段落？哪些可删？ |
 | 情绪落点 | 读完最后一句是什么感觉？ |
 
@@ -464,15 +378,15 @@
 
 ## 质量检查清单
 
-每次使用本手册完成拆文或大纲后，逐项核对：
+每次使用本手册完成长篇定位或大纲后，逐项核对：
 
 | # | 检查项 | 通过标准 |
 |---|--------|----------|
 | 1 | **题材定位正确** | 已通过路由表确认框架，无模棱两可 |
-| 2 | **结构比例达标** | 长篇8节点/5阶段各节点占比偏差不超过5%；短篇三幕占比偏差不超过5% |
+| 2 | **结构功能完整** | 8节点/5阶段承担的功能齐全；实际比例服从题材、卷功能与人物因果，不按固定 ±5% 判死 |
 | 3 | **情绪节拍完整** | 压抑→爆发→释放的完整情绪弧线存在，无断层 |
 | 4 | **人物弧线明确** | 主角有清晰的起点和终点变化；反派有独立动机不是工具人 |
-| 5 | **钩子密度足够** | 每2000字至少一个悬念/反转/信息差钩子 |
+| 5 | **期待链不断** | 章节强弱符合定位；回收旧期待前已经建立下一层期待，不按固定字数配钩子 |
 | 6 | **金手指自洽** | 金手指规则明确，使用有限制，后期不崩 |
 | 7 | **信息差利用到位** | 有读者知道但角色不知道、或角色知道但对手不知道的信息差设计 |
 | 8 | **技法匹配题材** | 已对照对应题材的"技法"条目，无遗漏 |

package/lib/oh-story/skills/story-setup/references/agent-references/{genre-core-mechanics.md → long-genre-mechanics.md}

@@ -2,7 +2,7 @@
 
 > **用途**：核心梗三层递进设计（主题→题材→情绪），微创新五法、冲突网络、金手指匹配、事业线/爱情线设计。构思和验证大纲时对照使用。
 > **语气**：指令式——每个原则都是"必须做到"的硬规则，违反就有明确后果。
-> **配合**：题材结构骨架见 genre-writing-formulas.md，读者画像见 genre-readers.md。
+> **配合**：长篇题材结构与声线见 genre-prose-cards.md，读者画像见 genre-readers.md。
 
 ---
 

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

@@ -0,0 +1,40 @@
+# 长篇质量覆盖
+
+> 与 `agent-quality.md` 配套，仅在 `long` profile 加载。长篇按章、单元、卷和全书分层审查；短篇全文百分比、每节字数和对话密度不适用。
+
+## 黄金三章
+
+- [ ] 第一章建立主角处境、主动目标或不可忽略的异常，而非只展示世界观。
+- [ ] 第二章让阻力、代价或信息复杂度升级，不重复第一章同类受挫。
+- [ ] 第三章给出阶段追查方向、可执行目标或第一笔兑现，同时保留更高层问题。
+- [ ] 主角在前三章作出不可替代的选择；关键因果和收益没有被导师、机构或偶然性夺走。
+- [ ] 每章结尾有继续阅读的理由；低压章可以是阶段目标、关系变化或未完成动作，不强求强悬念。
+- [ ] 核心机制在前三章至少立住两条可验证硬规则和一个尚未解释的例外；例外制造问题，不能推翻刚建立的规则。
+- [ ] 第三章结束后仍保留可执行的阶段目标；若嫌疑人、入口或线索载体退出，必须留下可追查的物件、地点、见证人或权限链。
+
+## 连载节奏
+
+- [ ] 最近一个章节窗口有可见进展；窗口长度按当前卷和章节定位判断，不固定为短篇节数。
+- [ ] 高压、推进、低压、关系和信息整理章形成张弛，连续章节没有同一情绪母题和同一种钩子高位运行。
+- [ ] 短期、中期、远期期待都有人维护；回收旧期待前已建立下一层期待。
+- [ ] 单章反转改变下一步行动，卷级反转改变对阶段机制的理解，全书真相没有被提前透支。
+
+## 读者契约与终局储备
+
+- [ ] 核心卖点按开篇承诺兑现，期待所有权和收益归属清楚。
+- [ ] 主角保有因果权与结算权；配角可以执行局部动作，但不能无声夺走关键选择和结算。
+- [ ] 延期的期待支付了利息，而不是被流程、解释或新设定吞掉。
+- [ ] 本卷没有动用后续阶段才该解锁的宿敌、身份、真相或能力上限。
+- [ ] 高潮后允许短暂低压和可见奖励，不机械立即追加更大危机。
+
+## 长篇反向检查
+
+- 删除“安全解释”后情绪是否更强、因果仍成立？
+- 若保留风险情节，它是否换来更强期待、代价、关系变化或资源变化？
+- 章节功能成立是否依赖固定“每章一高潮”或全文百分比？若是，改回章节定位与跨章因果。
+
+## 审查输出合同
+
+- 阻断项和高风险项必须同时给出：可定位证据、失败影响、最小修法；存在方向分叉时再给一个可选替代。
+- 最小修法需保护后续容量：说明保留什么期待、推迟什么揭示、下一阶段具体追什么，而非只让当前三章更热闹。
+- 同类症状合并到一个根因；优先指出会让阶段目标失效、机制天花板提前或主角因果权旁落的问题。

package/lib/oh-story/skills/{story-short-write/references/reversal-toolkit.md → story-setup/references/agent-references/long-reversal.md}

@@ -1,4 +1,4 @@
-# 反转设计工具箱
+# 长篇反转设计
 > 操作手册：反转类型、嵌套反转、误导技巧、打脸节奏。按决策路由选用，按设置/揭示步骤执行，用自检清单验收。
 > 反转类型枚举与拆文 `_meta.json.reversal_type` 字段一致：视角/身份/动机/时间线/信息/认知/无反转。
 
@@ -175,7 +175,7 @@
 **写法要点**：
 1. 不为"显得有设计感"硬加反转
 2. 报应型：每个报应要让读者等过、铺过，兑现时才解气
-3. 甜宠型：升温节拍密集，每节给一个甜点/反差点
+3. 甜宠型：在关系阶段节点给甜点/反差点，不为每章硬塞反转
 
 > 拆文时遇到此类，`reversal_type` 填「无反转」，`setup_clues`（反转铺垫）一项跳过阈值（见 analyze output-contract 的「structure_counts 数值校验」）。
 
@@ -183,19 +183,19 @@
 
 ## 嵌套反转
 
-一篇短篇可叠 2-3 层反转，必须主次分明。
+长篇可在单元、卷和全书三层安排反转，但每层只能有一个主认知变化；下位反转服务上位谜团，不能不断推翻世界规则。
 
 ### 双层嵌套
 
 ```
 读者以为：A（铺垫阶段）
-第一层反转：其实是 B！（70%处）
-第二层反转：B 也是假的，其实是 C！（90%处）
+第一层反转：其实是 B！（阶段假答案）
+第二层反转：B 解释了局部，但 C 才是更高层机制！（卷末认知升级）
 ```
 
 **执行要求**：
 - 第一层反转必须足够有说服力，让读者接受B就是真相
-- 第一层后给1-2段「消化时间」
+- 第一层后给至少一个行动后果或关系变化，不在同一场景立刻翻回去
 - 第二层要能同时解释A和B，比第一层更震撼
 
 示例：
@@ -208,36 +208,22 @@
 
 ### 三层嵌套（慎用）
 
-**使用条件**：只有15000字以上能装下三层。
-
-**执行要求**：
-- 间隔递减：第一层50-60%，第二层75-80%，第三层90-95%
-- 第三层必须最短最狠——一句话就够
-- 最后一层必须回答前面所有疑问
-- 每层都要有情感冲击，不只是信息冲击
-- 题材限制：只适合高智商悬疑、精心设计的复仇
+只在“单元假答案 → 卷级机制 → 全书真相”确有不同叙事职责时使用。每层必须改变角色下一步行动，并留下可回溯证据；若只是连续换答案，砍到两层。
 
 ---
 
 ## 反转时机
 
-### 最佳揭示位置
-
-| 反转类型 | 最佳位置 | 原因 |
-|----------|----------|------|
-| 身份反转 | 65-75% | 留够时间展示身份变化后的新冲突 |
-| 视角反转 | 70-80% | 需要足够篇幅建立错误认知 |
-| 动机反转 | 75-85% | 动机要在角色做出关键选择前揭示 |
-| 时间线反转 | 80-90% | 时间线需要最长铺垫 |
-| 信息反转 | 70-80% | 揭示后需要展示连锁反应 |
-| 认知反转 | 75-90% | 感情色彩要全程积累够才翻得动 |
+### 揭示位置按叙事层级决定
 
-### 时机铁律
+| 层级 | 合适时机 | 揭示后必须发生什么 |
+|------|----------|--------------------|
+| 场景/单章 | 当前行动获得可验证结果时 | 角色立刻调整选择或关系 |
+| 单元 | 阶段目标看似完成、旧解释无法覆盖新证据时 | 开启下一阶段目标并支付代价 |
+| 卷级 | 本卷承诺已兑现、读者能回看证据链时 | 改写对主线机制的理解，保留全书真相 |
+| 全书 | 核心矛盾具备结算条件时 | 完成因果、情绪与收益归属结算 |
 
-- 禁止在50%之前揭示——铺垫不够，反转没力度
-- 禁止在95%之后揭示——揭示后没有展开空间
-- 最优区间：70-85%
-- 双反转：第一个在55-65%，第二个在80-90%
+不要把全书百分比当铁律。反转太早或太晚的判断标准是：旧认知是否已经支撑过真实行动、揭示后是否还有足够篇幅展示后果。
 
 ---
 
@@ -282,7 +268,7 @@
 - [ ] 揭示方式自然，不靠角色大段独白解释
 
 ### 节奏
-- [ ] 反转揭示不超过300字（快速、干脆）
+- [ ] 揭示场景没有被解释独白淹没；复杂机制可以分行动、证据和后果多拍展示
 - [ ] 揭示后有足够篇幅展示反转影响
 - [ ] 反转后结尾在反转产生的情绪上收束
 
@@ -310,7 +296,7 @@
 ### 超额收获反转
 
 反转后收获超出预期，产生二次惊喜：
-- 短篇：主角以为只解决一个问题，结果连带解决了隐藏的更大问题
+- 长篇：主角解决阶段问题，同时获得通向更高层矛盾的资源、身份或证据
 - 网游文模式：Boss爆三样——立刻能用的 / 送人拉关系的 / 暂时用不到但一看很厉害的
 
 ### 情绪拉扯反转标准流程
@@ -338,7 +324,7 @@
 
 ### 打脸节奏铁律
 
-- 压抑不能太长——连输8场写3万字不行，改成连输4场+略写
+- 压抑长度服从单元功能；连续失败必须带来信息、能力、关系或策略积累，不能只换场景重复受挫
 - 压的同时必须给读者信心暗示（主角自信到自大："我们还是联赛前四！"）
 - 比起主角被欺负，读者更厌恶主角自暴自弃
 - 高潮部分要拉长，最大化利用（球迷反应、解说员、赛后跟进）

package/lib/oh-story/skills/{story-short-write/references/hooks-suspense.md → story-setup/references/agent-references/long-suspense.md}

@@ -1,4 +1,4 @@
-# 悬念编排操作手册
+# 长篇悬念编排
 
 悬念构建、强度分级、多线周期、分层钩子、期待接力、震惊分层的完整操作指南。
 
@@ -86,11 +86,11 @@
 
 ### 三段钩子设计（单章内）
 
-按章节进度分配悬念节奏：
+按章节功能安排，而不是把每章机械切成固定百分比：
 
-1. **种**（前 30%）：埋下钩子种子
-2. **养**（中 50%）：逐步加压，让读者意识到不对劲
-3. **收**（末 20%）：引爆或延迟引爆
+1. **种**：在本章第一个有效场景中提出异常、目标或未完成动作。
+2. **养**：用行动受阻、新证据或关系变化加压；过渡章可以只推进一拍。
+3. **收**：本章兑现一项状态变化，并把尚未解决的问题交给下一章。
 
 延迟引爆 = 比引爆更强的钩子，用于拉到下一章。
 
@@ -102,7 +102,7 @@
 
 - 确保读者脑中有三个好奇的东西：两长一短
 - 长期待收回后变短期爆发，同时新的长期待已铺好
-- 短篇中：一个主悬念 + 一个副悬念，结尾同时引爆
+- 长篇中：短期、中期、远期悬念不能在同一章全部引爆；每次回收至少保留或新建一条更长的期待线。
 
 ### 持续拉期待操作框架
 

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

@@ -177,7 +177,7 @@
 
 ```
 出了{医院/法院/某场所}，{天气映射心情}。
-{主角}{一个微动作暗示内心}。
+{主角}{一个会改变现场的选择、台词、任务动作或后果；必要时才用身体细节}。
 脑海中闪过{某人}的话——
 "{冲击性的一句话}"
 {主角的反应}。