@oh-story/dsh 0.1.3 → 0.1.5

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

@@ -13,6 +13,7 @@ Detect high-risk AI-flavor prose patterns that need human rewrite:
   - repeated negative setup followed by positive flip
   - em-dash (按功能改写), 碎句号 (连续短叙述句), 长段落 (按镜头断段)
   - 微动作复读 (「了下/了一下」式轻量补语高密度，电报体指纹)
+  - 套式反应细节 (指尖/指节/目光等无功能微动作与「平静得像在念」式语气比喻成片)
   - 抽象总结复读 (命运/棋局/这一刻终于明白/才刚刚开始，AI 结尾腔)
   - 套词密度过高 (仿佛/一丝/深吸一口气/平静无波等禁用词聚集)
   - 比喻密度过高 (像/好像/仿佛/如同等比喻标记成片复现)
@@ -30,7 +31,7 @@ Detect high-risk AI-flavor prose patterns that need human rewrite:
   - 引号强调滥用 (叙述里 1-4 字短词加引号强调，密度型)
 
 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 / 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 的长推理/氛围段可保留)。
+或 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。
 
 The script reports findings only. It never rewrites text, because the safe fix is
@@ -57,6 +58,26 @@ const MICRO_TIC_PATTERN = /了(?:[一两三几半])?[下阵圈道声眼口气会
 const MICRO_TIC_MIN_HITS = 5;
 const MICRO_TIC_PER_KILO = 6;
 
+// 套式反应细节：不是禁写身体，而是提示成片出现的“部位 + 轻微动作/状态”、
+// “胸口像被撞了一下”、喉结/眼圈/声音放轻等通用情绪尾巴，以及“平静语气 +
+// 像在念/宣判”模板。此类句子词面变化大，不能逐词 blocking；按章聚集到 4 处才
+// advisory，要求逐处做删除测试。正常受伤、打斗、生理反应若承担物理后果可保留。
+const STOCK_REACTION_PATTERNS = [
+  /(?:指尖|手指|指节|手背|掌心|拳头|袖口|衣角|裙角|下唇|嘴唇|唇角|嘴角|眉头|眼底|眸光|目光|视线|肩膀|呼吸)[^。！？!?\n]{0,16}(?:轻轻|微微|缓缓|悄然|不自觉|无意识|下意识|攥紧|握紧|收紧|绞紧|泛白|发白|叩|敲|摩挲|抿紧|抿成|移开|垂下|躲开|一颤|颤了?一下|停了?一下|顿了?一下)/g,
+  /(?:语气|声音)[^。！？!?\n]{0,12}(?:平静|冷静|平淡|冷淡|淡漠|平直)[^。！？!?\n]{0,12}(?:像|仿佛|如同|好像)[^。！？!?\n]{0,16}(?:念|读|报|说|陈述|宣判|背诵)/g,
+  /(?:胸口|心口)[^。！？!?\n]{0,16}(?:像|仿佛|如同|好像)[^。！？!?\n]{0,16}(?:撞|锤|压|攥|堵)[^。！？!?\n]{0,8}(?:一下|一记|一拳)?/g,
+  /(?:声音|嗓音|语气)[^。！？!?\n]{0,12}(?:放轻|压低|发紧|发颤|很轻|轻了些)/g,
+  /(?:喉结|喉头|喉咙)[^。！？!?\n]{0,10}(?:滚|动|紧|堵|发涩|发干)/g,
+  /(?:眼眶|眼圈|鼻子)[^。！？!?\n]{0,8}(?:发红|红了|发热|发酸|一酸)/g,
+  /(?:抿了?下唇|抿了?抿唇|抿了?下嘴|抿着笑)/g,
+];
+const STOCK_REACTION_MIN_HITS = 4;
+// 校准（真人语料，<br> 已还原为换行）：qimao 长篇 5584 章 + heiyan 短篇整篇 3983 篇。
+// 长篇章尺度（中位约 2100 字）per-kilo 1.0→1.5 误报 0.43%→0.39%，几乎不动；
+// 短篇整篇 8000-20000 字下 MIN_HITS 形同虚设、只剩密度门，1.0 时误报 5.57%，
+// 1.5 降到 1.46%。故取 1.5，把两个总体拉到同一量级（四份副本共用一组阈值）。
+const STOCK_REACTION_PER_KILO = 1.5;
+
 // 监控摄像头式动作清单：同一段连续堆叠通用动作动词（伸手/拿起/取过/挑开/放下/转身等），
 // 且用逗号/顿号串联成步骤表时，读感像无视角温度的监控记录。只做 advisory；
 // 打斗/追逐等功能性动作编排可保留或人工复核。
@@ -406,6 +427,7 @@ function scanProsePatterns(proseLines) {
   findings.push(...findQuoteEmphasisTic(proseLines));
   findings.push(...findPeriodStutter(proseLines));
   findings.push(...findMicroActionTic(proseLines));
+  findings.push(...findStockReactionTic(proseLines));
   findings.push(...findActionListTic(proseLines));
   findings.push(...findAbstractSummaryTic(proseLines));
   findings.push(...findClicheDensityTic(proseLines));
@@ -700,6 +722,47 @@ function findMicroActionTic(proseLines) {
   }];
 }
 
+// 套式反应细节：统计引号外叙述中通用的部位/声线反应与固定语气比喻。
+// 这是删除测试的候选集，不是身体描写黑名单；全篇只报一条，保留有动作后果、
+// 伤势、人物习惯或情节功能的细节。
+function findStockReactionTic(proseLines) {
+  let hits = 0;
+  let narrativeChars = 0;
+  let firstLine = null;
+  const samples = [];
+
+  for (const { text, lineNo } of proseLines) {
+    const trimmed = text.trim();
+    if (!trimmed || isDivider(trimmed) || isStructural(trimmed)) continue;
+    const narrative = stripQuoted(trimmed);
+    narrativeChars += visibleLength(narrative);
+
+    for (const pattern of STOCK_REACTION_PATTERNS) {
+      pattern.lastIndex = 0;
+      let match;
+      while ((match = pattern.exec(narrative)) !== null) {
+        hits += 1;
+        if (firstLine === null) firstLine = lineNo;
+        const sample = sentenceAround(narrative, match.index);
+        if (samples.length < 6 && sample && !samples.includes(sample)) samples.push(sample);
+      }
+    }
+  }
+
+  if (narrativeChars === 0 || hits < STOCK_REACTION_MIN_HITS) return [];
+  const perKilo = (hits / narrativeChars) * 1000;
+  if (perKilo < STOCK_REACTION_PER_KILO) return [];
+
+  return [{
+    line: firstLine,
+    column: 1,
+    type: 'stock-reaction-tic',
+    severity: 'advisory',
+    message: `套式反应细节：指尖/指节/喉结/眼圈/声音放轻等通用反应或“平静得像在念”式语气比喻 ${hits} 处（${perKilo.toFixed(1)}/千字）；逐处做删除测试，只标注情绪、不改变选择、关系、物件或动作结果的删掉，不要换部位或同义动作。`,
+    excerpt: compact(samples.join(' | ')),
+  }];
+}
+
 function findActionListTic(proseLines) {
   const findings = [];
 

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

@@ -2,7 +2,7 @@
 name: story-import
 version: 1.0.0
 description: "逆向导入已有小说。将已写好的小说（半成品或完本）反向解析为标准项目目录结构，兼容 story-long-write / story-short-write 后续写作流程；内部复用 story-long-analyze / story-short-analyze 的拆解管道，按篇幅自动分流。触发方式：/story-import、「导入小说」「反向解析」「导入」「把我的书导进来」。"
-metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claudecode"}}
+metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
 ---
 # story-import：逆向导入已有小说
 
@@ -12,9 +12,9 @@ metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claud
 
 ---
 
-> Agent 兼容性：检查专业 agent 是否可用时，按 `.claude/agents/{agent}.md` → `.opencode/agents/{agent}.md` → `.codex/agents/{agent}.toml` 的顺序查找。Codex 原生子代理调用优先使用同名 `agent_type`；如果当前 Codex 运行时返回 `unknown agent_type` 或未暴露 custom-agent registry，必须降级为 solo/direct。检测到 `.zcode/` 时同样直接 solo/direct，因为 ZCode 3.3.4 不执行项目 custom agents；报告 `Fallback: project custom agents unavailable -> solo`。Claude/OpenCode 兼容面保留 `subagent_type`。
+> 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: 25` 不一致时（标记缺失、字段缺失/非整数、小于或大于 25）**照常按文件存在性检查并 spawn**，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 25）` 并提示重新运行 `/story-setup` 后新开会话；大于 25 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
+> 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`。
 
 ## 核心原则
 
@@ -102,7 +102,7 @@ metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claud
 在进入 Phase 2 之前，先检测项目是否已部署 story-setup 基础设施：
 
 - 先读取 `.story-deployed` 并执行顶部 Spawn 版本门禁；旧版 `chapter-extractor` 文件即使仍在磁盘上也不可复用。
-- 只有 `agents_version: 25` 通过后，才按 `.claude/agents/chapter-extractor.md` → `.opencode/agents/chapter-extractor.md` → `.codex/agents/chapter-extractor.toml` 检查 Phase 2 长篇并行 agent。
+- 只有 `agents_version: 28` 通过后，才在当前运行时的 canonical 目录检查 Phase 2 `chapter-extractor`：Claude/OpenCode/Antigravity 为同名 Markdown，Codex 为同名 TOML。
 - 如果 `.story-deployed` 的 `target_cli` 包含 `zcode`，项目 agents 缺失是 ZCode 3.3.4 的预期状态：不要提示重复部署，直接以串行 solo/direct 进入分析并报告 fallback。
 
 **部署标记缺失、版本无效/过期，或当前端的 agent 不可用，且不是已部署 ZCode 项目时**，提示用户：
@@ -334,12 +334,21 @@ story-short-analyze 的拆解管道（Stage 2-6）本身**无 Stage 1 停靠点*
 
 **细纲**：从章节摘要反推生成 `大纲/细纲_第XXX章.md`：
 
+每章先通过 story-long-write 的 Wordcount Core 运行 `wordcount measure`，将 JSON 的 `actual` 作为已写章节的历史长度快照。这里记录的是原文在 `visible_chars_v1` 下的实际长度，不是让模型重新决定创作目标。依次探测 `python3`、`python`、`py -3`；找不到 Python 3 或 CLI 时返回 `TOOL_UNAVAILABLE` 并停止导入，不得用模型估算或静默跳过。
+
+```bash
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py wordcount measure \
+  --file "{原文章节文件}" \
+  --chapter {N}
+```
+
 ```markdown
 ## 细纲（第 N 章）
 
 ### 第 N 章：{章名}
 - 核心事件：{从摘要中提取}
-- 字数目标：{原文实际字数}
+- 字数目标：{storyctl 返回的 actual} 字
+- 字数口径：visible_chars_v1
 - 目标情绪：{从章节基调/情绪曲线提取；未知写 [待补充]}
 - 章首钩子：[待补充]
 - 爽点：{从情节点推断；无明确证据写 [待补充]}
@@ -364,7 +373,11 @@ story-short-analyze 的拆解管道（Stage 2-6）本身**无 Stage 1 停靠点*
 - 视角/信息差：{谁知道什么；读者知道什么；主角误判什么；未知写 [待补充]}
 
 #### 情节细化
-- 情节点序列：{从摘要情节点反推，每点“谁做了什么 + 功能标签”}
+- 情节点序列（逐行填下表；从摘要情节点反推）：
+
+| # | 情节点（谁做了什么） | 功能标签 | 执行边界 |
+|---|---|---|---|
+| 1 | {} | {功能不明写 [待补充]} | {从原文确认本点没有释放什么；未知写 [待补充]} |
 - 行动成本（可无）/收益归属：{有证据才写；行动成本可无、不硬造；未知写 [待补充]}
 
 #### 结尾设定和钩子
@@ -472,7 +485,7 @@ story-short-analyze 的拆解管道（Stage 2-6）本身**无 Stage 1 停靠点*
 
 #### Step 3：小节大纲生成
 
-从 `情节节点.md` 的功能分段反推 `{标题}/小节大纲.md`，按开头段/铺垫段/升级段/反转段/结尾段映射；短篇只做轻量蓝图：每节写 `结构段/五段功能`、主事件、3-5 个子事件、目标情绪、人物/关系变化、因果/逻辑链、结尾承接/小钩子。钩子或关系无法判断时标 `[待补充]`，不套用长篇完整章节蓝图。
+从 `情节节点.md` 的功能分段反推 `{标题}/小节大纲.md`，按开头段/铺垫段/升级段/反转段/结尾段映射；短篇只做轻量蓝图：每节写 `结构段/五段功能`、主事件、一个或多个真实推进、目标情绪、人物/关系变化、因果/逻辑链、结尾承接/小钩子。相关情节点可由同一动作链或对话同时兑现，不为凑数量拆成多个子事件。钩子或关系无法判断时标 `[待补充]`，不套用长篇完整章节蓝图。
 
 #### Step 4：外部对标引用视图（可选）
 
@@ -550,7 +563,7 @@ story-short-analyze 的拆解管道（Stage 2-6）本身**无 Stage 1 停靠点*
 
 - 设置 `.active-book` 指向导入的书名/标题目录
 - 确认项目可以被对应写作 skill 识别（长篇 → story-long-write，短篇 → story-short-write）
-- 可选验证：如果项目已部署 story-explorer agent（优先检查 `.claude/agents/` 下的 `story-explorer.md` 是否存在；不存在时再检查 `.opencode/agents/`，再不存在时检查 `.codex/agents/`），可 spawn `Agent(subagent_type: "story-explorer", prompt: "项目目录：{dir}\n查询类型：progress\n查询参数：导入验证")` 交叉验证迁移数据完整性
+- 可选验证：如果当前运行时的 canonical 目录已部署 story-explorer agent，可 spawn 交叉验证迁移数据完整性；Antigravity 检查 `.agents/agents/story-explorer/agent.md` 并用 `invoke_subagent` + `TypeName: "story-explorer"`。Prompt：`项目目录：{dir}\n查询类型：progress\n查询参数：导入验证`
 
 > setup 环境检测已在 Phase 1「环境检测前置」完成，此处不再重复检测。
 

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

@@ -2,7 +2,7 @@
 
 > 写作前必读。以下格式是当前仓库约定的默认正文交付格式；用户或目标平台有明确要求时，以用户/平台要求覆盖。
 >
-> **适用范围**：段落格式（戏剧单元/镜头优先，短段为底色，长段用于完整推理、氛围和情绪链）和对话格式适用于所有体裁。小节(beat)结构和字数标准仅适用于短篇。长篇小说字数以本章细纲的 `字数目标` 与统一 90% 放行下限为准。
+> **适用范围**：段落格式（戏剧单元/镜头优先，短段为底色，长段用于完整推理、氛围和情绪链）和对话格式适用于所有体裁。小节(beat)结构仅适用于短篇；小节不设统一最低字数。长篇按 `visible_chars_v1` 测量同口径细纲 `字数目标`：内部带 ±12%，用户带 ±15%。
 
 ---
 
@@ -119,19 +119,19 @@
 ### 基本规则
 
 - 用数字编号（`1` `2` `3`）分割小节，每个小节是一个完整的叙事 beat
-- 每小节 800-1500 字（爽文可压缩至 500-800 字/节，见 genre-writing-formulas.md）
-- 8-15 个小节覆盖全文（按目标字数反推；8000÷1000≈8节，12000÷800≈15节）
+- 小节长度服从其叙事职责，不设统一最低字数；整篇按锁定的交付范围控制，长篇章节按细纲「字数目标」处理
+- 小节数由情节阶段和转场需要决定；不为平均分配字数拆分完整动作链，也不把承担不同职责的小节硬合并
 - 每小节推进一个明确的情节点
 
 ### 小节内部结构
 
-每个小节应该有：
+每个小节至少完成第 1 项，其余按本节职责选用：
 
-1. **一个主事件** + **3-5 个子事件**（主事件推进核心情节，子事件丰富层次；初稿偏短时先回到小节/细纲补足计划内子事件、对话或冲突，再写正文；去AI味已有正文时不得新增剧情）
-2. **一个情绪变化**（读者的感受如何变化）
-3. **一条读者新获知的信息**
-4. **3-5 轮对话交锋**（揭示关系/升级冲突，参考 writing-craft.md 对话权力博弈。特定场景如独自发现/翻阅日记可标零，按当前 skill 的细纲/设计任务要求执行）
-5. **每个子事件三维度揉进**：发生+感知+反应揉进同一段正文（参考 writing-craft.md 场景写法）
+1. **一个主事件** + **一个或多个真实推进**（风险、信息、关系、资源、决定、行动或读者理解至少改变一项；相关情节点可由同一动作链或对话同时兑现，不为数量新增阻碍、对话或冲突）
+2. **情绪或压力落点**（确有变化时写清读者感受如何变化；任务、推理、手艺或等待链不强配情绪转折）
+3. **读者模型或下一步变化**（新信息、旧信息改义、决定、行动或后果均可，不强配新事实）
+4. **对白按功能使用**（需要时改变信息、策略、权力、关系或下一步行动；独自发现、核验证据、等待、手艺等场景可以无对白）
+5. **推进单元按需揉进信息维度**：发生是主干，感知和反应只在提供新信息时织入同一镜头（参考 writing-craft.md 场景写法）
 
 
 ### 小节之间的衔接
@@ -166,4 +166,3 @@
 6. **正文不使用破折号**：正文（含叙述、对话、心理描写）不使用破折号 `——`/`—` 或双连字符 `--`，改用句号、逗号、换行、动作 beat 或短句断开；不再设置“对话例外”
 7. **禁止通篇句号化或随机标点堆砌**：标点必须跟语气/人物声线/情绪功能匹配；该质问时用问号，该爆发时少量感叹；犹豫、吞咽、未说完用动作或句长变化表达，不用 `……` / `——` 硬造停顿，也不得无功能地乱撒 `？`/`！`
 8. **禁止正文混入章节元信息**：章节号只允许出现在标题/小节标记/文件名/追踪记录中。正文叙述、对话、心理描写里不得出现 `第[一二三四五六七八九十百千万两0-9]+章|上一章|上章|前一章|本章|这一章|前文|后文|伏笔|细纲|读者` 这类写作工程词；要改成角色能感知的事件锚点或相对时间，例如把“比第一章那三秒开火更疼”改成“比那三秒开火更疼”。例外：角色在故事世界内真实阅读/讨论“第X章”文本，或真实身为作者/读者并谈论读者身份时，可保留相应词。
-

package/lib/oh-story/skills/story-import/references/structure-mapping-long.md

@@ -264,14 +264,14 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 | 摘要字段 | 细纲字段 | 转换方式 |
 |---------|---------|---------|
 | 关键事件 | 核心事件 | 直接复用 |
-| 章节字数 | 字数目标 | 从原文统计 |
+| 章节字数 | 字数目标 + 字数口径 | 对原文章节运行 `storyctl.py wordcount measure`，写入 `actual` 与 `visible_chars_v1` |
 | 章节基调 / 情绪曲线 | 目标情绪 | 从摘要提取；缺失写 `[待补充]` |
 | 第一个情节点 | 章首钩子 | 只作为证据，设计目标标 `[待补充]` |
 | 爽点类情节点 | 爽点 | 从情节点类型推断；没有则写“无显性爽点 / [待补充]” |
 | 情节点起承转合 | 内容概括（起因/发展/转折/高潮/结尾） | 按情节点顺序归纳；证据不足写 `[待补充]` |
 | 主线/支线/任务线索 | 情节安排（主线/辅线/事件线/感情线/逻辑线） | 从剧情单元索引与摘要反推；无证据的辅线/感情线写“无”或 `[待补充]`，不得杜撰 |
 | 出场角色 / 关键物件 | 人物关系和出场顺序 | 按摘要出现顺序列出；关系变化只写有证据的“前 → 后”，缺失写 `[待补充]` |
-| 全部情节点 | 情节细化 / 情节点序列 | 每点写“谁做了什么 + 功能标签”；功能不明写 `[待补充]` |
+| 全部情节点 | 情节细化 / 情节点序列 | 按表格逐行写（# / 情节点 / 功能标签 / 执行边界）；功能或边界不明写 `[待补充]`，不反推逐点字数配额 |
 | 胜负/反转/收益损失 | 行动成本（可无）/收益归属 | 有明确证据才填写；行动成本可无、不硬造；否则 `[待补充]` |
 | 最后一个情节点 / 悬念类情节点 | 结尾设定和钩子 | 收束状态可归纳；章尾钩子设计目标标 `[待补充]` |
 

package/lib/oh-story/skills/story-import/references/structure-mapping-short.md

@@ -125,7 +125,7 @@ Phase 3-S 短篇结构迁移的详细映射规则。将 `拆文库/{导入书名
 
 ### 小节数量推算
 
-按原文实际字数估算：`总字数 ÷ 1000 ≈ 小节数`（短篇参考区间 8-15 个小节）。小节数与正文实际段落结构一致是质量清单必检项。
+以原文实际的分节标记和转场为准；原文没有显式分节时，按情节阶段和转场切分，`总字数 ÷ 1000` 只作粗略参考，不作为切分依据。小节数与正文实际段落结构一致是质量清单必检项。
 
 ---
 

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

@@ -6,7 +6,7 @@
 
 | 层级 | 文件 | 语义 |
 |---|---|---|
-| 唯一权威 | `_tracking-state.json` | schema、最后提交章、导入截止章、状态修订号、上下文结构、全部当前角色/伏笔/时间线状态 |
+| 唯一权威 | `_tracking-state.json` | schema、最后提交章、导入截止章、状态修订号、上下文结构、角色/伏笔/时间线，以及已提交章节的简短字数记录 |
 | 章节记录 | `逐章记录/第NNN章.md` | 本章对未来连续性有用的紧凑变化；目标 ≤1536 字节，硬上限 3072 字节；导入范围内修订写成覆盖记录 |
 | 派生视图 | `上下文.md`、`角色状态/{角色名}.md`、`伏笔.md`、`时间线/作者真相.md`、`时间线/读者已知.md` | 完全从 `_tracking-state.json` 生成；禁止手改，不作为程序输入 |
 
@@ -15,21 +15,27 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 
 ## 运行工具
 
-先按运行环境探测 Python 3 解释器（依次尝试 `python3`、`python`、`py -3`），再用当前 skill 根目录执行：
+先按运行环境探测 Python 3 解释器（依次尝试 `python3`、`python`、`py -3`）。追踪事务脚本使用当前 skill 根目录；字数与章节闭环统一使用 `story-long-write` skill 根目录：
 
 ```text
 {PYTHON} {当前 skill 根}/scripts/tracking_commit.py init   --project {书项目根} --input {初始化事务.json}
-{PYTHON} {当前 skill 根}/scripts/tracking_commit.py commit --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` 不存在时执行，绝不覆盖已初始化项目。
-- `commit`：读取唯一权威状态，在内存中完成合并、引用检查、全部视图渲染和容量检查；随后写逐章记录与派生视图，最后原子替换 `_tracking-state.json` 作为唯一提交点。
+- `wordcount checkpoint`：纯测量；返回当前实际字数、用户带与剩余用户区间，不写正文、不写 tracking、不做语义判断。每章最多调用一次。
+- `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及进入内带/用户带所需的机器删除区间。
+- `chapter commit`：再次读取当前文件、重新计数并重跑 blocking quality；只接受用户带内章节，把简短字数记录与逐章事务一起原子提交。
+- `chapter accept-current-length`：只接受带外但 quality pass 的章节；接受动作发生时重新读取、重新计数并立即原子提交，不保存可陈旧的历史决议。
 - `check`：严格验证 state schema、逐章记录连续性/规范名/体积、固定 7 栏、角色快照硬上限、派生文件集合，以及所有派生视图与 state 的逐字一致性。
 
-同一本书只允许工作流串行提交，不支持多个 Agent 或终端并发写。`expected_state_revision` 用于拒绝基于旧状态构造的顺序 stale transaction，不是并发锁。
+每本书由 `追踪/.tracking-commit.lock` 串行写事务，`expected_state_revision` 再拒绝基于旧状态构造的 stale transaction。两个不同事务并发时至多一个修订成功。字数记录也在锁内对当前正文和目标重新验证，正文或目标变化会让预先构造的记录直接失败。
 
-事务 JSON 在成功前必须保留。若文件写入失败，`_tracking-state.json` 尚未推进；修正环境后直接重跑**同一份** `commit`。append 重跑只接受内容完全相同的既有逐章记录，不维护 `dirty/pending/repair` 状态机。
+事务 JSON 是临时输入，不是项目产物：成功前必须保留；提交成功且紧随其后的 `check` 通过后立即删除，不能把 `init_transaction.json`、`chapter_*_transaction.json` 等输入长期留在书项目根目录。若文件写入失败，`_tracking-state.json` 尚未推进；修正环境后直接重跑**同一份** `commit`。append 重跑只接受内容完全相同的既有逐章记录，不维护 `dirty/pending/repair` 状态机。
 
 校验失败与写入失败处理方式不同：校验失败（字段非法、退役结构、容量超限）要按报错改事务本身，重跑同一份结果不变。派生视图被手改或外部改动导致 `check` 报 `derived view differs from _tracking-state.json` 时，重新提交**该章**的 `mode=revision` 事务让工具整份重建，`expected_state_revision` 取 `追踪/_tracking-state.json` 的 `state_revision` 字段——`check` 失败时只往 stderr 打 ERROR，不输出 JSON；不手改派生文件，也不删 `_tracking-state.json` 重来。手写出的逐章记录会让同章 `append` 永久报 `chapter delta N already exists with different content`——删掉那个手写文件后重跑原事务即可。
 
@@ -65,6 +71,8 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 
 导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。
 
+调用方的逐章 JSON 不写 `wordcount`；正式入口 `chapter commit` 或 `chapter accept-current-length` 在提交当下生成并注入。最终 state 只为已提交章节保留 `metric / target / actual / status / resolution / body_sha256`，不保存 MEASURE/RESOLVE 事件、ID 链、policy fingerprint 或独立 chapter state。
+
 ## 逐章事务
 
 ```json

package/lib/oh-story/skills/story-import/scripts/check-outline-contract.js

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+/**
+ * Deterministic 细纲 structural verifier for story-long-write.
+ *
+ * Usage:
+ *   node scripts/check-outline-contract.js --json <细纲路径...>
+ *   node scripts/check-outline-contract.js --json --project <书目录> --chapter N
+ * Exit: 0 = pass, 1 = blocking contract failures, 2 = invalid invocation.
+ *
+ * Scope is structural only: it decides whether the blueprint carries the fields,
+ * subsections and table shape the authoritative template names. It never judges
+ * whether a value is good. The contract itself sets this granularity —
+ * artifact-protocols.md 要求未知字段写 `[待补充]`，所以字段必须在场，值可以未知。
+ */
+
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+
+// 权威模板：references/workflow-setup.md「细纲（全书每章）」
+const FIELDS = [
+  '核心事件', '字数目标', '字数口径', '阶段位置', '单元ID/位置', '目标情绪',
+  '主角目标/关键选择', '章节定位', '本章结构公式', '章首钩子', '爽点',
+  '本章禁止提前释放', '契约风险',
+]
+const SUBSECTIONS = ['内容概括', '情节安排', '人物关系和出场顺序', '情节细化']
+const FIVE_ACT = ['起因', '发展', '转折', '高潮', '结尾']
+const PLOT_HEADER_FIRST = /^(?:#|序号)$/
+// 这两个字段实测直接影响正文质量，必须有实际内容
+const INTENT_FIELDS = ['目标情绪', '主角目标/关键选择']
+const CALIBER = 'visible_chars_v1'
+
+function fieldPattern(name) {
+  // 允许 -/*/+ 项目符号、可选 ** 加粗、全角或半角冒号
+  const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+  return new RegExp(`^\\s*[-*+]\\s*\\*{0,2}${escaped}\\*{0,2}\\s*[：:]`, 'm')
+}
+
+function readUtf8(file) {
+  try {
+    const text = fs.readFileSync(file, 'utf8').replace(/^/, '')
+    return { ok: text.trim().length > 0, text }
+  } catch (error) {
+    return { ok: false, text: '', error: error.message }
+  }
+}
+
+function makeCheck(id, ok, file, evidence, expected, repair) {
+  return {
+    id,
+    ok,
+    severity: 'blocking',
+    file,
+    evidence,
+    expected,
+    references: ['references/workflow-setup.md', 'references/artifact-protocols.md'],
+    repair,
+  }
+}
+
+function parseTableRow(line) {
+  const trimmed = line.trim()
+  if (!trimmed.startsWith('|') || !trimmed.endsWith('|')) return null
+  return trimmed.slice(1, -1).split('|').map((cell) => cell.replace(/\*\*/g, '').replace(/`/g, '').trim())
+}
+
+function verify(file) {
+  const name = path.basename(file)
+  const read = readUtf8(file)
+  const checks = []
+
+  checks.push(makeCheck(
+    'outline.readable',
+    read.ok,
+    name,
+    read.ok ? '文件存在且非空' : (read.error || '文件为空'),
+    '细纲文件存在且非空',
+    '只补建缺失的细纲文件，不改动同批其他章。'
+  ))
+  if (!read.ok) return report(file, checks)
+  const text = read.text
+
+  const missingFields = FIELDS.filter((field) => !fieldPattern(field).test(text))
+  checks.push(makeCheck(
+    'outline.required-fields',
+    missingFields.length === 0,
+    name,
+    missingFields.length ? `缺字段：${missingFields.join('、')}` : `${FIELDS.length} 个字段齐全`,
+    `按权威模板列出全部字段：${FIELDS.join('、')}；值未知时写 [待补充]，不杜撰剧情`,
+    '只补报告里缺的字段行；确实还定不下来的写 [待补充]，不为补字段新增副线或人物关系。'
+  ))
+
+  // 隔离实验（同章、同写作流程，只改细纲）：只补这两个字段就能复现补齐全部字段的收益，
+  // 盲评 3/3 胜过不补；补满五个字段与只补这两个不可区分。所以这两个字段不接受占位符，
+  // 其余字段仍按契约允许 [待补充]。
+  const hollow = INTENT_FIELDS.filter((field) => {
+    const match = text.match(new RegExp(`^\\s*[-*+]\\s*\\*{0,2}${field.replace('/', '\\/')}\\*{0,2}\\s*[：:]\\s*(.*)$`, 'm'))
+    if (!match) return false
+    const value = match[1].replace(/\[待补充\]/g, '').replace(/[\s、，,。;；]/g, '')
+    return value.length === 0
+  })
+  checks.push(makeCheck(
+    'outline.intent-fields-substantive',
+    hollow.length === 0,
+    name,
+    hollow.length ? `只有占位符，没有实际内容：${hollow.join('、')}` : '目标情绪与主角目标/关键选择都写了实际内容',
+    '目标情绪写清前状态→后状态；主角目标/关键选择写清本章要什么、必须做出的判断。这两项不接受 [待补充]',
+    '只把这两个字段替换成本章的实际情绪变化与实际取舍；其余字段不动。'
+  ))
+
+  const missingSubs = SUBSECTIONS.filter((sub) => !new RegExp(`^#{3,4}\\s*${sub}`, 'm').test(text))
+  checks.push(makeCheck(
+    'outline.subsections',
+    missingSubs.length === 0,
+    name,
+    missingSubs.length ? `缺小节：${missingSubs.join('、')}` : '四个小节齐全',
+    '包含 内容概括 / 情节安排 / 人物关系和出场顺序 / 情节细化 四个小节',
+    '只补缺失的小节标题及其条目，不重写已成立的内容。'
+  ))
+
+  const missingActs = FIVE_ACT.filter((act) => !fieldPattern(act).test(text))
+  checks.push(makeCheck(
+    'outline.five-act',
+    missingActs.length === 0,
+    name,
+    missingActs.length ? `五段式缺：${missingActs.join('、')}` : '五段式齐全',
+    '内容概括写全 起因 / 发展 / 转折 / 高潮 / 结尾',
+    '只补缺的那一段，不改其余四段。'
+  ))
+
+  const lines = text.split(/\r?\n/)
+  let header = null
+  for (const line of lines) {
+    const cells = parseTableRow(line)
+    if (cells && cells.length === 4 && PLOT_HEADER_FIRST.test(cells[0])) {
+      header = cells
+      break
+    }
+  }
+  const headerOk = Boolean(header) && header[2].includes('功能标签') && header[3].includes('执行边界')
+  checks.push(makeCheck(
+    'outline.plotpoint-table',
+    headerOk,
+    name,
+    header ? `表头：${header.join(' | ')}` : '未找到 | # | 情节点 | 功能标签 | 执行边界 | 表头',
+    '情节细化使用四列表格：# / 情节点（谁做了什么） / 功能标签 / 执行边界',
+    '只把情节点序列改成四列表格，逐点补功能标签与执行边界；不增删情节点本身。'
+  ))
+
+  const targetMatch = text.match(/字数目标\s*[：:]\s*(?:约\s*)?([\d,，]+)/)
+  const target = targetMatch ? Number(targetMatch[1].replace(/[,，]/g, '')) : null
+  const caliberOk = new RegExp(`字数口径\\s*[：:]\\s*${CALIBER}`).test(text)
+  checks.push(makeCheck(
+    'outline.wordcount-target',
+    Boolean(target) && Number.isFinite(target) && target >= 500 && target <= 20000 && caliberOk,
+    name,
+    `字数目标：${target === null ? '未识别' : target}；字数口径 ${CALIBER}：${caliberOk}`,
+    `字数目标为 500-20000 的正整数，并声明 字数口径：${CALIBER}`,
+    '只补字数目标或字数口径行，不调整情节安排。'
+  ))
+
+  return report(file, checks)
+}
+
+function report(file, checks) {
+  const failures = checks.filter((check) => !check.ok)
+  return {
+    schema_version: 1,
+    verifier: 'story-long-write.outline-contract',
+    file: path.resolve(file),
+    ok: failures.length === 0,
+    checks,
+    failures,
+    repair_scope: failures.map((failure) => ({
+      id: failure.id,
+      file: failure.file,
+      evidence: failure.evidence,
+      expected: failure.expected,
+      references: failure.references,
+      repair: failure.repair,
+    })),
+  }
+}
+
+function resolveChapter(project, chapter) {
+  const dir = path.join(project, '大纲')
+  let entries
+  try {
+    entries = fs.readdirSync(dir)
+  } catch (error) {
+    return { error: `无法读取 ${dir}：${error.message}` }
+  }
+  const wanted = Number(chapter)
+  const hit = entries.find((entry) => {
+    const match = entry.match(/^细纲_第0*(\d+)章.*\.md$/)
+    return match && Number(match[1]) === wanted
+  })
+  if (!hit) return { error: `${dir} 下没有第 ${wanted} 章细纲` }
+  return { file: path.join(dir, hit) }
+}
+
+function parseArgs(argv) {
+  const files = []
+  let project = null
+  let chapter = null
+  for (let index = 0; index < argv.length; index++) {
+    const arg = argv[index]
+    if (arg === '--json') continue
+    if (arg === '--project' || arg === '--chapter') {
+      if (index + 1 >= argv.length || argv[index + 1].startsWith('--')) return null
+      const value = argv[++index]
+      if (arg === '--project') project = value
+      else chapter = value
+      continue
+    }
+    if (arg.startsWith('--')) return null
+    files.push(arg)
+  }
+  if (project || chapter) {
+    if (!project || !chapter || files.length || !/^\d+$/.test(chapter)) return null
+    return { project, chapter }
+  }
+  if (!files.length) return null
+  return { files }
+}
+
+function main(argv) {
+  const parsed = parseArgs(argv)
+  if (!parsed) {
+    process.stderr.write('用法: node scripts/check-outline-contract.js --json <细纲路径...> | --json --project <书目录> --chapter N\n')
+    return 2
+  }
+  let targets = parsed.files
+  if (!targets) {
+    const resolved = resolveChapter(parsed.project, parsed.chapter)
+    if (resolved.error) {
+      process.stderr.write(`${resolved.error}\n`)
+      return 2
+    }
+    targets = [resolved.file]
+  }
+  const reports = targets.map((file) => verify(file))
+  const ok = reports.every((entry) => entry.ok)
+  process.stdout.write(`${JSON.stringify(reports.length === 1 ? reports[0] : reports, null, 2)}\n`)
+  return ok ? 0 : 1
+}
+
+if (require.main === module) process.exitCode = main(process.argv.slice(2))
+
+module.exports = { verify, FIELDS, SUBSECTIONS, FIVE_ACT }