@oh-story/dsh 0.1.0

package/lib/oh-story/skills/story-short-write/references/villain-and-reveal.md

@@ -0,0 +1,158 @@
+# 反派系统 + 真相揭露机制
+
+> 反派设计模板、真相揭露方式、报应设计。Phase 2 设计反派时加载。
+
+---
+
+**本文件职责**（其他内容去哪看）：
+- 各题材的反派套路（世情打脸反派、重生复仇反派等）已在 genre-writing-formulas.md，本文件只提供通用设计模板
+- 本文件的反派人设模板 `{身份}+{动机}+{作恶方式}+{致命弱点}` 侧重「设计蓝图」，genre-writing-formulas.md 的 `{人设}+{动机}+{行为}+{态度}+{受伤害程度}` 侧重「矛盾冲突公式」——前者用于 Phase 2 设计，后者用于 Phase 3 写作
+
+---
+
+## 1. 反派设计模板
+
+### 人设模板
+
+填写以下模板，写入设定.md：
+
+```
+反派：
+- 身份：{与主角的关系}
+- 动机：{自洽的作恶逻辑：贪婪/嫉妒/控制欲/报复/自保}
+- 作恶方式：{具体手段：言语打压/经济控制/社交孤立/人身伤害/法律构陷}
+- 致命弱点：{可被主角利用的弱点：贪婪/傲慢/秘密/依赖/恐惧}
+- 报应：{与恶行对应的结局}
+```
+
+### 嚣张度递增阶梯
+
+反派行为必须逐级递增，不跳跃也不重复：
+
+| 级别 | 行为类型 | 示例 |
+|------|----------|------|
+| 小恶（前 1/3） | 言语打压、冷暴力 | 「你嫁进来就算烧高香了」 |
+| 中恶（中段） | 经济/社交伤害 | 偷拿存折、在外败坏名声、挑拨关系 |
+| 大恶（后段） | 人身/法律伤害 | 下药、构陷、逼死、拐卖 |
+
+### 5 种反派类型速查
+
+| 类型 | 特征 | 代表作 | 致命弱点 |
+|------|------|--------|----------|
+| 操控型 | 以爱为名控制一切 | 王氏（皇弟） | 控制欲导致行事留下证据 |
+| 贪婪型 | 无底线索取 | 准儿媳 | 贪心过度暴露真面目 |
+| 伪装型 | 隐藏真实身份/目的 | 诈骗犯（重生弟弟） | 身份经不起调查 |
+| 嚣张型 | 仗势欺人，有恃无恐 | 萧琅（皇弟） | 傲慢导致不看身后 |
+| 软刀型 | 示弱博同情，暗中操控 | 妈妈（姐夫捎路） | 假面被证据击碎 |
+
+---
+
+## 2. 真相揭露机制
+
+### 4 种揭露方式
+
+#### 证物揭露
+
+物理证据一锤定音。
+
+操作：在铺垫段埋入「看似无关紧要的物件/文件」，揭露时翻转其意义。
+
+```
+铺垫：妈妈脖子上总戴着一把金锁，说是姐姐送的
+揭露：打开金锁，里面刻着「金包铜」三个字
+暴击：她从来没打开过这把锁
+```
+
+#### 证人揭露
+
+第三方视角打破谎言。
+
+操作：安排一个边缘角色（仆人/邻居/同事），在关键时刻说出主角不知道的信息。
+
+```
+铺垫：周嬷嬷总是欲言又止
+揭露：周嬷嬷临终前交给主角一封信——先皇后的供状
+暴击：王氏知道这封信的存在，所以一直在找周嬷嬷
+```
+
+#### 偷听/撞见
+
+主角获取隐藏信息。
+
+操作：设计一个「主角不该在场的场景」，让主角无意中看到/听到真相。
+
+```
+铺垫：妈妈每次接电话都走到阳台上
+揭露：主角路过阳台，听到妈妈说「那个金锁是假的，她到现在都不知道」
+暴击：电话那头是姐夫
+```
+
+#### 延迟剥洋葱
+
+一层真相引出更深真相。
+
+操作：每层用一个节揭露，每层都比上一层更残酷。
+
+```
+第1层：弟弟的女友不是她说的那个人
+第2层：女友是诈骗犯，有犯罪记录
+第3层：怀孕是假的
+第4层：弟弟已经被骗到电诈园区
+```
+
+### 按题材选择揭露节奏
+
+| 题材 | 推荐方式 | 节奏 |
+|------|----------|------|
+| 世情/爽文 | 证物揭露 或 证人揭露 | 一次大揭露，干净利落 |
+| 情感/虐心 | 偷听/撞见 + 延迟剥洋葱 | 分层揭露，层层更痛 |
+| 古言/复仇 | 证人揭露 + 证物揭露 | 先证人铺垫再证物一锤 |
+| 悬疑/推理 | 延迟剥洋葱 | 全程分层，最后一块拼图 |
+| 年代/亲情 | 偷听/撞见 | 意外发现，情绪冲击最大 |
+
+---
+
+## 3. 反派报应设计
+
+### 规则
+
+报应必须与恶行形成对应。恶行有多重，报应就有多重。
+
+### 对应原则
+
+| 恶行 | 报应 | 对应逻辑 |
+|------|------|----------|
+| 逼死在冷宫 | 自己住进冷宫 | 因果轮回 |
+| 偷拿存折 | 账户被冻结，一分拿不到 | 偷失去的，连自己的也失去 |
+| 以爱为名操控 | 被所有人抛弃 | 假爱真控，最终无人可控 |
+| 诈骗钱财 | 被更狠的人骗进园区 | 骗子被更高级骗子收割 |
+
+### 4 种报应模式
+
+| 模式 | 适用场景 | 操作 |
+|------|----------|------|
+| 法律制裁 | 现代背景，恶行触犯法律 | 报警/起诉/判决，用简短几句交代 |
+| 社会性死亡 | 虚伪型/操控型反派 | 真相公开，所有人看清真面目 |
+| 因果轮回 | 古言/复仇题材 | 做过的事回到自己身上 |
+| 精神崩溃 | 虐心/意难平题材 | 反派得到一切却发现失去了唯一重要的东西 |
+
+### 报应强度校准
+
+- 报应强度 = 恶行强度 × 1.0-1.2（不过度也不轻描淡写）
+- 不写长段报应描写，2-3 句带过，留白给读者
+- 报应的「爽」来自对应感，不是来自描写长度
+
+---
+
+## 4. 反转有效性自检（Phase 2 使用）
+
+写完 outline 后，用这个自检确认反转真的能反转读者：
+
+| 检查项 | 通过标准 | 不通过 = 需要 |
+|--------|---------|-------------|
+| 读者知道真相的时机 | >60% 合理；50-60% 灰区需审视反转力度；<50% 不算反转（三档口径详见 writing-workflow.md「反转信息差验证」） | 调整线索释放节奏，延后真相揭露 |
+| 是否有误导假线索 | ≥ 1 条读者会信的假线索 | 加入红鲱鱼或选择性叙述误导 |
+| 真相线索隐蔽度 | 回看能找到但正读时会忽略 | 线索藏在日常细节中，不用强调语气 |
+| 角色知道 vs 读者知道 | 反转前读者和角色至少有一方不知道真相 | 制造信息差：读者不知道 / 角色不知道 / 双方都不知道 |
+
+**失败模式**：「延迟揭露」不算反转。读者在第 2 节就知道真相，后面 10 节只等角色追上来 = 延迟揭露，读者会无聊。真正的反转发生在揭示那一刻，让读者和角色一起震惊。

package/lib/oh-story/skills/story-short-write/references/writing-workflow.md

@@ -0,0 +1,153 @@
+# writing-workflow.md：短篇写作工作流详解
+
+本文件包含 story-short-write 的详细工作流程指引。SKILL.md 中只保留摘要和触发条件。
+
+---
+
+## Phase 2 设计任务（框架确定后执行）
+
+### 开始前先加载 references（逐项检查，不能跳过）
+
+- 定题材腔调/招式 → 加载 `genre-styles/{题材}.md` + `short-craft.md` ✅/❌
+- 写反派/揭露方式 → 加载 `villain-and-reveal.md` ✅/❌
+- 写大纲 → 题材包 `genre-styles/{题材}.md` 的节奏骨架 +（冷门题材）`genre-writing-formulas.md` 速查表 ✅/❌
+- 反转信息差验证 → 需加载 `reversal-toolkit.md` ✅/❌
+- 伏笔回查 → 见下方「伏笔回查清单」 ✅/❌
+- 如某项不适用（如无反派），标注原因后可跳过
+
+### 设计步骤
+
+1. **设计信物 / 贯穿物**（可选，1-2 个）：见题材包招式库「信物翻转」（如追妻火葬场的信物意义翻转）
+   - 填写：`- 第1次出现（第X节）：{场景}（{含义}）` 重复三次，含节号定位
+2. **设计反派**（如有）：用 villain-and-reveal.md 反派模板
+   - 填写：`{身份} + {动机} + {作恶方式} + {致命弱点} + {报应}`
+3. **确定揭露方式**：从 villain-and-reveal.md 4 种真相揭露机制中选一种
+4. **编写 小节大纲.md**：每节 1 行，格式如下：
+   `结构段/五段功能 | 主事件 | 子事件×3-5 | 情绪 | 人物/关系变化 | 因果/逻辑链 | 读者新获知什么 | 结尾承接/钩子 | 伏笔/物件 | 动静 | 对话密度 | 目标字数`
+   - `结构段/五段功能` 使用开头/铺垫/升级/反转/结尾（或起因/发展/转折/高潮/结尾），用于轻量对应长篇的内容概括，但不要套长篇完整章节蓝图
+   - `人物/关系变化` 写本节前后变化；没有显性变化写“无显性，但关系压力/误解/距离变化为…”或 `[待补充]`
+   - `因果/逻辑链` 写 `原因 → 行动 → 结果 → 后果/新问题`，避免小节只是情绪堆叠
+   - `结尾承接/钩子` 写本节如何接下一节；最后一节写结尾落点
+   - 子事件必须功能明确（推动剧情/铺垫反转/升级情绪），禁止装饰性子事件
+   - 子事件不足 3 个时用扩展规则（加阻碍 / 配角反应 / 移动中发现 / 简短倒叙 / 动作递进；见 short-craft.md 第 10-11 节）
+   - 子事件用 `->` 连接，每个子事件包含具体情节点描述+功能标签：
+     `具体发生了什么{功能标签}` 如 `发现账单上多了一笔4800{发现}` / `把戒指冲进马桶{冲突}` / `他笑了{递进}`
+     功能标签：`对话` / `冲突` / `伏笔` / `回忆` / `发现` / `递进`
+     情节点描述要具体到"谁做了什么"，不能只写标签如`对话`或`冲突`
+   - 动静标记：`动` 或 `静` 或 `动静`，相邻两节尽量交替；如因题材需要连续同标记，需确保节内有情绪变化（如：两节都是"静"，但第一节"疑惑→心酸"、第二节"心碎→崩溃"，情绪曲线仍在上升）
+   - 对话密度：`高`（3+轮）/ `中`（1-2轮）/ `零`（全节无对话），尽量不连续 2 节标 `零`；翻阅日记、独自发现等场景允许例外，但连续零对话段落的情绪必须通过揉进感官细节和身体反应来推进
+5. **反转信息差验证**（outline 写完后、写作前必须验证）：
+   - 回答：读者在第几节知道真相？用「揭穿节号 ÷ 全文总节数」计算位置百分比
+     - < 50% → 延迟揭露，反转无效（读者已知真相太早，后续缺少震撼）
+     - 50-60% → 灰区，需审视反转力度是否足够（前文误导线索是否充分）
+     - > 60% → 反转位置合理（读者等得够久，冲击力最大化）
+   - 检查：至少有 1 条读者被成功误导的假线索（不是读者猜到后等角色追上来）
+   - 检查：反转前是否铺垫了 ≥3 条指向真相的线索（线索要隐蔽，不是明示）
+   - 验证：找一个人（或自我模拟）只看 outline，能否在反转前猜到真相？猜到 = 失败
+6. **伏笔回查清单**（outline 写完后、写作前检查）：
+   - 列出结尾所有关键元素（物件/信息/角色/关系变化）
+   - 每个结尾元素在前文有 ≥1 次铺垫？没有 = 天降，必须补铺垫
+   - 贯穿道具三次出现完整？（第 1 次出现在铺垫段，第 2 次出现在反转段，第 3 次出现在结尾段）
+   - 铺垫节号与揭穿节号的间距 ≥ 3 节（间距太短铺垫无效）
+
+### 写作前加载（按需，同时 ≤ 3 个）
+
+- 必读：`short-format.md`（正文格式）+ `short-craft.md`（通用底座）
+- 必读：`short-deslop.md`（写作时自检 AI 腔）
+- 按题材加载 1 个：`genre-styles/{题材}.md`（核心 10 题材）或 `genre-writing-formulas.md`（冷门题材速查表）
+- 按需加载：`villain-and-reveal.md` / `emotional-methods.md`
+
+### 工作目录结构
+
+工作目录结构见 [Phase 2：构思核心框架](../SKILL.md#phase-2构思核心框架)。设定.md 内容构成：核心框架 + 人设 + 反转铺垫 + 贯穿道具（含三次出现追踪表）+ 反派设计 + 对标摘要。小节大纲.md 每节 1 行，格式以 [设计任务（框架确定后执行）](../SKILL.md#设计任务框架确定后执行) 第 4 步为准。
+
+### 操作原则
+
+- 正文直接写入文件，不要只输出在对话里
+- 精修时读取文件再改写，修改记录直接体现在设定.md的贯穿道具追踪中
+- 设定.md 维护贯穿道具追踪表：
+  `| 物件 | 第1次出现(节号/含义) | 第2次出现(节号/含义) | 第3次出现(节号/含义) |`
+
+---
+
+## Phase 4 精修打磨
+
+### 精修检查清单
+
+```
+## 精修清单
+
+### 开头
+- [ ] 前 3 句话能抓住人？
+- [ ] 没有无意义的背景介绍？
+- [ ] 包含一个开篇钩子？
+
+### 情绪
+- [ ] 情绪曲线是否有明确走向？
+- [ ] 反转前的情绪铺垫够不够？
+- [ ] 反转后的冲击够不够？
+
+### 反转
+- [ ] 反转是否出乎意料？
+- [ ] 反转是否合情合理（回看有铺垫）？
+- [ ] 反转时机是否合适？
+
+### 节奏
+- [ ] 有没有拖沓的部分？
+- [ ] 每句话是否都有存在价值？
+- [ ] 字数是否在目标范围内？
+
+### 格式
+- [ ] 段落以短为主、有长短交错与疏密变化（非通篇同长度）？无连续超长大段？
+- [ ] 段间仅单换行？
+- [ ] 对话独立成行、引号风格符合项目/平台约定？
+- [ ] 标点节奏匹配语气/人物声线：没有通篇句号化，也没有随机堆砌问号/感叹号，或用 `……`/`——` 硬造停顿？
+- [ ] 正文（含对话）里的 `……`、`——`、`—`、`--` 已改成动作、短句、逗号或句号？
+- [ ] 无「他说/她道」？
+
+### 钩子
+- [ ] 每 2-3 小节有钩子？
+- [ ] 章末有钩子（悬念或余韵）？
+
+### AI 腔
+- [ ] 无禁止比喻：「命运的齿轮」「如潮水般」「仿佛春风」「心猛地一沉」「眼眶泛红」
+- [ ] 同一身体部位/情绪描写不超 5 次（统计：手指/心/膝盖/眼睛，超限必须替换）
+- [ ] 「像」使用频率：全文不超 10 处（含「像是」「不像」）
+- [ ] 完整 AI 腔黑名单见 short-deslop.md
+
+### 技法
+- [ ] 情绪外化：直给的情绪词后面是否接了场景里的具体动作或物件？无空泛情绪总结句（一丝X涌上心头）？
+- [ ] 信物（若用）：意义翻转是否完整？（查设定.md追踪表）
+- [ ] 一动一静：每节是否有动有静？
+- [ ] 开头密度：前 100 字事件 ≥ 3？
+
+### 结尾
+- [ ] 结尾是否有余韵？
+- [ ] 读者会不会想转发？
+```
+
+### 标点确定性收尾
+
+精修后对 `正文.md` 先运行 `node scripts/check-ai-patterns.js --check --fail-on=blocking 正文.md`。blocking 先改正文并复扫；advisory 只作读感提示，确属问题才改，功能性写法标 `[需复核]`。
+再运行 `node scripts/normalize-punctuation.js 正文.md`（默认 `--quote-mode keep`）清理无功能省略号、破折号、双连字符和独立分隔线；盐言「」不受影响。
+
+### 删减原则
+
+1. 不推动剧情的对话 → 删
+2. 不铺垫反转的描写 → 删
+3. 不推高情绪的心理活动 → 删
+4. 读者能猜到的内容 → 缩短
+5. 重复表达的情绪 → 合并
+
+---
+
+## 常见问题与解决方案
+
+| 问题 | 原因 | 解决方案 |
+|------|------|----------|
+| 开头不抓人 | 在做背景铺垫 | 直接从冲突开始 |
+| 中间拖沓 | 信息密度太低 | 删减或合并场景 |
+| 反转没力度 | 铺垫不够或太明显 | 增加误导线索 |
+| 结尾无力 | 反转后拖太长 | 反转后 500 字内收尾 |
+| 全篇平淡 | 情绪曲线太平 | 加大情绪落差 |
+| 感觉像流水账 | 缺乏情绪描写 | 加入人物内心感受 |