@oh-story/dsh 0.1.15 → 0.1.17

package/lib/oh-story/skills/story-setup/references/agent-references/writing-craft.md

@@ -1,6 +1,6 @@
 # 写作技法：可执行指令集
 
-> 写作全程参考。对话怎么写见 dialogue-mastery.md，开篇设计见 opening-design.md，章节格式按长篇 long-format.md 或短篇 format-and-structure.md。
+> 写作全程参考。对话怎么写见 dialogue-mastery.md，第 1-3 章的开篇写法见 opening-design.md「开篇落笔」；正文格式按调用方指定的格式文件与本书约定执行。
 
 ---
 
@@ -44,32 +44,33 @@
 
 ---
 
-## 2. 贯穿道具系统（三次出现规则）
+## 2. 贯穿道具：随情节改变意义
 
 ### 规则
 
-每个叙事单元（短篇/长篇卷）设计 1-2 个贯穿道具。每个物件必须出现 3 次，每次意义不同。
+物件能承载关系或处境变化时，可选用贯穿道具；每次重现都应增加信息或改变意义，次数与位置随剧情单元调整。
 
-### 三次出现编排
+### 三次出现示例
 
 | 出现时机 | 功能 | 示例 |
 |----------|------|------|
-| 第 1 次出现（前 1/4） | 建立初始意义 | 金锁 = 姐姐送的生日礼物（温暖） |
+| 第 1 次出现 | 建立初始意义 | 金锁 = 姐姐送的生日礼物（温暖） |
 | 第 2 次出现（中段转折） | 意义被颠覆 | 金锁 = 金包铜的假货（虚伪） |
 | 第 3 次出现（结尾） | 情感暴击 | 金锁被丢进垃圾桶（彻底决裂） |
 
 ### 物件设计模板
 
-填写以下模板，写入设定.md：
+采用贯穿道具时，记下每次出现的含义变化，随交付申报：
 
 ```
 物件：{名称}
-第1次出现：第{N}节 | {场景} | 含义：{初始意义}
-第2次出现：第{N}节 | {场景} | 含义：{转折意义}
-第3次出现：第{N}节 | {场景} | 含义：{结尾意义}
+| 章/场景 | 当次含义 | 新增信息或意义变化 |
+|---|---|---|
+| {位置} | {当次含义} | {首次建立/后续变化} |
 ```
 
-------|------|------|
+| 类型 | 功能 | 示例 |
+|------|------|------|
 | 信物型 | 承载关系的象征物 | 金锁（姐夫捎路）、木头小马（皇弟） |
 | 工具型 | 日常使用的功能性物件 | 打分本（准儿媳）、账本（迟来二十年） |
 | 痕迹型 | 残留的身体/环境痕迹 | 手腕旧疤、墙上身高刻度 |
@@ -79,7 +80,7 @@
 
 ## 3. 对话中的权力博弈
 
-对话权力博弈的完整技法（对话长度=权力地位、压制/反转/心死三种模式、示例、≤10字/≥20字操作指令）见 dialogue-mastery.md「权力博弈对话」，本文件不重复。结构化用法：在场景编排时，把权力反转放在爽点/反转节点上，用对话长度的突变标记权力易主。
+对话权力博弈的完整技法（对话长度=权力地位、压制/反转/心死三种模式、示例）见 dialogue-mastery.md「权力博弈对话」，本文件不重复。结构化用法：在场景编排时，把权力反转放在爽点/反转节点上，用对话长度的突变标记权力易主。
 
 ---
 
@@ -105,18 +106,18 @@
 
 ```
 数字线：
-第{N}节 | {数字1} | 含义：{初始}
-第{N}节 | {数字2} | 含义：{升级}
-第{N}节 | {数字3} | 含义：{暴击/反转}
+第{N}章 | {数字1} | 含义：{初始}
+第{N}章 | {数字2} | 含义：{升级}
+第{N}章 | {数字3} | 含义：{暴击/反转}
 ```
 
 ---
 
-## 5. 动静有起伏，不按节配额
+## 5. 动静有起伏，不按场景配额
 
 ### 规则
 
-一章整体要有推进与停顿的起伏，但不要求每个小节各塞一个“动”和“静”。停顿可以来自信息悬置、对话空白、环境压力或角色暂不行动，不等于安排擦灰、理衣领一类微小动作。
+一章整体要有推进与停顿的起伏，但不要求每个场景各塞一个“动”和“静”。停顿可以来自信息悬置、对话空白、环境压力或角色暂不行动，不等于安排擦灰、理衣领一类微小动作。
 
 ### 动与静的分类
 
@@ -127,36 +128,29 @@
 
 ### 操作指令
 
-- 按整章和场景需要安排动静，不给每个小节设数量指标
-- 连续多节全「动」时复核是否造成暴力疲劳；追逐/战斗有意连续可保留
-- 连续多节全「静」时复核是否停滞；等待/压迫有意延长可保留
+- 按整章和场景需要安排动静，不给每个场景设数量指标
+- 连续几个场景全「动」时复核是否造成暴力疲劳；追逐/战斗有意连续可保留
+- 连续几个场景全「静」时复核是否停滞；等待/压迫有意延长可保留
 - 情绪高低不对应固定动作类型：爆点可以突然安静，低谷也可以持续劳动
 
-### 节奏编排示例
-
-```
-节5（动）：萧衍一声令下，打了萧琅二十棍
-节6（静）：报数停了，殿里没人替萧琅求情
-节7（动）：王氏扑过来，跪在地上磕头
-节8（静）：王氏跪在原地，只听见宫门落锁
-```
-
 ---
 
 ## 6. 开头事件密度
 
 ### 规则
 
-前 100 字必须包含 ≥ 3 个事件。不做背景铺垫，直接上事件链。
+按题材和本章任务选用事件链开场，检查因果、有效变化和开头钩子，事件数随内容而定。
 
 ### 操作指令
 
-- 删除所有开头背景介绍（「在古代XX年间」「她是一个XX的女孩」）
-- 第 1 句就是事件，不是描述
-- 事件密度检查：数前 100 字里有几个独立的「发生的事」
+- 压缩无功能背景（「在古代XX年间」「她是一个XX的女孩」），保留理解当前处境所需的信息
+- 用行动、异常或具体处境建立阅读问题
+- 核对实际事件或信息变化是否推进目标、风险、关系或下一步行动
 
 ### 事件密度示例
 
+这组例子示范高密度事件链开场：
+
 ```
 ❌ 低密度（1 件事/100 字）：
 「沈栀是沈家的嫡女，自幼聪慧，深得父亲喜爱。这一天，她收到了一道圣旨。」
@@ -170,46 +164,28 @@
 
 ### 密度检查模板
 
-写完开头后，列出前 100 字的事件清单：
+写完所选事件链开头后，按实际内容逐项记录：
 
 ```
-事件1：{事件}
-事件2：{事件}
-事件3：{事件}
-（如果列出 < 3 个，重写开头）
+事件/变化：{实际内容}
+是否推进：{是/否；改变了什么}
 ```
 
 ---
 
-## 7. 小节密度诊断
+## 7. 场景偏短时怎么查
 
 ### 规则
 
-写完一个小节如果感觉偏短，用以下诊断清单排查。不要为了凑字数加描写。
-
-### 诊断清单
-
-小节写完后偏短？按顺序检查：
+写完一个场景觉得偏短，按下表排查；不为凑字数加描写。
 
 | 检查项 | 偏短原因 | 补救 |
 |--------|----------|------|
-| 关键子事件读得懂吗？ | 现场、因果或角色下一步缺了必要信息 | 只补真正缺失的维度；不为凑齐三项补感官或身体动作（见第8节） |
+| 关键子事件读得懂吗？ | 现场、因果或角色下一步缺了必要信息 | 只补真正缺失的信息；不为凑齐发生、感知、反应补感官或身体动作（见第8节） |
 | 对话只有 1-2 轮？ | 缺少对话交锋 | 加一轮权力博弈对话（见第3节） |
 | 情绪信息落地了吗？ | 只贴标签，或又用无功能微动作重复解释 | 优先落到选择、台词、物件和后果；必要时直写，身体细节须有功能（见第1节） |
 | 仍偏短且关键情节点写薄？ | 冲突、选择、代价或关系变化没有演到位 | 回到细纲内已有事件补交锋与后果；没有内容就补纲，不拿感官/回忆注水 |
 
-### 子事件不够时怎么扩
-
-写 outline 时子事件不够？按以下顺序选择：
-
-```
-IF 主事件是冲突/对抗 → 加「阻碍」：主角被中途打断或阻止
-IF 主事件涉及配角 → 加「反应」：配角的意外反应
-IF 主事件有空间移动 → 加「发现」：移动途中发现新线索
-IF 主事件触发回忆 → 加「倒叙」：插入一段 2-3 句的简短回忆
-IF 主事件是一连串动作 → 加「递进」：动作引发的连锁反应
-```
-
 ### 任务卡点：只在“办事本来会卡住”时使用
 
 任务卡点不是多写流程，也不是为了显得自然；它是让角色想办成一件具体事时被卡住一下，并卡出变化。
@@ -234,86 +210,66 @@ IF 主事件是一连串动作 → 加「递进」：动作引发的连锁反应
 - 为显得自然而加流程细节；删掉无损就删
 - 为凑字数重复解释情绪，或给每段补一个无功能身体反应
 
-**一处显式例外：人物余韵。** 上面「删掉无损就删」不针对给人物加层的段落——一次说岔了的关心、一个被误会的反应、一个空镜。它的"无损"只对情节成立：判断方法不是问它推进了什么，是问**删掉之后谁少了一层**。
-
-**这是豁免，不是配额。** 材料里长出这样一处就别砍；没长出来就没有，**不要为了凑"每章一处"补一段**。
+给人物加层的段落（一次说岔了的关心、一个被误会的反应、一个空镜）不按“删掉无损就删”判，要问删掉之后谁少了一层；材料里长出来就留，不为每章凑一处。
 
 ---
 
-## 8. 场景写法（三维度揉进）
+## 8. 场景写法
 
 ### 从细纲到正文：把规格演成场景，不照抄形状
 
-细纲各字段是本章"要发生什么"的规格，**不是正文的形状**。照着细纲的形状逐格填，正文就成了一条一条交代的电报体、一拍一句平推的生硬解说——这是"照抄大纲形状"，和照抄范例形状同属 AI 味来源。
+细纲各字段是本章"要发生什么"的规格，**不是正文的形状**。照着细纲的形状逐格填，正文就成了一条一条交代的电报体、一拍一句平推的生硬解说，和照抄范例形状一样会写出 AI 味。
 
-- 情节点序列是"要发生什么"的清单，不是句子模板：不要一个情节点写成一句或一段、按序平推；把每个点演成角色此刻可感知的选择、动作、对话、物件、结果，必要时才用身体反应——**演出来，不是交代出来**。
-- **状态变化要给出台阶，不只给前后。** 一样东西烧起来、一张脸沉下去、一个人的态度转过来——要让读者看见中间态：先怎样、跟着怎样、最后成了什么。只给起点和终点的是概述，不是场景。台阶是**序列**不是堆料：同一状态换十种说法说十遍，仍然只是一个台阶。
+- 情节点序列是"要发生什么"的清单，不是句子模板：不要一个情节点写成一句或一段、按序平推；把每个点演成角色此刻可感知的选择、动作、对话、物件、结果，必要时才用身体反应，**演出来，不是交代出来**。
+- **状态变化要给出台阶，不只给前后。** 一样东西烧起来、一张脸沉下去、一个人的态度转过来，要让读者看见中间态：先怎样、跟着怎样、最后成了什么。只给起点和终点的是概述，不是场景。台阶是**序列**不是堆料：同一状态换十种说法说十遍，仍然只是一个台阶。
 - 同一约束如果在「核心事件 / 内容概括 / 情节安排 / 情节点」里重复出现，生成前只合并成**一个语义点**；重复字段不是强调，更不是四次复述额度。正文不得沿用提纲里反复出现的同一措辞逐项交代。
 - 五段式（起因/发展/转折/高潮/结尾）是给细纲作者的功能拆解，不是正文的五个自然段；正文不必逐段顺叙，也不必一段对一格。
 - "谁做了什么"的概括句、"A→B→C"箭头链、"收束到什么状态"是规划口径，不要原样搬进叙述。
-- 同一场戏里的几个点可以合并、互相打断，不必排成逐点清单；因果依赖或刻意的停顿分隔才串行。只改顺序不会让正文变好看（交错与否的对照实验测不出差别），密点展开、疏点带过更要紧（见「疏密分配」）。
-- 章尾落在最后一个具体的动作、画面、台词或悬念上；细纲「结尾设定」是规划口径，不要在正文里写成"就这样……""他终于明白……"式的状态总结句（结尾去升华见 anti-ai-writing.md）。
+- 同一场戏里的几个点可以合并、互相打断，不必排成逐点清单；因果依赖或刻意的停顿分隔才串行。交错要有行动或信息关系，重点仍是密点展开、疏点带过（见「疏密分配」）。
+- 章尾落在最后一个具体的动作、画面、台词或悬念上；细纲「结尾设定」是规划口径，不要在正文里写成"就这样……""他终于明白……"式的状态总结句。
 
-### 视角姿态：深度限知（贴地沉浸）
+### 视角：深度限知
 
-三维度揉进之前，先定叙述姿态。默认锁死主视角角色的"此刻感知"——只写他此刻看到、听到、闻到、身体感到、脑中闪过的东西。这一条同时解决两个最顽固的 AI 味：代入感不足，和"作者在场"的说教/上帝腔。
+默认锁死主视角角色的"此刻感知"，只写他此刻看到、听到、闻到、身体感到、脑中闪过的东西。这样既有代入感，也没有"作者在场"的说教腔。本书文风允许有限全知时，叙述者可补角色不知的事实，但不预告后面才发生的结果；不把视角限制当成通用去味法。
 
 - **镜头不拉远、不俯瞰、不切他人内心**：别写"整个大厅陷入死寂"这种摄像机视角，写"她听见自己的心跳，旁边的呼吸声一下子全没了"。
-- **读者与角色同步获知**：角色不知道的不写；不提前剧透，不补全背景。悬念来自"她也不知道"，禁止提前剧透句如"她不知道的是"。
+- **读者与角色同步获知**：角色不知道的不写；不提前剧透，不补全背景。悬念来自"她也不知道"，不写"她不知道的是"这类提前剧透句。
 - **念头是动作的一部分**：用半句的、被打断的、带情绪偏见的主观判断，不写完整理性的内心独白；不强配身体动作，情绪落地按第 1 节。
-- **主观偏差代替客观叙述**：场景被角色情绪染色。她恨谁，谁就被写得可憎；她慌，光线就晃。不写中立的、谁看都一样的描述。但只能是她此刻带偏见的瞬间感觉，不能写成"像在宣判一件早已定好的事"这类客观盖棺断言（那是作者下场定性，见 anti-ai-writing.md 模式 8）。
-
-深度限知是"自然去 AI"的根：把镜头钉死在角色身体里，作者就没有位置跳出来解释、总结、安排了（配合 anti-ai-writing.md 模式 8）。
+- **主观偏差代替客观叙述**：场景被角色情绪染色。她恨谁，谁就被写得可憎；她慌，光线就晃。但只能是她此刻带偏见的瞬间感觉，不能写成"像在宣判一件早已定好的事"这类客观盖棺断言。
 
-### 文风指纹：按题材借 cadence，不套万能腔
+### 句子节奏按题材借
 
-不同题材的真实文风 cadence 会影响读感；有效写法不同。男频/军旅可以借旧网文连贯叙事惯性，现代日常可写普通任务推进；悬疑、科幻、古代不要硬套盘龙腔、旧网文腔或第一人称声口，先读本书 `设定/文风.md`、对标拆文和匹配章摘要。
+先按本章情绪和本书文风写顺，再处理解释总结、过度压缩和比喻堆叠。男频、军旅可以借老网文连贯叙事的惯性，现代日常写普通的办事推进；悬疑、科幻、古代不要硬套老派玄幻的大段铺陈或第一人称声口，先读本书 `设定/文风.md`、对标拆文和匹配章摘要。不要把句子机械拉长或压短，也不要全局换成某本对标书的词法。
 
-落地顺序：先按本章情绪和题材文风写顺，再处理解释总结、过度压缩和比喻堆叠；不要把句子机械拉长/压短，也不要全局替换成某个对标书的词法。
-
-### 规则
+### 发生、感知、反应写进同一镜头
 
-关键子事件不能只剩一句提纲概括。发生是主干；感知和反应只在提供新信息时加入，并与发生织进同一镜头，不按维度分段，也不要求三项齐全。
-
-### 三维度揉进规则
-
-发生、感知、反应是可选的信息维度，不是逐段配额。详写的关键子事件可以把其中确有内容的维度织在同一镜头里；上下文已经清楚的维度留空，不为凑齐三项补感官或身体动作。过场、赶路、信息交代类子事件 1-2 句带过即可（见「疏密分配」），把字数预算让给情绪节点。
+关键子事件不能只剩一句提纲概括。发生是主干；感知和反应只在提供新信息时加入，并与发生织进同一镜头，不按维度分段，也不要求三项齐全。上下文已经清楚的维度留空；过场、赶路、信息交代类子事件 1-2 句带过即可（见「疏密分配」），把字数让给情绪节点。
 
 | 维度 | 内容 | 要点 |
 |---|---|---|
 | 发生 | 事情出现了 | 1-2句，包含一个具体细节 |
-| 感知 | 主角注意到什么 | 只取会改变理解、判断或气氛的一处声音、物件、空间或身体感受，不按感官凑数 |
-| 反应 | 角色接下来怎么办 | 可以是选择、台词、策略、任务动作、明确感受或有后果的身体反应，不默认写微动作 |
-
-任务卡点写法可从三维中取需要的内容：发生 = 事情办不下去；感知 = 被退回的纸、扣住的物件、对方半句话等具体凭据；反应 = 角色改策略、付代价、求助、硬闯、退让或记下一笔。不要把“为什么被卡住”解释成一段说明书，也不要在 scene 末尾另补动作尾巴来解释意义。
+| 感知 | 主角注意到什么 | 只取会改变理解、判断或气氛的一处声音、物件、空间或身体感受，不按感官凑数；装饰性场景描写（"阳光洒在窗台上"）不算 |
+| 反应 | 角色接下来怎么办 | 可以是选择、台词、策略、任务动作、明确感受或有后果的身体反应；不用无功能微动作给已清楚的情绪再贴标签 |
 
-### 反模式：堆叠式描写（绝对禁止）
+任务卡点也这样写：发生 = 事情办不下去；感知 = 被退回的纸、扣住的物件、对方半句话等具体凭据；反应 = 角色改策略、付代价、求助、硬闯、退让或记下一笔。不要把“为什么被卡住”解释成一段说明书，也不要在场景末尾另补动作尾巴来解释意义。
 
-把三个维度分成三段依次写完，是 AI 最常见的写作痕迹。读者看到的是同一个动作被掰开写了三遍：
+把三个维度分成三段依次写完，同一个动作就被掰开写了三遍：
 
-> ❌ **堆叠式（错误）**：
-> 林父低着头，左手把文书压住，右手拿笔，往纸上落。
+> ❌ 林父低着头，左手把文书压住，右手拿笔，往纸上落。
 >
 > 手在抖。
 >
 > 手从肘到腕都在抖，笔尖在纸上停了停，写了一横，又停，那个"林"字的撇写歪了，他顿了顿，把笔往下压，重写，写完了，笔在手里还是没稳。
 
-→ 一件事写成发生→感知→反应三段，同一个动作掰开三遍
-
-### 正确写法：揉进式
-
 需要的维度融进同一段连续正文，读者读到一个完整瞬间：
 
-> ✅ **揉进式（正确）**：
-> 林父左手压着文书，右手拿笔往纸上落，笔尖一触纸面就偏了，从肘到腕止不住地抖，那一横斜着拖出去。他顿了顿，把笔往下压，重写，写完的"林"字撇是歪的，笔在手里还是没稳住。
-
-→ 这里的身体反应改变了落笔结果，承担信息；不是为了证明人物紧张而另加微动作
+> ✅ 林父左手压着文书，右手拿笔往纸上落，笔尖一触纸面就偏了，从肘到腕止不住地抖，那一横斜着拖出去。他顿了顿，把笔往下压，重写，写完的"林"字撇是歪的，笔在手里还是没稳住。
 
-### 画面分段（防止一段到底）
+这里的身体反应改变了落笔结果，承担信息；不是为了证明人物紧张而另加微动作。
 
-三维度揉进不是把一个子事件塞进一个长段。揉进解决"同一瞬间被拆成发生/感知/反应三段"的问题；断段解决"手机阅读时一段过密"的问题。
+### 画面分段
 
-断段按镜头/信息变化，不按维度变化：
+断段按镜头和信息变化，不按维度变化，也不按字数。揉进解决"同一瞬间被拆成三段"，断段解决"手机阅读时一段过密"，两件事不冲突。
 
 | 触发点 | 断段方式 |
 |---|---|
@@ -326,46 +282,42 @@ IF 主事件是一连串动作 → 加「递进」：动作引发的连锁反应
 判定规则：
 
 - 一段只承载一个镜头拍点/一个动作单元，或一条尚未结束的连续推理、氛围、情绪链。
-- 常规叙事段可短，但句子内部不碎——叙述句不要一个动作一句号、句句断开，也不要用逗号罗列动作——用虚词把前后接成一口气（见本节「句子怎么连」）；细密描写、推理判断、氛围压迫、情绪沉淀可以稍长，前提是仍在讲同一件事。
+- 常规叙事段可短，但句子内部不碎：叙述句不要一个动作一句号、句句断开，也不要用逗号罗列动作，用虚词把前后接成一口气（见「句子怎么连」）；细密描写、推理判断、氛围压迫、情绪沉淀可以稍长，前提是仍在讲同一件事。
 - 长度只是诊断，不是强制阈值：读起来拥挤、包含多个动作/信息/视线切换时才拆；完整戏剧单元未结束时不要为凑短而硬拆。
 - 常规正文保持短段、稍长段、对话、动作段交替；高压冲突、打脸、反转段可以更碎更短。
 - 不要连续多段同长度，也不要把一个完整推理链切成机械碎片。
-- **最重的一句要最短。** 全章最重的那一拍——底牌亮出、一句定生死的许诺、身份被说破——用最短的一段承接，能单句成段就单句成段。**长度表达绵延，不表达重量**；要"慢"用停顿，不用字数。
+- **最重的一句通常短，常单句成段。** 全章最重的那一拍（底牌亮出、一句定生死的许诺、身份被说破）用最短的一段承接。长度表达绵延，不表达重量；要"慢"用停顿，不用字数。
 
-输出前必须做一次自然节奏重排：
+输出前做一次自然节奏重排：
 
 1. 扫描每个自然段；先问“这段是否只完成一件事/一个镜头/一条推理或情绪链”。是则保留，不因字数单独拆。
 2. 若同段里出现新动作、新物件、新信息、新对话、视线转移、场景结束，就在这些位置断段。
 3. 若连续多个极短段仍属于同一镜头/同一件事，合并相邻句，避免碎成提纲或诗行。
 4. 若一个长句朗读卡顿或信息过载，先删修饰或拆句；拆句后仍保持同一段的戏剧单元完整。
 
-### 主语与名字节奏（防止“主语过密”）
+### 主语与名字节奏
 
-主角名/角色名承担“主语重置”和“强调”功能，不承担每句打标签的功能：
+角色名用来重置主语和强调，不给每句打标签：
 
 - 段首、场景切换、多人同场、视角重置时，用主角名建立主语。
 - 同一动作链/同一段内部，优先用“他/她”、动作承接或省略主语，让句子自然流动。
 - 关键转折、情绪爆点、身份反差、读者需要重新盯住主角时，再点名强化。
 - 反面信号：连续多句或连续多段都以同一主角名开头，但中间没有主语混淆、场景切换或强调需要。
-- 不按全章名字出现次数机械裁判；最终标准是读起来是否有“每句都在报名字”的卡顿感。
+- 不按全章名字出现次数机械裁判；最终标准是读起来是否有“每句都在报名字”的卡顿感。为了省主语把多人同场写到指代不清，同样是错。
 
-错误修法：为了短，把一条完整推理/氛围链切成多段；为了省主语，把多人同场写到指代不清。
+### 疏密分配
 
-正确修法：保留同一件事的连续性，在新动作、新物件、新信息、新对话处断开；段首点名建立主语，段中用代词/省略流动，关键转折再点名。
-
-### 疏密分配（详略不均）
-
-不要每个情节点一样长、一样细——平均用力是 AI 腔的根源，也是读起来"哪都写得满、哪都不出彩"的原因。按情节权重分配笔墨：
+按这场戏要让读者经历什么分配笔墨，不要每个情节点一样长、一样细；平均用力读起来"哪都写得满、哪都不出彩"。
 
 | 情节点类型 | 笔墨 | 写法 |
 |---|---|---|
 | 爽点/打脸/反转/情绪高潮 | 密（详写） | 感知、动作、对话交锋铺满，慢镜头逐拍展开 |
-| 过场/赶路/信息交代/时间跳转 | 疏（略写） | 1-2 句带过，甚至一句概括，不展开三维度 |
+| 过场/赶路/信息交代/时间跳转 | 疏（略写） | 1-2 句带过，甚至一句概括，不展开 |
 | 铺垫/日常/关系升温 | 中 | 挑一两个有代入感的细节写实，其余略 |
 
-原则：一章里详写的情节点集中在情绪节点，过场坚决压缩。读者记住的是密处的画面，疏处只是把他们快速送到下一个爽点。密度有起伏，节奏才有呼吸。
+原则：一章里详写的情节点集中在情绪节点，过场坚决压缩。读者记住的是密处的画面，疏处只是把他们快速送到下一个爽点。
 
-**同类并列项要递减，不要平均。** 三样物件、四拨人马、五次出手——第一个写足，第二个减半，后面的一句带过或只给一个区别点。**递减不是省略**：被压缩的那几个仍要各有一个不重复的记号，否则是漏写。
+**同类并列项不平均用力。** 三样物件、四拨人马、五次出手，按这场戏的作用决定谁展开、谁概括、谁略过，不规定递减次数；被概括的仍各留一个不重复的区分点，否则是漏写。
 
 **判为"密"的地方禁止量词加概括。** "一连七八下""斗了半晌""众人纷纷点头""交手数十回合"（把过程折叠成一个数字，是疏处的手法）。密处只有一种写法：挑出其中**具体的几下**，逐拍写。
 
@@ -374,25 +326,18 @@ IF 主事件是一连串动作 → 加「递进」：动作引发的连锁反应
 子事件之间按真实关系连接（因果、接招、新信息、空间移动、角色下一步），不为过渡另补身体动作。句子内部同样要连，不要罗列：
 
 - **动作串分主次、带虚词**：一句里超过三个动作，用「就、才、又、便、却、倒、还、再、先……才」接出先后和因果，别写成逗号清单。❌「坛子挪到墙角，床板拿袖子擦了一遍，铺盖摊开。」✅「她先把坛子挪到墙角，拿袖子把床板擦了一遍，这才把铺盖摊开。」
-- **少写没做的事**：「没A，也没B」「不A，也不B」一章至多一两处，写人物做了什么。❌「他没说让她住，也没说不让。」✅「他掀着帘子站了一会儿，一句话不说，进里间去了。」
-- **对话带口气**：人物说话按身份、年纪、地方带「吧、呢、啊、嘛、哎」和口头的停顿，全章对话不能一个语气词都没有。
+- **少写没做的事**：「没A，也没B」「不A，也不B」只在排除猜测、写出落空时用，其余写人物做了什么。❌「他没说让她住，也没说不让。」✅「他掀着帘子站了一会儿，一句话不说，进里间去了。」
+- **对话带口气**：人物说话按身份、年纪、地方和场合带「吧、呢、啊、嘛、哎」和口头的停顿；通篇对话都是不带口气的完整书面句时，回头按人物恢复，不给每人硬塞同一个口头禅。
 - **碎句留给重拍**：单独成行的短句只给章尾、反转、情绪峰值；盘算、过渡写成连贯的一句。
-- **比喻用中文现成的说法**，不造「嗓门比香味还亮」这类跨感官新搭配。
-
-### 三维度的边界
+- **比喻贴着人物**：取角色此刻熟悉、手边的东西，不造「嗓门比香味还亮」这类跨感官新搭配，也不用「如潮水般」「如沐春风」这类套话。
 
-- ✓ 感知是主角主动注意到的细节（有注意力的焦点）
-- ✓ 反应是角色受此影响后的下一步，可落在选择、台词、策略、任务动作、明确感受或有后果的身体变化
-- ✗ 感知不能是装饰性场景描写（"阳光洒在窗台上"）
-- ✗ 反应不能只用无功能微动作给已经清楚的情绪再贴一次标签
-- ✗ 三个维度不能重复表达同一个信息
 ---
 
 ## 9. 语气标点谱系（标点跟着语气走）
 
 ### 规则
 
-标点承担语气、权力关系和情绪起落，不能当装饰。写正文时先判断“这句话在场景里做什么”，再决定用句号、逗号、问号、感叹号、冒号或换行/动作；不再用省略号和破折号制造停顿。
+标点承担语气、权力关系和情绪起落，不能当装饰。写正文时先判断“这句话在场景里做什么”，再决定用句号、逗号、问号、感叹号、冒号或换行/动作；默认不用省略号和破折号制造停顿，本书文风明确采用时按裁决。
 
 ### 标点谱系
 
@@ -402,14 +347,14 @@ IF 主事件是一连串动作 → 加「递进」：动作引发的连锁反应
 | 质问 / 试探 / 反问 | 问号、短跟句、动作停顿 | 关键问题用 `？`，追问可短句独立成行 | 不要连续 5 句全是 `？` |
 | 惊讶 / 爆发 / 打脸 | 少量感叹号、单句成段 | 只在情绪峰值用 1 个 `！`，爆点前后用短句承接 | 禁止 `!!!` 和整段喊叫 |
 | 犹豫 / 未说完 / 心虚 | 逗号、句号、短句、吞咽/停手等动作 | 用动作或句长变化停顿；必要时另起短句 | 不用 `……` 替代停顿 |
-| 被打断 / 拖长音 | 动作打断、换行、短句、未完成动作 | 用“他抬手截住她的话。”这类动作切断 | 正文和对话都不用 `——`/`—`/`--` |
+| 被打断 / 拖长音 | 动作打断、换行、短句、未完成动作 | 用“他抬手截住她的话。”这类动作切断 | 不用 `——`/`—`/`--` |
 | 信息揭示 / 判断落点 | 冒号、分号、短句 | “证据只有一个：门锁从里面扣上了。”可用冒号制造落点 | 不写论文式长分号链 |
 
 ### 执行步骤
 
 1. 读本场景目标情绪和角色声线，给每个关键对话回合标一类语气（压迫/试探/爆发/迟疑/被打断）。
 2. 精修时扫一遍句尾：如果一整段只剩句号，检查是否把质问、迟疑、爆点压平；如果满屏 `？`/`！`，删到只保留有功能的位置。
-3. 正文（含对话）里的 `……`、`——`、`—`、`--` 都改成句号、逗号、短句、换行或动作断句。知乎盐言 `「」` 只是引号风格，不影响问号、感叹号的合法使用。
+3. 没有文风裁决时，正文（含对话）里的 `……`、`——`、`—`、`--` 都改成句号、逗号、短句、换行或动作断句。知乎盐言 `「」` 只是引号风格，不影响问号、感叹号的合法使用。
 
 ---
 
@@ -429,14 +374,14 @@ IF 主事件是一连串动作 → 加「递进」：动作引发的连锁反应
 
 ### 说话权分级：惜墨表示地位
 
-在场的人不是平权的。**一场戏只给三到四个人台词**，其余降级为一个动作或一个目光——地位越高的人给的动作越少、越静，用惜墨表示分量；同等级同立场的合并成一句，连名字都不必给。**点名的时机 ＝ 承担功能的时机**，提前点名是提前许诺。
+在场的人不是平权的。台词只给有立场、承担功能的人，其余降级为一个动作或一个目光：地位越高的人给的动作越少、越静，用惜墨表示分量；同等级同立场的合并成一句，连名字都不必给。**点名的时机 ＝ 承担功能的时机**，提前点名是提前许诺。
 
-反面信号：五六个人各做一个等重量的小动作——镜头被平摊，谁也没立住。
+反面信号：五六个人各做一个等重量的小动作，镜头被平摊，谁也没立住。
 
 ### 标价人：谁说这件事重要
 
 "厉害／难得／要命"由**有立场的人**当场标价，不由叙述者断言。四种方式：**内行估价**（懂行的人给一句业内口径评语）、**最强者的姿态**（最有分量的人必须做出动作才顶得住）、**基准线被打破**（熟悉此地的人说"往常不该是这样"）、**稀缺度**（交代平常要什么代价才换得到）。
 
-**标价发生在事情起效之前**，不能等结果出来再补。反面：该标价的人就在场，却只写他"笑了笑，凑到旁边说了句什么"——位置留了，内容没给。
+**标价发生在事情起效之前**，不能等结果出来再补。反面：该标价的人就在场，却只写他"笑了笑，凑到旁边说了句什么"：位置留了，内容没给。
 
-**尺子要先于被度量的事出场，至少两把**（同场另一个做到几寸、当年最好的那个用了多久）。事后补一轮尺子也可以（同一个爽点吃第二遍）。
+**首次建立分量时，先给读者能比出高低的尺子**（同场另一个做到几寸、当年最好的那个用了多久）。事后补一轮尺子也可以（同一个爽点吃第二遍）。

package/lib/oh-story/skills/story-setup/references/diagnostics.md

@@ -1,16 +1,16 @@
 # 仅检查写作环境
 
-用于 `story-setup check` 或「检查写作环境」「为什么 agent 不可用」等诊断请求。默认只读，完成报告后结束；不复制文件、修改配置、创建部署标记，也不运行部署、迁移或提交命令。用户已要求修复时，先列出发现，再按 `story-setup/SKILL.md` 的原有部署流程与对应宿主的 `references/deploy-*.md` 处理。
+用于 `story-setup check` 或「检查写作环境」「为什么 agent 不可用」等诊断请求。只检查并报告，不复制文件、修改配置、创建部署标记或运行部署、迁移、提交命令。用户已要求修复时，先列出发现，再按 `story-setup/SKILL.md` 的原有部署流程与对应宿主的 `references/deploy-*.md` 处理。
 
 ## 1. 确定检查对象
 
 优先使用用户指定的项目根；未指定时从当前目录向上找最近的 `.story-deployed`。找不到则报告「未找到部署标记，无法确认部署状态」，检查现有文件和运行环境，不据此自动初始化。不要扫描无关项目。
 
-读取 `.story-deployed` 的目标端、版本和 reference 路径。多个目标端分别检查；字段缺失、内容不可解析、目标端未知时记录具体问题，不猜一个端写回。部署版本与正在执行的 `story-setup/SKILL.md` 比较；本地包可能落后于项目，不把降级重铺当作修复。
+读取 `.story-deployed` 的目标端、版本和 reference 路径。多个目标端分别检查；字段缺失、内容不可解析、目标端未知时记录具体问题，不猜一个端写回。将 `agents_version` 与当前 `story-setup/SKILL.md` 比较；本地包较旧时先更新，不能降级重铺。
 
 ## 2. 复用部署验证
 
-以每个目标端对应的 `references/deploy-{target_cli}.md` 里的「部署清单」与「验证」为准（只读目标端那几份），加上 `story-setup/SKILL.md` Phase 3 的部署标记检查，逐项读取目标文件并执行只读校验。不要维护另一份 skill 名称、数量、agent 路径或 hooks 事件清单。
+以每个目标端对应的 `references/deploy-{target_cli}.md` 里的「部署清单」与「验证」为准（只读目标端那几份），加上 `story-setup/SKILL.md` Phase 3 的部署标记检查，逐项读取目标文件并执行只读校验。skill、agent 与 hooks 清单均沿用部署文件。
 
 - 区分安装的 skill 包和项目部署副本：Claude Code、Codex、OpenCode 的项目路径主要保存 agent、hooks 和参考资料，不要求在那里出现整套 `SKILL.md`。其他端按各自部署清单检查；skills-only 端没有原生 agents/hooks 是预期行为。
 - 参考资料按源目录的相对文件列表逐一核对，包含子目录；只看目录非空或文件数量相同不足以证明完整。源包不可用或源与目标是同一份时，说明无法独立验证完整性，不把它判为通过。
@@ -33,6 +33,6 @@
 
 ## 4. 报告与后续
 
-读者是不懂编程的作者。报告先用写书的话写两段：「现在能用什么」（正常可用的写作能力，一句话概括）和「需要你做什么」（逐条可照做，如「新开一个会话」「在 Codex 里打开 /hooks 信任一下」；没有就写「无需操作」），这两段不出现脚本名、字段名、状态名或文件路径。之后才按「发现的问题」「未验证项」汇总技术明细，每项给出目标端或书目、文件路径/命令结果、具体影响和下一步；正常结果合并概述，skills-only 的预期限制不渲染成安装失败。结论限定为本次实际检查的范围，不承诺所有写作能力都已验证。
+读者是不懂编程的作者。报告先用写书的话写两段：「现在能用什么」（正常可用的写作能力，一句话概括）和「需要你做什么」（逐条可照做，如「新开一个会话」「在 Codex 里打开 /hooks 信任一下」；没有就写「无需操作」），这两段不出现脚本名、字段名、状态名或文件路径。之后才按「发现的问题」「未验证项」汇总技术明细，每项给出目标端或书目、文件路径/命令结果、具体影响和下一步；正常结果合并概述，skills-only 的预期限制不渲染成安装失败。结论写明本次实际验证的能力。
 
 需要补部署文件时建议重跑 `story-setup`；源包本身缺失或比项目旧时先更新源包，再部署；当前会话未加载能力时提示新开会话或完成该 CLI 的信任步骤。仅检查请求到此结束，不为了消除告警自行执行修复。