@oh-story/dsh 0.1.8 → 0.1.9

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

@@ -22,7 +22,7 @@ const path = require('path')
 const FIELDS = [
   '核心事件', '字数目标', '字数口径', '阶段位置', '单元ID/位置', '目标情绪',
   '主角目标/关键选择', '章节定位', '本章结构公式', '章首钩子', '爽点',
-  '本章禁止提前释放', '契约风险',
+  '本章标价', '闭环状态', '本章禁止提前释放', '写手自由区', '契约风险',
 ]
 const SUBSECTIONS = ['内容概括', '情节安排', '人物关系和出场顺序', '情节细化']
 const FIVE_ACT = ['起因', '发展', '转折', '高潮', '结尾']
@@ -46,11 +46,11 @@ function readUtf8(file) {
   }
 }
 
-function makeCheck(id, ok, file, evidence, expected, repair) {
+function makeCheck(id, ok, file, evidence, expected, repair, severity = 'blocking') {
   return {
     id,
     ok,
-    severity: 'blocking',
+    severity,
     file,
     evidence,
     expected,
@@ -65,7 +65,47 @@ function parseTableRow(line) {
   return trimmed.slice(1, -1).split('|').map((cell) => cell.replace(/\*\*/g, '').replace(/`/g, '').trim())
 }
 
-function verify(file) {
+function resolveBookRoot(file, projectRoot) {
+  if (projectRoot) return path.resolve(projectRoot)
+  const parent = path.dirname(path.resolve(file))
+  if (path.basename(parent) === '大纲') return path.dirname(parent)
+  return null
+}
+
+// 项目引用须写目录路径；裸文件名可能指向 skill reference，不猜测其归属。
+const REF_DIR_PREFIX = /^(?:设定|大纲|追踪|正文|读者笔记|对标)\//
+
+function checkSettingRefs(text, name, file, projectRoot) {
+  const bookRoot = resolveBookRoot(file, projectRoot)
+  if (!bookRoot) {
+    return makeCheck('outline.setting-refs-exist', true, name, '未能定位书目录（细纲不在 大纲/ 下且未传 --project），跳过', '细纲引用的项目内文件真实存在', '无需修复。')
+  }
+  const refs = new Set()
+  const pattern = /`([^`\n]+?\.md)[^`\n]*`/g
+  let match
+  while ((match = pattern.exec(text)) !== null) {
+    const token = match[1].trim().replace(/\\/g, '/')
+    if (token.includes('{') || token.includes('}')) continue
+    if (REF_DIR_PREFIX.test(token) || /^\.{1,2}\//.test(token)) refs.add(token)
+  }
+  const missing = []
+  for (const token of refs) {
+    const base = /^\.{1,2}\//.test(token) ? path.dirname(path.resolve(file)) : bookRoot
+    try {
+      if (!fs.statSync(path.resolve(base, token)).isFile()) missing.push(token)
+    } catch { missing.push(token) }
+  }
+  return makeCheck(
+    'outline.setting-refs-exist',
+    missing.length === 0,
+    name,
+    missing.length ? `引用的路径不是可用文件：${missing.join('、')}` : `${refs.size} 处项目内引用全部存在`,
+    '细纲引用的每个项目内 .md 文件都真实存在——不许把槽位指向查无实据的权威文件',
+    '修正引用路径；或按「创作自主权分级」先把缺的设定落档（B 级直接补、C 级进《供给单》提案），再在细纲引用。'
+  )
+}
+
+function verify(file, projectRoot = null) {
   const name = path.basename(file)
   const read = readUtf8(file)
   const checks = []
@@ -133,21 +173,82 @@ function verify(file) {
   let header = null
   for (const line of lines) {
     const cells = parseTableRow(line)
-    if (cells && cells.length === 4 && PLOT_HEADER_FIRST.test(cells[0])) {
+    // 四列是旧表（# / 情节点 / 功能标签 / 执行边界），五列是现行模板（中间多一列「分辨率」）。
+    // 两种都收：功能标签固定在第 3 列，执行边界一律取最后一列，旧细纲不因加列而失效。
+    if (cells && (cells.length === 4 || cells.length === 5) && PLOT_HEADER_FIRST.test(cells[0])) {
       header = cells
       break
     }
   }
-  const headerOk = Boolean(header) && header[2].includes('功能标签') && header[3].includes('执行边界')
+  const headerOk = Boolean(header)
+    && header[2].includes('功能标签')
+    && header[header.length - 1].includes('执行边界')
+    && (header.length === 4 || header[3].includes('分辨率'))
   checks.push(makeCheck(
     'outline.plotpoint-table',
     headerOk,
     name,
-    header ? `表头：${header.join(' | ')}` : '未找到 | # | 情节点 | 功能标签 | 执行边界 | 表头',
-    '情节细化使用四列表格：# / 情节点（谁做了什么） / 功能标签 / 执行边界',
-    '只把情节点序列改成四列表格，逐点补功能标签与执行边界；不增删情节点本身。'
+    header ? `表头：${header.join(' | ')}` : '未找到 | # | 情节点 | 功能标签 | [分辨率] | 执行边界 | 表头',
+    '情节细化使用五列表格：# / 情节点（谁做了什么） / 功能标签 / 分辨率 / 执行边界（四列旧表仍收，但新建细纲按五列模板走）',
+    '只把情节点序列改成五列表格，逐点补功能标签、分辨率与执行边界；不增删情节点本身。'
   ))
 
+  // 「放」半边：五列表的执行边界必须至少一个点解除限制（模板既有要求），
+  // 全是禁令的情节点表实测会把整章压成同一个温度（015 章十一个点全「不许」）。
+  if (headerOk && header.length === 5) {
+    const rows = []
+    for (const line of lines) {
+      const cells = parseTableRow(line)
+      if (cells && cells.length === 5 && /^\d+$/.test(cells[0])) rows.push(cells)
+    }
+    if (rows.length) {
+      const released = rows.filter((cells) => {
+        const match = cells[4].match(/(?:^|[。；;\s])放\s*[：:]([^]*?)(?=(?:禁|放)\s*[：:]|$)/)
+        if (!match) return false
+        const value = match[1].replace(/[\s。；;，,、\[\]【】]/g, '')
+        return value.length > 0 && !/^(?:无|暂无|待补充|待定|无缺口)$/.test(value)
+      })
+      checks.push(makeCheck(
+        'outline.plotpoint-release',
+        released.length > 0,
+        name,
+        `${rows.length} 个情节点里 ${released.length} 个写了「放」`,
+        '执行边界写成「禁＋放」两半，每章至少一个点写了「放」——放行是解除限制，不是义务',
+        '给最该出彩的一两个点补「放」半边（谁可以出声、谁可以失态、允不允许当场标价），不改情节点本身。'
+      ))
+      if (released.length > 0 && rows.length >= 3 && released.length * 3 < rows.length) {
+        checks.push(makeCheck(
+          'outline.plotpoint-release-ratio',
+          false,
+          name,
+          `${rows.length} 个情节点里只有 ${released.length} 个写了「放」（不足三分之一）`,
+          '建议至少三分之一的情节点写「放」半边，避免整章只剩禁令',
+          '按人工判断酌情补「放」；本项不阻断。',
+          'advisory'
+        ))
+      }
+    }
+  }
+
+  // 章级「禁止提前释放」只写本章特有的三五条；条目过多多半是把卷级常任禁忌逐章复读了。
+  const releaseMatch = text.match(/^\s*[-*+]\s*\*{0,2}本章禁止提前释放\*{0,2}\s*[：:]\s*(.*)$/m)
+  if (releaseMatch) {
+    const items = releaseMatch[1].split(/[、；;，,\/]/).map((s) => s.trim()).filter(Boolean)
+    if (items.length > 5) {
+      checks.push(makeCheck(
+        'outline.release-brevity',
+        false,
+        name,
+        `本章禁止提前释放列了 ${items.length} 条`,
+        '章级只写本章特有的三五条；卷级常任禁忌写在卷纲「本卷禁碰的终局底牌」，不逐章复读',
+        '把与卷纲常任重复的条目删掉，只留本章特有；本项不阻断。',
+        'advisory'
+      ))
+    }
+  }
+
+  checks.push(checkSettingRefs(text, name, file, projectRoot))
+
   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)
@@ -164,7 +265,8 @@ function verify(file) {
 }
 
 function report(file, checks) {
-  const failures = checks.filter((check) => !check.ok)
+  const failures = checks.filter((check) => !check.ok && check.severity === 'blocking')
+  const advisories = checks.filter((check) => !check.ok && check.severity === 'advisory')
   return {
     schema_version: 1,
     verifier: 'story-long-write.outline-contract',
@@ -172,6 +274,7 @@ function report(file, checks) {
     ok: failures.length === 0,
     checks,
     failures,
+    advisories,
     repair_scope: failures.map((failure) => ({
       id: failure.id,
       file: failure.file,
@@ -200,13 +303,65 @@ function resolveChapter(project, chapter) {
   return { file: path.join(dir, hit) }
 }
 
+// --supply：批末验证《供给单》已落卷纲——定位单元卡块，确认其中有「供给自查」小节。
+function verifySupply(volumeFile, unitId) {
+  const read = readUtf8(volumeFile)
+  if (!read.ok) {
+    return { schema_version: 1, verifier: 'story-long-write.outline-supply', file: path.resolve(volumeFile), unit: unitId, ok: false, evidence: read.error || '卷纲文件为空' }
+  }
+  // 只检查目标单元内的标题，不把正文提及或代码示例当成小节。
+  let fence = null
+  const lines = read.text.split(/\r?\n/).map((line) => {
+    const marker = line.match(/^\s{0,3}(`{3,}|~{3,})/)
+    if (marker) {
+      if (!fence) fence = marker[1]
+      else if (marker[1][0] === fence[0] && marker[1].length >= fence.length) fence = null
+      return ''
+    }
+    return fence ? '' : line.replace(/\*\*/g, '')
+  })
+  const headings = []
+  for (let index = 0; index < lines.length; index++) {
+    const heading = lines[index].match(/^(#{1,6})\s+(.+)$/)
+    if (heading) headings.push({ index, level: heading[1].length, title: heading[2] })
+  }
+  const card = headings.find((heading) => {
+    const id = heading.title.match(/剧情单元\s+([A-Za-z][\w-]*)/)
+    if (id) return id[1] === unitId
+    const end = headings.find((next) => next.index > heading.index)?.index ?? lines.length
+    return lines.slice(heading.index + 1, end).some((line) => {
+      const field = line.match(/^\s*[-*+]\s*单元ID\s*[：:]\s*([A-Za-z][\w-]*)\s*$/)
+      return field?.[1] === unitId
+    })
+  })
+  const end = card ? (headings.find((next) => next.index > card.index && next.level <= card.level)?.index ?? lines.length) : 0
+  const ok = Boolean(card) && headings.some((heading) => heading.index > card.index && heading.index < end && /^供给自查(?:\s|[（(]|$)/.test(heading.title))
+  if (!card) {
+    return { schema_version: 1, verifier: 'story-long-write.outline-supply', file: path.resolve(volumeFile), unit: unitId, ok: false, evidence: `卷纲中未找到剧情单元 ${unitId}` }
+  }
+  return {
+    schema_version: 1,
+    verifier: 'story-long-write.outline-supply',
+    file: path.resolve(volumeFile),
+    unit: unitId,
+    ok,
+    evidence: ok ? '单元卡含「供给自查」小节' : `剧情单元 ${unitId} 的卡内没有「供给自查」小节——每批出细纲前须产出《供给单》（含「无缺口」情形），见 workflow-setup.md「按剧情批出细纲」步骤 3`,
+  }
+}
+
 function parseArgs(argv) {
   const files = []
   let project = null
   let chapter = null
+  let supply = null
   for (let index = 0; index < argv.length; index++) {
     const arg = argv[index]
     if (arg === '--json') continue
+    if (arg === '--supply') {
+      if (index + 2 >= argv.length) return null
+      supply = { volumeFile: argv[++index], unitId: argv[++index] }
+      continue
+    }
     if (arg === '--project' || arg === '--chapter') {
       if (index + 1 >= argv.length || argv[index + 1].startsWith('--')) return null
       const value = argv[++index]
@@ -217,6 +372,10 @@ function parseArgs(argv) {
     if (arg.startsWith('--')) return null
     files.push(arg)
   }
+  if (supply) {
+    if (project || chapter || files.length) return null
+    return { supply }
+  }
   if (project || chapter) {
     if (!project || !chapter || files.length || !/^\d+$/.test(chapter)) return null
     return { project, chapter }
@@ -228,9 +387,14 @@ function parseArgs(argv) {
 function main(argv) {
   const parsed = parseArgs(argv)
   if (!parsed) {
-    process.stderr.write('用法: node scripts/check-outline-contract.js --json <细纲路径...> | --json --project <书目录> --chapter N\n')
+    process.stderr.write('用法: node scripts/check-outline-contract.js --json <细纲路径...> | --json --project <书目录> --chapter N | --json --supply <卷纲路径> <单元ID>\n')
     return 2
   }
+  if (parsed.supply) {
+    const supplyReport = verifySupply(parsed.supply.volumeFile, parsed.supply.unitId)
+    process.stdout.write(`${JSON.stringify(supplyReport, null, 2)}\n`)
+    return supplyReport.ok ? 0 : 1
+  }
   let targets = parsed.files
   if (!targets) {
     const resolved = resolveChapter(parsed.project, parsed.chapter)
@@ -240,7 +404,7 @@ function main(argv) {
     }
     targets = [resolved.file]
   }
-  const reports = targets.map((file) => verify(file))
+  const reports = targets.map((file) => verify(file, parsed.project || null))
   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

package/lib/oh-story/skills/story-long-analyze/SKILL.md

@@ -14,7 +14,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 > Agent 兼容性：只检查当前运行时的 canonical 目录：Claude `.claude/agents/{agent}.md`、OpenCode `.opencode/agents/{agent}.md`、Codex `.codex/agents/{agent}.toml`、Antigravity `.agents/agents/agent-name/agent.md`（`agent-name` 为目标 agent 名），不得因其他端文件存在而误判。Codex 使用同名 `agent_type`；Antigravity 使用 `invoke_subagent` + `TypeName`。对应运行时未暴露 custom-agent registry / `invoke_subagent` 或返回未知 agent 时，必须降级 solo/direct。检测到 `.zcode/` 时同样直接 solo/direct，因为 ZCode 3.3.4 不执行项目 custom agents；报告 `Fallback: project custom agents unavailable -> solo`。Claude/OpenCode 兼容面保留 `subagent_type`。
 >
-> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 29` 不一致时（标记缺失、字段缺失/非整数、小于或大于 29）**照常按文件存在性检查并 spawn**，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 29）` 并提示重新运行 `/story-setup` 后新开会话；大于 29 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 30` 不一致时（标记缺失、字段缺失/非整数、小于或大于 30）**照常按文件存在性检查并 spawn**，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 30）` 并提示重新运行 `/story-setup` 后新开会话；大于 30 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
 
 ## 拆解边界声明（主线程同样适用）
 

package/lib/oh-story/skills/story-long-write/SKILL.md

@@ -25,7 +25,9 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 > 内置适配 Claude Code / OpenCode / Codex / Antigravity / ZCode / OpenClaw。专业 agent 只查当前端 canonical 目录（`.claude/agents`、`.opencode/agents`、`.codex/agents` TOML、`.agents/agents`）；Antigravity 用 `invoke_subagent` + 同名 `TypeName`。文件或运行时能力缺失、返回 unknown agent，或当前为不执行 custom agents 的 ZCode 3.3.4 时，报告 fallback 并 solo/direct 执行。
 >
-> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 29` 不一致时（标记缺失、字段缺失/非整数、小于或大于 29）**照常按文件存在性检查并 spawn**，但只检查当前运行时的 canonical 目录；同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 29）` 并提示重新运行 `/story-setup` 后新开会话；大于 29 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 30` 不一致时（标记缺失、字段缺失/非整数、小于或大于 30）**照常按文件存在性检查并 spawn**，但只检查当前运行时的 canonical 目录；同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 30）` 并提示重新运行 `/story-setup` 后新开会话；大于 30 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
+
+**文风裁决**：正文写作、改写或审稿前先读 [references/style-resolution.md](references/style-resolution.md)，加载本书文风并形成 `style_resolution`；无作者记忆也执行。当前请求、本书文风和 active 偏好按维度覆盖通用 references；同一裁决交给后续执行者。
 
 ## 核心方法
 
@@ -36,7 +38,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 3. **用模块组装，不要重新发明**。每个题材都有验证过的剧情模式——反转怎么铺、爽点怎么爆、感情怎么拉扯。找到对的模块，把对标书的具体角色看成功能位（对手/盟友/催化剂），再映射到你的角色。用你自己的素材填充这些功能位。
 4. **只加载必需信息**。写每章只读“不知道就会写错”的角色状态、待收伏笔、相关设定。其余留在文件系统里。
 5. **契约与推进决策走权威参考文件**。涉及读者契约、主角代理权、利益安全、期待债、终局储备（终局底牌/升级台阶）、机构/势力边界和 契约安全 / 需补强 / 契约破坏 风险判定时，先按 `references/reader-contract-and-progression.md` 校准，不在 SKILL.md 内复制长规则。
-6. **复用作者习惯**。若作者记忆 state 已存在，正文前用 `scripts/author_memory_commit.py query --kind prose_style --kind story_design` 获取本次相关 active 条目（总输出 ≤2KB），原样传给实际正文/改写 agent；设定/大纲按任务查询其他 kind。硬门禁、当前请求、本书设定/文风优先。明确长期声明在收尾用 `record` 写入并回传回执；完整规则见 [references/author-memory.md](references/author-memory.md)，不混入追踪。
+6. **作者记忆**：按 [references/author-memory.md](references/author-memory.md) 查询本次相关 active 项、≤2KB，正文前原样传给执行者；当前请求、本书文风优先。长期声明用 `record` 写入并回传回执。
 
 | 题材 | 核心情绪 | 重点参考 |
 |------|---------|---------|
@@ -87,6 +89,18 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 > **拆文库/对标关系**：`拆文库/` = analyze skill 的原始产出，是数据源。`对标/` = 写作项目的引用视图，存放与本项目相关的对标数据子集。首次引用对标书时，从 `拆文库/{书名}/` 复制相关子目录（章节/角色/剧情/设定）、`剧情/节奏.md`、`剧情/情绪模块.md`、`文风.md` 和 `拆文报告.md` 到 `对标/{书名}/`。
 >
 > **对标书路径查找**：优先 `{项目}/对标/{书名}/`，不存在则回退 `拆文库/{书名}/`。下文所有对标数据加载均使用此规则。
+>
+> **卷纲不整读（取段器）**：任何场景要卷纲内容一律走
+> `{PYTHON} {skill 根}/scripts/outline_view.py --unit {单元ID} {卷纲路径}`（脚本统一输出 UTF-8），
+> 只要契约不要单元时用 `--contract`，先看一屏目录用 `--toc`。
+> **两档分明**：**写正文用 `--stage write`**（卷级常任＋单元级，批次底稿一概不给）；**排纲/补纲用默认 `--stage outline`**（另带该单元在用的批次底稿）。
+> 供给自查、建纲追加、批次级复检这类底稿是**排纲期的工作底稿，写作期不是输入**——它们里头凡有写作期约束力的条目，
+> 建纲时就必须下沉到单元级段或细纲（`--check` 的 W1 告警专盯这个）。
+> 取的是**闭包不是点名段**——输出恒等于「全部卷级常任段 ＋ 该单元的单元级段 ＋ 该单元在用的批次底稿」，逐章表（情绪弧线等）按该单元章区间裁行，
+> 带退役标记的行默认不输出（要看历史加 `--history`）。
+> 找不到单元时脚本 exit 1 并报错，不静默降级——报错就去核对单元ID或先补卷纲，不要改用整读绕过。
+> 段头的 `> 作用域：` 声明是这套的地基，格式与 checker 见 `references/artifact-protocols.md` 卷纲模板；
+> 未声明作用域的段会被保守纳入并告警，跑 `outline_view.py --check {卷纲路径}` 修。
 
 ---
 
@@ -116,112 +130,9 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### Phase 4：正文写作辅助
 
-#### 项目文件结构
-
-长篇写作必须用文件系统管理，不要把内容堆在对话里。在用户指定的工作目录下创建：
-
-```
-{书名}/
-├── 设定/
-│   ├── 世界观/
-│   │   ├── 背景设定.md        # 时代背景、地理、历史
-│   │   ├── 力量体系.md        # 修炼/能力/等级体系
-│   │   └── ...
-│   ├── 角色/
-│   │   ├── 沈栀.md            # 每个人物一个文件，文件名用角色名
-│   │   └── ...
-│   ├── 势力/
-│   │   ├── 天机阁.md          # 每个势力/组织一个文件
-│   │   └── ...
-│   ├── 关系.md                # 角色关系映射
-│   ├── 题材定位.md            # 题材核心梗+对标分析+终局底牌/升级台阶（防写无可写）
-│   └── 题材正文提示卡.md       # 题材正文核心：边界/期待/爽点/节奏/禁漂移
-├── 大纲/
-│   ├── 大纲.md                # 全书卷级结构
-│   ├── 卷纲_第一卷.md         # 每卷一个：对标结构坐标+剧情单元+情绪弧线(含章节定位)+人物弧线+伏笔+反转
-│   └── 细纲_第001章.md        # 每章一个：章节定位+事件+钩子(按章节定位,章首/章尾/段落级)+爽点+悬念
-├── 正文/
-│   ├── 第001章_章名.md
-│   └── ...
-├── 对标/                          ← 拆文产出的结构化资产
-│   └── {对标书名}/
-│       ├── 原文/
-│       │   ├── 第001章_章名.md
-│       │   └── ...
-│       ├── 角色/                  ← 从拆文库/结构化输出同步
-│       │   └── {角色名}.md
-│       ├── 剧情/                  ← 从拆文库/结构化输出同步
-│       │   ├── {剧情单元名}.md
-│       │   ├── 故事线.md
-│       │   ├── 节奏.md             # 关键信息推进 + 情绪触动点 + 爆发节奏（权威节奏索引）
-│       │   └── 情绪模块.md         # 读者需求/情绪引擎 + 可复现模块（权威模块索引）
-│       ├── 设定/                  ← 从拆文库/结构化输出同步
-│       │   ├── 世界观/             ← 按主题拆分到子目录
-│       │   │   ├── 背景设定.md
-│       │   │   ├── 力量体系.md
-│       │   │   ├── 地理.md
-│       │   │   └── 金手指.md
-│       │   └── 势力/
-│       │       └── {势力名}.md
-│       └── 拆文报告.md
-├── 追踪/
-│   ├── _tracking-state.json        ← 唯一结构化权威状态
-│   ├── 上下文.md                  ← 派生续写状态卡（固定 7 栏），≤12KB
-│   ├── 逐章记录/第NNN章.md          ← 未来相关紧凑记录，≤3072 字节
-│   ├── 角色状态/{角色名}.md         ← 派生核心角色当前快照
-│   ├── 伏笔.md                    ← 派生伏笔当前视图
-│   └── 时间线/{作者真相.md,读者已知.md}
-├── 参考资料/
-│   └── {topic}.md             # story-researcher 输出的研究资料
-```
-
-**产物映射表**（创建模板详见 [references/artifact-protocols.md](references/artifact-protocols.md)）：
-
-| 文件 | 粒度 | 创建阶段 | 读取时机 |
-|------|------|---------|---------|
-| 设定/关系.md | 全书 | Phase 2 | 按需：story-explorer relationship 查询、story-review 查设定（不在每章写作回路里逐章读） |
-| 设定/题材定位.md（含 `主对标书` 字段，多对标时必填） | 全书 | Phase 2 | Phase 3 大纲、每卷开始前、Phase 4 写前召回 |
-| 设定/题材正文提示卡.md | 全书/题材 | Phase 2（缺失则 Phase 4 写前即时生成） | Phase 4 每章写作前：按 `genre-prose-cards.md` 索引匹配后读取 `genre-prose-cards/` 目录对应单题材卡优先、`style-genre-modules.md` 通用模块兜底，与通用正文要求、情绪/节奏召回和文风一起组装 prompt |
-| 设定/角色/{角色名}.md、设定/势力/{名}.md | 角色/势力 | Phase 3 细纲后增量补全（首批含主角/主要角色） | Phase 4 状态筛选/写作 |
-| 设定/文风.md（自定义文风·优先级最高） | 本书 | 用户自写（Claude Code 可代写）；导入/拆解不覆盖 | Phase 4 每章写作前：含实质内容则取代对标文风作权威风格基 |
-| 对标/{书名}/文风.md | 对标书 | analyze Stage 6 输出 → story-import 显式绑定或本 skill 首次引用时同步 | Phase 4 每章写作前（文风召回；有自定义文风时降为参考/句长兜底） |
-| 大纲/卷纲_第X卷.md | 卷 | Phase 3 | Phase 4 写卷首章前 |
-| 追踪/_tracking-state.json | 全书 | Phase 3 初始化 | 唯一结构化权威，不进正文 prompt；每章运行 `tracking_commit.py check` 读取章号和修订号 |
-| 追踪/伏笔.md | 全书当前视图 | Phase 3 初始化 | 续写状态卡缺项时按 ID 定点查询；每 ID 只一行 |
-| 追踪/时间线/{作者真相.md,读者已知.md} | 全书当前事实/认知派生视图 | Phase 3 初始化 | 按作者真相或读者认知的实际问题选择视图 |
-| 对标/{书名}/拆文报告.md | 对标书 | 用户手动+analyze | Phase 2 核心设定、Phase 3 大纲、Phase 4 写作 |
-| 追踪/逐章记录/第NNN章.md | 章 | Phase 4 每章事务 | 日更不读；目标 ≤1536 字节、硬上限 3072 字节，按需查询历史原因 |
-| 追踪/上下文.md（续写状态卡，≤12KB） | 全书当前状态 | Phase 3 初始化 | 日更每章整份读；由事务工具整份重建，固定 7 栏 |
-| 参考资料/{topic}.md | 按需 | Phase 4（story-researcher 输出） | Phase 4 后续章节写作时复用 |
-| 追踪/角色状态/{角色名}.md | 核心角色 | 首次进入正文或导入初始化 | 久别角色按名读取一个小快照；目标 ≤4096 字节、硬上限 8192 字节；静态人设仍读 `设定/角色/` |
-| 对标/{书名}/角色/{角色名}.md | 对标书 | analyze 输出 | Phase 4 模块召回（角色参考） |
-| 对标/{书名}/剧情/{剧情单元名}.md | 对标书 | analyze 输出 | Phase 3 卷纲选段与细纲成批（剧情单元卡「对标剧情参照」）、Phase 4 模块召回（剧情模块参考） |
-| 对标/{书名}/剧情/情绪模块.md | 对标书 | analyze Stage 3 输出 → story-import 显式绑定或本 skill 首次引用时同步 | Phase 2 核心设定、Phase 3 大纲、Phase 4 每章写作前（读者需求 / 情绪引擎、可复现模块选择） |
-| 对标/{书名}/剧情/节奏.md | 对标书 | analyze Stage 3 输出 → story-import 显式绑定或本 skill 首次引用时同步 | Phase 3 大纲、Phase 4 每章写作前（关键信息推进、情绪触动点、爆发节奏参考） |
-| 对标/{书名}/设定/*.md | 对标书 | analyze 输出 | Phase 2 设定参考、Phase 4 世界观约束 |
-
-**缺失文件处理**：当前主产物缺失时显式修复，不拼装降级结果：
-1. **角色状态文件缺失** → 当前协议项目先运行 `tracking_commit.py check`，再重跑产生该状态的完整事务；已有正文但 `_tracking-state.json` 缺失时重新 `/story-import`。不得从前文临时推断后直接手写快照。
-2. **角色、普通剧情单元或设定等非主产物子目录缺失** → 按「对标书路径查找」查找项目视图与根目录数据源，仍缺失则跳过该可选模块。本条不适用于 `剧情/情绪模块.md` 和 `剧情/节奏.md`。
-3. **`剧情/情绪模块.md` / `剧情/节奏.md` 缺失** → 写前准备必须停下，设置 `missing_primary_contract: true` 并给出 `repair_action`：重跑 `/story-long-analyze` Stage 3+ 或重新 `/story-import`，不得用摘要文件假装已召回权威模块。
-4. **有对标书但 `文风.md` 缺失** → 若有 `设定/文风.md`（含实质内容）走自定义文风模式继续；否则日更文风召回 fail-fast，提示先运行 `/story-long-analyze` Stage 6 并 `/story-import` 同步。**完全无对标项目**则跳过文风召回、不阻塞（有 `设定/文风.md` 时用它写作）。情绪/节奏轴（`missing_primary_contract`）独立，自定义文风模式不豁免其 fail-fast。
-5. **伏笔/时间线文件缺失** → 视为当前语义检查点损坏，停止写正文；先运行 `tracking_commit.py check`，再用事务修复。卷纲/大纲中的计划不能代替已发生事实的当前检查点。
-6. **`设定/题材正文提示卡.md` 缺失** → 不阻塞；写前从 `设定/题材定位.md` 精确匹配 `references/genre-prose-cards.md` 索引，并只读取 `references/genre-prose-cards/` 中对应题材单卡（高/中/低置信照原卡标注），无命中再用 `references/style-genre-modules.md` 通用流派模块即时生成短 `genre_prose_card`。只有 `设定/题材定位.md` 也缺失时，退回细纲和目标平台做低置信题材卡，并在意图确认写明。
-
-**对标分析权威优先级（权威读取顺序）**：
-1. `剧情/情绪模块.md` 是读者需求 / 情绪引擎、爽文套路框架、可复现模块和重组指南的权威来源。
-2. `剧情/节奏.md` 是关键信息推进、章节扩写技法聚合、情绪触动点和爆发节奏的权威来源。
-3. `文风.md` 只管句长、标点、对话潜台词、原文锚点等风格；它不能覆盖情绪模块或节奏意图。**自定义文风 `设定/文风.md`（用户自写、不被导入/拆解覆盖）优先级高于对标 `文风.md`**：含实质内容时作权威风格基，对标文风降为参考与句长数值兜底；命中硬安全线的写法（`……` / 破折号 / 段间空行 / 碎句）仍按 narrative-writer 归一，自定义只接管句长 / 软标点 / 潜台词 / 情绪交替。
-4. `章节/第K章_摘要.md` 是具体章节证据，用来校验和补足权威索引，不反向覆盖 `情绪模块.md` / `节奏.md`。
-5. `拆文报告.md`、`剧情/故事线.md` 是投影/摘要；若与 `剧情/情绪模块.md` 或 `剧情/节奏.md` 冲突，写作以两个权威文件为准，并在写前准备 `gaps.conflict` 记录冲突来源。
-
-**文件组织原则：**
-- **人物一个一个文件**：`角色/角色名.md`，方便按需读取
-- **势力一个一个文件**：`势力/势力名.md`，组织/门派/家族/国家等
-- **世界观按主题拆分**：背景、力量体系、社会结构等各自独立
-- **细纲一章一个文件**：`细纲_第XXX章.md`，含钩子设计，与正文一一对应
-- **正文按章拆分**：每章一个文件，`第XXX章_章名.md`
-- 每章写完直接写入 `正文/` 目录，不要先输出到对话
+#### 项目文件与产物
+
+创建目录、首次引用对标、定位产物或遇到文件缺失时，先完整读取 [references/project-files.md](references/project-files.md)，按其中目录结构、产物映射、缺失处理和权威顺序执行；正常续写不重复加载目录表。
 
 #### 单章写作流程
 
@@ -249,91 +160,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ## 参考资料索引
 
-按场景加载，不一次全部加载。
-
-各场景的完整步骤按需加载，本文件只保留场景路由、项目文件结构与产物契约、参考索引：开书三阶段（Phase 1-3）在 `references/workflow-setup.md`，单章正文与质量检查（Phase 4-5）在 `references/workflow-chapter.md`，日更批量在 `references/workflow-daily.md`，回炉大修在 `references/workflow-revision.md`。
-
-### Phase 1：选题方向
-
-| 场景 | 加载文件 |
-|------|---------|
-| 确定题材类型 | `references/long-genre-catalog.md` |
-| 判断市场方向 | `references/genre-readers.md` |
-| 特殊题材考量 | `references/plot-special-topics.md` |
-| 女频长篇（题材/文案/平台/感情线） | `references/female-audience-writing.md` |
-
-### Phase 2：核心设定
-
-| 场景 | 加载文件 |
-|------|---------|
-| 设定人物 | `references/character-basics.md` |
-| 设计关系 | `references/character-relations.md` |
-| 题材框架与定位 | `references/long-genre-catalog.md` + `references/long-genre-mechanics.md` |
-| 创建 artifact | `references/artifact-protocols.md` |
-| 读者契约与主角高光 | `references/reader-contract-and-progression.md` |
-
-### Phase 3：大纲搭建
-
-| 场景 | 加载文件 |
-|------|---------|
-| 搭建大纲 | `references/outline-methods.md` |
-| 设计矛盾与结构 | `references/outline-conflict.md` |
-| 深度结构设计 | `references/outline-structure-theory.md` |
-| 节奏与升级感 | `references/outline-rhythm.md` |
-| 小纲与卡文 | `references/plot-core-methods.md` |
-| 选择叙事框架 | `references/plot-frameworks.md` |
-| 题材结构 | `references/genre-prose-cards.md` 索引 + `references/genre-prose-cards/` 单题材卡 |
-| 黄金三章 | `references/opening-design.md` |
-| 情绪弧线 | `references/emotional-arc-design.md` |
-| 契约/终局储备/剧情单元安全审查 | `references/reader-contract-and-progression.md` |
-| 反转设计 | `references/long-reversal.md` |
-| 细纲结构验收 | `scripts/check-outline-contract.js`（新建/补建后跑，只判字段与表结构） |
-
-### Phase 4：正文写作
-
-| 场景 | 加载文件 |
-|------|---------|
-| 章节钩子 | `references/long-chapter-hooks.md` |
-| 悬念设计 | `references/long-suspense.md` |
-| 题材正文提示卡 / 题材分类卡 | `references/genre-prose-cards.md` 索引 + `references/genre-prose-cards/` 单题材卡目录（按题材分类优先） + `references/style-genre-modules.md`（通用流派补充） |
-| 打斗/装逼 | `references/style-combat-face.md` |
-| 写作技法 | `references/style-craft.md` |
-| 商业创作核心方法 | `references/commercial-core-methods.md` |
-| 对话 | `references/dialogue-mastery.md` |
-| 人物深化 | `references/character-design-methods.md` |
-| 情绪技法 + 叙事单元 | `references/plot-emotion-system.md` + `references/emotional-methods.md` |
-| 写作技法全程参考 | `references/writing-craft.md` |
-| 格式 | `references/long-format.md`（章节、段落、对话、标点与工程元信息） |
-| 状态追踪协议 | `references/state-tracking.md` |
-| 当前剧情单元与契约校准 | `references/reader-contract-and-progression.md` |
-
-### Phase 5：质量检查
-
-| 场景 | 加载文件 |
-|------|---------|
-| 质量检查 | `references/long-chapter-quality.md` + `references/reader-contract-and-progression.md` |
-| 禁用词扫描 | `references/banned-words.md` |
-| AI句式脚本复扫 | `scripts/check-ai-patterns.js` |
-| 去AI味 | `references/anti-ai-writing.md` |
-
-### 按主题快速定位（横切主题）
-
-有些主题横跨多个阶段、散在多个文件里。下表给每个主题一个**权威文件**（先读它，通常够用），配套文件只在需要那个角度时再加载。括号是该文件里对应的小节。
-
-| 主题 | 权威文件（先读） | 配套文件（按角度补充） |
-|------|-----------------|----------------------|
-| 爽点（按意图分流） | **`references/plot-emotion-system.md`**（爽点设计体系：本质/六种类型/倒推法——"怎么设计爽点"先读这个） | 翻盘/高潮式爽点→`references/plot-core-methods.md`（假胜→崩解）· 打脸/装逼释放→`references/style-combat-face.md`· 题材声线与长线约束→`references/genre-prose-cards.md`· 爽文循环/多层→`references/outline-methods.md`·`references/outline-conflict.md` |
-| 情绪模块 | **`对标/{书名}/剧情/情绪模块.md`（项目/书级权威）**；无对标或设计新模块时再读 `references/plot-emotion-system.md` | `references/outline-rhythm.md` 只作理论参考；不得覆盖对标书权威模块 |
-| 节奏 | **`对标/{书名}/剧情/节奏.md`（项目/书级权威）**；无对标或设计新节奏时再读 `references/outline-rhythm.md` | `references/plot-core-methods.md` 只作理论参考；不得覆盖对标书权威节奏 |
-| 高潮 | **`references/plot-core-methods.md`**（高潮构建公式：蓄能→假胜→崩解） | `references/outline-rhythm.md`（高潮分类与反推）· `references/outline-methods.md`（八节点故事结构：结构定位） |
-| 金手指 | **`references/plot-special-topics.md`**（金手指拆分理解与战力防崩 + 进阶设计） | `references/outline-conflict.md`（金手指与身份：四点统一） |
-| 感情线 | **`references/character-relations.md`**（好感度体系/四阶段 + 男女频差异） | `references/outline-conflict.md`（感情线设计）· `references/style-combat-face.md`（后宫文女主 / 男频极简爱情线构型）· `references/plot-special-topics.md`（爱情线提纯策略） |
-| 反转 | **`references/long-reversal.md`**（单元/卷级/全书反转、铺垫、有效性自检） | `references/plot-core-methods.md`（假胜：先给希望再击碎） |
-| 人物 | **`references/character-basics.md`**（主角/配角/反派/动机模板速填） | `references/character-design-methods.md`（三层标签反差/九维深化）· `references/character-relations.md`（关系类型/感情线） |
-| 女频写作 | **`references/female-audience-writing.md`**（女频长篇：核心原则/文案/题材/感情线长线/平台） | `references/genre-readers.md`（读者心理/平台差异）· `references/character-relations.md`（感情线总框架） |
-| 去AI味 | **`references/anti-ai-writing.md`**（AI指纹/核心规则/Show Don't Tell） | `references/banned-words.md`（禁用词扫描）· `references/long-chapter-quality.md`（成稿检查） |
-
----
+阶段必读项按首屏 Reference Gate 执行；其他题材、结构与写作技法按 [参考索引](references/reference-index.md) 的加载条件选用。
 
 ## 语言