dsh-maoying 0.1.19 → 0.1.21

package/lib/epub.mjs

@@ -121,9 +121,15 @@ export function buildZip(entries) {
  * XML 文本转义：& 必须先转（否则把刚生成的 &amp; 又转一遍），再 < > 与引号。
  * 章节正文与标题里出现的都过这里；属性值一律用生成的 ASCII 名不走它，引号
  * 转义属防御纵深（将来属性值万一改走用户输入也不破 XML）。
+ *
+ * L8：XML 1.0 非法控制字符（\x00-\x08、\x0B、\x0C、\x0E-\x1F；\t \n \r 合法
+ * 保留）先替换为 U+FFFD 再转义——混入即产非法 XHTML，阅读器可能拒载整本。
+ * 选替换不选剥离：脏字符多半是复制粘贴事故，U+FFFD 给作者与阅读器留下
+ * 「这里有脏字符」的可见痕迹，静默剥除会无声丢字。
  */
 export function escapeXml(text) {
   return String(text ?? '')
+    .replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, '\uFFFD')
     .replace(/&/g, '&amp;')
     .replace(/</g, '&lt;')
     .replace(/>/g, '&gt;')

package/lib/novel-parse.mjs

@@ -35,6 +35,13 @@ export const CHAPTER_STATUSES = [
   ['accepted', '已定稿'],
 ]
 
+/**
+ * 伏笔超期阈值：planted 状态超过该章数未推进即提醒（checkProject 的伏笔超期
+ * warn 用）。数字出处：skills/maoying-foreshadow-discipline/SKILL.md「清理纪律」
+ * ——planted 超过 30 章未推进应升级（置 progressing 并规划推进）或 abandoned。
+ */
+export const FORESHADOW_STALE_CHAPTERS = 30
+
 // CJK 计数范围：基本区 + 扩展 A + 扩展 B（\u{20000}-\u{2A6DF}）。扩展 B 在增补
 // 平面，必须带 u 标志按码点匹配——网文生僻字（如「𠮷」）此前会被漏计。
 const CJK_RE = /[\u4e00-\u9fff\u3400-\u4dbf\u{20000}-\u{2a6df}]/gu
@@ -99,15 +106,21 @@ export function parseScalarText(raw) {
  *   - 顶层数组（volumes.yml / foreshadows.yml 等）：`- key: value` 起条目，
  *     缩进行补键；裸 `- 标量` 收作字符串条目。
  * 深嵌套不在支持范围（数据规范本身就禁止）。解析不了返回 null。
+ *
+ * H2：onWarn（可选回调）接收「认不出但没炸」的行告警——目前只有数组分支的
+ * 零缩进散键行一种；调用方（panel-core collectArrayYml / checkProject /
+ * buildBrief）把消息各自挂上文件名再入自家告警通道，散键不再静默蒸发。
  */
-export function parseFlatYamlArray(text) {
+export function parseFlatYamlArray(text, onWarn = null) {
   if (text === null) return null
   const lines = []
-  for (const raw of text.split(/\r?\n/)) {
+  const lineNos = [] // 源行号随行登记：散键告警要能定位到文件行
+  text.split(/\r?\n/).forEach((raw, i) => {
     const line = stripInlineComment(raw).replace(/\s+$/, '')
-    if (line.trim() === '' || line.trim().startsWith('#')) continue
+    if (line.trim() === '' || line.trim().startsWith('#')) return
     lines.push(line)
-  }
+    lineNos.push(i + 1)
+  })
   if (lines.length === 0) return null
   const first = lines[0].trim()
   if (first === '[]') return []
@@ -119,7 +132,8 @@ export function parseFlatYamlArray(text) {
       if (current !== null) arr.push(current)
       current = null
     }
-    for (const line of lines) {
+    for (let li = 0; li < lines.length; li++) {
+      const line = lines[li]
       const trimmed = line.trim()
       if (trimmed.startsWith('- ')) {
         flush()
@@ -134,6 +148,11 @@ export function parseFlatYamlArray(text) {
       } else if (trimmed === '-') {
         flush()
         current = {}
+      } else if (!/^[ \t]/.test(line)) {
+        // H2：数组形态里零缩进、非「-」起头的散键行不属于任何条目——旧实现会
+        // 静默并入前一条目，手改残留键能覆盖前条 status 且零告警。丢弃并告警
+        // （顶层纯键值不经过本分支——那是合法映射形态）。
+        if (onWarn !== null) onWarn(`第 ${lineNos[li]} 行零缩进散键「${trimmed}」不属于任何条目，已丢弃`)
       } else if (current !== null) {
         const m = /^([^:]+):\s*(.*)$/.exec(trimmed)
         if (m !== null) current[m[1].trim()] = parseScalarText(m[2])
@@ -208,7 +227,9 @@ export function chapterSortKey(stem) {
 function listMdFiles(dir) {
   if (!existsSync(dir)) return []
   return readdirSync(dir)
-    .filter((f) => f.endsWith('.md'))
+    // M10：.md 大小写不敏感（/\.md$/i）——panel-core 的 collectOutlines /
+    // collectMdEntities 同口径收录 .MD，CLI 侧不得把同一批文件漏在门外
+    .filter((f) => /\.md$/i.test(f))
     .sort((a, b) => a.localeCompare(b, undefined, { numeric: true }))
 }
 
@@ -310,6 +331,9 @@ export function buildIndexYaml(chapters, volumesRaw) {
   if (volumes.length === 0) lines.push('  []')
   for (const volume of volumes) {
     const id = String(volume.id ?? '')
+    // M8：重复 id 不在此处去重——index 重建是确定性纯函数、静默择一反而把数据
+    // 问题藏进产物；重复 id 由 checkProject 报 error 兜底，源头修 volumes.yml
+    // （claimed 用 Set，同批章节重复入卷只影响卷内字数之和，orphans 不受影响）。
     const members = chapters.filter((ch) => ch.volume === id)
     for (const ch of members) claimed.add(ch.stem)
     lines.push(`  - id: ${flowScalar(id || '（缺 id）')}`)
@@ -444,7 +468,8 @@ function collectCharacterCards(novelDir) {
   if (!existsSync(dir)) return []
   const cards = []
   for (const file of readdirSync(dir)) {
-    if (!file.endsWith('.md')) continue
+    // M10：口径与 listMdFiles 一致——.MD 大小写不敏感（面板实体卡目录收录同款文件）
+    if (!/\.md$/i.test(file)) continue
     const text = readTextOrNull(path.join(dir, file))
     if (text === null) continue
     const { meta, body, raw } = parseChapterFile(text)
@@ -455,9 +480,11 @@ function collectCharacterCards(novelDir) {
 }
 
 /** 顶层数组 yml 读取：文件缺失、解析失败或非数组一律给 []（条目只留对象）。
- * `-` 空条目后跟裸标量（`-\n- foo`）会被解析成无任何自有键的空对象，一并过滤。 */
-function readYamlArray(novelDir, name) {
-  const raw = parseFlatYamlArray(readTextOrNull(path.join(novelDir, name)))
+ * `-` 空条目后跟裸标量（`-\n- foo`）会被解析成无任何自有键的空对象，一并过滤。
+ * onWarn（H2）透传给 parseFlatYamlArray 收散键丢弃告警，消息不含文件名，
+ * 由调用方按需挂（checkProject 入 problems、buildBrief 入 warnings）。 */
+function readYamlArray(novelDir, name, onWarn = null) {
+  const raw = parseFlatYamlArray(readTextOrNull(path.join(novelDir, name)), onWarn)
   if (!Array.isArray(raw)) return []
   return raw.filter(
     (item) => item !== null && typeof item === 'object' && !Array.isArray(item) && Object.keys(item).length > 0,
@@ -599,8 +626,10 @@ export function buildBrief(novelDir, chapterRef, options = {}) {
   }
   const idx = chapters.findIndex((c) => c.stem === target.stem)
 
-  // 卷名：volumes.yml 的 title，缺了退「卷N」/卷 id
-  const volumesRaw = parseFlatYamlArray(readTextOrNull(path.join(novelDir, 'volumes.yml')))
+  // 卷名：volumes.yml 的 title，缺了退「卷N」/卷 id（H2：散键告警挂文件名入 warnings）
+  const volumesRaw = parseFlatYamlArray(readTextOrNull(path.join(novelDir, 'volumes.yml')), (w) =>
+    warnings.push(`volumes.yml: ${w}`),
+  )
   const volTitles = new Map()
   if (Array.isArray(volumesRaw)) {
     for (const v of volumesRaw) {
@@ -654,7 +683,7 @@ export function buildBrief(novelDir, chapterRef, options = {}) {
   // 出场角色卡：有章纲按章纲选人（卡名/ slug 命中 + 「出场角色：」行点名）；
   // 章纲缺失时回退「前章出场角色 + 主角」（主角判定见 protagonistCards 注释）
   const cards = collectCharacterCards(novelDir)
-  const relations = readYamlArray(novelDir, 'relations.yml')
+  const relations = readYamlArray(novelDir, 'relations.yml', (w) => warnings.push(`relations.yml: ${w}`))
   let roleCards = []
   let missingNames = []
   if (outline !== null) {
@@ -683,7 +712,7 @@ export function buildBrief(novelDir, chapterRef, options = {}) {
   // 活跃伏笔：status ∈ planted/progressing 的条目照录
   const hasForeshadowsFile = existsSync(path.join(novelDir, 'foreshadows.yml'))
   if (!hasForeshadowsFile) warnings.push('未找到 foreshadows.yml，活跃伏笔一节按空处理')
-  const activeForeshadows = readYamlArray(novelDir, 'foreshadows.yml').filter(
+  const activeForeshadows = readYamlArray(novelDir, 'foreshadows.yml', (w) => warnings.push(`foreshadows.yml: ${w}`)).filter(
     (f) => f.status === 'planted' || f.status === 'progressing',
   )
   const fsParts = activeForeshadows.map((f) => renderForeshadowBrief(f))
@@ -717,6 +746,15 @@ const CHAPTER_WRITERS = ['author', 'ai']
 /** 伏笔状态机枚举（docs/spec.md）。 */
 const FORESHADOW_STATUSES = ['planted', 'progressing', 'resolved', 'abandoned']
 
+/** 伏笔 source 枚举（templates/novel/foreshadows.yml 声明；缺省归 plan 不报）。 */
+const FORESHADOW_SOURCES = ['plan', 'backfill']
+
+/** clue-board.yml 的 kind 枚举（templates/novel/clue-board.yml 声明）。 */
+const CLUE_KINDS = ['clue', 'red-herring', 'deduction', 'question']
+
+/** memories.yml 的 category 枚举（templates/novel/memories.yml 声明）。 */
+const MEMORY_CATEGORIES = ['character', 'location', 'item', 'event', 'promise', 'appearance', 'arc', 'other']
+
 /** project.yml 的共创模式枚举（五期 §9.1）。 */
 const PROJECT_MODES = ['ai-draft', 'co-write', 'author-draft']
 
@@ -796,6 +834,83 @@ function parseTimelineYear(year) {
   return m === null ? null : Number(m[0])
 }
 
+// ── AI 味统计（checkProject 第三组规则的实现；独立纯函数便于测试与复用）──────
+
+/** 连续同式开头判定下限：连续 ≥ 3 句以相同前 2 字开头算句式重复。 */
+export const STYLE_REPEAT_RUN = 3
+/** 比喻词密度阈值：每千 CJK 字超过 2 处判 AI 味风险。 */
+export const STYLE_METAPHOR_PER_KILO = 2
+/** 句长波动检查的最少句数：句数不足时统计无意义，不查。 */
+export const STYLE_SENTENCE_MIN = 20
+/** 句长变异系数（标准差/均值）下限：低于它说明长短句交替不足。 */
+export const STYLE_SENTENCE_CV_MIN = 0.3
+
+/** AI 高频比喻词清单（字面计数，不做修辞判定）。 */
+const METAPHOR_WORDS = ['仿佛', '宛如', '好似', '如同', '恍若', '好像']
+
+/** 章纲「钩子」小节的标题行：#{1,3} 级、「钩子」或「章尾钩子」打头即算。 */
+const OUTLINE_HOOK_RE = /^#{1,3}[ \t]*(?:章尾)?钩子/m
+
+/**
+ * 章节正文的 AI 味统计（纯函数，不读文件、不调模型）：按句切分（。！？…；，切分符不含逗号；
+ * 保留句文本），三条指标互相独立、命中才报，返回 warn 消息数组（level/file
+ * 由调用方挂）：
+ *   a. 连续同式开头——取最长的同前缀连续句段，达到 STYLE_REPEAT_RUN 报一次/章；
+ *   b. 比喻词密度——METAPHOR_WORDS 总次数 / 千 CJK 字超过 STYLE_METAPHOR_PER_KILO
+ *      （分母用 countCjk，与全库字数统计同口径）；
+ *   c. 句长波动——句数达 STYLE_SENTENCE_MIN 且变异系数（总体标准差/均值）
+ *      低于 STYLE_SENTENCE_CV_MIN。
+ */
+export function checkChapterStyle(body) {
+  const text = String(body ?? '')
+  const messages = []
+  const sentences = text
+    .split(/[。！？…；]+/)
+    .map((s) => s.trim())
+    .filter((s) => s !== '')
+  if (sentences.length === 0) return messages
+  // a. 连续同式开头：一次线性扫描，记最长的同前缀连续段
+  let best = null
+  let curPrefix = null
+  let curRun = 0
+  for (const sentence of sentences) {
+    const prefix = sentence.slice(0, 2)
+    if (prefix === curPrefix) curRun++
+    else {
+      curPrefix = prefix
+      curRun = 1
+    }
+    if (best === null || curRun > best.run) best = { prefix, run: curRun }
+  }
+  if (best.run >= STYLE_REPEAT_RUN) {
+    messages.push(`疑似句式重复：连续 ${best.run} 句以「${best.prefix}」开头`)
+  }
+  // b. 比喻词密度：字面总次数 / 千 CJK 字，严格超过阈值才报
+  let metaphorCount = 0
+  for (const word of METAPHOR_WORDS) metaphorCount += text.split(word).length - 1
+  const kilo = countCjk(text) / 1000
+  if (kilo > 0 && metaphorCount / kilo > STYLE_METAPHOR_PER_KILO) {
+    messages.push(
+      `比喻词密度偏高：${metaphorCount} 处 / ${Number(kilo.toFixed(1))}千字（阈值 ${STYLE_METAPHOR_PER_KILO}/千字）——AI 味风险`,
+    )
+  }
+  // c. 句长波动：句数足够且变异系数过低才报（均值 0 只可能全空句，已被过滤）
+  if (sentences.length >= STYLE_SENTENCE_MIN) {
+    const lengths = sentences.map((s) => s.length)
+    const mean = lengths.reduce((sum, l) => sum + l, 0) / lengths.length
+    if (mean > 0) {
+      const variance = lengths.reduce((sum, l) => sum + (l - mean) ** 2, 0) / lengths.length
+      const cv = Math.sqrt(variance) / mean
+      if (cv < STYLE_SENTENCE_CV_MIN) {
+        messages.push(
+          `句长节奏过平：${sentences.length} 句变异系数 ${cv.toFixed(2)}（阈值 ${STYLE_SENTENCE_CV_MIN.toFixed(2)}）——长短句交替不足`,
+        )
+      }
+    }
+  }
+  return messages
+}
+
 /**
  * 静态体检（五期 §9.6）：只查文件规范，不调模型。返回
  *   { ok, problems: [{ level: 'error'|'warn', file, message }], summary }
@@ -806,6 +921,16 @@ export function checkProject(novelDir) {
   const problems = []
   const push = (level, file, message) => problems.push({ level, file, message })
 
+  // H2：顶层数组账本 yml 的极简解析告警（零缩进散键被丢弃等）并入 problems——
+  // 与面板快照的 warnings 通道对齐，散键不能再静默蒸发。
+  const readAccountYml = (name) => readYamlArray(novelDir, name, (w) => push('warn', name, w))
+  // M9：账本章节引用统一校验——空值是「未填」不算悬空，指向未写章节报 error
+  // （口径与 foreshadows planted_chapter 的既有引用校验一致）。
+  const refCheck = (file, label, field, ref) => {
+    if ((typeof ref !== 'string' || ref.trim() === '') && typeof ref !== 'number') return
+    if (!chapterRefExists(ref, stems, nums)) push('error', file, `${label}的 ${field} 引用章节不存在：${ref}`)
+  }
+
   // —— chapters/：frontmatter 完整性、枚举、章号卷号一致 ——
   const chaptersDir = path.join(novelDir, 'chapters')
   const chapterFiles = listMdFiles(chaptersDir)
@@ -813,6 +938,9 @@ export function checkProject(novelDir) {
 
   const stems = new Set()
   const nums = new Set()
+  // 全书已写章节的最大卷章序数（vol,num）：伏笔超期检查的比对基准。规范文件名
+  // 优先；不合规范但 frontmatter 卷号章号可解析的章按 frontmatter 口径补入。
+  let maxWritten = null
   for (const file of chapterFiles) {
     const stem = file.slice(0, -3)
     stems.add(stem)
@@ -824,10 +952,12 @@ export function checkProject(novelDir) {
     }
     let meta = {}
     let fmRaw = null
+    let chapterBody = '' // AI 味统计要在循环尾用正文，try 块里的 parsed 出了作用域
     try {
       const parsed = parseChapterFile(readFileSync(path.join(chaptersDir, file), 'utf8'))
       meta = parsed.meta
       fmRaw = parsed.raw
+      chapterBody = parsed.body
     } catch {
       push('error', rel, '章节文件读取失败')
       continue
@@ -844,6 +974,16 @@ export function checkProject(novelDir) {
       push('error', rel, `status 越枚举：${meta.status}（合法值 pending|writing|review|accepted）`)
     }
     if (Number.isInteger(meta.num)) nums.add(meta.num)
+    // 汇总最大卷章序数：文件名可解析用文件名；否则退 frontmatter volume+num
+    // （裸章号口径的卷号记 0）。vol*1000+num 线性化比较——单卷章数远不到千。
+    const ordNum = key !== null ? key.num : (Number.isInteger(meta.num) ? meta.num : null)
+    if (ordNum !== null) {
+      const volMatch = /^v(\d+)$/.exec(typeof meta.volume === 'string' ? meta.volume.trim() : '')
+      const ordVol = key !== null ? key.vol : (volMatch !== null ? Number(volMatch[1]) : 0)
+      if (maxWritten === null || ordVol * 1000 + ordNum > maxWritten.vol * 1000 + maxWritten.num) {
+        maxWritten = { vol: ordVol, num: ordNum }
+      }
+    }
     const missingDims = FIVE_DIM_KEYS.filter((k) => meta[k] === undefined || meta[k] === '')
     if (missingDims.length > 0) push('warn', rel, `五维字段缺失：${missingDims.join('、')}`)
     if (meta.summary === undefined || meta.summary === '') push('warn', rel, 'summary 缺失（index.yml 与 stats 直接引用）')
@@ -865,16 +1005,25 @@ export function checkProject(novelDir) {
     if (typeof meta.writer === 'string' && meta.writer !== '' && !CHAPTER_WRITERS.includes(meta.writer)) {
       push('error', rel, `writer 越枚举：${meta.writer}（合法值 author|ai）`)
     }
+    // AI 味统计（warn）：只查有正文的章；指标与阈值见 checkChapterStyle
+    if (chapterBody.trim() !== '') {
+      for (const message of checkChapterStyle(chapterBody)) push('warn', rel, message)
+    }
   }
 
   // —— foreshadows.yml：状态枚举、id 去重、章节引用、状态-字段自洽 ——
-  const foreshadows = readYamlArray(novelDir, 'foreshadows.yml')
+  const foreshadows = readAccountYml('foreshadows.yml')
   const seenIds = new Map()
   foreshadows.forEach((f, i) => {
     const label = typeof f.id === 'string' && f.id !== '' ? f.id : `第 ${i + 1} 条`
     if (typeof f.status === 'string' && f.status !== '' && !FORESHADOW_STATUSES.includes(f.status)) {
       push('error', 'foreshadows.yml', `伏笔 ${label} status 越枚举：${f.status}（合法值 ${FORESHADOW_STATUSES.join('|')}）`)
     }
+    // M9：source 枚举（模板声明 plan|backfill）——缺省不报，面板快照侧同样把
+    // 非 backfill 归一成 plan，两侧口径一致
+    if (typeof f.source === 'string' && f.source !== '' && !FORESHADOW_SOURCES.includes(f.source)) {
+      push('error', 'foreshadows.yml', `伏笔 ${label} source 越枚举：${f.source}（合法值 ${FORESHADOW_SOURCES.join('|')}）`)
+    }
     if (typeof f.id === 'string' && f.id !== '') {
       if (seenIds.has(f.id)) push('error', 'foreshadows.yml', `伏笔 id 重复：${f.id}（第 ${seenIds.get(f.id) + 1} 条与第 ${i + 1} 条）`)
       else seenIds.set(f.id, i)
@@ -917,12 +1066,45 @@ export function checkProject(novelDir) {
     ) {
       push('error', 'foreshadows.yml', `伏笔 ${label} 的 resolved_chapter（${resolvedRef}）早于 planted_chapter（${f.planted_chapter}）`)
     }
+    // 清理纪律（skills/maoying-foreshadow-discipline/SKILL.md「清理纪律」：
+    // planted 超过 30 章未推进应升级推进或弃用）：planted 且埋设章可解析时，
+    // 与全书已写章节的最大卷章序数求间隔章数，超过阈值给 warn。
+    // abandoned/resolved/progressing 不查，埋设章解析不出（非规范写法）跳过。
+    // 与上面 expected_resolve 的反向提醒语义不同（那边查排期目标章是否已写出，
+    // 这边查时间跨度），同一条伏笔可能双报——允许。
+    if (f.status === 'planted' && plantedOrd !== null && maxWritten !== null) {
+      // 带卷引用按 vol*1000+num 线性化相减（卷内即章号差，跨卷差值上千、必然
+      // 超阈值）；裸章号无卷信息，与最大章号直接相减（同 nums 的存在性口径）。
+      const gap =
+        plantedOrd.vol === 0
+          ? maxWritten.num - plantedOrd.num
+          : maxWritten.vol * 1000 + maxWritten.num - (plantedOrd.vol * 1000 + plantedOrd.num)
+      if (gap > FORESHADOW_STALE_CHAPTERS) {
+        push('warn', 'foreshadows.yml', `伏笔 ${label} 埋设于 ${f.planted_chapter}，已 ${gap} 章未推进（阈值 ${FORESHADOW_STALE_CHAPTERS} 章）——确认是否遗忘`)
+      }
+    }
+  })
+
+  // —— volumes.yml：id 去重（M8：重复 id 会让同批章节被 filter 重复计入多个
+  // 卷，卷字数之和 ≠ total；写法对齐 foreshadows id 去重）——
+  const volumes = readAccountYml('volumes.yml')
+  const seenVolIds = new Map()
+  volumes.forEach((v, i) => {
+    if (typeof v.id === 'string' && v.id !== '') {
+      if (seenVolIds.has(v.id)) {
+        push('error', 'volumes.yml', `分卷 id 重复：${v.id}（第 ${seenVolIds.get(v.id) + 1} 条与第 ${i + 1} 条）——同 id 卷会把章节重复计入`)
+      } else {
+        seenVolIds.set(v.id, i)
+      }
+    }
   })
 
   // —— timeline.yml：年份可解析、不倒挂（warn：故事内纪年本就允许花写）——
-  const timeline = readYamlArray(novelDir, 'timeline.yml')
+  const timeline = readAccountYml('timeline.yml')
   let prevYear = null
   timeline.forEach((t, i) => {
+    // M9：chapter 指向已写正文；放在年份解析之前，免得花写年份把引用校验跳过
+    refCheck('timeline.yml', `第 ${i + 1} 条时间线`, 'chapter', t.chapter)
     const parsed = parseTimelineYear(t.year)
     if (parsed === null) {
       push('warn', 'timeline.yml', `第 ${i + 1} 条 year 无法解析为数字：${t.year}`)
@@ -934,14 +1116,34 @@ export function checkProject(novelDir) {
     prevYear = parsed
   })
 
+  // —— memories.yml：category 枚举 + source_chapter 引用（M9 补对称校验，
+  // 枚举以 templates/novel/memories.yml 声明为准）——
+  readAccountYml('memories.yml').forEach((m, i) => {
+    if (typeof m.category === 'string' && m.category !== '' && !MEMORY_CATEGORIES.includes(m.category)) {
+      push('error', 'memories.yml', `第 ${i + 1} 条记忆 category 越枚举：${m.category}（合法值 ${MEMORY_CATEGORIES.join('|')}）`)
+    }
+    refCheck('memories.yml', `第 ${i + 1} 条记忆`, 'source_chapter', m.source_chapter)
+  })
+
+  // —— clue-board.yml：kind 枚举 + related_chapter 引用（M9 补对称校验，
+  // 枚举以 templates/novel/clue-board.yml 声明为准）——
+  readAccountYml('clue-board.yml').forEach((c, i) => {
+    if (typeof c.kind === 'string' && c.kind !== '' && !CLUE_KINDS.includes(c.kind)) {
+      push('error', 'clue-board.yml', `第 ${i + 1} 条线索 kind 越枚举：${c.kind}（合法值 ${CLUE_KINDS.join('|')}）`)
+    }
+    refCheck('clue-board.yml', `第 ${i + 1} 条线索`, 'related_chapter', c.related_chapter)
+  })
+
   // —— relations.yml：a/b 角色有卡（warn：可能是已死亡/未建档角色，故不升 error）——
   const cards = collectCharacterCards(novelDir)
   const knownRoles = new Set(cards.map((c) => c.slug))
   for (const card of cards) {
     if (typeof card.meta.name === 'string' && card.meta.name !== '') knownRoles.add(card.meta.name)
   }
-  const relations = readYamlArray(novelDir, 'relations.yml')
+  const relations = readAccountYml('relations.yml')
   relations.forEach((r, i) => {
+    // M9：started/ended 指向已写正文（ended 空串是「未结束」，refCheck 视作未填跳过）
+    for (const k of ['started', 'ended']) refCheck('relations.yml', `第 ${i + 1} 条关系`, k, r[k])
     for (const side of ['a', 'b']) {
       const value = typeof r[side] === 'string' ? r[side].trim() : ''
       if (value !== '' && !knownRoles.has(value)) {
@@ -950,6 +1152,17 @@ export function checkProject(novelDir) {
     }
   })
 
+  // —— outlines/*.md：章纲缺「钩子」小节（warn：章纲本身可选，写了就须带钩子节）——
+  // 章纲纯 markdown 无 frontmatter；「钩子」或「章尾钩子」须独立成节写明
+  // （#{1,3} 级标题行，见 OUTLINE_HOOK_RE）。空 outlines/ 目录（或缺目录）不报。
+  const outlinesDir = path.join(novelDir, OUTLINES_DIR)
+  for (const file of listMdFiles(outlinesDir)) {
+    const text = readTextOrNull(path.join(outlinesDir, file))
+    if (text !== null && !OUTLINE_HOOK_RE.test(text)) {
+      push('warn', outlineFile(file.slice(0, -3)), '章纲缺「钩子」小节（## 钩子 或 ## 章尾钩子）——章尾钩子须独立成节写明')
+    }
+  }
+
   // —— characters/*.md：name 缺失是硬伤；重复键给 warn ——
   for (const card of cards) {
     if (typeof card.meta.name !== 'string' || card.meta.name.trim() === '') {
@@ -988,12 +1201,14 @@ export function checkProject(novelDir) {
       if (!hasWorldLore) {
         push('error', 'world/', 'phase 已过 setting 但 world/ 与 science/ 均无条目（setting → outline 判据：世界观核心条目须落盘）')
       }
-      if (readYamlArray(novelDir, 'volumes.yml').length === 0) {
+      // 复用上方已读的 volumes / relations（M8/H2 起 readAccountYml 带告警采集，
+      // 这里重复读会导致同一份文件告警计两次）
+      if (volumes.length === 0) {
         push('error', 'volumes.yml', 'phase 已过 setting 但 volumes.yml 为空或缺失（setting → outline 判据：分卷规划须在案）')
       }
       // 关系网判据（六期补）：两张及以上角色卡时 relations.yml 不得为空——
       // 空关系网意味着设定阶段漏登关系，关系图与大纲师的戏剧权重都无从谈起。
-      if (cards.length >= 2 && readYamlArray(novelDir, 'relations.yml').length === 0) {
+      if (cards.length >= 2 && relations.length === 0) {
         push('error', 'relations.yml', 'phase 已过 setting 但 relations.yml 为空（setting → outline 判据：两张及以上角色卡时关系网须登记）')
       }
     }