@oh-story/dsh 0.1.0

package/lib/oh-story/skills/story-long-write/references/quality-checklist.md

@@ -0,0 +1,184 @@
+
+# 网文质量检查清单
+
+## 目录
+
+- [一、通用检查](#一通用检查)
+- [二、长篇专项](#二长篇专项)
+
+## 一、通用检查
+
+### 章节结构
+- [ ] 开头有钩子（不是天气/风景/日常开场）
+- [ ] 中段有推进（快节奏题材要有可见事件；慢热题材状态变化即可）
+- [ ] 局势有变化（读完这章，世界跟之前不一样了）
+- [ ] 结尾落在变化上（不是总结）
+
+### 开篇检查（前 300-500 字）
+- [ ] 有钩子，能抓住注意力
+- [ ] 不从天气/风景/日常开始
+- [ ] 主角快速出场
+- [ ] 卖点或危机可见
+
+### 章节推进
+- [ ] 本章至少改变目标 / 风险 / 信息 / 关系 / 资源 / 身份 / 情绪立场七类状态之一；快节奏（番茄/爽文）应有可见事件或爽点，慢热/情感文才可只靠低压小变化达标，不强求每章高潮
+- [ ] 不是水字数（删掉这章会损失哪项状态变化？答不出才需压缩）
+- [ ] 任务卡点有用：卡住之后是否带来上述状态变化？
+- [ ] 推进强弱是否符合本书已建立的题材、兑现节奏与对标，而非套固定通用字数
+
+### 信息传递
+- [ ] 没有大段设定说明文
+- [ ] 信息跟着冲突走（通过事件传递设定）
+- [ ] 设定量可控（一章不超 3 个新概念）
+
+### 场景检查
+- [ ] 场景有目标（人物要什么）
+- [ ] 场景有阻碍（什么挡着）
+- [ ] 场景有变化（结束后跟之前不同）
+- [ ] 人物在做事情，不是在感觉事情
+- [ ] 没有可删除的段落
+
+### 章尾
+- [ ] 结尾落在变化上
+- [ ] 有危机/决定/发现/反转中的至少一个
+- [ ] 不是总结式结尾
+- [ ] 拉住读者翻下一页
+
+### 语言
+- [ ] 没有空洞的抒情段落
+- [ ] 没有连续多段同一情绪
+- [ ] 对话符合人物身份（不同人说话方式不同）
+- [ ] 情绪通过动作落地（不是直接说"他很难过"）
+- [ ] 标题行以外没有章节/写作元信息：不得出现 `第[一二三四五六七八九十百千万两0-9]+章|上一章|上章|前一章|本章|这一章|前文|后文|伏笔|细纲|读者` 这类词；需要承接前文时改成角色能感知的事件锚点或相对时间；故事内真实阅读/讨论“第X章”或真实读者身份语境除外
+
+### 连载连续性
+- [ ] 没有遗忘之前的承诺/伏笔
+- [ ] 没有突然塞入大量新设定
+- [ ] 伏笔有推进
+- [ ] 故事引擎还在运转
+
+### 水（filler）检测
+以下信号出现 = 可能水了：
+- 全章对话没有任何新信息
+- 同一个情绪写了 3 段以上
+- 场景描写超过 500 字但不推进剧情
+- 角色回忆之前发生的事但没有任何新视角
+- 连续 2 章以上没有冲突
+- 删掉无损的流程细节 / 任务卡点 = 水；压缩或删除
+
+---
+
+## 二、长篇专项
+
+### 黄金三章检查
+- [ ] 第一章前 500 字有钩子？
+- [ ] 主角第一章就出场？
+- [ ] 第一章有事件（不是纯铺垫）
+- [ ] 第二章有升级（矛盾加深）
+- [ ] 第三章有追读理由（给出继续看的动力）
+- [ ] 前三章有至少 2 个爽点？
+- [ ] 世界观没有大段说明文？
+- [ ] 每章结尾有往下看的理由？（低压/过场章弱钩子或阶段目标即可，不强求强悬念）
+
+### 节奏检查
+- [ ] 最近 5 章是否有明确进展？
+- [ ] 爽点间隔是否超过 5000 字？（按章节定位：高压/推进章查间隔；低压/关系/信息整理章不计入）
+- [ ] 有没有连续 2 章以上没有冲突？（呼吸章正常；红线是连续两章压力级≤1 或相邻章情绪趋同）
+- [ ] 一卷是否有章节定位高低层次，没有全程同一力度？低压+过场是否克制（合计不超约 15%）？
+
+### 人物检查
+- [ ] 主角行为符合人设？
+- [ ] 配角是否有存在感？
+- [ ] 反派逼格是否匹配当前阶段？
+
+### 五维评分标准
+
+每个维度 0-100 分，根据评分结果选择精修策略。
+
+### 维度 1：核心一致度
+检查：关键冲突、关键行动、人物动机是否前后一致。
+
+| 问题 | 严重度 | 修复 |
+|------|--------|------|
+| 人物动机突然改变无铺垫 | critical | 补充动机转变的触发事件 |
+| 核心冲突前后不一致 | high | 回溯修改冲突设定 |
+| 关键行动与人物性格矛盾 | high | 调整行动或补充解释 |
+| 次要矛盾遗忘 | medium | 回收或弱化 |
+
+### 维度 2：表层重写度
+检查：句式与措辞是否足够原创，避免套路化表达。
+
+| 问题 | 严重度 | 修复 |
+|------|--------|------|
+| 照搬原句导致语气不自然 | medium | 只在确有 AI 腔时改写，正常原句可保留 |
+| 大量使用 AI 标志词 | high | 替换为具体描述 |
+| 同一句式重复出现 | medium | 变换表达方式 |
+| 描写过于文学化（辞藻堆砌、书面腔、比喻成串） | medium | 改为口语化/动作化；动作化不是切成三五字短句串，改写后叙述仍以逗号长句为主 |
+
+### 维度 3：格式一致度
+检查：段落是否按戏剧单元/镜头自然断开，主语/角色名节奏是否自然，开头结尾格式是否统一。
+
+| 问题 | 严重度 | 修复 |
+|------|--------|------|
+| 机械按字数切段或主语过密 | medium | 按戏剧单元重排段落，段首点名、段中代词/省略、关键转折再点名 |
+| 章节字数偏离目标 | **high** | 写作/大纲修复时先回到细纲补足计划内情节点，再展开；去AI味已有正文时不得新增剧情 |
+| 格式混乱（对话/描写不统一）| low | 统一格式 |
+
+### 维度 4：可读性
+检查：是否有啰嗦、AI 腔、空泛总结、套路修辞。
+
+| AI 腔特征 | 如何识别 | 如何修复 |
+|-----------|----------|----------|
+| 空泛总结 | 「他终于明白了」「一切尽在不言中」 | 删掉，用行动代替 |
+| 套路修辞 | 「命运仿佛在和他开玩笑」 | 删掉或换成具体描述 |
+| 比喻堆叠 | 连续多处「像/好像/仿佛/如同」，每个画面都靠比喻解释 | 只留最有叙事功能的少数比喻，其余改成动作、物件、声音或后果 |
+| 情绪标签 | 「他感到一阵悲伤」 | 改为行为表现 |
+| 心理描写空转 | 内心独白无新信息、重复同一情绪或复述读者已知 | 只压缩空转部分；带新信息、决断或情绪转折的独白不按句数压缩 |
+
+### 维度 5：逻辑连贯
+检查：句间/段间是否通顺，有无设定冲突。
+
+| 问题 | 严重度 | 修复 |
+|------|--------|------|
+| 设定前后矛盾 | critical | 查找并统一设定 |
+| 时间线错误 | high | 标记时间线并修正 |
+| 角色信息不一致 | high | 建立角色档案对照 |
+| 因果链断裂 | medium | 补充过渡 |
+
+### 精修策略
+
+根据五维评分结果，选择精修策略：
+
+| 主要问题 | 策略 | 说明 |
+|----------|------|------|
+| 核心一致度低 | rewrite | 围绕核心冲突重写相关段落 |
+| 字数超标 | compress | 删减不推动剧情的内容 |
+| 无意义卡点 | compress | 保留卡出的变化，压掉流程 |
+| AI 腔重 | de_ai | 替换禁用词、改写句式 |
+| 小问题多 | polish | 打磨语言细节 |
+
+### 读者契约与终局储备双向审查
+
+参 `reader-contract-and-progression.md`。先问“无毒吗”，再问“好看吗”：**无毒不等于好看**，没有 契约破坏 只代表不踩雷，还要确认情绪兑现足够强。
+
+- [ ] 读者契约：本章/本卷是否兑现开篇承诺，还是把核心卖点交给机构、配角或偶然性？风险标记：契约安全 / 需补强 / 契约破坏。
+- [ ] 主角代理权：按因果权 + 结算权审查，而非按出场时长；用“关键节点四问”核对决定、不可替代选择、后果与核心结算。配角可执行局部动作，但不能无声夺走期待所有权。
+- [ ] 期待债：承诺是否被偿还、延期并支付利息，还是被解释/流程/设定吞掉？
+- [ ] 终局储备：本单元是否动用了本阶段还不该解锁的终局底牌（宿敌/真相/身份/金手指上限）？是否让某条升级线逼近天花板、后面没台阶接？两问皆否即放行——单章一战多得（多线齐涨）是好设计，不算超速。
+- [ ] 兑现归属：期待所有权是否按承诺结算；自愿让渡只有在“长期净收益为负 + 控制/因果权下降”同时出现时亮红灯，战略性让步的更大控制/未来收益/权力/信息交换是否可见？
+- [ ] 节奏续接：高潮/兑现后是否允许短暂低压和小而可见的收益/奖励，而非机械立即加危机？新元素是否支付换书债、没有逃避旧承诺？
+- [ ] 题材特定风险：履约爽文/能力幻想中，主角是否反复以愚蠢或可避免的无能制造灾难并由他人收拾，损害因果权与结算信任？
+- [ ] 反向审查：若删除“安全解释”，情绪是否更强？若保留风险情节，是否带来更强期待、代价或爽点？
+
+- [ ] 综合线：契约、主角代理权、期待债、终局储备是否互相支撑，而不是只做到“无毒”。
+
+
+### 单元情绪因果可证伪检查
+
+- [ ] 目标是否只有“热血/悲伤”等情绪标签，却没有前状态→触发→后状态的情绪因果？
+- [ ] 承载对象是否只是等待主角解决问题的工具角色？
+- [ ] 高潮是否依赖巧合或最后一刻新增设定？
+- [ ] 主角的硬能力是否服务核心情绪，而非只服务自我证明？
+- [ ] 个体/关系/群体兑现是否回到本书的题材契约？群体兑现只在题材需要时使用。
+- [ ] 是否错把“更安全”或“获得成长”本身当成高潮，却没有情绪意义变化？
+- [ ] 机制是否保持可选：不把物件、误解、反转、死亡、疾病、哭喊或群体抬升当成通用硬模板？

package/lib/oh-story/skills/story-long-write/references/reader-contract-and-progression.md

@@ -0,0 +1,109 @@
+# 读者契约与终局储备
+
+本文件是 `story-long-write` 关于读者契约、主角代理权（叙事能动性/主导性）、利益安全与阶段推进的权威参考文件。相关洞察由授权社区样本提炼而来；样本多数是问题帖/避坑帖，属于非统计共识，也不能替代具体题材、平台和对标书判断。
+
+**安全边界**：本文件不得包含来源站点隐私数据、访问凭证、cookies、tokens、请求签名、私有标识符，或任何能反推出私域账号/请求环境的信息。
+
+## 1. 核心概念
+
+### 读者契约
+- 读者契约 = 开篇、题材、主角配置、叙事口吻共同许诺的阅读快感。
+- 写作前先确认：读者是来看主角解决问题、见证团队群像、看导师托举后辈，还是看制度合作建设？不同契约下同一情节风险不同。
+- 题材边界先于单条禁忌：政府、宗门总部、跨国组织、多国公司等高层级机构一出现，可能开启制度/势力范围情节线；先检查本书是否从开篇承诺了这种玩法。
+
+### 主角代理权：因果权 + 结算权
+- 主角代理权首先看**因果权 + 结算权**，不看出场时长，也不要求主角永远亲自动手或垄断每个镜头。
+- 主角不可替代首先体现为因果权：主角通过决策、布局、授权、不可替代的信息/资源，或主动选择关键后果，决定事情为什么发生、如何进入与怎样转向。
+- 结算权 = 核心收益、认可、权力或关键后果依照既有承诺回到应得者。可以借力、组队、被救、接受指导或让他人执行局部动作，只要因果与结算没有被无声夺走。
+- 职业/权力幻想题材尤其敏感：读者通常期待主角掌握资源、做出决策、承担或选择后果并拿回可见收益。
+- 题材例外（直给爽文）：番茄战神/赘婿/打脸/都市异能等，主角亲自出手、当面碾压本身就是契约兑现，代理权不能拿来给主角划水、让下属封神；只有布局/权谋/经营/群像/导师题材才默认可幕后运筹、隔人兑现。
+
+### 期待所有权
+- 承诺的兑现/高光属于本卷或本单元已经许诺的主角或其他承诺所有者；配角可以执行局部动作，但不能无声夺走期待所有权。
+- 群像、导师或制度合作可把期待所有权明确给团队成员/学生/机构角色；关键是预先承诺、按约结算，而非事后解释抢戏合理。
+
+### 关键节点四问
+大纲、正文与审查遇到关键节点时统一问；答案可以指向主角，也可以指向本卷已承诺的其他所有者，不要求主角亲自完成每个动作：
+1. 谁决定事情为什么发生/如何进入？
+2. 谁作出不可替代的关键选择？
+3. 谁承担或选择关键后果？
+4. 核心收益/认可/权力最终结算给谁？
+
+### 利益安全与兑现归属
+- 利益安全 = 读者相信自己追的核心卖点不会被没收、稀释、转赠或交给无关角色消化。
+- 兑现归属 = 谁铺垫、谁承压、谁选择，谁就应拿到主要情绪回报；旁观者/配角反应可以放大爽点，不能替代主角爽点。
+- 核心资产（金手指、关键资源、身份底牌、独家技术、关键证据）不得无交换地交出、暴露给外部机构或被上级接管。若必须交出，需要可见交换：权力、保护、资源、渠道、名分、债权、信息、阶段胜利或更大局面的主动权。
+
+### 期待债
+- 每次埋承诺（主角会反击、资源会升级、身份会揭开、感情会推进）都产生期待债。
+- 期待债可以延期，但要付利息：阶段性进展、新信息、局势变化、情绪释放或更清晰的下一目标。
+- 用解释、设定或机构流程拖延兑现，会增加合理化债务。
+
+### 终局储备与推进节奏
+
+“写无可写”的病根是两类**宏观资源**被提前打光，跟单章涨多少关系不大。管住这两类、放开单章密度，才既不透支又不憋屈。
+
+**两类会打光的宏观资源（开书时定，逐卷解锁）**
+- **终局底牌**：头号宿敌、终极真相/身世、金手指上限、身份/地位终点、核心情感的最终确定。一次性资源，用了就没。开书时列进 `设定/题材定位.md` 的「终局底牌与升级台阶」小节，每项标最早可解锁的卷/阶段（从终局倒推成卷级里程碑，一卷只解锁一个大里程碑）。
+- **升级台阶**：境界/等级/地图/势力层级的剩余档数。开书时做一次台阶检查——体系档数 × 每档停留篇幅 ≥ 全书目标字数；台阶不够是设计病，设计期补（拉长体系/加地图层），不靠每章憋。敌人/目标/地图成**梯队**，逐级解锁，禁止越级提前秒顶级 boss / 解决终极目标。
+
+**单章 / 单个剧情单元放开密度（爽感来源，不要压）**
+- 每个剧情单元设 1 条**主推线**（战力线/资源线/身份线/关系线/信息线/地图线/制度线/势力线/事业线/情感确定性等升级线其一，承担本轮最大高潮），其余线按剧情自然给**战果**（轻触到大涨皆可）。**一战多得——一场大胜同时破境、缴获、收势力、涨声望、抱得美人——是允许且常见的好设计，该给就给。**
+- 章级推进按平台/题材分档：快节奏（番茄/爽文）保留“每章要有可见事件或爽点推进”的下限；慢热/种田/情感文才放宽到“改变目标 / 风险 / 信息 / 关系 / 资源 / 身份 / 情绪立场七类状态之一即可”。低压/过渡章用小而可见的变化承接，不强求每章高潮。
+- 高潮/兑现后可安排一段短暂低压，让读者先拿小而可见的收益/奖励，再进下一轮压力；不强制兑现后立即加危机。
+- 可选工具：行动成本/成功代价。重要成功可带时间、关系、暴露、资源消耗或新敌意等成本；低压/过渡/纯奖励章不强制附加代价。
+
+**推进过快判定（透支两问）**
+1. 是否动用了本阶段还不该解锁的终局底牌（宿敌了结、终极真相、身份终点、金手指触顶）？
+2. 是否让某条升级线逼近天花板、后面没台阶接？
+
+任一为“是” = 真正的透支预警 → 回退或改纲；两者皆否，多线齐涨放行。这套判定是经验法则，档位与里程碑按本书题材、平台与对标调整，不是硬门槛。
+
+### 合理化债务
+- 解释成本用于说明机构响应/接管、保密、资源调动、跨区执法、组织协作等为什么成立。
+- 检查：这些解释是否服务核心情绪？若解释本身吞掉爽点、代入或主角高光，就先缩短解释、改为可见交换，或把机构反应降级为旁观/阻碍/资源接口。
+
+## 2. 制度/机构与旁观者设计
+
+- 提到政府、宗门总部、跨国组织、多国公司等不天然有毒；它们只是高层级叙事开关。
+- 国家合作 / 政府合作类故事可以算契约安全，前提是开篇已承诺制度合作，主角保持不可替代，并获得可见权力、保护、资源、收益或更高行动权限。
+- 若本书承诺的是个人逆袭、职业掌控、独享金手指，外部机构接管核心问题通常需要强交换与主角主动选择。
+- 旁观者/反应层适合做：震惊、误判、舆论扩散、资源报价、敌我站队、见证主角选择。避免让旁观者替主角复仇、替主角做最终裁决、替主角拿核心收益。
+
+## 3. 风险等级
+
+| 等级 | 定义 | 处理 |
+|---|---|---|
+| 契约安全 | 与开篇题材契约一致；主角仍拥有关键选择/不可替代贡献；收益归属清楚 | 可写，注意把交换和收益可视化 |
+| 需补强 | 可能稀释主角高光或推进过快，但能通过铺垫、交换、成本、题材声明修复 | 写前补理由、补代价或调整为阶段性而非终局兑现 |
+| 契约破坏 | 没收核心卖点；自愿让渡同时造成**长期净收益为负 + 主角控制/因果权下降**（尤其没有可见战略交换）；无关角色夺走期待所有权；核心资产无交换上交或被接管 | 修纲；战略性让步可用局部聚光灯/资源换取更大控制、未来收益、关系/制度权力、信息优势，或兑现已承诺的群像/导师高光，不按让渡本身判红灯 |
+
+## 4. 好/坏例与例外
+
+### 职业/权力幻想主角自愿让出聚光灯
+- 红灯组合：让渡同时导致长期净收益为负、主角控制/因果权下降，且看不到战略交换；不是任何自愿让渡都算 契约破坏。
+- 好：主角授权下属执行，但方案、关键资源、最终谈判和风险承担由主角掌控；或用局部聚光灯/资源换取更大控制、未来收益、关系/制度权力、信息优势。下属表现反过来证明主角识人/组织能力。
+- 例外：若本书从开篇承诺“导师/经营组织/群像成长”，主角的高光可以是培养体系、选人眼光和关键兜底。
+
+### 给出资源或核心资产
+- 坏：主角把独家技术、金手指产物、关键证据无条件交给机构，换来口头感谢，后续由机构推进主线。
+- 好：主角交换到牌照、保护、渠道、话语权、独占收益或更大舞台，并保留不可替代的控制点。
+
+### 无关角色替主角复仇
+- 坏：压迫主角多章的敌人，被路过强者或随机事故解决，主角没选择、没出手、没获得认知/资源/地位变化。
+- 好：配角可以助攻或见证，但关键证据、布局、决断、公开裁决或最后反击由主角完成。
+- 例外：悲剧、悬疑、群像战争可让他人完成局部动作，但要让主角获得新的核心任务、代价或认知推进。
+
+### 提前打光终局储备（多线齐涨本身没问题）
+- 坏：一个剧情单元把全书级底牌一次性烧光——解决头号宿敌、揭终极身世、坐实终局身份、金手指直接触顶，后面没大目标可写。
+- 好：本单元让主角一战多得（破境+缴获+声望齐涨），但都在体系台阶之内、不碰终局底牌；宿敌只退一个梯队、真相只揭一层，大底牌留到后续卷偿还期待债。
+
+### 合法群像 / 导师故事例外
+- 群像契约：每个 POV 有自己的目标和偿还，主角不是唯一爽点来源；卷契约应写清谁在本卷拥有高光。
+- 导师契约：导师主角的高光在设计训练、识破困局、关键兜底、承担更高层代价，而不是每次亲手收割。
+- 制度合作契约：开篇即承诺国家/机构协作，主角以专家、指挥者、关键资源拥有者或不可替代执行者身份获得明确权力和收益。
+
+## 5. 续接与换书债
+
+- **换书债**：引入新地图、新机构、新能力、新敌人或新谜团，既要支付必要的铺垫成本，也会新增期待债；不能靠新鲜元素逃避旧承诺。
+- **题材特定高风险**：在履约爽文/能力幻想中，主角反复因愚蠢或可避免的无能制造灾难，再由别人收拾，会持续损害因果权、控制感和结算信任；这是依题材契约判断的高风险，不是所有故事的绝对禁令。

package/lib/oh-story/skills/story-long-write/references/reversal-toolkit.md

@@ -0,0 +1,349 @@
+# 反转设计工具箱
+> 操作手册：反转类型、嵌套反转、误导技巧、打脸节奏。按决策路由选用，按设置/揭示步骤执行，用自检清单验收。
+> 反转类型枚举与拆文 `_meta.json.reversal_type` 字段一致：视角/身份/动机/时间线/信息/认知/无反转。
+
+## 决策路由
+
+| 你要设计什么 | 用哪种反转 | 关键操作 |
+|-------------|-----------|---------|
+| 角色不是你以为的人 | 身份反转 | 埋3处行为细节暗示 |
+| 真相从另一个角度完全不同 | 视角反转 | 引入另一角色视角打破认知 |
+| 角色做某事的原因不是你以为的 | 动机反转 | 高压场景中二选一暴露真动机 |
+| 时间顺序跟读者理解不同 | 时间线反转 | 不撒谎只调叙述顺序 |
+| 读者掌握了错误信息 | 信息反转 | 新证据直接否定旧"事实" |
+| 读者对整个角色/关系的理解被颠覆 | 认知反转 | 全程铺感情色彩，结尾翻转色彩 |
+| 甜宠/喜剧/报应型，本就没有反转 | 无反转 | 走报应兑现或甜度递进，不硬塞反转 |
+| 要叠多层反转 | 嵌套反转 | 主次分明，间隔递减 |
+
+---
+
+## 反转类型
+
+### 1. 身份反转
+
+**触发条件**：角色真实身份与读者认知不同。
+
+**设置步骤**：
+1. 确定表面身份和隐藏身份
+2. 通过行为细节泄露（禁止用叙述者直接说明）
+3. 回看至少埋3处暗示
+
+**揭示步骤**：
+1. 用场景同时揭示身份和动机
+2. 禁止让角色自说"其实我是XX"
+3. 选在读者最不期待揭示的时机
+
+| 表面身份 | 隐藏身份 | 铺垫线索 |
+|----------|----------|----------|
+| 乖巧继女 | 幕后操控者 | 总在关键时刻「恰好」不在场 |
+| 热心邻居 | 伤害主角的人 | 对主角家里的布局太熟悉了 |
+| 死去的恋人 | 还活着 | 「遗物」里有一件不该存在的东西 |
+| 陌生人 | 主角失忆前的至亲 | 叫出了主角只有至亲才知道的小名 |
+
+示例铺排：
+```
+铺垫1（5%）：邻居帮修水管，对水管走向异常熟悉
+铺垫2（25%）：邻居「随口」提到主角家灯每天几点关
+铺垫3（50%）：梦到有人站床前，醒来闻到烟味——邻居抽烟
+揭示（75%）：监控里，每晚站床前的人穿邻居那件灰色外套
+```
+
+### 2. 视角反转
+
+**触发条件**：叙事者视角是片面的，真相从另一个角度完全不同。
+
+**设置步骤**：
+1. 确保所有叙述都是事实，但不是全部事实
+2. 叙述者解读引导读者走错方向
+3. 关键信息被「合理地」跳过或淡化
+4. 叙述者自己也真诚地相信这套叙事——他不是在骗读者，他自己也被骗了
+
+**揭示步骤**：
+1. 引入另一角色视角/证词
+2. 展示主角「没看到」的场景
+3. 用证据打破认知
+
+| 主角视角 | 真实视角 | 关键差异 |
+|----------|----------|----------|
+| 丈夫出轨对不起我 | 我才是被蒙在鼓里的第三者 | 时间线上的空白 |
+| 同事在排挤我 | 我的「好心」一直在伤害别人 | 别人视角下我的行为 |
+| 我在拯救这段关系 | 我在控制对方 | 对方的反应其实是在自保 |
+| 我是受害者 | 我是施害者 | 记忆被叙述者篡改了 |
+
+**铁律**：叙述者必须真诚地相信自己的视角，禁止叙述者明知真相而故意误导读者。
+
+### 3. 动机反转
+
+**触发条件**：角色做某事的真正原因与读者以为的不同。
+
+**设置步骤**：
+1. 给角色一个「表面动机」让读者觉得合理
+2. 真正动机藏在表面之下
+3. 埋下行为细节与表面动机的微小矛盾（矛盾不要太大）
+
+**揭示步骤**：
+1. 制造高压场景迫使角色二选一
+2. 表面动机指向选A，但角色选了B
+3. 选择行为直接暴露真正动机
+
+| 表面动机 | 真正动机 | 行为矛盾线索 |
+|----------|----------|-------------|
+| 想和前夫复婚 | 想拿回藏在婚房里的东西 | 从不关心他的生活，只关心那套房子 |
+| 保护妹妹 | 嫉妒妹妹，想控制她 | 每次「保护」都让妹妹更孤立 |
+| 追求公平正义 | 报个人私仇 | 目标人物恰好和当年的事有关 |
+| 害怕失去朋友 | 害怕朋友发现自己背叛了她 | 每次朋友接近真相就制造新危机 |
+
+### 4. 时间线反转
+
+**触发条件**：故事的实际时间顺序与读者理解的顺序不同。
+
+**设置步骤**：
+1. 确定真实时间顺序和读者理解的顺序
+2. 用叙述技巧让读者以为A在B之前，实际B在A之前
+3. 不撒谎，只调整叙述顺序
+4. 用时态、季节、物品新旧作为天然时间线索
+
+**揭示步骤**：
+1. 找一个不可能存在的时间矛盾
+2. 或让角色提到「还没发生」的事
+3. 或展示物品状态与时间线不符
+
+| 读者以为的时间线 | 真实时间线 | 揭示方式 |
+|------------------|-----------|----------|
+| 丈夫丧妻后变质 | 妻子「死后」还活着 | 时间戳对不上的消息 |
+| 姐姐在弟弟出事后崩溃 | 弟弟出事因姐姐先做了某事 | 医院记录上的时间 |
+| 两人正在恋爱 | 这是一段回忆，已分开 | 「我当时不知道那是最后一次」 |
+| 重生后第二天 | 重生前的最后一天循环 | 镜子里倒影和之前不一样 |
+
+**铁律**：写完必须画时间线图自查。
+
+### 5. 信息反转
+
+**触发条件**：读者（和主角）掌握了错误的关键信息。
+
+**设置步骤**：
+1. 给读者一个来自可靠来源的「事实」
+2. 所有人物基于此「事实」行动
+3. 在后果中埋下矛盾证据
+
+**揭示步骤**：
+1. 新证据直接否定旧「事实」
+2. 读者和主角同时发现被骗
+3. 前面所有剧情获得新解读
+
+| 错误信息 | 真实信息 | 揭示的连锁反应 |
+|----------|----------|---------------|
+| 遗嘱遗产给长子 | 遗嘱被调包，本给次子 | 长子所有「孝心」都是演戏 |
+| 医生说孩子亲生 | DNA报告被篡改 | 配偶从受害者变加害者 |
+| 朋友说看到他出轨 | 朋友在撒谎 | 朋友的「安慰」其实是操控 |
+| 老板说提拔我 | 岗位已取消 | 老板画饼为让我多干活 |
+
+**核心区别**：信息反转是认知层面的——你以为世界是A，其实是B。核心是「一条假信息」。
+
+### 6. 认知反转
+
+**触发条件**：读者对某个角色/关系的整体理解被颠覆；重点在整段感情色彩翻转，而非单条信息纠错。
+
+**与信息反转的区别**：信息反转翻一条事实（遗嘱归属、亲子关系真伪）；认知反转翻读者对整个角色/关系的感情判断（恨了全程的妈其实一直在护着她）。信息反转改事实答案，认知反转改"我对他的感觉"。
+
+**设置步骤**：
+1. 全程让读者积累一种感情色彩（这个妈狠心/这个丈夫凉薄/这个对手纯坏）
+2. 每个负面场景都埋一个被忽略的反向细节（狠话之后多塞了钱、转身擦了眼泪）
+3. 细节要小到读者当时不在意，回看才发现处处都是
+
+**揭示步骤**：
+1. 用一个场景或一件遗物，让所有负面行为同时获得反向解读
+2. 不解释，让读者自己把全程重新过一遍
+3. 揭示后情绪从"恨/怨"翻成"亏欠/意难平"
+
+| 全程认知 | 翻转后认知 | 反向细节铺垫 |
+|----------|-----------|-------------|
+| 后妈刻薄赶我走 | 她赶我走是怕她仇家牵连我 | 每次骂完都往我包里塞钱 |
+| 丈夫冷漠不管家 | 他在外面替我扛了所有债 | 深夜接的"应酬"电话都是催债 |
+| 师父偏心打压我 | 他压我是知道我会被盯上 | 每次罚我都安排在别人看得见的地方 |
+
+**追妻/世情主力反转**：这是追妻火葬场、世情最常用的反转——男主/婆婆/亲人全程被恨，结尾翻成"原来一直在爱/在护"，意难平拉满。
+
+### 7. 无反转
+
+**触发条件**：甜宠、喜剧、反差萌、报应型复仇/重生——这类故事本就没有传统反转，硬塞反转反而毁节奏。
+
+**爽感来源（替代反转）**：
+- **报应兑现型**（复仇/重生爽文）：爽点不在"真相翻转"，在反派一步步走向毁灭、每条恶行精确对应一条报应（以彼之道还施彼身）。用报应设计表：恶行→报应→爽感来源。
+- **甜度递进型**（甜宠/青春）：爽点在关系一步步升温，反差萌反复"装失败"。全程正向情绪阶梯上升，不经历反转的负向回落。
+
+**写法要点**：
+1. 不为"显得有设计感"硬加反转
+2. 报应型：每个报应要让读者等过、铺过，兑现时才解气
+3. 甜宠型：升温节拍密集，每节给一个甜点/反差点
+
+> 拆文时遇到此类，`reversal_type` 填「无反转」，`setup_clues`（反转铺垫）一项跳过阈值（见 analyze output-contract 的「structure_counts 数值校验」）。
+
+---
+
+## 嵌套反转
+
+一篇短篇可叠 2-3 层反转，必须主次分明。
+
+### 双层嵌套
+
+```
+读者以为：A（铺垫阶段）
+第一层反转：其实是 B！（70%处）
+第二层反转：B 也是假的，其实是 C！（90%处）
+```
+
+**执行要求**：
+- 第一层反转必须足够有说服力，让读者接受B就是真相
+- 第一层后给1-2段「消化时间」
+- 第二层要能同时解释A和B，比第一层更震撼
+
+示例：
+```
+铺垫：丈夫出轨了，妻子收集证据准备离婚
+第一层（70%）：丈夫没出轨，那女人是他线人——他在调查妻子的公司
+第二层（90%）：妻子公司确实有问题；举报人换成妻子自己，丈夫只是被引导发现
+——她故意让丈夫发现，只有丈夫「不经意」揭发她才能拿到保险赔偿
+```
+
+### 三层嵌套（慎用）
+
+**使用条件**：只有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%
+
+---
+
+## 误导技巧
+
+误导要引导读者自己走向错误结论，不能欺骗读者。
+
+### 两大底层路径
+
+- **加法路径（分层法）**：在真实信息上叠加假信息。线索既可用逻辑线A解释为A'，也可用B解释为B'。A'是误导方向（常见故事），B'是真相（不常见故事）。误导读者以为是A'时，必须同时暗埋与B'相关的线索。
+- **减法路径（信息残缺法）**：不添加假信息，隐藏关键信息的一部分。只让主角得知成功的部分。导致下行的最好不是主角主动行动获得的，可以让配角获得那半信息后交给主角时发生意外。
+
+### 五种技巧速查
+
+| 技巧 | 操作方法 | 示例 |
+|------|---------|------|
+| 选择性叙述 | 主角只关注某些信息，读者跟着走 | 主角在意丈夫和女同事暧昧，忽略「客户」的奇怪电话 |
+| 情绪引导 | 用情绪场景引导判断 | 暖的父女戏→其实是愧疚，他做了对不起女儿的事 |
+| 假线索（红鲱鱼） | 给可疑角色/事件吸引注意力 | 诡异邻居和主线无关，真正威胁是一直正常的人 |
+| 刻板印象利用 | 利用社会认知偏见 | 强势婆婆其实是保护儿媳，她知道一些儿媳不知道的事 |
+| 信息分层 | 真相同假信息混在一起 | 丈夫确实秘密联系人（真）→前女友（假）→亲妹妹（真） |
+
+**红鲱鱼铁律**：红鲱鱼必须在故事里有自己的功能（推进情节/增加趣味），只是不是反转的答案。
+
+---
+
+## 反转自检清单
+
+### 合理性
+- [ ] 回看铺垫至少有3处暗示指向反转
+- [ ] 反转不依赖巧合——角色选择推动了反转
+- [ ] 没有引入前面完全没提过的新信息
+
+### 冲击力
+- [ ] 反转后情绪强度高于反转前
+- [ ] 反转改变了读者对前面所有剧情的理解
+- [ ] 反转让读者想翻回开头重看
+
+### 公平性
+- [ ] 读者有可能在反转前猜到（不是必须，但有可能）
+- [ ] 没有对读者撒谎——只是没说出全部真相
+- [ ] 揭示方式自然，不靠角色大段独白解释
+
+### 节奏
+- [ ] 反转揭示不超过300字（快速、干脆）
+- [ ] 揭示后有足够篇幅展示反转影响
+- [ ] 反转后结尾在反转产生的情绪上收束
+
+---
+
+## 常见反转错误
+
+| 错误 | 问题 | 修正 |
+|------|------|------|
+| 天降反转 | 前面完全没铺垫 | 至少埋3条线索 |
+| 解释过多 | 大段文字解释反转 | 用行动/场景让读者自己明白 |
+| 反转太弱 | 读者早就猜到了 | 加误导或换反转类型 |
+| 反转太多 | 3个以上反转堆在一起 | 砍到1-2个做到极致 |
+| 反转无感 | 只改变信息没改变情绪 | 反转必须同时改变读者情感判断 |
+| 反转作弊 | 引入前面不存在的信息 | 所有反转要素必须在前文中出现过 |
+
+---
+
+## 特殊反转技法
+
+### 虚晃一枪反转法
+
+先给出"应该不会发生"的预期让读者放松，然后意外以反转形式发生。类似鬼片推开门什么都没有->松口气->回头撞鬼。
+
+### 超额收获反转
+
+反转后收获超出预期，产生二次惊喜：
+- 短篇：主角以为只解决一个问题，结果连带解决了隐藏的更大问题
+- 网游文模式：Boss爆三样——立刻能用的 / 送人拉关系的 / 暂时用不到但一看很厉害的
+
+### 情绪拉扯反转标准流程
+
+1. 展示物品/能力强大，读者期待+1
+2. 配角因信息差认为鸡肋，读者期待打脸+1
+3. 展示反派特性恰好克制，读者期待+1
+4. 配角拿更强装备打反派失败，期待+1
+5. 众人看衰主角，期待继续+1
+6. 主角秒杀，期待满足
+7. 众人震惊，配角马后炮分析，期待满足
+8. 新一轮收获，满足+新期待产生
+
+---
+
+## 打脸的深层节奏
+
+### 三种打脸方式
+
+| 方式 | 特点 | 适用场景 |
+|------|------|----------|
+| 主动挑衅->打脸 | 简单粗暴 | 小白文最常见 |
+| 对手挑衅->被打脸 | 压主角同时给读者安全感和反击暗示 | 需要积蓄仇恨时 |
+| 借他人之手打脸 | 支持者代为回击，无损主角形象 | 保持主角高逼格时 |
+
+### 打脸节奏铁律
+
+- 压抑不能太长——连输8场写3万字不行，改成连输4场+略写
+- 压的同时必须给读者信心暗示（主角自信到自大："我们还是联赛前四！"）
+- 比起主角被欺负，读者更厌恶主角自暴自弃
+- 高潮部分要拉长，最大化利用（球迷反应、解说员、赛后跟进）
+- 大高潮不要险胜——充分铺垫后要尽情碾压，干净利落的大胜
+
+### 高潮间过渡
+
+升级练功也有爽点，但大爽点落在升级后打脸，读者期待升级后的兑现。