npm - @oh-story/dsh - Versions diffs - 0.1.14 → 0.1.16 - Mend

@oh-story/dsh 0.1.14 → 0.1.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (533) hide show

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

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

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

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

@@ -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 @@
 ### 逐节落表
-设计完成后，用一张表检查每节的 `功能 / 新证据或误判 / 主动者 / 节尾钩子 / 是否主付费点`。没有改变证据归属、嫌疑判断、关系立场或风险等级的节，应合并或改写；强钩子只标真正改变读者预期的节点。
+设计完成后，对照小节大纲检查每节的 `功能 / 新证据或误判 / 主动者 / 节尾钩子 / 是否主付费点`。没有改变证据归属、嫌疑判断、关系立场或风险等级的节，应在设计阶段合并或改写；正文阶段须先回到大纲调整。强钩子只标改变读者预期的节点。
 ---

package/lib/oh-story/skills/story-setup/references/agent-references/story-logic.md ADDED Viewed

@@ -0,0 +1,65 @@
+# 故事成立与变化：诊断因果，按授权修复
+本文件检查事件、行为、信息和结果的关系。句段表达见 [expression.md](expression.md)，既有内容的详略见 [narrative-focus.md](narrative-focus.md)。执行范围由调用方确定，审稿只报告。
+## 沿事件检查，不套冲突公式
+先从原文和已有设计确认人物处境、所知信息、本场作用及结果，再追问结果怎样发生。人物可以被动、冲动、犯错、忍让；日常、沉淀和氛围场景也有价值。不要求每场戏都有对手、反转、代价或胜负。
+| 检查对象 | 可执行的问题 | 需要定位的缺口 |
+|---|---|---|
+| 行为依据 | 他根据当时所知，为什么会选这一步？害怕、习惯、误判有无文本支持？ | 只因作者需要就突然信任、反抗、原谅；人物为结果临时变性格 |
+| 因果承接 | 后件由前件的哪个条件触发？中间条件已经写过，还是根本不存在？ | “然后”连接一串事件，解释句宣称成功却没有成立过程 |
+| 他人立场 | 对方想保住什么，有什么限制？他为什么接受或改变策略？ | 所有人只负责帮忙、送线索、惊讶或认错，没有自己的理由 |
+| 办法与结果 | 解法、失误、收益是否有前文支撑？结果的分量与准备是否相称？ | 临时出现的证据或能力解决问题；一句请求就越过已建立的阻力 |
+| 变化与承接 | 经历之后，关系、认知、资源、期待、情绪或行动空间有什么变化？后文是否接住？ | 连续场景重置到原状，同一种办法反复奏效，已发生的事没有影响 |
+| 信息与时序 | 谁在何时知道什么，从何得知？读者何时获知？ | 人物提前知道答案、把回忆当现场、剧透尚未揭露的因果 |
+逐项有问题才记录，正常项可以略过，不为填满检查表回头加戏。判断“过平”要指出原文中的重复或缺失：例如连续求助被拒却从未调整办法，或已经设计的关系变化没有影响后来行为。一次没有冲突的照料不能据此判平。
+## 缺的是写法，还是成立条件
+遇到转变突兀，先检索本次提供的前文、设定与大纲。结论分三种：
+- **依据已有，正文没接上**：按既定信息边界恢复承接，避免重复解释。若已定承诺只在前文出现，可以让角色在当前交涉中使用它。
+- **资料不足，暂时不能判断**：明确哪一项未知，继续有依据的改稿；不能因为没给全书就判全书无铺垫，也不能替作者补出前情。
+- **当前设计确实缺条件**：说明原文的哪次选择或结果缺少什么支持，给最小设计方案及影响。增加“他终于被打动”这类解释不能补足对方立场。
+区分信息缺口与悬念：门外留下湿脚印，尚不知道谁来过，构成一个明确的问题；不应替作者猜出答案。读者连人物为何守着这扇门、当下要做什么都无从理解时，才回查并补已有的必要背景。
+## 诊断深度与执行权限分别确定
+| 可以在普通去味中落改 | 需要剧情设计授权的改动 |
+|---|---|
+| 修正可核实的指代、主体、时序笔误 | 多种解释均成立，需要替作者选定真实动机 |
+| 恢复已有因果、条件和信息来源的承接 | 新增承诺、证据、人物身份、能力、事件或信息来源 |
+| 展开已定交锋、权衡和反馈，调整同场详略 | 改变人物决定、胜负、关系走向、代价或事件顺序 |
+| 在既定揭露边界内呈现已知信息 | 提前揭底、搬动伏笔，或改变读者与人物获知顺序 |
+对白措辞和必要微连接可以为既定内容服务；不能借“一次性动作”新增威胁、承诺、拿到证据或改变人物策略。改换视角时只叙述该视角有依据的感知与认知，不能添加“进门时发现”“后来听说”等新经历来保留信息。
+作者已明确要求重写或允许调整剧情时，直接执行被授权部分，保留其余已定事实；不用再次请求同一授权。仍缺少关键选择依据时，提出可审阅的最小选项。修法要写到哪次行为、什么条件或什么结果上，说明会牵动哪些后文，不只说“加强冲突”。建议与推测放在报告，不悄悄成为正文事实。
+## 成组示例：结果需要可成立的过程
+以下为合成示例。
+**原文**：掌柜指认学徒改了账。学徒拿出一张抄本，众人立刻相信他，掌柜当众认错。
+**可定位的诊断**：抄本由谁保存、为何可信、众人凭什么有能力和立场核对，都未交代。仅仅有人拿出纸，不能证明其上内容成立；也不能靠增加旁人惊讶来补足。
+**普通去味**：清理空泛修饰，保留已定的澄清结果；查前文有无验账惯例、独立底稿或见证条件。当前资料没有时，把未修的缺口列入报告，提出最小方案及需要新增的条件，不把方案当作发生过的事。
+**已有前情且作者授权演出**：此前三位伙计各自封存过底稿，掌柜允许众人当面核账。
+> 学徒把自己的底稿放在柜上，请另两人拆开封存的那两页。三份末行都是同一个数，和掌柜手中的新账对不上。
+>
+> 掌柜拿着那几页纸，承认这一笔不是学徒改的。
+证据的分量来自已有的独立保存与核对条件，没有临时增加秘密证人。若前情已经写足，只需呈现核对；无需再制造一次失败来“增加波折”。
+**会改坏的方向**：突然增加录音、权势亲戚或暗中交易，让结果更热闹却改掉故事依据；或未经授权把澄清改为失败，以“增加代价”替作者决定后果。
+## 修后回读
+把本次修改前后放回事件链，核对人物知情顺序、选择依据、结果及下一场承接。报告区分已修的缺口、仍需设计的部分和因资料不足未作结论的部分。表达顺了不代表故事缺口已经消失。

package/lib/oh-story/skills/story-setup/references/agent-references/style-combat-face.md CHANGED Viewed

@@ -40,7 +40,7 @@
 - 该受伤扭转战局就写扭转
 - 金手指对剧情的效果必须展示得清清楚楚
-为了情绪的顺畅，甚至可以在一定程度上牺牲合理性、牺牲行文。
+为突出兑现，可压缩解释、弱化非关键细节；既有能力边界与因果仍须成立。
 ### 关键原则
 - 前期拉了期待，爽点释放必须匹配期待高度，否则反作用
@@ -159,7 +159,7 @@
    - 主角用什么老技能和新技能达成对比？
    - 对方用什么技能给读者"主角可能要输"的错觉？
    - 过程中是否需要震惊旁观者？
-5. **反转设计**：长篇打斗不能势均力敌，必须有反转
+5. **反转设计**：需要胜负拉扯时安排有铺垫的反转；预定碾压则把能力效果与战局变化写透
 ### 不同力量体系的打斗特征
@@ -171,7 +171,7 @@
 ### 战斗描写实操技巧
-- 修饰词每个动作应有信息量——读者脑中能浮现画面就合格
+- 每个动作及其修饰都应提供信息——读者脑中能浮现画面就合格
 - 重复使用的招式一句带过，只写效果，再用旁人震惊渲染
 - 大招首次出场可以详细描写，后续使用精简为"结果概括+旁观反应"
 - 白描写法要用在关键处迸发强烈情感，战斗全用白描反而不易写好