@oh-story/dsh 0.1.3 → 0.1.5

package/lib/oh-story/skills/story-short-write/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-short-write/scripts/check-delivery-contract.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+/**
+ * Deterministic delivery verifier for story-short-write.
+ *
+ * Usage:
+ *   node scripts/check-delivery-contract.js --json \
+ *     --min-chars N --max-chars N --sections N [project-dir]
+ * Exit: 0 = pass, 1 = blocking delivery failures, 2 = invalid invocation.
+ *
+ * The verifier only checks user-visible size and shape. It does not score prose,
+ * causality, emotion, or any other semantic quality dimension.
+ */
+
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+
+const MARKERS = [
+  { style: 'numeric-heading', pattern: /^###\s*\d+\.$/ },
+  { style: 'chapter-heading', pattern: /^###\s*第[一二三四五六七八九十百千万两〇零0-9]+章$/ },
+  { style: 'zhihu-numeric', pattern: /^\d+\.$/ },
+]
+
+function readBody(file) {
+  try {
+    const text = fs.readFileSync(file, 'utf8').replace(/^\uFEFF/, '')
+    return { ok: text.trim().length > 0, text }
+  } catch (error) {
+    return { ok: false, text: '', error: error.message }
+  }
+}
+
+function visibleChars(text) {
+  return Array.from(text).filter((character) => !/\s/u.test(character)).length
+}
+
+function markerFor(line) {
+  const trimmed = line.trim()
+  return MARKERS.find((entry) => entry.pattern.test(trimmed)) || null
+}
+
+function makeCheck(id, ok, evidence, expected, repair) {
+  return {
+    id,
+    ok,
+    severity: 'blocking',
+    file: '正文.md',
+    evidence,
+    expected,
+    references: ['references/short-format.md'],
+    repair,
+  }
+}
+
+function verify(projectDir, contract) {
+  const project = path.resolve(projectDir)
+  const bodyFile = path.join(project, '正文.md')
+  const bodyRead = readBody(bodyFile)
+  const checks = []
+
+  checks.push(makeCheck(
+    'delivery.body-readable',
+    bodyRead.ok,
+    bodyRead.ok ? '正文.md 存在且非空' : (bodyRead.error || '正文.md 为空'),
+    '项目目录下存在非空的 正文.md',
+    '只补建或恢复 正文.md；不要改动设定与大纲。'
+  ))
+  if (!bodyRead.ok) return report(project, contract, checks)
+
+  const actual = visibleChars(bodyRead.text)
+  checks.push(makeCheck(
+    'delivery.visible-chars',
+    actual >= contract.minChars && actual <= contract.maxChars,
+    `非空白 Unicode 字符：${actual}`,
+    `用户要求 ${contract.minChars}-${contract.maxChars} 个非空白字符`,
+    actual < contract.minChars
+      ? '只扩写既有情节点的行动、后果或对话，不新增支线。'
+      : '只压缩重复解释、复述和无功能过场，不删关键证据或结算。'
+  ))
+
+  const lines = bodyRead.text.replace(/\r\n?/g, '\n').replace(/\n+$/, '\n').split('\n')
+  const markers = lines
+    .map((line, index) => ({ line: index + 1, marker: markerFor(line), text: line.trim() }))
+    .filter((entry) => entry.marker)
+  checks.push(makeCheck(
+    'delivery.section-count',
+    markers.length === contract.sections,
+    `识别到 ${markers.length} 个小节标记：${markers.map((entry) => entry.text).join('、') || '无'}`,
+    `正文恰好 ${contract.sections} 节`,
+    '只校正缺失、多余或误写的小节标记；不要为凑节数新开支线。'
+  ))
+
+  const styles = new Set(markers.map((entry) => entry.marker.style))
+  checks.push(makeCheck(
+    'delivery.section-style',
+    markers.length > 0 && styles.size === 1,
+    markers.length ? `小节标记样式：${Array.from(styles).join('、')}` : '没有可识别的小节标记',
+    '全文统一使用 short-format.md 允许的一种小节标记',
+    '只统一小节标记的样式，不改正文内容。'
+  ))
+
+  const numericSequence = markers.map((entry) => {
+    const match = entry.text.match(/\d+/)
+    return match ? Number(match[0]) : null
+  })
+  const sequenceOk = markers.length > 0 && (
+    numericSequence.every((number) => number !== null)
+      ? numericSequence.every((number, index) => number === index + 1)
+      : new Set(markers.map((entry) => entry.text)).size === markers.length
+  )
+  checks.push(makeCheck(
+    'delivery.section-sequence',
+    sequenceOk,
+    `小节序列：${markers.map((entry) => entry.text).join('、') || '无'}`,
+    '数字小节从 1 连续递增；中文章名不得重复',
+    '只修正小节标记编号，不改正文内容。'
+  ))
+
+  const markerLines = new Set(markers.map((entry) => entry.line - 1))
+  const invalidBlankLines = []
+  for (let index = 0; index < lines.length; index++) {
+    if (lines[index].trim() !== '') continue
+    const isEdge = index === 0 || index === lines.length - 1
+    const touchesMarker = markerLines.has(index - 1) || markerLines.has(index + 1)
+    if (!isEdge && !touchesMarker) invalidBlankLines.push(index + 1)
+  }
+  checks.push(makeCheck(
+    'delivery.blank-lines',
+    invalidBlankLines.length === 0,
+    invalidBlankLines.length ? `正文段落间空行：${invalidBlankLines.join('、')}` : '正文段落间无空行',
+    '只允许文件边缘或小节标记相邻处出现空行，正文段落之间紧密单换行',
+    '只删除报告行的多余空行。'
+  ))
+
+  return report(project, contract, checks)
+}
+
+function report(project, contract, checks) {
+  const failures = checks.filter((check) => !check.ok)
+  return {
+    schema_version: 1,
+    verifier: 'story-short-write.delivery-contract',
+    project,
+    contract: {
+      metric: 'non_whitespace_unicode_chars_v1',
+      min_chars: contract.minChars,
+      max_chars: contract.maxChars,
+      sections: contract.sections,
+    },
+    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 parsePositiveInteger(value) {
+  if (!/^[1-9]\d*$/.test(value || '')) return null
+  const number = Number(value)
+  return Number.isSafeInteger(number) ? number : null
+}
+
+function parseArgs(argv) {
+  const values = {}
+  const positional = []
+  for (let index = 0; index < argv.length; index++) {
+    const arg = argv[index]
+    if (arg === '--json') continue
+    if (['--min-chars', '--max-chars', '--sections'].includes(arg)) {
+      if (index + 1 >= argv.length || argv[index + 1].startsWith('--')) return null
+      values[arg] = parsePositiveInteger(argv[++index])
+      if (values[arg] === null) return null
+      continue
+    }
+    if (arg.startsWith('--')) return null
+    positional.push(arg)
+  }
+  if (positional.length > 1) return null
+  if (!values['--min-chars'] || !values['--max-chars'] || !values['--sections']) return null
+  if (values['--min-chars'] > values['--max-chars']) return null
+  return {
+    project: positional[0] || '.',
+    contract: {
+      minChars: values['--min-chars'],
+      maxChars: values['--max-chars'],
+      sections: values['--sections'],
+    },
+  }
+}
+
+function main(argv) {
+  const parsed = parseArgs(argv)
+  if (!parsed) {
+    process.stderr.write('用法: node scripts/check-delivery-contract.js --json --min-chars N --max-chars N --sections N [project-dir]\n')
+    return 2
+  }
+  const result = verify(parsed.project, parsed.contract)
+  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`)
+  return result.ok ? 0 : 1
+}
+
+if (require.main === module) process.exitCode = main(process.argv.slice(2))
+
+module.exports = { markerFor, visibleChars, verify }

package/lib/oh-story/skills/story-short-write/scripts/check-phase2-contract.js

@@ -0,0 +1,363 @@
+#!/usr/bin/env node
+/**
+ * Phase 2 deterministic contract verifier for story-short-write.
+ *
+ * This script is intentionally mechanical: it checks whether the two Phase 2
+ * artifacts expose the fields and table shape required by the skill. It does
+ * not pretend to judge story quality or whether a reference was genuinely
+ * understood.
+ *
+ * Usage: node scripts/check-phase2-contract.js --json [project-dir]
+ * Exit: 0 = pass, 1 = blocking contract failures, 2 = invalid invocation.
+ */
+
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+
+const OUTLINE_HEADERS = [
+  '结构段/五段功能',
+  '主事件',
+  '情节推进',
+  '情绪',
+  '人物/关系变化',
+  '因果/逻辑链',
+  '读者新获知什么',
+  '结尾承接/钩子',
+  '伏笔/物件',
+  '场景形态',
+  '对白作用',
+  '目标字数',
+]
+
+const LEGACY_OUTLINE_HEADERS = new Map([
+  [2, '子事件×3-5'],
+  [9, '动静'],
+  [10, '对话密度'],
+])
+
+const FUNCTION_TAG = /\{(?:对话|冲突|伏笔|回忆|发现|递进)\}/
+
+function cleanCell(value) {
+  return value.replace(/\*\*/g, '').replace(/`/g, '').trim()
+}
+
+function parseTableLine(line) {
+  const trimmed = line.trim()
+  if (!trimmed.startsWith('|') || !trimmed.endsWith('|')) return null
+  return trimmed.slice(1, -1).split('|').map(cleanCell)
+}
+
+function isSeparatorRow(cells) {
+  return cells.length > 0 && cells.every((cell) => /^:?-{3,}:?$/.test(cell))
+}
+
+function readUtf8(file) {
+  try {
+    const text = fs.readFileSync(file, 'utf8').replace(/^\uFEFF/, '')
+    return { ok: text.trim().length > 0, text }
+  } catch (error) {
+    return { ok: false, text: '', error: error.message }
+  }
+}
+
+function makeCheck(id, ok, file, evidence, expected, references, repair) {
+  return { id, ok, severity: 'blocking', file, evidence, expected, references, repair }
+}
+
+function verify(projectDir) {
+  const project = path.resolve(projectDir)
+  const skillRoot = path.resolve(__dirname, '..')
+  const settingsFile = path.join(project, '设定.md')
+  const outlineFile = path.join(project, '小节大纲.md')
+  const settingsRead = readUtf8(settingsFile)
+  const outlineRead = readUtf8(outlineFile)
+  const checks = []
+
+  checks.push(makeCheck(
+    'phase2.settings-readable',
+    settingsRead.ok,
+    '设定.md',
+    settingsRead.ok ? '文件存在且非空' : (settingsRead.error || '文件为空'),
+    '项目目录下存在非空的 设定.md',
+    ['references/writing-workflow.md'],
+    '只补建或补全 设定.md，不改动已通过的 小节大纲.md。'
+  ))
+  checks.push(makeCheck(
+    'phase2.outline-readable',
+    outlineRead.ok,
+    '小节大纲.md',
+    outlineRead.ok ? '文件存在且非空' : (outlineRead.error || '文件为空'),
+    '项目目录下存在非空的 小节大纲.md',
+    ['references/writing-workflow.md'],
+    '只补建或补全 小节大纲.md，不改动已通过的 设定.md。'
+  ))
+
+  if (!settingsRead.ok || !outlineRead.ok) return report(project, checks)
+
+  const settings = settingsRead.text
+  const outline = outlineRead.text
+
+  const platformMatch = settings.match(/目标平台\s*[：:]\s*(知乎(?:盐选)?|小程序|番茄(?:短篇)?)/)
+  checks.push(makeCheck(
+    'phase2.platform-declared',
+    Boolean(platformMatch),
+    '设定.md',
+    platformMatch ? `目标平台：${platformMatch[1]}` : '未找到可识别的目标平台字段',
+    '写明“目标平台：知乎盐选 / 小程序 / 番茄短篇”之一',
+    ['references/submission-craft.md'],
+    '只在 设定.md 的基本信息或 Phase 2 设计校验区补目标平台。'
+  ))
+
+  const genreMatch = settings.match(/(?:题材参考|题材包)\s*[：:]\s*`?(references\/(?:genre-styles\/[^`\s|]+\.md|genre-writing-formulas\.md))`?/)
+  let genreEvidence = '未找到题材参考路径'
+  let genreOk = false
+  if (genreMatch) {
+    const resolved = path.resolve(skillRoot, genreMatch[1])
+    const insideSkill = resolved.startsWith(`${skillRoot}${path.sep}`)
+    genreOk = insideSkill && fs.existsSync(resolved) && fs.statSync(resolved).isFile()
+    genreEvidence = genreOk ? `题材参考：${genreMatch[1]}` : `题材参考不可读：${genreMatch[1]}`
+  }
+  checks.push(makeCheck(
+    'phase2.genre-reference-declared',
+    genreOk,
+    '设定.md',
+    genreEvidence,
+    '写明一个真实存在的 references/genre-styles/{题材}.md；冷门题材写 references/genre-writing-formulas.md',
+    ['references/writing-workflow.md', 'references/short-craft.md'],
+    '只补题材参考路径与从该参考选出的 2-3 个核心招式，不重写故事框架。'
+  ))
+
+  const movesMatch = settings.match(/核心招式\s*[：:]\s*([^\n]+)/)
+  const moves = movesMatch
+    ? movesMatch[1].split(/[；;]|\s\/\s/).map((item) => item.trim()).filter(Boolean)
+    : []
+  checks.push(makeCheck(
+    'phase2.genre-moves-declared',
+    moves.length >= 2 && moves.length <= 3,
+    '设定.md',
+    moves.length ? `识别到 ${moves.length} 个核心招式` : '未找到核心招式字段',
+    '“核心招式：招式一；招式二[；招式三]”，共 2-3 个',
+    ['references/writing-workflow.md'],
+    '只补或收敛核心招式字段到 2-3 个，并保持已选题材参考不变。'
+  ))
+
+  const villainSkipped = /反派(?:设计)?\s*[：:]\s*(?:无|不适用)\s*[（(][^)）]+[)）]/.test(settings)
+  const villainFields = ['身份', '动机', '作恶方式', '致命弱点', '报应']
+  const missingVillainFields = villainFields.filter((field) => !new RegExp(`(?:^|\\n)\\s*[-*]?\\s*${field}\\s*[：:]`, 'm').test(settings))
+  const villainOk = villainSkipped || missingVillainFields.length === 0
+  checks.push(makeCheck(
+    'phase2.villain-contract',
+    villainOk,
+    '设定.md',
+    villainSkipped ? '已明确反派不适用' : (villainOk ? '反派五字段齐全' : `缺字段：${missingVillainFields.join('、')}`),
+    '无反派时写“反派设计：不适用（原因）”；有反派时填写身份、动机、作恶方式、致命弱点、报应',
+    ['references/villain-and-reveal.md'],
+    '只补反派缺失字段；若确无反派，改为带原因的不适用声明。'
+  ))
+
+  const placeholderFields = ['题材参考', '核心招式', '反派设计', '反转类型', '反转位置', '付费点', '目标平台', '目标字数']
+  const placeholderLines = settings.split(/\r?\n/)
+    .map((line, index) => ({ line: index + 1, text: line }))
+    .filter((entry) => placeholderFields.some((field) => entry.text.includes(`${field}：`) || entry.text.includes(`${field}:`)))
+    .filter((entry) => /\{[^}]*\}/.test(entry.text))
+  checks.push(makeCheck(
+    'phase2.no-template-placeholders',
+    placeholderLines.length === 0,
+    '设定.md',
+    placeholderLines.length ? `仍是模板占位符的行：${placeholderLines.map((entry) => entry.line).join('、')}` : '契约字段没有未填写的 {} 占位符',
+    'Phase 2 契约字段写实际设计内容，不保留 {} 模板占位符',
+    ['references/writing-workflow.md'],
+    '只把报告行的占位符替换成本篇的实际设计，不重写其他字段。'
+  ))
+
+  const lines = outline.split(/\r?\n/)
+  let headerAt = -1
+  let headerCells = null
+  for (let index = 0; index < lines.length; index++) {
+    const cells = parseTableLine(lines[index])
+    if (cells && cells[0] === OUTLINE_HEADERS[0]) {
+      headerAt = index
+      headerCells = cells
+      break
+    }
+  }
+  const currentHeader = Boolean(headerCells) && headerCells.length === OUTLINE_HEADERS.length &&
+    headerCells.every((cell, index) => cell === OUTLINE_HEADERS[index])
+  const legacyHeader = Boolean(headerCells) && headerCells.length === OUTLINE_HEADERS.length &&
+    headerCells.every((cell, index) => cell === (LEGACY_OUTLINE_HEADERS.get(index) || OUTLINE_HEADERS[index]))
+  const headerOk = currentHeader || legacyHeader
+  checks.push(makeCheck(
+    'phase2.outline-12-columns',
+    headerOk,
+    '小节大纲.md',
+    headerCells
+      ? `表头 ${headerCells.length} 列：${headerCells.join(' | ')}${legacyHeader ? '（兼容旧项目；新建项目使用现行列名）' : ''}`
+      : '未找到以“结构段/五段功能”开头的 Markdown 表格',
+    `使用固定 12 列表头：${OUTLINE_HEADERS.join(' | ')}`,
+    ['references/writing-workflow.md'],
+    '只修表头和错位单元格，不改动各节已经成立的剧情内容。'
+  ))
+
+  const rows = []
+  if (headerAt >= 0) {
+    for (let index = headerAt + 1; index < lines.length; index++) {
+      const cells = parseTableLine(lines[index])
+      if (!cells) {
+        if (rows.length) break
+        continue
+      }
+      if (isSeparatorRow(cells)) continue
+      rows.push({ line: index + 1, cells })
+    }
+  }
+  const rowShapeFailures = rows.filter((row) => row.cells.length !== OUTLINE_HEADERS.length)
+  checks.push(makeCheck(
+    'phase2.outline-data-rows',
+    rows.length > 0 && rowShapeFailures.length === 0,
+    '小节大纲.md',
+    rows.length === 0 ? '固定表头下没有数据行' : (rowShapeFailures.length ? `列数错误行：${rowShapeFailures.map((row) => row.line).join('、')}` : `识别到 ${rows.length} 节，均为 12 列`),
+    '固定表头下至少一行数据，且每节恰好 12 列',
+    ['references/writing-workflow.md'],
+    '只补缺失节或修复报告行的列错位。'
+  ))
+
+  const progressionFailures = []
+  const progressionRows = rows.filter((item) => item.cells.length === OUTLINE_HEADERS.length)
+  for (const row of progressionRows) {
+    const progression = row.cells[2].split(/\s*(?:->|→)\s*/).filter(Boolean)
+    if (progression.length < 1 || progression.some((item) => !FUNCTION_TAG.test(item))) {
+      progressionFailures.push(row.line)
+    }
+  }
+  checks.push(makeCheck(
+    'phase2.outline-subevents',
+    rows.length > 0 && progressionFailures.length === 0,
+    '小节大纲.md',
+    progressionFailures.length
+      ? `情节推进为空或功能标签错误行：${progressionFailures.join('、')}`
+      : (progressionRows.length === rows.length
+          ? `所有 ${rows.length} 节均有至少一个带功能标签的真实推进`
+          : `已检查 ${progressionRows.length}/${rows.length} 行；其余行由 phase2.outline-data-rows 报告列错位`),
+    '每节至少一个真实推进；有先后关系时以 -> 连接，每个含 {对话/冲突/伏笔/回忆/发现/递进} 标签之一，不设固定数量',
+    ['references/writing-workflow.md', 'references/short-craft.md'],
+    '只修报告行的“情节推进”单元格，不重写其他列或其他节；不要为数量补事件。'
+  ))
+
+  const targetMatch = settings.match(/目标字数\s*[：:]\s*(?:约\s*)?([\d,，]+)\s*(?:字)?\s*(?:[-–—~～]|到|至)\s*([\d,，]+)\s*字?/) ||
+    settings.match(/目标字数\s*[：:]\s*(?:约\s*)?([\d,，]+)\s*字?/)
+  const toNumber = (value) => Number(String(value).replace(/[,，]/g, ''))
+  const targetLow = targetMatch ? toNumber(targetMatch[1]) : null
+  const targetHigh = targetMatch && targetMatch[2] !== undefined ? toNumber(targetMatch[2]) : targetLow
+  const statedTarget = targetLow
+  const rowTargets = progressionRows.map((row) => {
+    const match = row.cells[11].match(/([\d,，]+)/)
+    return match ? Number(match[1].replace(/[,，]/g, '')) : null
+  })
+  const targetSum = rowTargets.every((value) => Number.isFinite(value))
+    ? rowTargets.reduce((sum, value) => sum + value, 0)
+    : null
+  const isRange = targetHigh !== null && targetHigh !== targetLow
+  const targetOk = statedTarget !== null && statedTarget >= 1000 && targetHigh <= 200000 &&
+    targetHigh >= targetLow && progressionRows.length === rows.length && targetSum !== null &&
+    (isRange
+      ? targetSum >= targetLow && targetSum <= targetHigh
+      : Math.abs(targetSum - statedTarget) <= statedTarget * 0.05)
+  checks.push(makeCheck(
+    'phase2.target-word-sum',
+    targetOk,
+    '设定.md、小节大纲.md',
+    `设定目标：${statedTarget === null ? '未识别' : (isRange ? `${targetLow}-${targetHigh}` : statedTarget)}；大纲合计：${targetSum === null ? '有非数字目标字数' : targetSum}`,
+    '设定.md 的目标字数为 1000-200000 的正整数或区间（用户明确范围优先，未指定时默认 8000-20000）；大纲每行目标字数可解析，写区间时合计落在区间内，写单值时误差不超过 5%',
+    ['references/writing-workflow.md', 'references/submission-craft.md'],
+    '只修目标字数字段或各节“目标字数”单元格，使合计匹配；不要用增删剧情绕过数字错误。'
+  ))
+
+  const reversalMatch = settings.match(/反转位置\s*[：:]\s*第?\s*(\d+)\s*节?\s*(?:÷|\/)\s*(?:共|全文)?\s*(\d+)\s*节?\s*=\s*(\d+(?:\.\d+)?)\s*%/)
+  const noReversal = /反转类型\s*[：:]\s*无反转/.test(settings) &&
+    /反转位置\s*[：:]\s*不适用\s*[（(][^)）]+[)）]/.test(settings)
+  let reversalOk = false
+  let reversalEvidence = '未找到“反转位置：第 X 节 ÷ 共 Y 节 = Z%”'
+  if (noReversal) {
+    reversalOk = true
+    reversalEvidence = '反转类型为无反转，位置已带原因标为不适用'
+  } else if (reversalMatch) {
+    const reveal = Number(reversalMatch[1])
+    const total = Number(reversalMatch[2])
+    const stated = Number(reversalMatch[3])
+    const calculated = total > 0 ? (reveal / total) * 100 : NaN
+    reversalOk = reveal >= 1 && reveal <= total && total === rows.length &&
+      Math.abs(stated - calculated) <= 0.6
+    reversalEvidence = `声明第 ${reveal} 节 ÷ 共 ${total} 节 = ${stated}%；大纲识别 ${rows.length} 节`
+  }
+  checks.push(makeCheck(
+    'phase2.reversal-position',
+    reversalOk,
+    '设定.md',
+    reversalEvidence,
+    '有反转时写明揭穿节号、全文总节数和计算百分比；总节数须与大纲一致，计算误差不超过 0.6%。无反转时写明“反转类型：无反转”和带原因的“反转位置：不适用（…）”',
+    ['references/writing-workflow.md', 'references/short-reversal.md'],
+    '只修正反转位置计算或对应节次；位置质量按 short-reversal.md 的误判决策与揭示后果功能链判断，不为跨过固定百分比而搬节。'
+  ))
+
+  const paywallMatch = settings.match(/付费点\s*[：:]\s*第?\s*(\d+)\s*节末/)
+  const paywallSection = paywallMatch ? Number(paywallMatch[1]) : null
+  const paywallRows = rows
+    .map((row, index) => ({ section: index + 1, hook: row.cells[7] || '' }))
+    .filter((row) => /付费点/.test(row.hook))
+  const paywallOk = paywallSection !== null && paywallRows.length === 1 &&
+    paywallRows[0].section === paywallSection
+  let paywallEvidence = '设定.md 未按“付费点：第 X 节末”声明'
+  if (paywallSection !== null && paywallRows.length === 0) {
+    paywallEvidence = `设定.md 声明第 ${paywallSection} 节末；大纲“结尾承接/钩子”列未标出付费点`
+  } else if (paywallSection !== null && paywallRows.length > 0) {
+    paywallEvidence = `设定.md 声明第 ${paywallSection} 节末；大纲标在第 ${paywallRows.map((row) => row.section).join('、')} 节`
+  }
+  checks.push(makeCheck(
+    'phase2.paywall-in-both',
+    paywallOk,
+    '设定.md、小节大纲.md',
+    paywallEvidence,
+    '设定.md 写“付费点：第 X 节末”，且小节大纲.md 第 X 行数据的“结尾承接/钩子”单元格只标一次“付费点”',
+    ['references/submission-craft.md', 'references/writing-workflow.md'],
+    '只在缺失的文件补同一个付费断点，并确保它位于对应节末的钩子单元格。'
+  ))
+
+  return report(project, checks)
+}
+
+function report(project, checks) {
+  const failures = checks.filter((check) => !check.ok)
+  return {
+    schema_version: 1,
+    verifier: 'story-short-write.phase2-contract',
+    project,
+    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 main(argv) {
+  const args = argv.filter((arg) => arg !== '--json')
+  if (args.length > 1 || args.some((arg) => arg.startsWith('--'))) {
+    process.stderr.write('用法: node scripts/check-phase2-contract.js --json [project-dir]\n')
+    return 2
+  }
+  const result = verify(args[0] || '.')
+  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`)
+  return result.ok ? 0 : 1
+}
+
+if (require.main === module) process.exitCode = main(process.argv.slice(2))
+
+module.exports = { OUTLINE_HEADERS, verify }