@oh-story/dsh 0.1.15 → 0.1.16

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

@@ -0,0 +1,63 @@
+# 叙事用笔：让篇幅落在值得经历的地方
+
+本文件检查场景与段落组的详略。表达修法见 [expression.md](expression.md)，需要改变事件或人物选择时见 [story-logic.md](story-logic.md)。取舍服从 [style-resolution.md](style-resolution.md) 的文风裁决。
+
+## 从场景作用找到重心
+
+通读一场连续的戏，用一句话说明它要让读者经历什么：一次选择、交涉转向、关系变冷、发现误会，也可以是生活处境、松弛、氛围或余韵。只作为本次判断依据，不强制生成逐段标签或新附件。
+
+沿正文找最需要被经历的地方：人物何时改变判断，哪句话使交涉转向，犹疑怎样走到决定，某个日常细节怎样拉近或拉开关系。对照实际篇幅，指出具体的过详或过略。场景重心没有展开时，先检查原文、前后文或已定设计是否已有过程，不能用一批感官细节顶替。
+
+| 问题 | 看什么 | 怎么处理 |
+|---|---|---|
+| 次要过程占住篇幅 | 开门、倒水、赶路、逐件清点被连续展开，却不改变人物处境或读者感受 | 压成必要承接，留能建立空间、声口、关系或氛围的细节 |
+| 关键过程被概述吞掉 | “商量妥了”“三言两语解释清楚”“她终于想通了”替代选择或交锋 | 展开已有条件、试探、判断和反馈；依据缺失时转故事诊断，不编造说服理由 |
+| 同类对象平均用力 | 三个人、四件物品各给同样篇幅，读者找不到重心 | 围绕此场作用分配；重要对象展开，其他对象概括或略过，不规定递减次数 |
+| 状态原地打转 | 反复写害怕、愤怒、沉默，人物的理解和行动始终相同 | 合并复述，保留会改变下一步或积累体验的过程 |
+| 只见结果、不见过渡 | 上句拒绝、下句答应；情绪突然抵达 | 找回已有承接；若成立条件从未设计，提出故事修法 |
+
+“平”可能来自重心写薄，也可能来自故事没有足够的变化。先判断是哪一种，避免把所有慢场景都压短。
+
+## 删除、压缩、展开各有检验
+
+**删除测试**：删去后，是否损失事实、伏笔、因果、空间方向、人物声口、关系、情绪持续时间或审美体验？没有损失可以删除，包括整段；有损失则保留有效部分或压缩表达。无须给每个细节编出后续情节用途。
+
+**压缩测试**：用一句概述替代后，读者是否只知道结果，却无法体会人物怎样走到这里？如果丢掉必要的犹疑、交锋或情绪抵达，就保留展开。事实未丢只是一项检查，不能据此抹平生活质感。
+
+**展开测试**：新增的每一轮有没有使信息、处境、判断、关系或感受发生变化？同一情绪可以持续，停顿也有时间感；只换措辞强调强度的反应链应收拢。原文已有的分阶段变化可以分段演出，不因相邻出现动作、感知、反应就判重复。
+
+重排后通读整场：读者还能知道谁在哪里、为什么停下、下一步为何发生吗？删过头导致电报体时，恢复必要的主体、连接和承接，不恢复模板解释。遵守作者字数范围；若有效内容不足以满足下限，报告缺口，不用微动作或新事件补齐。删改比例只描述实际变化，不决定哪些废话必须保留。
+
+## 细节要服务这场戏
+
+- **动作**：保留带来阻碍、失败、选择、关系或人物习惯的动作。没有必要逐次记录伸手、拿起、放下、转身；打斗、追逐、操作步骤若承担真实空间和因果信息，可以细写。
+- **心理**：保留新判断、误判、回忆、权衡与自我欺骗。准确直写能承担过渡；反复翻译刚发生的事、总结同一情绪则压缩。不能把内心活动一律改成身体反应。
+- **对话**：看双方各自争取什么、什么不愿说、哪次回应改变了局面。关键处展开，其余可用叙述带过，不把原文每个“他说/她说”都改成一行台词。对白、叙述和心理共同承接这场戏，不用整齐的一问一答代替场景。不要求每句答非所问，也不靠加粗话提高烈度。
+- **环境和物件**：观察应贴人物此时的注意力。可以建立生活质感、时间感、审美和关系；不要求每件东西都成为线索。逐件同精度陈列、通用天气和无功能装饰应压缩。
+- **群像反应**：人物因立场不同改变行动，值得分开；全体轮流手抖、后退、吃惊只是在重复标价。判断和分量可以由有立场的人给出，不强行给所有人台词。
+
+## 信息交付与收尾
+
+新人物、新物件或新设定出现时，让读者知道当前行动所需的身份、作用或限制。已有场内载体和简明叙述都可使用，不强迫改成手机、账单或办事卡点。必要解释可以直说；读者暂时不知道答案时，至少要知道自己正在等哪个问题。
+
+分清角色已知、读者已知与仍待揭露的信息。故意留下的悬念不补答案，必要承接不删成生词清单。事实依据与揭露时机的核查见 [story-logic.md](story-logic.md)。
+
+结尾检查最后一拍带来了什么：行动未完、关系变化、一次兑现、尚未解决的问题或情绪余韵都可以。动作、对话、心理和带立场的叙述均可收尾；清理重复复述、空泛哲理与没有具体对象的预告。短篇的主观审判、心死判词和火葬场预告按本书卖点取舍，保留并不等于放过重复。
+
+## 同一事实怎样换用笔
+
+以下为合成示例。已定事实：余舟要送信过溪，先试石墩，第二块松动后退回；他改从上游的倒树过，把信袋挂在颈前，终于到了对岸。
+
+**用笔失衡**：溪边有三棵树，两棵树皮灰白，一棵长了苔。树下散着石子，近处圆一些，远处扁一些。余舟想了几个办法，费了一番工夫，终于把信带过溪。
+
+**重心恢复**：
+
+> 余舟踏上第二块石墩，石头往下一沉，他赶紧退回岸边。
+>
+> 上游横着一棵倒树。他沿溪走过去，把信袋挂到颈前，空出手扶着树干，一点点挪到了对岸。
+
+改的是已定尝试和调整的呈现，没有新加救援者、工具或意外。如果资料只说“费了一番工夫”，连尝试和办法都没有，就不能照本例编石墩和倒树。
+
+**会改坏的方向**：只写“他从倒树过了溪”，会把已有的试探和改变办法压没；逐一罗列抬脚、落脚、换手，又会让无差别的动作抢走注意力。
+
+**该保留的慢处**：老人收起亡妻的茶具，先按她原来的位置放好，再取下来包纸。多停留的这一会儿可以让读者经历习惯与失落。可以修机械句式，不能仅以“事件推进少”删掉。

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

@@ -22,7 +22,7 @@
 +-- 轻喜剧       → 用"吐槽式反应+认知错位"
 ```
 
-> **路由只示意每个题材一个可行的开头方向，不是必用套路。** 箭头是"起手候选之一"，不是查表取的唯一解。每本书按主角、卖点、对标自选或自造开头切口；同一题材连续开书不复用同一套路骨架——照套就成了可检索的开头指纹（同 writing-craft.md 身体细节规则：照抄或复用，产物本身就是新模板指纹）。下方「题材开头模板」同理，是菜单不是模具。
+> 路由与下方模板提供开头候选。按本书主角、卖点、对标另定切口和信息释放顺序，同题材连续开书不复用同一套路骨架。
 
 ### 开头策略选择
 
@@ -147,7 +147,7 @@
 
 ## 题材开头模板
 
-> 下列每个题材只给一个填空骨架，**是示意方向、不是要照填的模具**。填空即成稿会让同题材两本书开头逐句同构（同样的地点句→场景句→反常行为句→悬念句），正是"开头同质化"的来源。用它定"开头该解决什么"（快速抛冲突/身份反差/悬念），具体切口、句序、信息释放顺序按本书主角和对标一本一变；同一题材连续开书别复用同一骨架。
+> 先从骨架中确定本书开头要解决的冲突、身份反差或悬念，再自行安排句序与场景。
 
 ### 都市脑洞
 
@@ -285,12 +285,12 @@
 
 | 人设类型 | 适合的金手指 | 翻车组合 |
 |----------|-------------|----------|
-| 开朗/搞笑型 | 自爆类（装逼爽+吐槽契合） | 搞笑型+自爆金手指=不搭 |
+| 开朗/搞笑型 | 自爆类（装逼爽+吐槽契合） | 能力代价破坏已定轻松基调 |
 | 心狠手辣型 | 传统型（升级、资源获取） | 冷酷型+搞笑金手指=违和 |
 
 ---
 
-## 七步法字数分配
+## 六段开篇字数分配
 
 | 段落 | 字数 | 内容 |
 |------|------|------|

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

@@ -64,13 +64,13 @@ Phase 3 设计矛盾与主线结构时加载。包含矛盾设计、主线支线
 按以下步骤逆推主线结构：
 
 1. 先确定一句话结局。
-2. 逆推各级目标（世界首富<--本州<--本国<--省<--市<--县<--镇<--村<--家庭）。
+2. 逆推各级目标（世界首富<--本国<--省<--市<--县<--镇<--村<--家庭）。
 3. 大主线拆为中主线，中主线拆为小主线，不断细化。
 4. 小主线完成后，中主线变为新的小主线，循环推进。
 
 ### 主线 = 冲突驱动
 
-主线故事 = 解决冲突。将大冲突拆分为多个小冲突形成故事线。每个阶段必须有一个无法解决的核心冲突。
+主线故事 = 解决冲突。将大冲突拆分为多个小冲突形成故事线。每个阶段须保留一个尚未解决、能推动后续行动的核心冲突。
 
 ### 支线 = 完成主线的手段
 
@@ -430,7 +430,7 @@ Phase 3 设计矛盾与主线结构时加载。包含矛盾设计、主线支线
 
 优先级：
 1. **先有趣再有用**：先确保事件有戏剧性。
-2. **拆出来的情节就是戏剧性**：拆书时有爽点的事件直接用。
+2. **拆出戏剧机制**：回查爽点由什么矛盾、选择和结果产生，再换成本书人物与事件。
 3. **不够有趣时做铺垫拉期待**。
 
 ---
@@ -444,7 +444,7 @@ Phase 3 设计矛盾与主线结构时加载。包含矛盾设计、主线支线
 - [ ] 主角是否有三种动机来源中的至少两种（世界背景/金手指/人物关系）
 - [ ] 主线结构是否用高潮逆推法拆分为大/中/小主线
 - [ ] 冲突是否持续升级（言语->行动->激烈对抗->决定胜负），且有明确结果
-- [ ] 每个阶段是否有无法解决的核心冲突驱动读者继续看
+- [ ] 每个阶段是否有尚未解决的核心冲突驱动读者继续看
 - [ ] 支线最终是否汇聚回主线
 - [ ] 暗线（如有）是否在高潮与明线交汇
 - [ ] 感情线（如有）是否按四阶段推进，试探阶段占30-50%

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

@@ -43,7 +43,7 @@ Phase 3 建大纲时加载。包含大纲创建法、结构分级、节点设计
 
 ### 第3步：故事线组织与信息点预埋
 
-同时管理 8 条故事线，每条必须标注预埋时机：
+按下表检查 8 类故事线，实际采用的每条标注预埋时机；同一条线可兼属多类，不必另建八条：
 
 | 故事线 | 内容 | 预埋什么 |
 |--------|------|----------|
@@ -91,7 +91,7 @@ Phase 3 建大纲时加载。包含大纲创建法、结构分级、节点设计
 
 ### 约束规则（必须遵守）
 
-- 时空关联:逻辑关联 >= 1:3（每1个因果推进，至少3个场景推进）
+- 检查相邻剧情的选择与后果如何相接，避免只靠同一时间、地点串联（如“拿到线索→决定调查”，而非仅“第二天换个地方”）
 - 后续剧情情绪值不能显著低于前序
 - 相同金手指逻辑禁止连续使用
 - 同类剧情套路间隔 >= 3个不同类型剧情
@@ -149,8 +149,8 @@ Phase 3 建大纲时加载。包含大纲创建法、结构分级、节点设计
 
 ### 细纲
 
-- 细纲:正文 = 1:2.5~1:3
-- 不展开具体情节，只关注目的和效果
+- 1:2.5~1:3 可作细纲详略参考，不替代 workflow-outline.md 的必填模板
+- 写清目的、效果与可执行情节点，不提前写成正文
 - 每个节点标注"详写"还是"略写"
 - 核心目的：让后续写作能快速定位要交付的目的和效果
 

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

@@ -57,7 +57,7 @@ Phase 3-4 节奏把控时加载。包含升级感设计、情绪模块公式、
 - 升级前：铺垫未升级时的待遇差距、资源获取难度
 - 升级后：多方面展示变化——战力、待遇、人际关系、资源获取
 
-**升级次数控制**：主角升级最好不超过3次，质量提升而非数量堆叠。
+**升级次数控制**：一个剧情单元内重点展示的升级最好不超过3次，突出质变；全书升级随体系展开。
 
 **即时反馈与延迟反馈**：
 
@@ -214,7 +214,7 @@ Phase 3-4 节奏把控时加载。包含升级感设计、情绪模块公式、
 
 **1. 现实高潮**（社会热点）：路怒症、出轨、霸凌等。不照搬，要把情绪极限化。一般放在开头或上架节点。
 
-**2. 作品高潮**（8类）：
+**2. 作品高潮**（7类）：
 
 | 类别 | 典型 |
 |------|------|

package/lib/oh-story/skills/story-setup/references/agent-references/plot-core-methods.md

@@ -24,16 +24,16 @@
 
 ## 小纲四步法
 
-细纲与正文比例控制在 **1:2.5 ~ 1:3**。
+**1:2.5 ~ 1:3** 是细纲详略参考，实际仍须满足 workflow-outline.md 的必填模板。
 
 按以下四步操作：
 
 1. **分段判断** — 把大纲按剧情节点分段
-2. **标注目的和效果** — 每段标注，不展开情节
+2. **标注目的和效果** — 每段写清要发生什么、带来什么变化
 3. **标注详写/略写** — 明确哪些段展开、哪些段带过
 4. **快速定位** — 让后续写作能快速定位本段要交付的目的和效果
 
-记住：细纲只关注目的和效果，不展开情节。
+细纲写清目的、效果与可执行情节点，不提前扩写成正文。
 
 ---
 
@@ -271,7 +271,7 @@
 ### 核心冲突的节奏保护规则
 
 1. 非大结局章节通常不解决全书核心冲突；若阶段核心冲突收束，要同步开启下一期待
-2. 章末约200字宜保留悬念、决定、发现、余韵或阶段目标；低压章节不强求硬悬念
+2. 章末围绕最后一个具体落点保留悬念、决定、发现、余韵或阶段目标；低压章节不强求硬悬念
 3. 局部胜利可伴随新的代价、风险或下一任务；纯奖励/低压回收章可只提供明确收益和后续期待
 
 ### 事件后的冷却章节数
@@ -500,7 +500,7 @@
 
 ### 节奏与期待
 - [ ] 三层期待（短/中/长）是否同时在线
-- [ ] 章末约200字是否保留悬念、决定、发现、余韵或阶段目标
+- [ ] 章末是否保留悬念、决定、发现、余韵或阶段目标
 - [ ] 信息密度是否有高低交替（不能一直高或一直低）
 - [ ] 冷却期规则是否遵守
 

package/lib/oh-story/skills/story-setup/references/agent-references/short-chapter-hooks.md

@@ -1,6 +1,6 @@
-# 章级钩子：章首/章尾钩子选择与写作
+# 短篇钩子：节首/节尾与全文悬念
 
-> 写每章开头或结尾时加载。先看决策路由，选对钩子类型，再套模板。
+> 设计短篇节首、节尾或全文悬念时加载，按当前问题选手法。
 
 ---
 
@@ -25,15 +25,13 @@
 | 制造好奇 | 悬念对话 / 闪前碎片 / 神秘独白 | 信息差驱动 |
 | 对比冲击 | 反差场景 / 意象预示 | 反差吸引 |
 
-### 章节阶段与钩子强度
+### 短篇悬念的承接与收束
 
-| 故事阶段 | 推荐类型 | 强度 |
-|----------|---------|------|
-| 第 1 章 | 系统激活 / 截断 / 危机升级 | 必须强 |
-| 2-3 章 | 选择 / 信息差 / 情感转折 | 强 |
-| 中期日常 | 对话悬念 / 信息差 / 身份即将揭露 | 中 |
-| 高潮前 | 危机升级 / 悬念预知 | 强 |
-| 大结局 | 时间跳跃 / 情感转折 | 收束 |
+先确定全文最终要回答的核心问题。副悬念为它提供证据、误导或情绪代价，不另开独立支线。
+
+局部问题揭晓后，让答案改变下一步行动、关系立场或读者对核心问题的判断。延迟揭晓时，也要交付新证据、误判修正或局部反击，避免一直抬问题。
+
+舒缓的小节可用局部兑现和明确行动承接。进入终局时回答核心问题，不用无关的新谜题延长故事。
 
 ---
 
@@ -182,7 +180,7 @@
 
 ### 爽点核心公式
 
-爽点 = 两个逻辑的冲突点：
+爽点来自读者预期与主角表现的落差：
 - **大众逻辑**：对手不可战胜 → 恐惧/绝望
 - **主角逻辑**：正好手痒/轻描淡写
 - 落差越大 → 爽点越爽
@@ -191,35 +189,17 @@
 
 | 角色 | 操作 |
 |------|------|
-| 吃瓜群众 | 用议论吹高对手逼格 → 震惊反应完成打脸升华 |
+| 围观者 | 用判断展示对手优势，受结果影响后改变立场 |
 | 对手 | 嚣张到让读者恨 → 被打脸时才爽 |
 | 主角 | 铺垫时低调 → 释放时干脆 |
 
-看点 = 吊起读者期待；爽点 = 满足期待。一一对应：前面铺垫多少，后面爽点就有多少。
-
-### 装逼打脸节奏
-
-| 阶段 | 公众期（5 章循环） | VIP 期 |
-|------|-------------------|--------|
-| 人设 | 1 章 | 1-2 章 |
-| 铺垫 | 2 章 | 5 章 |
-| 打脸 | 1 章 | 1-2 章 |
-| 善后 | 1 章 | 1 章 |
-
-**关键**：
-- 前置小无敌：打脸前必须把道具/人物/实力准备好，没有则读者担惊受怕，嘲讽变虐主
-- 铺垫比打脸重要：铺垫到位后主角站着不说话都能装逼
-- 打脸对象层级决定爽感层级：路人甲震惊不叫爽，有分量的人震惊才叫爽
-- 章末钩子约 100 字即可显著提升完读率
-
----
+先让读者期待一个具体结果，再用主角行动及其后果兑现；围观反应只能放大效果。
 
 ## 质量检查
 
 写完章首/章尾后对照：
 
 - [ ] 章首前 100 字有钩子（不是风景/天气开头）
-- [ ] 章尾有让读者想翻下一页的东西
-- [ ] 钩子强度与章节阶段匹配（日常章不必强钩子）
-- [ ] 连续两章不用同一种钩子
-- [ ] 钩子约 100 字，点到即止，不拖沓
+- [ ] 非终局节尾有未完成动作、新信息、关系变化、局部兑现或明确下一步，读者知道为何继续
+- [ ] 延迟的答案已有阶段收益，副悬念服务全文核心问题
+- [ ] 终局兑现此前承诺，不靠新增无关困境延长故事

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

@@ -1,6 +1,6 @@
 # 情感设计方法：三板斧 + 拉扯节奏 + 失败模式
 
-> 设计情感桥段时加载。先看决策路由选策略，再用三板斧设计具体段落。
+> 设计情感桥段时加载，按当前关系与目标情绪选择方法。
 
 ---
 
@@ -81,7 +81,7 @@
 温暖 → 残忍 → 善意 → 真相 → 原谅 → 来不及 → 释然 → 细节暴击
 ```
 
-不是所有故事都走完整曲线。按题材选择子集：
+按题材选用曲线中需要的转折：
 
 | 题材 | 典型节奏 | 核心拉扯 |
 |------|----------|----------|
@@ -93,7 +93,7 @@
 
 ### 拉扯原则
 
-1. **情绪不能一路虐到底或一路爽到底**（连续多个小节没有情绪立场、期待或压力变化时，查是否停滞）
+1. **情绪、期待或压力要持续变化**；连续多个小节不变时检查停滞。甜宠可沿甜度递进，报应型可沿反制升级，不强行插入负向回落
 2. **每次转向都要有触发事件**（不能无理由地改变情绪）
 3. **最后一次转向决定结尾余韵的基调**
 4. **爽文允许快速反弹，虐文需要更长铺垫**
@@ -148,8 +148,8 @@
 
 | 失败模式 | 识别方法 | 修正方向 |
 |----------|----------|----------|
-| **太平** | 连续 5+ 节没有情绪转折 | 插入意外事件或新信息 |
-| **太赶** | 重大转折只用了 1 节铺垫 | 给转折至少 3 节铺垫 |
+| **太平** | 连续多个小节没有情绪、期待或压力变化 | 检查原定事件是否带来新信息、选择或后果 |
+| **太赶** | 重大转折缺乏足以支撑它的铺垫 | 补清关系积累与转折的触发事件 |
 | **假虐** | 读者不心疼，只是看着难受 | 检查羁绊铺设是否具体 |
 | **割裂** | 前半部分和后半部分像两篇不同的故事 | 用伏笔/物件/主题贯穿 |
 | **烂尾** | 反转后还在补交代、新开事件 | 篇幅按小节大纲分配；反转后只写兑现与余韵 |
@@ -159,8 +159,6 @@
 
 ## 快速自查
 
-设计情感时，用这个清单：
-
 - [ ] 前 1/3 有具体羁绊细节（不是抽象描述）？
 - [ ] 中段有反差/撕裂（读者以为 A → 实际是 B）？
 - [ ] 结尾有安静细节（不是大段抒情）？
@@ -170,9 +168,9 @@
 
 ---
 
-## 三板斧与 SKILL.md 五段结构映射
+## 三板斧与五段结构映射
 
-| 三板斧 | 对应 SKILL.md 五段 | 说明 |
+| 三板斧 | 对应写作五段 | 说明 |
 |--------|-------------------|------|
 | 第一斧：羁绊铺设（前 1/3） | 铺垫段（第二段，占 30-40%） | 用物件/数字/习惯建立关系质感 |
 | 第二斧：情感撕裂（中后段） | 升级段（第三段）+ 反转段（第四段） | 反差/错位/延迟真相制造撕裂 |

package/lib/oh-story/skills/story-setup/references/agent-references/short-genre-formulas.md

@@ -1,7 +1,6 @@
 # 短篇题材写作公式
 
-> **用途**：短篇题材的结构骨架、情绪节拍、必选场景、关键规则。章数只是小节编排方式，不代表长篇卷级结构。
-> **语气**：指令式——每个公式都是可直接套用的结构骨架。
+> **用途**：按题材选择结构、情绪节拍、场景与写法；章数表示短篇小节编排。
 > **配合**：优先使用当前 skill 内的通用技法 reference；story-setup 部署后使用项目本地 agent reference bundle 中的写作技法、结构格式、题材风格模块副本。
 > **适用范围**：本文件的节奏参数只适用于短篇和短篇小节；长篇任务转交 `story-long-write`，本文件不提供长篇开局公式。
 
@@ -9,7 +8,7 @@
 
 ## 决策路由：按题材选公式
 
-> 写之前先定位题材，找到对应公式，按公式结构推进。
+> 核心 10 题材优先用 genre-styles 风格包；冷门题材从下表选择对应公式。
 
 | 题材/类型 | 对应公式 | 篇幅 |
 |-----------|---------|------|
@@ -47,7 +46,7 @@
 
 **情绪**：愤怒→爽→紧张→更爽→极爽→余韵+震撼
 **必选场景**：当众羞辱开场、冷静到可怕的反击、标志性动作、逐层揭露证据、反派自曝、隐藏伏笔回收
-**规则**：主角永不失态；情绪克制直写，不堆体感；对方越歇斯底里主角越平静；先让反派得意再翻转
+**规则**：主角以冷静反击为主；情绪克制直写，不堆体感；用对方失控与主角选择形成反差，先让反派得意再翻转
 
 ---
 
@@ -66,7 +65,7 @@
 
 **情绪**：压抑×3→释放→释放→短暂再压→终极释放
 **必选场景**：回归羞辱、被冤枉被打、信物展示、身份揭露名场面、妹妹恶毒递进、父母偏心加码
-**规则**：分步揭露身份；压抑3节释放1节；父母用"偏心"写不用"坏"写；妹妹恶从阴阳怪气→陷害→要杀
+**规则**：分步揭露身份，随身份与反击推进释放情绪；父母用"偏心"写不用"坏"写；妹妹恶从阴阳怪气→陷害→要杀
 
 ---
 
@@ -110,6 +109,7 @@
 ```
 
 **情绪**：愤怒→解气→甜→紧张→极爽→余韵
+新男主承接温柔与身份揭露线，渣男承接后悔收尾。
 **必选场景**：前世付出导语交代清；双重生博弈；年代细节（的确良、大团结、赤脚医生）；男主看似缺陷实则完美；渣男崩溃写足；结尾用渣男视角写后悔
 **规则**：年代感靠真实历史细节；"替罪羊"比"被出轨"更有冲击力；双重生=双重信息战；渣男绝望反衬女主洒脱
 
@@ -180,9 +180,9 @@
 
 **情绪比例**：虐30%→觉醒15%→爽35%→治愈20%
 **虐三层**：言语伤害→行为伤害→身体伤害
-**必选场景**：开篇信息炸弹；白月光出场每句话羞辱女主；临界事件（监控/母亲去世丈夫带秘书旅行）；死遁/消失30%作品使用；渣男追悔被拒；新恋情暗示50%
+**必选场景**：开篇信息炸弹；白月光以台词羞辱女主；临界事件（监控/母亲去世丈夫带秘书旅行）；渣男追悔被拒。死遁/消失、新恋情暗示按本篇设计选用
 **简介6步**：情境设定→冲突引爆→对话金句→女主转折→悬念钩子→身份预告
-**规则**：100%第一人称；伤害性对话"精准刺痛"非谩骂；觉醒是一瞬间；爽按序释放不能乱序
+**规则**：本式默认第一人称；伤害性对话针对人物处境，避免只剩谩骂；用临界事件触发觉醒，再依次兑现反击与治愈
 
 ---
 
@@ -205,8 +205,6 @@
 
 | 指标 | 女频 | 男频 |
 |------|------|------|
-| 情绪触发密度 | 3.23次/千字 | 2.50次/千字 |
-| 反转密度 | 1.77次/千字 | 1.21次/千字 |
 | 反转类型 | 信息差型（心声/真相） | 力量型（身份/实力） |
 | 反派类型 | 渣男+绿茶+偏心父母 | 兄弟+老板+势利眼 |
 | 复仇方式 | 信息差式（真相揭露） | 力量式（实力碾压） |
@@ -362,7 +360,7 @@
 | "与狗，不得入内" | 逐出公司 |
 | "从今天起，她连这栋大楼的大门都不能再踏进半步" | 永久驱逐 |
 
-动作库与台词库只示意「冷静反差 + 权力宣告」的方向，禁止照搬原句：高频套句已是可检索的模板指纹，每本书按人设自造。
+动作与台词按人物、筹码和现场压力另写，库中示例只演示「冷静反差 + 权力宣告」，禁止照搬。
 
 ---
 

package/lib/oh-story/skills/story-setup/references/agent-references/short-paragraph-hooks.md

@@ -1,5 +1,5 @@
 # 段落级钩子技法
-短篇/段落级钩子类型、组合技法、禁忌、对话情绪递增、不公平伤害、围观者层级。用于段落内微钩子设计。
+用信息差、代价或关系变化在段落中引起期待，并安排后续兑现。
 
 ---
 
@@ -20,13 +20,13 @@
 | 11 | 冷发现 | 发现异常后第一反应保持极度冷静，冷静本身制造悬念 | "钥匙扣上印着'悦安月子中心VIP'。我们明明没有孩子。我笑着点头。当天就去月子中心记下了预约单。" | ★5 |
 
 ### 使用要点
-- 信息差不能拖太久，超过 3000 字读者会烦
+- 信息差悬置期间持续交付新证据、局部答案或行动后果
 - 倒计时一旦设定，必须到期兑现，不能烂尾
 - 反转必须有铺垫，无铺垫的反转是作弊
-- 暗牌不能藏太久，短篇里最多藏 30% 篇幅
+- 暗牌在能改变局势时兑现，等待期间用局部反击维持期待
 - 打脸要干脆利落，一句话打脸比一段话打脸爽
-- 代价必须真实，主角最后什么都没失去则代价钩子失效
-- 弱者不能只是工具人，要有自己的行动线
+- 代价风险必须影响选择；最终避免损失时，写清为此付出的行动与条件
+- 弱者要有影响主线的行动或选择，避免只作受害道具
 - 灵魂视角的限制（只能看不能动）必须严格遵守
 
 ---
@@ -53,10 +53,8 @@
 | 阶梯背叛 + 冷发现 | 层层加码 + 全程冷静 |
 
 ### 组合使用原则
-1. 技巧服务表达，不要为了用技巧而用技巧
-2. 构思剧情阶段可同时考虑多种技巧丰富剧情
-3. 技巧可杂糅使用，没用就丢弃
-4. 不要通过单个技巧推导剧情，技巧是工具不是束缚
+1. 先按目标情绪与剧情需要选技巧，再考虑组合
+2. 组合中的每种技巧都须带来信息、选择或情绪变化；无作用的去掉
 
 ---
 
@@ -68,7 +66,7 @@
 | 机械降神 | 章尾抛出危机，下章开头用巧合解决 |
 | 过度留白 | 连续多章不揭示任何信息，读者失去耐心 |
 | 低风险钩 | 用无关紧要的事制造悬念 |
-| 同类型连用 | 连续 3 章以上用同一种钩子类型 |
+| 机械复用 | 连续用同一种手法重复相同问题，没有新信息或局部兑现 |
 
 ---
 
@@ -104,12 +102,13 @@
 | 损失转嫁型 | 反派将受惩罚嫁祸给主角 | 威逼利诱、做局、逼迫顶罪 | 隐蔽、阴险 |
 | 针锋相对型 | 反派所处秩序被主角打破 | 陷害、算计、伤害 | 不留活路 |
 
-### 压主角的正确方式
+### 爽文中安排主角受压
+
 1. 尽量不压——用"他人否定，主角打脸"替代"主角真受委屈"
 2. 否定间接化——当面嘲讽改为内心活动或背后议论
 3. 否定理由合情合理——基于现有信息的合理判断
 4. 否定人物多元化——不同立场否定方式不同
-5. 只在卷高潮时稍微压一下
+5. 重大失利须推动后续选择或反击，避免延长同一种压抑
 
 ---
 

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

@@ -12,8 +12,10 @@
 
 ## 反转与证据链
 
+有反转或取证情节时检查：
+
 - [ ] 每层反转前至少有可回溯线索，误导信息本身真实，只是解释方向错误。
-- [ ] 第一层给出可信阶段答案，第二层同时解释旧线索并改变情绪判断。
+- [ ] 采用两层反转时，第一层给出可信阶段答案，第二层解释旧线索并改变情绪判断。
 - [ ] 证据分批释放，最后一批改变全局认知；具体批次数由全文长度和题材决定。
 - [ ] 揭示后仍有行动、关系或代价结算，不用大段独白解释全部机关。
 - [ ] 若后半程出现更深冲突或第二议题，开篇问题与它之间至少已有两处因果或证据绑定；否则不是升级，而是换主线。
@@ -24,13 +26,13 @@
 - [ ] 对话承担取证、权力变化、关系撕裂或信息差，密度服从题材和源文基线，不套统一 45–65%。
 - [ ] 主角冷静、失控或强势必须来自人设和处境，不要求标志性端杯、转笔等模板动作。
 - [ ] 反派/操盘者有独立动机，不能只为最后一翻突然改设定。
-- [ ] 每个决定性证据转折都标明谁取得、谁验证、谁选择公开；主角至少拥有一次决定性发现和最终不可逆选择，不能一路被配角喂答案。
+- [ ] 决定性证据转折交代谁取得、谁验证、谁选择公开；主角至少拥有一次决定性发现和最终不可逆选择，不能一路被配角喂答案。
 
 ## 审查输出合同
 
-- 阻断项和高风险项必须同时给出：可定位证据、失败影响、最小修法；确有不同方向时再给一个可选替代。
+- 阻断项和高风险项须给出可定位证据、影响与最小修法；有不同方向时再给可选替代。
 - 最小修法要说明改哪一节、补哪条因果或移走哪笔结算，不能只写“加强铺垫”“提升主动性”。
-- 同类症状合并到一个根因，不用问题数量冒充审查深度。
+- 同类症状合并为根因，不重复计数。
 
 ## 结尾
 

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

@@ -1,6 +1,6 @@
 # 短篇反转设计
-> 操作手册：反转类型、嵌套反转、误导技巧、打脸节奏。按决策路由选用，按设置/揭示步骤执行，用自检清单验收。
-> 反转类型枚举与拆文 `_meta.json.reversal_type` 字段一致：视角/身份/动机/时间线/信息/认知/无反转。
+> 按决策路由选择反转，依次设计铺垫、揭示与后果，再用清单验收。
+> 反转类型与拆文 `_meta.json.structure_counts.reversal_type` 一致：视角/身份/动机/时间线/信息/认知/无反转。
 
 ## 决策路由
 
@@ -138,13 +138,13 @@
 | 朋友说看到他出轨 | 朋友在撒谎 | 朋友的「安慰」其实是操控 |
 | 老板说提拔我 | 岗位已取消 | 老板画饼为让我多干活 |
 
-**核心区别**：信息反转是认知层面的——你以为世界是A，其实是B。核心是「一条假信息」。
+**核心区别**：信息反转纠正一条关键假信息，并让此前基于它的行动获得新解释。
 
 ### 6. 认知反转
 
 **触发条件**：读者对某个角色/关系的整体理解被颠覆；重点在整段感情色彩翻转，而非单条信息纠错。
 
-**与信息反转的区别**：信息反转翻一条事实（遗嘱归属、亲子关系真伪）；认知反转翻读者对整个角色/关系的感情判断（恨了全程的妈其实一直在护着她）。信息反转改事实答案，认知反转改"我对他的感觉"。
+**与信息反转的区别**：信息反转纠正遗嘱归属、亲子关系真伪等事实；认知反转改变对整个角色或关系的感情判断，如一直被恨的母亲原来在保护主角。
 
 **设置步骤**：
 1. 全程让读者积累一种感情色彩（这个妈狠心/这个丈夫凉薄/这个对手纯坏）
@@ -169,12 +169,12 @@
 **触发条件**：甜宠、喜剧、反差萌、报应型复仇/重生——这类故事本就没有传统反转，硬塞反转反而毁节奏。
 
 **爽感来源（替代反转）**：
-- **报应兑现型**（复仇/重生爽文）：爽点不在"真相翻转"，在反派一步步走向毁灭、每条恶行精确对应一条报应（以彼之道还施彼身）。用报应设计表：恶行→报应→爽感来源。
+- **报应兑现型**（复仇/重生爽文）：在伏笔回查清单记下施害场景、台词或物件，兑现时可攻守对调；对得准比还得多重要，不要求逐条返还。
 - **甜度递进型**（甜宠/青春）：爽点在关系一步步升温，反差萌反复"装失败"。全程正向情绪阶梯上升，不经历反转的负向回落。
 
 **写法要点**：
 1. 不为"显得有设计感"硬加反转
-2. 报应型：每个报应要让读者等过、铺过，兑现时才解气
+2. 报应型：让读者等过、铺过，兑现才解气
 3. 甜宠型：升温节拍保持连续变化；若多个叙事单元都没有心动、试探、选择或关系后果，再检查是否停滞，不为逐节达标硬塞甜点
 
 > 拆文时遇到此类，`reversal_type` 填「无反转」，`setup_clues`（反转铺垫）一项跳过阈值（见 analyze output-contract 的「structure_counts 数值校验」）。
@@ -197,7 +197,7 @@
 
 **执行要求**：
 - 第一层反转必须足够有说服力，让读者接受B就是真相
-- 第一层后给1-2段「消化时间」
+- 第一层后用1-2段写角色如何按阶段答案行动，再引出第二层
 - 第二层要能同时解释A和B，比第一层更震撼
 
 示例：
@@ -213,7 +213,7 @@
 **使用条件**：只有篇幅、线索容量和情绪结算空间都足够时才用；多数短篇优先把一至两层做透。
 
 **执行要求**：
-- 间隔通常递减，但按小节功能和结算欠账定位，不套固定全文百分比
+- 间隔可逐渐缩短，按小节功能及尚待兑现的行动、关系后果定位
 - 第三层必须最短最狠——一句话就够
 - 最后一层必须回答前面所有疑问
 - 每层都要有情感冲击，不只是信息冲击
@@ -249,8 +249,8 @@
 
 ### 两大底层路径
 
-- **加法路径（分层法）**：在真实信息上叠加假信息。线索既可用逻辑线A解释为A'，也可用B解释为B'。A'是误导方向（常见故事），B'是真相（不常见故事）。误导读者以为是A'时，必须同时暗埋与B'相关的线索。
-- **减法路径（信息残缺法）**：不添加假信息，隐藏关键信息的一部分。只让主角得知成功的部分。导致下行的最好不是主角主动行动获得的，可以让配角获得那半信息后交给主角时发生意外。
+- **加法路径（分层法）**：将真实线索与人物相信的假信息放在一起，使同一线索既能支持错误解释，也能在回看时指向真相；引导误判时同步埋下真相依据。
+- **减法路径（信息残缺法）**：只展示关键信息的一部分。例如主角先得知计划成功，遗漏的代价由配角在传递消息时遭遇的意外带出。
 
 ### 五种技巧速查
 
@@ -290,7 +290,7 @@
 
 ### 逐节落表
 
-设计完成后，用一张表检查每节的 `功能 / 新证据或误判 / 主动者 / 节尾钩子 / 是否主付费点`。没有改变证据归属、嫌疑判断、关系立场或风险等级的节，应合并或改写；强钩子只标真正改变读者预期的节点。
+设计完成后，对照小节大纲检查每节的 `功能 / 新证据或误判 / 主动者 / 节尾钩子 / 是否主付费点`。没有改变证据归属、嫌疑判断、关系立场或风险等级的节，应在设计阶段合并或改写；正文阶段须先回到大纲调整。强钩子只标改变读者预期的节点。
 
 ---