@oh-story/dsh 0.1.8 → 0.1.9

package/lib/oh-story/skills/story-deslop/references/deslop-gates.md

@@ -0,0 +1,154 @@
+# 去AI味 Gate 执行细则
+
+本文件承接调用方选定 Gate；只执行所选范围，不扩大为全量。表达先按 [style-resolution.md](style-resolution.md) 的本书裁决，剧情和信息保护边界仍有效。写作自检与写后审查沿用下方「写手 A-G 判据」；独立去味沿用「删除优先判断」及各门禁详细步骤。模式解释、三遍法与范例见 [anti-ai-writing.md](anti-ai-writing.md)。
+
+#### 删除优先判断（先于各 Gate）
+
+每条被标记项先判能否删除，再考虑润色——很多 AI 味句是废话（解释、注水、凑数），润色后照样冗余。
+
+1. 删掉后是否丢失伏笔、钩子、角色特征、情节推进、必要信息或必要转折？都不丢则直接删，不进 Gate。
+2. 丢任意一项 → 保留信息进对应 Gate 改写（只删"怎么说"的 AI 味，不删"说什么"）。
+3. 删除服从既有"过度去AI味保护"与「诊断与分级」比例上限：不整段删、不删剧情功能；若删后跌破字数下限，改为降AI重写，不删完再用新废话凑字。
+4. 删完通读：若整段只剩最短句、结构虚词被扫光、每个动作都带「了一下」式尾巴，就是删过头的电报体（见 anti-ai-writing.md 模式 9）——把非峰值叙述句恢复成自然白话，不是接着删。删的是废话，不是中文的自然冗余；这条只调删减的度，禁用词与套路句式的清理力度不因此降低。
+
+以下为各 Gate 的详细规则（删不掉的标记项按此润色；无论 agent 还是主线程执行，均须遵循）：
+
+#### 门禁 A：禁用词替换
+
+加载 [references/banned-words.md](banned-words.md)，对照禁用词表逐项检查。
+
+**白名单机制**：按 [references/style-resolution.md](style-resolution.md) 读取书目录的 `.deslop-whitelist`。获准字面片段由深扫、标点整理和 hook 一致豁免；无文件不创建空表，不因检测器报警自行放行，也不继承其他书的白名单。
+
+**保护规则优先级**：保留创作意图与剧情功能 > 去AI Gate。Gate A-F 只能改变表达方式；Gate G 删的是非故事性的作者解释/旁白（不是情节）。任何 Gate 都不能删除伏笔、钩子、角色特征、人物记忆、情绪承接、因果锚点、关键信息或必要转折；遇到冲突时改为降AI重写或标注 `[需复核]`。
+
+替换规则：
+- 禁用词 → 具体动作/细节描写
+- 不能简单换成另一个形容词
+- 要用"展示"替代"告诉"
+
+示例：
+- ❌ "眼中闪过一丝不易察觉的悲伤" → ✅ "他垂下眼"
+- ❌ "深吸一口气" → ✅ 直接删；若确有功能，改成角色当下动作（如把话咽回去）
+- ❌ "嘴角勾起一抹冷笑" → ✅ "他冷笑了一声"
+
+#### 门禁 B：句式去套路
+
+检测并替换以下AI高频句式：
+
+| 句式 | 问题 | 替代方案 |
+|------|------|----------|
+| 否定铺垫后接肯定翻转 | **最毒** 中文 AI 句式之一 | 直接写后项，或改成动作/细节呈现 |
+| 跨段「不是A / 也不是B / 只是C」 | 可能是工整铺排，也可能是辩解、悬念排除或情绪递进 | `formulaic-parallelism` advisory；通读语境，仅在重复提纲或拖慢画面时压缩 |
+| 「至于X不X，怎么X」/同动词「不V A，不V B」 | 工整决策栏、否定清单；正常台词也可能出现 | 结合语境复核；若只是复述前文或细纲，压成一次判断或只留一项 |
+| "...，带着..." | 万能状语，AI最爱 | 用独立短句或动作描写 |
+| "声音不大，却带着……" | AI 最爱声音描写 | 直接写声音特征或动作 |
+| 陈词滥调/万能比喻 | 公式化比喻会显 AI 腔 | 优先直接白描；确需比喻时只留少数生活化、角色化比喻 |
+| "他/她知道..." | 直接告诉读者 | 用行为展示认知 |
+| 对话标签密度过高/公式化标签 | 每句都标注会机械 | 普通"说"可保留；高频或公式化时用动作/上下文替代 |
+| "仿佛/犹如/宛若/如同" | 文言腔过重 | 口语化表达或白描 |
+| "不容置疑/显而易见" | 书面化判断词 | 用具体事实说话 |
+
+**修饰词清扫**：检查物品/人物前面的形容词、定语、副词、指示代词、量词，多余即删。删除后阅读不影响才删；含义流失则改成简洁名词。
+
+示例：
+- "白色的药片" → "药片"
+- "飞驰的汽车" → "汽车"
+- "手里那截链子" → "链子"
+- "多年的衣服" → "旧衣服"（保留含义）
+
+形容词原则：一次只用一个形容词修饰或不修饰，不连用、不堆砌。
+
+#### 门禁 C：情绪落地
+
+直接写情绪本身不是 AI 味。上下文已让情绪成立，就保留准确的直写或删掉重复说明；需要补足信息时，沿用原文的选择、台词、物件和后果，不为情绪词另配动作。
+
+身体细节按功能取舍：伤势、动作失败、人物习惯或情节后果可以保留；只重复标注情绪的微动作删掉，不换部位或同义动作。具体判据见 `anti-ai-writing.md` 规则 2。
+
+**重复描写去重**：当相邻段反复表达同一信息、同一动作或同一情绪时，按 Gate C/D 处理，不另开专项流程。
+
+处理方法：
+- 合并同一瞬间的重复描写，保留最能推动情绪或剧情的细节
+- 如果原文把一个动作拆成"动作概述 → 感知细节 → 身体反应"，改成同一段连续画面
+- 若合并后节奏过快，恢复原文中有功能的信息，或把既有信息改成更自然的动作/对话表达；不在原动作后追加描写层，也不新增原文没有的情节
+
+示例：
+- ❌ "他拿起笔。手在抖。笔尖又停住。"
+- ✅ "他拿起笔，笔尖刚碰到纸就偏了，手腕压了两次都没压稳。"
+
+**重复语义四类**（同一意思不重复表达，只留一个最合适且简洁的）：
+
+| 类别 | 错误例 | 修法 |
+|------|--------|------|
+| 形容词重复 | "兴高采烈地笑着跑过来" | "笑着跑过来" |
+| 近义词重复 | "非常重要的关键问题" | "关键问题" |
+| 含义重复 | "我好饿，肚子咕咕叫" | "我好饿" |
+| 上下文主语/物品重复 | 上文说"把抗抑郁药扔了一地"，下文不必再写"地上的抗抑郁药"，只写"药片" | 模糊简洁口语化即可 |
+
+**多余场景/人物/物品描写**：服务情节人物之外的修饰描写直接删。
+
+示例：
+- "游惑手里握着一把短刀，刀锋冷冽" → "游惑手里握着一把短刀"
+- "手铐紧紧扣住两人的手腕，中间连着一截不算长的链条" → "手铐扣住两人的手腕，中间连着链条"
+- "暴雪极地的考场里，风雪没有停下的意思" → "暴雪极地的考场里"
+
+#### 门禁 D：节奏调整
+
+AI写作的节奏问题：句式过于整齐、段落过于匀称。
+
+处理方法：
+- 打断连续排比句（保留1-2个，删掉其余）
+- 只拆臃肿修饰、堆叠比喻、抽象总结的长句；改写后叙述仍以逗号长句为主（见 anti-ai-writing.md 规则 3），不要把正常的逗号长句拆成短句串
+- 偶尔用不完整句（口语感）
+- 段落长短交错（不要每段都3-5行）
+- 不按硬指标排版：番茄高分样本不是 50-60 字一行，也不是逢句号必换行；按动作/信息变化自然断段，读起来不卡即可
+- 标点节奏跟语气走：避免通篇句号化；保留有功能的 `？` / 少量 `！`，把 `……` / `——` 改成动作、短句、换行、逗号或句号，删除随机堆砌或刷屏符号
+
+#### 门禁 E：对话去腔调
+
+AI写的对话特征：每句话都信息完整、逻辑清晰、表达精准。
+
+处理方法：
+- 加入口语化表达（"嗯""哦""行吧"）
+- 适当打断对话（角色可以答非所问）；对话被打断或拖长时用动作、换行或短句处理，不用 `——`
+- 用动作穿插对话（"她喝了口水。'然后呢？'"）
+- 删掉解释性对话（角色不会把自己的动机说清楚）
+- Gate B 同样检查台词：连续工整否定、`至于X不X，怎么X`、同动词 `不V A，不V B` 不能因脚本的台词豁免而漏审；有明确人物/任务功能才保留
+- 不为凑比例硬扩台词；番茄对话占比随题材波动，台词只在角色此刻真会说、必须说时增加
+- 口误、停顿、粗话和重复要服务人物身份与情绪，不作为“真人感”装饰批量添加
+- 不把所有对话末尾改成句号：质问保留问号，爆发峰值保留少量感叹；吞回去/没说完用动作停顿、短句或换行，不用 `……`
+
+#### 门禁 F：结尾去升华
+
+AI写作的结尾特征：总想总结、升华、点题。
+
+处理方法：
+- 删掉总结性语句
+- 用动作/场景收尾，不要用感慨收尾
+- 如果结尾有"他知道...""这一刻..."→ 基本可以删
+
+#### 门禁 G：去解释腔/上帝感/安排感
+
+最难察觉、最"像 AI"的一类（对应 anti-ai-writing.md 模式 8）。叙述者跳出角色当下去解释、剧透、总结、定性、升华，读者闻到"作者在场/剧情被安排"。
+
+处理方法：
+- 删解释因果：「之所以…是因为」「原来…」「这意味着」→ 删，因果让读者从动作对话里自己拼。
+- 删上帝视角剧透：「她不知道的是」「殊不知」「多年以后」「仿佛预示着」→ 删。
+- 删替读者定性：「演得真好」「这出戏她看过一遍」「他就是这样薄情」→ 删，证据留给读者判断。
+- 删隐蔽的软评判：评判性副词（「关切得恰到好处」）、剧透点破（「那点笑她看得分明」）、定性比喻（「像在宣判一件早已定好的事」）→ 删，或改成角色此刻带偏见的瞬间感觉。
+- 注意：Gate G 删的是"非故事性的作者旁白"，不是删情节。删完若变薄，靠角色动作/对话补，不补叙述者解说。
+
+**任务卡点修法边界**：任务卡点不是固定公式，也不是通用补流程按钮。原文已有任务、证据、手续、物件缺口时，可以把解释总结压成角色当下要处理的具体卡点；原文没有缺口时，只删解释或改动作/对话，不新造剧情。所有卡点都先做“删掉试试”：删掉后不丢伏笔、钩子、信息、关系变化或必要转折，就压缩或删除。
+
+---
+
+## 写手 A-G 判据
+
+以下为原 narrative-writer 的写作自检/审查判据，调用方给了 Gate 就只执行该范围；未给时仍 A-G。
+
+- **A 禁用词**：命运齿轮/如潮水般/心猛地一沉类逐一替换（对照 `banned-words.md`；书级文风有裁决按其配额）。
+- **B 句式**：连续排比、刻意对称打散；**禁止高置信否定铺垫后再肯定翻转**——同句「不是A，(而)是B」「没有X没有Y只是Z」直接写肯定内容或改动作承担对比；跨段「不是A / 也不是B / 只是C」、`至于X不X，怎么X`、同动词 `不V A，不V B` 只作语义复核（advisory），重复细纲或拖慢画面时改，承担辩解、悬念排除或情绪递进时可保留（书级文风另有裁定按其执行）；普通名词不加引号强调（对话、逐字引用、场内载体原文除外）。
+- **C 情绪**：删空泛 AI 情绪总结句；上下文已成立就删补充说明；不设「情绪词→身体动作」默认转换。
+- **D 节奏**：只拆臃肿修饰、堆叠比喻、信息过载的长句；句长按书级文风带执行，长短随情绪 beat 交错——沉淀放慢、冲突骤短，忌通篇同长度。
+- **E 对话去腔调**：所有角色同一语气→按语言风格档案差异化；犹豫/打断/拖长用动作、短句或换行承担。
+- **F 结尾去升华**：大段抒情收尾→安静细节收尾。
+- **G 去解释腔/上帝感**：先按本书叙述姿态判断；授权的有限全知、评论或旁人内心不因形式删除。删无功能的解释、未经授权的剧透、重复总结和空泛定性（之所以/原来/这意味着/她不知道的是/殊不知/多年以后）；承担锚点或情绪的压成角色白话；已有场内载体（手机/公告/屏幕）优先保留为角色看到的文本。

package/lib/oh-story/skills/story-deslop/references/style-resolution.md

@@ -0,0 +1,27 @@
+# 文风与参考冲突裁决
+
+写正文、改写、去 AI 味和审稿都先做这一步；inline 与 agent 用同一份裁决。无需另建画像或要求作者填写配置。
+
+## 按维度取值，不把整份文件互相覆盖
+
+表达选择按以下顺序取第一个明确、适用的要求：**当前请求 > 本书文风/设定 > 本书 active 作者记忆 > 题材、流程、全局 active 记忆 > 主对标文风 > 题材包与通用 references 默认值**。未声明的维度才向下补齐；本书例外不撤销全局习惯，临时要求不写回长期记忆。
+
+句长、视角、标点、对话落法、情绪直写、修辞、叙述者评论和收尾方式都是表达维度。reference 中的“必须”“禁用”“最高优先级”、示例和检测阈值不使默认写法升级为作者不可覆盖的规则。主对标的低置信观察不压过作者的明确选择。
+
+事实与表达分开裁决：文风不能改变细纲事件、已知事实、信息揭露边界、用户字数范围、改写范围、文件结构或追踪协议；有限全知允许换视角，不等于可提前揭底。转限知时可暂不叙述该人物无从得知的信息，事实本身不变；不得补出“早已知道”“后来发现”或新观察经历来保全原文信息。审稿照常评价因果、可读性与情绪效果，不能仅因使用了作者选定的写法就判错，也不能因为作者喜欢就忽略真实缺陷。
+
+## 加载与传递
+
+1. 从本次正文路径确定书目录（长篇为 `正文/` 的父目录，短篇为 `正文.md` 所在目录）。读该书 `设定/文风.md`；短篇同时读 `设定.md` 的文风约定。无文件就继续，不创建占位文件、不猜其他书。文风无最低字数限制，一句可执行的偏好也有效；空白、纯标题、待补充不算。
+2. `_文风摘要.md` 只能辅助定位，不能独立替代全文。当前会话已读全文时无需反复读；摘要与全文不一致用全文，不让旧摘要压过作者的新修改。
+3. 作者记忆 query 显式传当前书名、已知题材和流程以及需要的 kind，避免只取到 global。只用 active；同一维度窄范围覆盖宽范围，不拼成同时满足的清单。无法判定的同范围冲突才问作者，已能按优先级解决的不询问。
+4. 在现有 prompt 填 `style_resolution`：本次生效的表达要求及来源、被覆盖的默认条款、必须保留的事实/信息边界；只列与任务有关的冲突，无冲突可写“按本书文风”。原样传给正文、去味和文字 reviewer，并传文风全文路径。同一批次复用，当前请求或文风变动时更新。单独调用去味/审稿也执行本步骤，不能靠上一次会话的记忆。
+
+## 检测器如何服从裁决
+
+检测器不理解作者意图。保留现有默认检查；明确采用且有功能的命中，复用**书目录**下的 `.deslop-whitelist`：UTF-8，一行一个原文字面片段，空行和以 `#` 开头的整行注释忽略，不支持正则或通配符。不向父目录找，避免跨书继承。
+
+- 本书文风明确允许某种停顿标点时，可登记 `——` 或 `……`；具体修辞登记完整的获准原句，不能登记“不是”“没有”等泛词来关闭整类检查。
+- 每项用上一行 `# 来源：…；用途：…` 说明当前请求或文风依据。只为执行作者已明确的选择登记，不因脚本报警自动放行。当前请求禁止某写法时移除相冲突的豁免；一次性保留只登记该句，不推断长期习惯。
+- 深扫、标点整理和写后/下一章检查读取同一白名单。豁免只影响对应字面片段的风格检查；同一行其他问题照报，事实、字数、占位、工程词、截断和文件结构检查不豁免。
+- 所选 Gate 仍执行：检查该写法是否重复、冗余、破坏节奏或越过信息边界；有这些具体问题才改。裁决与发现可简短写在正常交付报告中，不写进小说正文。

package/lib/oh-story/skills/story-deslop/scripts/check-ai-patterns.js

@@ -2,6 +2,7 @@
 'use strict';
 
 const fs = require('fs');
+const { loadStyleWhitelist, maskStyleText } = require('./style-whitelist.js');
 const path = require('path');
 
 const USAGE = `Usage: node check-ai-patterns.js [--check] [--json] [--fail-on=blocking|all] <file...>
@@ -30,6 +31,7 @@ Detect high-risk AI-flavor prose patterns that need human rewrite:
   - 章尾状态总结体 (文末窗口 这一夜注定/这一切都结束了/新的人生才刚刚开始/命运的齿轮)
   - 引号强调滥用 (叙述里 1-4 字短词加引号强调，密度型)
 
+Book-local .deslop-whitelist literal spans are excluded from style scanning (no regex or ancestor inheritance).
 Each finding carries severity: blocking by default for generation/deslop cleanup (not-is-comparison / em-dash / voice-contrast / negation-parade / reverse-not-is / trailer-ending / trailer-summary). This is a local style/readability gate, not an AIGC detector score; functional human text can be marked for review instead of hard-edited for a detector.
 或 advisory (period-stutter / long-paragraph / micro-action-tic / stock-reaction-tic / action-list-tic / abstract-summary-tic / cliche-density-tic / metaphor-density-tic / reasoning-chain-tic / system-notice-formality-tic / overcompressed-prose-tic / low-connective-density-tic / quote-emphasis-tic / formulaic-parallelism，是提示，justified 的长推理/氛围段可保留)。
 --fail-on=blocking 只在出现 blocking finding 时退出 1；默认 --fail-on=all 有任何 finding 即退出 1。
@@ -308,7 +310,10 @@ for (const file of options.files) {
     continue;
   }
 
-  const findings = scanDocument(input).map((finding) => ({ file, ...finding }));
+  let whitelist;
+  try { whitelist = loadStyleWhitelist(fullPath); }
+  catch (error) { die(`${file}: unable to read .deslop-whitelist (${error.message})`); }
+  const findings = scanDocument(maskStyleText(input, whitelist)).map((finding) => ({ file, ...finding }));
   allFindings.push(...findings);
 }
 

package/lib/oh-story/skills/story-deslop/scripts/check-degeneration.js

@@ -43,6 +43,17 @@ const PLACEHOLDER_PATTERNS = [
   { re: /我(无法|不能)(继续(写|创作|生成|下去)|生成(内容|文本|正文)?|创作|续写|完成(这个|本)?(章|篇|创作|请求))/, label: '元信息泄漏（生成拒绝语）', hard: false },
 ];
 
+const QUOTED_SPAN_PATTERNS = [
+  /「[^」]*」/g,
+  /『[^』]*』/g,
+  /【[^】]*】/g,
+  /“[^”]*”/g,
+  // 单引号须成对；词内撇号（don't、O’Connor）不作为开闭引号。
+  /(?<![A-Za-z0-9_])‘(?:[^’]|(?<=[A-Za-z0-9_])’(?=[A-Za-z0-9_]))*(?!(?<=[A-Za-z0-9_])’[A-Za-z0-9_])’/g,
+  /"[^"]*"/g,
+  /(?<![A-Za-z0-9_])'(?:[^']|(?<=[A-Za-z0-9_])'(?=[A-Za-z0-9_]))*(?!(?<=[A-Za-z0-9_])'[A-Za-z0-9_])'/g,
+];
+
 // 工程词泄漏（正文元信息扫描的确定性版）：弱模型把写作工程词漏进正文，破坏代入感
 // （DeepSeek-v4 这类会在对话里冒「该到下一章了」）。漏词的模型自己发现不了，靠脚本兜。
 // tier1 = 纯写作流水线术语，正文里几乎永不合法；tier2 = 章节结构/歧义词，角色在故事内
@@ -150,21 +161,23 @@ function isContent(trimmed) {
   return trimmed && !trimmed.startsWith('#') && !/^-{3,}$/.test(trimmed);
 }
 
-function isDialogueLike(trimmed) {
-  return /[“”"'‘’「」『』【】]/.test(trimmed);
+// 等长遮住成对引号内的内容以保留列号；未闭合引号不豁免。
+function maskQuotedSpans(text) {
+  let masked = text;
+  for (const pattern of QUOTED_SPAN_PATTERNS) {
+    masked = masked.replace(pattern, (match) => ' '.repeat(match.length));
+  }
+  return masked;
 }
 
 // 去掉成对引号内的片段（台词/系统词/引用物件），只留引号外叙述。复读判定用：重复台词是体裁
 // 手法（豁免），但「叙述 + 引号内物件/短台词」混合行里引号外叙述的复读仍是退化，不能整行豁免。
 function stripQuoted(text) {
-  return text
-    .replace(/「[^」]*」/g, '')
-    .replace(/『[^』]*』/g, '')
-    .replace(/【[^】]*】/g, '')
-    .replace(/“[^”]*”/g, '')
-    .replace(/‘[^’]*’/g, '')
-    .replace(/"[^"]*"/g, '')
-    .replace(/'[^']*'/g, '');
+  let stripped = text;
+  for (const pattern of QUOTED_SPAN_PATTERNS) {
+    stripped = stripped.replace(pattern, '');
+  }
+  return stripped;
 }
 
 function visibleLength(text) {
@@ -253,18 +266,19 @@ function findPlaceholders(content) {
   const findings = [];
   for (const { trimmed, lineNo } of content) {
     if (!isContent(trimmed)) continue;
-    const dialogue = isDialogueLike(trimmed);
+    const outsideQuotes = maskQuotedSpans(trimmed);
     for (const { re, label, hard } of PLACEHOLDER_PATTERNS) {
-      if (!hard && dialogue) continue; // soft 拒绝语在对话行里可能是正常台词，豁免
-      const m = re.exec(trimmed);
+      // hard 信号仍扫描整行；soft 自指/拒绝语只扫描成对引号外，且遮罩等长以保留列号。
+      const m = re.exec(hard ? trimmed : outsideQuotes);
       if (m) {
+        const index = m.index || 0;
         findings.push({
           line: lineNo,
-          column: (m.index || 0) + 1,
+          column: index + 1,
           type: 'placeholder-leak',
           severity: 'blocking',
           message: `${label}：正文混入元信息/拒绝语/占位符，重写本段干净落地。`,
-          excerpt: compact(trimmed.slice(Math.max(0, (m.index || 0) - 4), (m.index || 0) + 20)),
+          excerpt: compact(trimmed.slice(Math.max(0, index - 4), index + 20)),
         });
         break; // one finding per line is enough
       }
@@ -283,17 +297,22 @@ function findMetaLeak(content) {
       // 标题行（第N章 章名，无 ## 前缀时也算）属「标题行以外的正文」之外，排除
       if (/^第[一二三四五六七八九十百千万两0-9]+章/.test(trimmed)) continue;
     }
-    const dialogue = isDialogueLike(trimmed);
-    let m = META_TIER1_RE.exec(trimmed);
+    const outsideQuotes = maskQuotedSpans(trimmed);
+    let m = META_TIER1_RE.exec(outsideQuotes);
+    let quotedTier1 = false;
+    if (!m) {
+      m = META_TIER1_RE.exec(trimmed);
+      quotedTier1 = Boolean(m);
+    }
     if (m) {
       // tier1 纯工程词正文里几乎永不合法→blocking；但写手/编剧题材里角色在故事内真讨论创作，
-      // 台词（对话行）里可能合法，降级为 advisory（仍报告，交人/LLM 判，不强制回炉）。
+      // 且命中实际位于成对引号内时可能合法，降级为 advisory。同一行别处出现引号不影响判定。
       findings.push({
         line: lineNo,
         column: m.index + 1,
         type: 'meta-leak',
-        severity: dialogue ? 'advisory' : 'blocking',
-        message: `工程词泄漏：「${m[0]}」是写作流水线术语，正文里不该出现；改成角色/场景内表达。${dialogue ? '例外：角色为作者/编剧、在故事内真实讨论创作时，台词里可能合法。' : ''}`,
+        severity: quotedTier1 ? 'advisory' : 'blocking',
+        message: `工程词泄漏：「${m[0]}」是写作流水线术语，正文里不该出现；改成角色/场景内表达。${quotedTier1 ? '例外：角色为作者/编剧、在故事内真实讨论创作时，台词里可能合法。' : ''}`,
         excerpt: compact(trimmed.slice(Math.max(0, m.index - 6), m.index + 18)),
       });
       continue; // tier1 命中即可，不再叠 tier2

package/lib/oh-story/skills/story-deslop/scripts/normalize-punctuation.js

@@ -2,6 +2,7 @@
 'use strict';
 
 const fs = require('fs');
+const { loadStyleWhitelist, styleSpans } = require('./style-whitelist.js');
 const path = require('path');
 
 const USAGE = `Usage: node normalize-punctuation.js [--check] [--quote-mode keep|ascii|yan] <file...>
@@ -9,6 +10,7 @@ const USAGE = `Usage: node normalize-punctuation.js [--check] [--quote-mode keep
 Normalize正文 punctuation deterministically:
   - replace ellipses, em dashes, and double hyphens with Chinese punctuation
   - remove markdown divider lines (---) from正文
+  - preserve pause punctuation covered by book-local .deslop-whitelist literals
   - keep quote style by default; convert quotes only when explicitly requested
 `;
 
@@ -61,7 +63,10 @@ for (const file of options.files) {
     continue;
   }
 
-  const result = normalizeDocument(input, options.quoteMode);
+  let whitelist;
+  try { whitelist = loadStyleWhitelist(fullPath); }
+  catch (error) { die(`${file}: unable to read .deslop-whitelist (${error.message})`); }
+  const result = normalizeDocument(input, options.quoteMode, whitelist);
   totalFindings += result.findings.length;
 
   if (options.check) {
@@ -94,7 +99,7 @@ function die(message) {
   process.exit(2);
 }
 
-function normalizeDocument(input, quoteMode) {
+function normalizeDocument(input, quoteMode, whitelist) {
   const { lines, endings } = splitLinesKeepingEndings(input);
 
   const findings = [];
@@ -159,7 +164,7 @@ function normalizeDocument(input, quoteMode) {
     }
 
     const commentOpenBefore = commentOpen;
-    const punctuationResult = normalizePausePunctuation(line, lineNo, commentOpen);
+    const punctuationResult = normalizePausePunctuation(line, lineNo, commentOpen, whitelist);
     findings.push(...punctuationResult.findings);
     line = punctuationResult.line;
     commentOpen = punctuationResult.commentOpen;
@@ -237,7 +242,7 @@ function isClosingFence(line, fence) {
 // 一遍归一化留不干净，再跑一遍还会改已定稿的正文；所以反复归一化到不动点。
 // 每遍至少把一个 `…/./—/-` 换成非停顿字符，字符数严格递减，必然收敛。
 // findings 只留第一遍：同一处不重复计数，column 也仍然是原行的偏移。
-function normalizePausePunctuation(line, lineNo, commentOpen) {
+function normalizePausePunctuation(line, lineNo, commentOpen, whitelist) {
   let current = line;
   let findings = null;
   let commentOpenAfter = commentOpen;
@@ -245,7 +250,7 @@ function normalizePausePunctuation(line, lineNo, commentOpen) {
   for (;;) {
     const comments = htmlCommentSpans(current, commentOpen);
     commentOpenAfter = comments.open;
-    const pass = normalizePausePunctuationPass(current, lineNo, comments.spans);
+    const pass = normalizePausePunctuationPass(current, lineNo, comments.spans.concat(styleSpans(current, whitelist)));
     if (findings === null) findings = pass.findings;
     if (pass.line === current) break;
     current = pass.line;

package/lib/oh-story/skills/story-deslop/scripts/style-whitelist.js

@@ -0,0 +1,39 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+// Book-local only: never inherit an unrelated workspace or another book's choices.
+function loadStyleWhitelist(file) {
+  const parent = path.dirname(path.resolve(file));
+  const book = path.basename(parent) === '正文' ? path.dirname(parent) : parent;
+  try {
+    return fs.readFileSync(path.join(book, '.deslop-whitelist'), 'utf8')
+      .split(/\r?\n/).map(line => line.trim())
+      .filter(line => line && !line.startsWith('#'))
+      .sort((a, b) => b.length - a.length);
+  } catch (error) {
+    if (error.code === 'ENOENT') return [];
+    throw error;
+  }
+}
+
+function styleSpans(text, whitelist) {
+  const spans = [];
+  for (const literal of whitelist) {
+    for (let at = text.indexOf(literal); at !== -1; at = text.indexOf(literal, at + 1)) {
+      spans.push([at, at + literal.length]);
+    }
+  }
+  return spans;
+}
+
+function maskStyleText(text, whitelist) {
+  const chars = text.split('');
+  for (const [start, end] of styleSpans(text, whitelist)) {
+    chars.fill('？', start, end);
+  }
+  return chars.join('');
+}
+
+module.exports = { loadStyleWhitelist, styleSpans, maskStyleText };

package/lib/oh-story/skills/story-import/SKILL.md

@@ -14,7 +14,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 > Agent 兼容性：只检查当前运行时的 canonical 目录：Claude `.claude/agents/{agent}.md`、OpenCode `.opencode/agents/{agent}.md`、Codex `.codex/agents/{agent}.toml`、Antigravity `.agents/agents/agent-name/agent.md`（`agent-name` 为目标 agent 名），不得因其他端文件存在而误判。Codex 使用同名 `agent_type`；Antigravity 使用 `invoke_subagent` + `TypeName`。对应运行时未暴露 custom-agent registry / `invoke_subagent` 或返回未知 agent 时，必须降级 solo/direct。检测到 `.zcode/` 时同样直接 solo/direct，因为 ZCode 3.3.4 不执行项目 custom agents；报告 `Fallback: project custom agents unavailable -> solo`。Claude/OpenCode 兼容面保留 `subagent_type`。
 >
-> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 29` 不一致时（标记缺失、字段缺失/非整数、小于或大于 29）**照常按文件存在性检查并 spawn**，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 29）` 并提示重新运行 `/story-setup` 后新开会话；大于 29 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 30` 不一致时（标记缺失、字段缺失/非整数、小于或大于 30）**照常按文件存在性检查并 spawn**，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 30）` 并提示重新运行 `/story-setup` 后新开会话；大于 30 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
 
 ## 核心原则
 
@@ -54,7 +54,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 1. 数清最后一个完整章号 `N`（`正文/第NNN章_*.md` 的最大值）。
 2. 从旧 `追踪/` 现有文件（角色状态、伏笔、时间线等，文件名按项目实际情况）和最近 3-5 章正文，重建当前状态：核心角色快照、未回收伏笔、已揭示时间线事件、长期约束、下一章承诺。角色快照的反推方法见 [references/character-state-reverse.md](references/character-state-reverse.md)。
-3. 按 [references/tracking-transaction.md](references/tracking-transaction.md) 的初始化事务格式构造 JSON，`last_chapter` 写 `N`（第 1..N 章不伪造逐章记录），执行 `tracking_commit.py init`。
+3. 完整读取 [references/tracking-initialization.md](references/tracking-initialization.md)，按其初始化事务格式构造 JSON，`last_chapter` 写 `N`（第 1..N 章不伪造逐章记录），执行 `tracking_commit.py init`。
 4. `init` 会把旧追踪结构按原样整体移入 `追踪/_旧追踪存档/` 再建当前协议——旧内容不删除、不参与解析，留给作者查阅。
 5. 跑 `tracking_commit.py check` 确认通过，再回 `/story-long-write 日更` 续写。
 

package/lib/oh-story/skills/story-import/references/format-and-structure.md

@@ -108,7 +108,7 @@
 
 执行规则：
 - 写对话时先看角色关系和权力位置：强势角色常短句收束，试探角色多问号和半句，崩溃角色才允许少量感叹/省略。
-- 写叙述时用句长、逗号停顿和单句成段制造节奏；不要把破折号当节奏工具，对话里也不要用。
+- 写叙述时用句长、逗号停顿和单句成段制造节奏；默认不用破折号硬造节奏；本书文风明确授权的功能性用法保留。
 - 精修时检查两类问题：**通篇句号化**（语气全被压平）与**随机标点堆砌**（问号/感叹号不承载情绪功能，或用省略号/破折号硬造停顿）。
 - 引号风格按项目/平台约定；知乎盐言的 `「」` 是合法对话格式，`quote-mode keep` 时不得擅自改掉。
 
@@ -163,6 +163,6 @@
 3. **避免对话标签机械化**：高频或公式化的「他说」「她道」「他笑了笑说」用动作/上下文替代；普通“说”可保留
 4. **禁止缩进**：不使用 `　　`（全角空格）或半角空格缩进
 5. **禁止正文段落 Markdown 渲染**：除统一的小节/章节标记（如 `###1.`）外，正文段落中不使用加粗 `**`、斜体 `*`、标题 `#`、分隔线 `---` 等 Markdown 语法
-6. **正文不使用破折号**：正文（含叙述、对话、心理描写）不使用破折号 `——`/`—` 或双连字符 `--`，改用句号、逗号、换行、动作 beat 或短句断开；不再设置“对话例外”
+6. **默认停顿写法**：正文默认用句号、逗号、换行、动作 beat 或短句承担停顿；本书明确选择的功能性破折号/省略号按调用方文风裁决与书级白名单保留。标点偏好不属于不可覆盖的文件结构协议。
 7. **禁止通篇句号化或随机标点堆砌**：标点必须跟语气/人物声线/情绪功能匹配；该质问时用问号，该爆发时少量感叹；犹豫、吞咽、未说完用动作或句长变化表达，不用 `……` / `——` 硬造停顿，也不得无功能地乱撒 `？`/`！`
 8. **禁止正文混入章节元信息**：章节号只允许出现在标题/小节标记/文件名/追踪记录中。正文叙述、对话、心理描写里不得出现 `第[一二三四五六七八九十百千万两0-9]+章|上一章|上章|前一章|本章|这一章|前文|后文|伏笔|细纲|读者` 这类写作工程词；要改成角色能感知的事件锚点或相对时间，例如把“比第一章那三秒开火更疼”改成“比那三秒开火更疼”。例外：角色在故事世界内真实阅读/讨论“第X章”文本，或真实身为作者/读者并谈论读者身份时，可保留相应词。

package/lib/oh-story/skills/story-import/references/tracking-initialization.md

@@ -0,0 +1,31 @@
+# 追踪初始化事务
+
+## 初始化事务
+
+新书从第 0 章初始化。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
+
+```json
+{
+  "schema_version": 1,
+  "book_title": "让你管账号，你高燃混剪炸全网",
+  "last_chapter": 0,
+  "context": {
+    "position": {
+      "volume": "第一卷·军宣整顿",
+      "volume_start_chapter": 1,
+      "story_time": "江晨到火箭军文工团报到前",
+      "scene": "火箭军文工团"
+    },
+    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
+    "active_character_names": [],
+    "continuity_risks": [],
+    "recent_chapters": [],
+    "next_chapter_commitments": ["让江晨报到，并落下五天百万粉的新手任务"]
+  },
+  "character_snapshots": {},
+  "foreshadow": [],
+  "timeline_events": []
+}
+```
+
+导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。

package/lib/oh-story/skills/story-import/references/tracking-transaction.md

@@ -20,14 +20,13 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 ```text
 {PYTHON} {当前 skill 根}/scripts/tracking_commit.py init   --project {书项目根} --input {初始化事务.json}
 {PYTHON} {当前 skill 根}/scripts/tracking_commit.py check  --project {书项目根}
-{PYTHON} {story-long-write skill 根}/scripts/storyctl.py wordcount checkpoint --file {前半段临时文件} --target {目标} --chapter {N}
 {PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter check   --project {书项目根} --chapter {N}
 {PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter commit  --project {书项目根} --chapter {N} --input {逐章事务.json}
 {PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter accept-current-length --project {书项目根} --chapter {N} --input {逐章事务.json}
 ```
 
 - `init`：只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
-- `wordcount checkpoint`：纯测量；返回当前实际字数、用户带与剩余用户区间，不写正文、不写 tracking、不做语义判断。每章最多调用一次。
+- `wordcount measure` / `wordcount checkpoint`：纯测量入口；不写正文、不写 tracking、不做语义判断。长篇正文流程一次写完整章，**不在章中调用测量**，长度由 `chapter check` 一次收口；这两个入口供导入、审查等其他场景使用。
 - `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及进入内带/用户带所需的机器删除区间。
 - `chapter commit`：再次读取当前文件、重新计数并重跑 blocking quality；只接受用户带内章节，把简短字数记录与逐章事务一起原子提交。
 - `chapter accept-current-length`：只接受带外但 quality pass 的章节；接受动作发生时重新读取、重新计数并立即原子提交，不保存可陈旧的历史决议。
@@ -43,33 +42,7 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 
 ## 初始化事务
 
-新书从第 0 章初始化。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
-
-```json
-{
-  "schema_version": 1,
-  "book_title": "让你管账号，你高燃混剪炸全网",
-  "last_chapter": 0,
-  "context": {
-    "position": {
-      "volume": "第一卷·军宣整顿",
-      "volume_start_chapter": 1,
-      "story_time": "江晨到火箭军文工团报到前",
-      "scene": "火箭军文工团"
-    },
-    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
-    "active_character_names": [],
-    "continuity_risks": [],
-    "recent_chapters": [],
-    "next_chapter_commitments": ["让江晨报到，并落下五天百万粉的新手任务"]
-  },
-  "character_snapshots": {},
-  "foreshadow": [],
-  "timeline_events": []
-}
-```
-
-导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。
+仅新书或导入初始化时，执行 `init` 前必须完整读取 [tracking-initialization.md](tracking-initialization.md)，按其中原始 JSON 与导入边界构造事务。已有项目续写直接使用下方逐章事务，不重复读初始化示例。
 
 调用方的逐章 JSON 不写 `wordcount`；正式入口 `chapter commit` 或 `chapter accept-current-length` 在提交当下生成并注入。最终 state 只为已提交章节保留 `metric / target / actual / status / resolution / body_sha256`，不保存 MEASURE/RESOLVE 事件、ID 链、policy fingerprint 或独立 chapter state。