@oh-story/dsh 0.1.8 → 0.1.9

package/lib/oh-story/skills/story-review/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-review/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-review/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。
 

package/lib/oh-story/skills/story-review/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-review/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-review/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-review/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-setup/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: story-setup
 version: 1.2.10
-description: "网文写作工具集基础设施部署。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配；Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」。"
+description: "网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配；Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。"
 metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
 ---
 # story-setup：网文写作工具集基础设施部署
@@ -10,6 +10,11 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 **执行铁律：不覆盖用户已有配置，合并而非替换。**
 
+## 选择模式
+
+- 参数为 `check`，或用户只要求检查部署、诊断环境、排查 agent 不可用时：完整读取 [references/diagnostics.md](references/diagnostics.md)，按其中流程仅检查并报告；不进入下面的部署流程。
+- 用户要求安装、更新或修复时：执行下面的部署流程。检查后已明确授权的修复沿用本文件的部署与合并规则。
+
 ---
 
 ## Phase 1：检测项目状态
@@ -19,9 +24,9 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 > 判据是「有没有 `SKILL.md`」：只看正在执行的 `SKILL.md` 同级的 `references/`。项目内 `.claude/skills/story-setup/`、`.codex/skills/story-setup/` 和 OpenCode 的 `skills/story-setup/` 只有 `references/agent-references/`、不含 `SKILL.md`，不会是执行目录，也不要拿它们核对。Antigravity / ZCode / OpenClaw / Reasonix / generic 的项目副本是整份 skill 拷贝、自带 `SKILL.md`，9 个子目录本就齐全，照常核对即可。
 
 1. 检查当前目录是否已部署过（存在 `.story-deployed`）
-   - `agents_version` 缺失、非整数或小于 `29` → 标记为待更新，继续执行当前部署
-   - `agents_version: 29` → 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用**当前本地 skill 包**刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（`npx skills add` 或 marketplace），再回来重跑
-   - `agents_version` 大于 `29` → 当前 story-setup 比项目部署旧；停止以避免降级覆盖，提示先更新 oh-story-claudecode，不写任何部署文件
+   - `agents_version` 缺失、非整数或小于 `30` → 标记为待更新，继续执行当前部署
+   - `agents_version: 30` → 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用**当前本地 skill 包**刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（`npx skills add` 或 marketplace），再回来重跑
+   - `agents_version` 大于 `30` → 当前 story-setup 比项目部署旧；停止以避免降级覆盖，提示先更新 oh-story-claudecode，不写任何部署文件
    - 同时读 `target_cli` 字段。**已部署项目以 sentinel 里的值为准**：非空时（逗号分隔的多端组合原样保留）跳过下面第 5-12 步的环境探测与选择，直接按这些端重新部署。只有字段缺失或为空，才回落到探测。用户明确要求增删目标端时，用 AskUserQuestion 在现有值基础上改，改完的值写回 sentinel。
 2. 检查是否有书名目录（包含 `追踪/` 子目录的目录，或用户自定义结构）
    - 有 → 识别为长篇项目，显示当前项目信息
@@ -372,7 +377,7 @@ Reasonix（DeepSeek-Reasonix CLI）当前只部署 skills 与 `AGENTS.md`，不
 - 写入以下字段（YAML `key: value` 格式，hook 用 `references/templates/hooks/lib/sentinel.sh` 读取）：
   ```
   deployed_at: <date -u +"%Y-%m-%dT%H:%M:%SZ">
-  agents_version: 29
+  agents_version: 30
   setup_skill_version: 1.2.10
   target_cli: claude-code（或 opencode、codex、antigravity、zcode、openclaw、reasonix、generic，或其任意组合）
   resolver_strategy: project-local-skill-reference
@@ -380,10 +385,12 @@ Reasonix（DeepSeek-Reasonix CLI）当前只部署 skills 与 `AGENTS.md`，不
   ```
 - 此文件供 session-start.sh 和写作 skill 检测部署状态，避免重复提示
 - target_cli 含 claude-code 时，同时创建一次性标记文件 `.claude/.agents-pending-restart`（空文件即可）。session-start.sh 在下一个会话启动时据此确认 agents 已随新会话注册，并自动删除该标记——用来向用户确认「重启已生效」。ZCode 不创建该标记，因为它不部署项目 agents。
-- 如果 `.story-deployed` 已存在但 `agents_version` 缺失、非整数或小于 `29`，按本次流程更新 hooks/agents/rules/reference bundle（具体变更见 `UPGRADING.md`）；大于 `29` 时已在 Phase 1 停止，不得降级覆盖
+- 如果 `.story-deployed` 已存在但 `agents_version` 缺失、非整数或小于 `30`，按本次流程更新 hooks/agents/rules/reference bundle（具体变更见 `UPGRADING.md`）；大于 `30` 时已在 Phase 1 停止，不得降级覆盖
 
 ## Phase 3：验证安装
 
+按 `.story-deployed.target_cli` 选择对应端的检查：第 1–4 项仅用于 Claude Code，第 5 项是所有端共有的部署标记检查，第 6 项是部署报告，第 7–13 项按目标端各选其一。仅检查模式复用第 1–5 项与对应端的第 7–13 项，跳过第 6 项，且其中要求实际执行 hook 或写入 fixture 的子项改为只做静态校验（文件存在、语法有效、注册项齐全），不运行会写入项目的 hook，也不创建部署标记。
+
 1. 验证 hooks 注册：
    - 检查 `.claude/settings.local.json` 中的 hooks 字段是否正确
    - 检查 `.claude/hooks/` 下的脚本是否存在且有执行权限
@@ -396,7 +403,7 @@ Reasonix（DeepSeek-Reasonix CLI）当前只部署 skills 与 `AGENTS.md`，不
    - 检查 `.claude/skills/story-setup/references/agent-references/` 下 reference 文件完整
    - 检查所有 `story-setup/references/agent-references/<file>.md` 都能解析到 deployed bundle
 5. 验证部署标记：
-   - 检查 `.story-deployed` 是否存在且包含时间戳、`agents_version: 29`、`setup_skill_version: 1.2.10`、`target_cli`、`resolver_strategy`、`references_dir`
+   - 检查 `.story-deployed` 是否存在且包含时间戳、`agents_version: 30`、`setup_skill_version: 1.2.10`、`target_cli`、`resolver_strategy`、`references_dir`
 6. 输出安装报告：
    - 列出所有已部署的文件
    - 列出需要注意的事项（如已有配置已合并）
@@ -509,9 +516,9 @@ Reasonix（DeepSeek-Reasonix CLI）当前只部署 skills 与 `AGENTS.md`，不
 ## 重新部署
 
 - `.story-deployed` 不存在 → 全新安装，Phase 2 全部执行
-- `.story-deployed` 存在且 `agents_version: 29` → 提示已部署，AskUserQuestion 确认是否重新部署；提示里写明重新部署只用当前本地 skill 包刷新项目文件，skill 本身的更新走 `npx skills add` 或 marketplace
-- `.story-deployed` 存在但 `agents_version` 缺失、非整数或小于 `29` → 提示需要更新，重新执行 Phase 2 覆盖 agents/hooks/rules/reference bundle，CLAUDE.md / AGENTS.md / settings.local.json / .codex/hooks.json / `.agents/hooks.json` / .zcode/config.json 走合并策略
-- `.story-deployed` 存在且 `agents_version` 大于 `29` → 当前 skill 版本过旧，停止并提示先更新 oh-story-claudecode；不覆盖项目中的更新部署
+- `.story-deployed` 存在且 `agents_version: 30` → 提示已部署，AskUserQuestion 确认是否重新部署；提示里写明重新部署只用当前本地 skill 包刷新项目文件，skill 本身的更新走 `npx skills add` 或 marketplace
+- `.story-deployed` 存在但 `agents_version` 缺失、非整数或小于 `30` → 提示需要更新，重新执行 Phase 2 覆盖 agents/hooks/rules/reference bundle，CLAUDE.md / AGENTS.md / settings.local.json / .codex/hooks.json / `.agents/hooks.json` / .zcode/config.json 走合并策略
+- `.story-deployed` 存在且 `agents_version` 大于 `30` → 当前 skill 版本过旧，停止并提示先更新 oh-story-claudecode；不覆盖项目中的更新部署
 
 ---
 

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

@@ -1,5 +1,7 @@
 # 去AI味完整指南
 
+> 本文件的句长、视角、标点、修辞与禁用词是默认写法，服从 [style-resolution.md](style-resolution.md) 的逐维裁决。所选 Gate 检查表达效果，不因作者有意选择某写法就机械删除；获准命中按书级 `.deslop-whitelist` 处理。
+
 <!-- 同名副本×5 字节同步，改动后跑 scripts/check-shared-files.sh -->
 
 > 识别AI写作指纹、系统性去AI三遍法、禁用词约束、改写范例库。用于正文写作后做去AI味自检和改写时查阅。
@@ -105,18 +107,11 @@
 
 ### 规则 2：动作 + 对话 + 情绪反应
 
-三要素循环推进，不要单写心理活动超过 2 段：
+动作、对话与情绪反应按场景需要交织，不按固定顺序轮换，不为凑齐三项补反应。
 
-```
-动作 -> 对话 -> 情绪反应 -> 动作 -> 对话 -> ……
-```
+情绪没有固定译法，关键节点也可以准确直写。上下文已让情绪成立，不另补反应；需要补足信息时，优先选择、台词、策略、物件或实际后果。
 
-情绪不用"他感到/他觉得"，用身体反应和行为表现：
-- 不写"他很紧张" -> 写"手心全是汗，筷子差点掉了"
-- 不写"她很愤怒" -> 写"她把杯子摔在地上，碎片弹到脚背上也没弯腰捡"
-- 不写"他很伤心" -> 写"他在车里坐了二十分钟才发动引擎"
-
-以上替换针对关键情绪节点；低强度过场情绪可一笔直写（"他有点烦"），不必处处外化。
+身体细节只有带来新信息、影响动作或体现人物与场景特点时才保留。只在句尾重复标注情绪的微动作删掉，不换部位或同义动作。去味时沿用原文已有事实，不凭空添加摔杯子、攥袖口等行为。
 
 ### 规则 3：句子该多长（短句是工具，不是默认）
 
@@ -157,7 +152,7 @@
 1. 用行为代替形容词
 2. 用细节代替总结
 3. 用对话代替旁白说明
-4. 用反应代替情绪词
+4. 用后果代替情绪总结
 
 ---
 
@@ -219,8 +214,7 @@
 > 完整禁用词表和句式模板见 [banned-words.md](banned-words.md)
 
 ### 正确替代示例
-- '他感到一丝紧张' -> '他的手在抖'
-- '她很伤心' -> '她背过身，把袖口攥皱了'
+- '他感到一丝紧张，手心全是汗' -> '他签名时划破了纸'（身体细节只在造成后果时留）
 - '"好的。"他说道' -> '"好的。"他把门卡塞回口袋'
 - '他深吸一口气' -> '他把话咽回去'
 
@@ -276,7 +270,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 | 解释因果 | 「之所以…是因为」「原来…」「这意味着」「正是因为」-> 删。因果只从角色动作、对话、反应里让读者自己拼 |
 | 上帝视角剧透 | 「她不知道的是」「殊不知」「多年以后」「冥冥之中」「仿佛预示着」-> 删。只写角色此刻知道的，悬念让读者自己悬 |
 | 替读者下结论/定性 | 「演得真好」「这出戏她看过一遍」「他就是这样薄情的人」-> 删。把证据（神态、动作、台词）摆出来，定性留给读者 |
-| 替角色总结心理 | 「她明白，这一切都是命」-> 换成一句带偏见的闪念或一个身体反应 |
+| 替角色总结心理 | 「她明白，这一切都是命」-> 无新增信息就删；确有角色判断时保留带偏见的闪念，不强配身体反应 |
 | 总结/动机/评价链把意义说满 | 「他终于明白」「这是最好的选择」「所有人都会记住这一刻」-> 删掉定性，改成角色当下要处理的具体缺口、未完成动作或局部反馈；不是保留评价再硬塞物件/动作 |
 | 安排感/硬铺垫 | 为后文强行交代背景、整段回忆倒叙 -> 背景按角色此刻真实所需，用闪念、半句话、物件零碎带出，不集中交代 |
 | 升华式收尾 | 结尾对仗拔高、金句点题 -> 用一个动作或一句留白收住，把"意思"压进画面里 |
@@ -315,7 +309,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 
 自检：删完连读一遍，读感像提纲或流水口令，就是删过了——把非峰值句恢复成自然白话，不是接着删。
 
-本模式约束的是删减的度，不降低清理力度：禁用词、套路句式、告知式心理照删照改，模式 1-8 与 Gate A-G 全额执行；回填只回结构虚词和连接，不保留、不恢复任何模板措辞。
+本模式约束的是删减的度，不降低清理力度：选定 Gate 内的禁用词、套路句式、告知式心理照删照改；回填只回结构虚词和连接，不保留、不恢复任何模板措辞。
 
 ### 模式 10：二修伪自然（油腻倒装 / 监控动作清单 / 对话指标化）
 
@@ -381,7 +375,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 ## 系统性去AI三遍法
 
 ### Pass 1：去泛化（Strip Generic）
-- 抽象情绪总结句 -> 删或替换为具体动作
+- 抽象情绪总结句 -> 按规则 2 判断：删重复说明，保留准确直写，需要时用原文已有信息落地
 - 假深度句 -> 删
 - 意义膨胀 -> 缩小到具体影响
 - 空洞结论 -> 删
@@ -411,13 +405,9 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 
 **原则**：少即是多。每段加 1-2 个具体细节就够了。
 
-### 升级策略
+### 执行范围
 
-| AI味程度 | 策略 |
-|----------|------|
-| 轻度 | 只做 Pass 1 |
-| 中度 | Pass 1 + Pass 2 |
-| 重度 | 完整三遍 + 重点段落重写 |
+调用方指定 Gate 时，只处理选定 Gate；三遍法只安排顺序，不重新分级或扩大范围。未指定范围时，按实际问题选择适用检查。
 
 ### 自检清单
 - 对话自然度检查：对话是否使用口语化表达，是否避免了书面语/正式腔调
@@ -456,31 +446,13 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 
 ## 改写范例库
 
-### 情绪外化范例
-
-**紧张**
-- '他感到一阵紧张，心跳不由自主地加快了'
-- 他攥紧了手里的纸杯，水洒出来一些
+### 情绪落地示例
 
-**愤怒**
-- '愤怒在他心中燃烧，他不由得握紧了拳头'
-- 他把筷子往桌上一拍，碗里的汤溅了出来
-
-**悲伤**
-- '一丝悲伤涌上心头，她的眼中闪过泪光'
-- 她低头搅着咖啡，搅了很久
-
-**害怕**
-- '恐惧瞬间笼罩了他，他感到一阵战栗'
-- 他的背贴在墙上，不敢动
-
-**失望**
-- '她感到一丝失落，心仿佛被什么东西揪住了'
-- "哦。"她把手机锁了屏
-
-**惊讶**
-- '他的瞳孔微微收缩，显然没有想到会听到这样的话'
-- 他张了张嘴，什么都没说出来
+| 原文与语境 | 处理 |
+|---|---|
+| 「他很紧张。再错一题，补考也过不了。」 | 情绪有具体原因，可以直写，不补手抖或出汗 |
+| 「她已经决定不再等他。她攥了攥袖口。」袖口动作无后续作用 | 删除第二句，不换成低头或咬唇 |
+| 「手腕的伤让他握不住笔，签名只写了一半。」 | 保留，身体状态造成动作失败，不能当作情绪套话删除 |
 
 ### 场景描写范例
 
@@ -571,7 +543,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 - [ ] **无书面语连词堆砌**：无"于是乎/与此同时/从而/因而/诚然"泛滥
 - [ ] **章尾无总结升华**：用动作/对话/悬念收束，无感悟/哲理/预告
 - [ ] **无大段心理描写**：心理活动不超过2段，无括号标注内心
-- [ ] **情绪用动作展示**：关键情绪节点无直接写"愤怒/伤心/紧张"，用身体反应替代；低强度过场情绪可一笔直写，不必处处外化
+- [ ] **情绪落地**：按规则 2 保留准确直写与有功能的身体细节，删除重复说明，不给每个情绪词配动作
 - [ ] **对话口语化**：无书面腔，不同角色语气可区分
 - [ ] **标点不压平**：没有把质问、爆发、犹豫全部压成句号；也没有随机堆砌 `？`/`！`，或用 `……`/`——` 硬造停顿
 - [ ] **Show Don't Tell**：用行为代替形容词，用细节代替总结

package/lib/oh-story/skills/story-setup/references/agent-references/banned-words.md

@@ -1,8 +1,10 @@
 # AI味禁用词与句式表
 
+> 表达默认值服从 [style-resolution.md](style-resolution.md)；文件结构与事实约束不豁免。
+
 <!-- 同名副本×6 字节同步，改动后跑 scripts/check-shared-files.sh -->
 
-## 最毒禁用句式（出现即修，最高优先级）
+## 默认优先检查的句式（先对照本书文风）
 
 写网文最毒的 AI 句式，作者一旦养成就会反复出现。Gate A 第一遍扫描必须命中：