@oh-story/dsh 0.1.8 → 0.1.10

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

@@ -1,75 +1,10 @@
-# 状态追踪协议
+# 角色状态记录格式
 
-> 本文件定义"本节速记"的提取逻辑和"角色状态记录"的格式。写作 skill 在写前准备的状态筛选步骤中加载此文件。
-
----
-
-## 本节速记
-
-写作每一章/每一节前，从所有已加载的上下文中筛选出只与本节相关的信息。目的是避免全量加载导致 LLM 上下文被无关信息稀释。
-
-### 筛选逻辑
-
-从上下文中提取三类信息：
-
-1. **当前状态**：本章涉及角色的最新能力、关系变化、公众形象
-2. **历史因果**：与本章事件直接相关的伏笔成因、前史事件
-3. **世界约束**：本章涉及的世界观规则（力量体系、社会规则、地理限制）
-
-### 筛选标准
-
-**只保留"如果不知道这个，本章会写错"的信息。**
-
-具体判断方法：
-- 本章细纲中提到了某个角色 → 保留该角色的当前状态
-- 本章有伏笔回收 → 保留伏笔的埋设细节和前文铺垫
-- 本章涉及特定地点/能力/规则 → 保留相关世界观约束
-- 纯背景知识（与本章事件无因果关联） → 丢弃
-
-### 输出格式
-
-筛选后输出一个简洁的"本节速记"：
-
-```
-## 本节速记（第{N}章）
-
-### 角色状态
-{角色A}：{一句话当前状态，含最近变化}
-{角色B}：{一句话当前状态}
-
-### 相关伏笔/前史
-{伏笔1}：{埋设细节，{埋设章节}}，本章需要{回收/推进}
-
-### 世界约束
-{约束1}：{与本章相关的规则/设定}
-```
-
-**示例（demo《让你管账号，你高燃混剪炸全网》第 10 章）：**
-```
-## 本节速记（第10章）
-
-### 角色状态
-江晨：火箭军文工团宣传兵，《诸君，且听龙吟》已爆红，正从军宣新人升为军内认可的创作者
-钟嘉嘉：军报记者，采访稿已经过审，与江晨从采访关系转为稳定合作
-周薄森：文工团副团长，已从担心江晨惹事转为认可其创作能力
-
-### 相关伏笔/前史
-五天百万粉任务：第1章发布，第10章仍未结算；本章只推进声量，留到第11章结算
-专业团队重拍：本章用高清专业版“缺了灵魂”反衬江晨手机原版不可替代
-
-### 世界约束
-军宣作品采用要经过组织决策；江晨可以靠作品效果赢得认可，不能跳过军内流程直接拍板
-```
-
----
-
-## 角色状态记录格式
-
-> ⚠️ **本节仅适用于长篇写作。** 短篇通常不需要独立角色状态追踪。
+> story-import 反推角色状态（character-state-reverse.md）时按本格式写 `追踪/角色状态/{角色名}.md`。
 
 动态状态按核心角色拆成 `追踪/角色状态/{角色名}.md`，由 `tracking_commit.py` 根据事务 JSON 整份覆盖；静态原始人设仍在 `设定/角色/{角色名}.md`。只为后续会复用的主角、反派、核心配角建快照，不为路人、一次性功能角色建文件。
 
-### 格式
+## 格式
 
 ```markdown
 # 江晨｜当前状态
@@ -98,7 +33,7 @@
 - 钟嘉嘉所谓“只猜对一半”仍未解释
 ```
 
-### 更新规则
+## 更新规则
 
 1. 每章只记录身份、位置、目标、身心状态、能力资源、关系、已知信息、未结事项中真正发生变化的内容。
 2. 核心复用角色发生变化时，在同一事务的 `character_changes` 写变化，并在 `character_snapshots` 提交其**截至当前已写最后一章**的完整快照；工具以快照是否存在判断核心/临时角色，整份覆盖核心角色小文件，不追加历史。

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

@@ -33,6 +33,8 @@ Phase 3-L 长篇结构迁移的详细映射规则和模板。将 `拆文库/{导
 | `剧情/散落情节.md` | `大纲/大纲.md` 附录或对应卷纲 | 合并到相关卷的大纲 |
 | — | `追踪/上下文.md` | 由初始化事务生成续写状态卡（固定 7 栏），≤12288 字节 |
 
+旧拆文的目录或字段名与上表不同时，先建立一次“旧路径 → 当前目标”的来源映射，再按实际可读内容转换；不要为了改名复制出第二套拆文真源。`剧情/节奏.md`、`剧情/情绪模块.md` 或主题化设定缺失时，旧内容能支持的导入步骤照常执行，对应摘要写「未知/待增强」；只有用户要启用依赖这些资料的新对标召回时，才回到 story-long-analyze 做按需增强。
+
 ---
 
 ## 正文标准化规则
@@ -263,17 +265,17 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 
 | 摘要字段 | 细纲字段 | 转换方式 |
 |---------|---------|---------|
-| 关键事件 | 核心事件 | 直接复用 |
+| 关键事件 + 局面结果 | 核心事件 | 合并为“谁采取什么行动 → 局面如何变化”；旧摘要没有 `局面结果` 时只用 `关键事件` |
 | 章节字数 | 字数目标 + 字数口径 | 对原文章节运行 `storyctl.py wordcount measure`，写入 `actual` 与 `visible_chars_v1` |
-| 章节基调 / 情绪曲线 | 目标情绪 | 从摘要提取；缺失写 `[待补充]` |
-| 第一个情节点 | 章首钩子 | 只作为证据，设计目标标 `[待补充]` |
+| `基调：` | 目标情绪 | 读取紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他枚举；缺失写 `[待补充]` |
+| 章尾钩子 | 章首承接证据 | 作为下一章开篇需要承接的等待；新的章首钩子设计目标仍标 `[待补充]` |
 | 爽点类情节点 | 爽点 | 从情节点类型推断；没有则写“无显性爽点 / [待补充]” |
-| 情节点起承转合 | 内容概括（起因/发展/转折/高潮/结尾） | 按情节点顺序归纳；证据不足写 `[待补充]` |
+| 情节点起承转合 + 因果 | 内容概括（起因/发展/转折/高潮/结尾） | 按情节点顺序归纳，用因果链校正起因与转折；证据不足写 `[待补充]` |
 | 主线/支线/任务线索 | 情节安排（主线/辅线/事件线/感情线/逻辑线） | 从剧情单元索引与摘要反推；无证据的辅线/感情线写“无”或 `[待补充]`，不得杜撰 |
-| 出场角色 / 关键物件 | 人物关系和出场顺序 | 按摘要出现顺序列出；关系变化只写有证据的“前 → 后”，缺失写 `[待补充]` |
-| 全部情节点 | 情节细化 / 情节点序列 | 按表格逐行写（# / 情节点 / 功能标签 / 执行边界）；功能或边界不明写 `[待补充]`，不反推逐点字数配额 |
+| 涉及 + 状态变化 | 人物关系和出场顺序 | `涉及` 给出候选人物，`状态变化` 只写有证据的“前 → 后”；关键物件从证据或旧情节点补充，缺失写 `[待补充]` |
+| 全部情节点 | 情节细化 / 情节点序列 | 按表格逐行写（# / 情节点 / 功能标签 / 执行边界）；保持原顺序，功能或边界不明写 `[待补充]`，不反推逐点字数配额 |
 | 胜负/反转/收益损失 | 行动成本（可无）/收益归属 | 有明确证据才填写；行动成本可无、不硬造；否则 `[待补充]` |
-| 最后一个情节点 / 悬念类情节点 | 结尾设定和钩子 | 收束状态可归纳；章尾钩子设计目标标 `[待补充]` |
+| 章尾钩子 + 局面结果 | 结尾设定和钩子 | 局面结果写收束状态，章尾钩子写已存在的等待；未来设计仍标 `[待补充]` |
 
 ---
 
@@ -410,7 +412,7 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 | `拆文库/{对标书名}/剧情/节奏.md` | `{项目}/对标/{对标书名}/剧情/节奏.md` | 日更选择 `rhythm_reference` 的必备权威文件；缺失则不登记该对标 |
 | `拆文库/{对标书名}/剧情/情绪模块.md` | `{项目}/对标/{对标书名}/剧情/情绪模块.md` | 日更选择 `selected_emotion_module` 的必备权威文件；缺失则不登记该对标 |
 | `拆文库/{对标书名}/剧情/*.md` | `{项目}/对标/{对标书名}/剧情/*.md` | 剧情单元、故事线、散落情节等剧情资产；与权威节奏/情绪文件冲突时以后者为准 |
-| `拆文库/{对标书名}/章节/*.md`（第N章_摘要.md + 黄金三章 第1-3章_深度拆解.md）| `{项目}/对标/{对标书名}/章节/*.md` | 匹配章证据，含「关键信息与扩写技法」 |
+| `拆文库/{对标书名}/章节/*.md`（第N章_摘要.md + 黄金三章 第1-3章_深度拆解.md）| `{项目}/对标/{对标书名}/章节/*.md` | 匹配章证据；摘要读取概要、关键事件、局面结果、涉及、状态变化与情节点序列（含类型、主题标签与基调），黄金三章另含深度写法 |
 | `拆文库/{对标书名}/角色/*.md` | `{项目}/对标/{对标书名}/角色/*.md` | 角色功能位、关系与反应层参考 |
 | `拆文库/{对标书名}/设定/` | `{项目}/对标/{对标书名}/设定/` | 世界观、势力、金手指等设定约束参考 |
 | `拆文库/{对标书名}/拆文报告.md` | `{项目}/对标/{对标书名}/拆文报告.md` | 人类可读摘要投影 |

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

@@ -0,0 +1,31 @@
+# 追踪初始化事务
+
+## 初始化事务
+
+新书从第 0 章初始化。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
+
+```json
+{
+  "schema_version": 1,
+  "book_title": "让你管账号，你高燃混剪炸全网",
+  "last_chapter": 0,
+  "context": {
+    "position": {
+      "volume": "第一卷·军宣整顿",
+      "volume_start_chapter": 1,
+      "story_time": "江晨到火箭军文工团报到前",
+      "scene": "火箭军文工团"
+    },
+    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
+    "active_character_names": [],
+    "continuity_risks": [],
+    "recent_chapters": [],
+    "next_chapter_commitments": ["让江晨报到，并落下五天百万粉的新手任务"]
+  },
+  "character_snapshots": {},
+  "foreshadow": [],
+  "timeline_events": []
+}
+```
+
+导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。

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

@@ -18,24 +18,25 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 先按运行环境探测 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 init   --project {书项目根} --input {书项目根}/.story/work/init.json
 {PYTHON} {当前 skill 根}/scripts/tracking_commit.py check  --project {书项目根}
-{PYTHON} {story-long-write skill 根}/scripts/storyctl.py wordcount checkpoint --file {前半段临时文件} --target {目标} --chapter {N}
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py draft  --project {书项目根} --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}
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter commit  --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter accept-current-length --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
 ```
 
 - `init`：只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
-- `wordcount checkpoint`：纯测量；返回当前实际字数、用户带与剩余用户区间，不写正文、不写 tracking、不做语义判断。每章最多调用一次。
-- `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及进入内带/用户带所需的机器删除区间。
+- `draft`：按当前 state 把逐章事务预填到 `.story/work/第NNN章/tracking.json`（修订号、模式、章名、`context` 四项当前值），并输出各文本字段的字数上限与在场核心角色的当前快照；调用方只填 `delta` 与有变化角色的快照。
+- `wordcount measure` / `wordcount checkpoint`：纯测量入口；不写正文、不写 tracking、不做语义判断。长篇正文只在前组写完后由父流程调用一次 `checkpoint`（见 workflow-chapter 步骤 6），整章长度由 `chapter check` 收口。
+- `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 的逐字一致性。
 
 每本书由 `追踪/.tracking-commit.lock` 串行写事务，`expected_state_revision` 再拒绝基于旧状态构造的 stale transaction。两个不同事务并发时至多一个修订成功。字数记录也在锁内对当前正文和目标重新验证，正文或目标变化会让预先构造的记录直接失败。
 
-事务 JSON 是临时输入，不是项目产物：成功前必须保留；提交成功且紧随其后的 `check` 通过后立即删除，不能把 `init_transaction.json`、`chapter_*_transaction.json` 等输入长期留在书项目根目录。若文件写入失败，`_tracking-state.json` 尚未推进；修正环境后直接重跑**同一份** `commit`。append 重跑只接受内容完全相同的既有逐章记录，不维护 `dirty/pending/repair` 状态机。
+事务 JSON 是临时输入，不是项目产物：只写在书目录 `.story/work/` 下（逐章事务放 `.story/work/第NNN章/tracking.json`），不写系统 `/tmp`、书根、`大纲/` 或 `正文/`；成功前必须保留，提交成功后即可删除（`storyctl.py chapter commit` / `accept-current-length` 成功时自动删除该章目录；直接调用 `tracking_commit.py commit` 时由调用方删除）——之后 `check` 失败按下文提交 `mode=revision` 新事务修复，不需要原事务。若文件写入失败，`_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`——删掉那个手写文件后重跑原事务即可。
 
@@ -43,33 +44,7 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 
 ## 初始化事务
 
-新书从第 0 章初始化。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
-
-```json
-{
-  "schema_version": 1,
-  "book_title": "让你管账号，你高燃混剪炸全网",
-  "last_chapter": 0,
-  "context": {
-    "position": {
-      "volume": "第一卷·军宣整顿",
-      "volume_start_chapter": 1,
-      "story_time": "江晨到火箭军文工团报到前",
-      "scene": "火箭军文工团"
-    },
-    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
-    "active_character_names": [],
-    "continuity_risks": [],
-    "recent_chapters": [],
-    "next_chapter_commitments": ["让江晨报到，并落下五天百万粉的新手任务"]
-  },
-  "character_snapshots": {},
-  "foreshadow": [],
-  "timeline_events": []
-}
-```
-
-导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。
+仅新书或导入初始化时，执行 `init` 前必须完整读取 [tracking-initialization.md](tracking-initialization.md)，按其中原始 JSON 与导入边界构造事务。已有项目续写直接使用下方逐章事务，不重复读初始化示例。
 
 调用方的逐章 JSON 不写 `wordcount`；正式入口 `chapter commit` 或 `chapter accept-current-length` 在提交当下生成并注入。最终 state 只为已提交章节保留 `metric / target / actual / status / resolution / body_sha256`，不保存 MEASURE/RESOLVE 事件、ID 链、policy fingerprint 或独立 chapter state。
 

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

@@ -18,11 +18,13 @@
 const fs = require('fs')
 const path = require('path')
 
-// 权威模板：references/workflow-setup.md「细纲（全书每章）」
+// 权威模板：references/workflow-setup.md「排纲自查与细纲」里的细纲模板
+// 必填只留有证据或事故撑腰的核心字段；阶段位置、章节定位、结构公式、本章标价、闭环状态、
+// 写手自由区、契约风险、镜头准入、信息差触发点与「分辨率」列是可选的阅读体验字段——
+// 写了照样消费，没写不拦（#383 隔离实验：只补目标情绪与主角目标就复现了补满全部字段的收益）。
 const FIELDS = [
-  '核心事件', '字数目标', '字数口径', '阶段位置', '单元ID/位置', '目标情绪',
-  '主角目标/关键选择', '章节定位', '本章结构公式', '章首钩子', '爽点',
-  '本章禁止提前释放', '契约风险',
+  '核心事件', '字数目标', '字数口径', '单元ID/位置', '目标情绪',
+  '主角目标/关键选择', '章首钩子', '爽点', '本章禁止提前释放',
 ]
 const SUBSECTIONS = ['内容概括', '情节安排', '人物关系和出场顺序', '情节细化']
 const FIVE_ACT = ['起因', '发展', '转折', '高潮', '结尾']
@@ -46,11 +48,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 +67,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 文件都真实存在——不许把槽位指向查无实据的权威文件',
+    '修正引用路径；或按新增物三级先把缺的设定落档（「写了要报」直接补并登记、「先问作者」进排纲底稿的供给自查提案），再在细纲引用。'
+  )
+}
+
+function verify(file, projectRoot = null) {
   const name = path.basename(file)
   const read = readUtf8(file)
   const checks = []
@@ -133,21 +175,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 || /放/.test(header[header.length - 1]))) {
+    const rows = []
+    for (const line of lines) {
+      const cells = parseTableRow(line)
+      if (cells && cells.length === header.length && /^\d+$/.test(cells[0])) rows.push(cells)
+    }
+    if (rows.length) {
+      const released = rows.filter((cells) => {
+        const match = cells[cells.length - 1].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 +267,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 +276,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 +305,81 @@ function resolveChapter(project, chapter) {
   return { file: path.join(dir, hit) }
 }
 
+// --supply：批末验证供给自查已落盘。新书写在卷纲旁的 排纲底稿_{单元ID}.md；老卷纲写在单元卡块内。
+function hasSupplyHeading(text) {
+  return text.split(/\r?\n/).some((line) => {
+    const heading = line.replace(/\*\*/g, '').match(/^#{1,6}\s+(.+)$/)
+    return Boolean(heading) && /^供给自查(?:\s|[（(]|$)/.test(heading[1])
+  })
+}
+
+function verifySupply(volumeFile, unitId) {
+  const draftFile = path.join(path.dirname(volumeFile), `排纲底稿_${unitId}.md`)
+  const draft = readUtf8(draftFile)
+  if (draft.ok) {
+    const ok = hasSupplyHeading(draft.text)
+    return {
+      schema_version: 1, verifier: 'story-long-write.outline-supply', file: path.resolve(draftFile), unit: unitId, ok,
+      evidence: ok ? '排纲底稿含「供给自查」小节' : `${path.basename(draftFile)} 里没有「供给自查」小节——每批出细纲前须做供给自查（含「无缺口」情形），见 workflow-setup.md「排纲自查与细纲」步骤 3`,
+    }
+  }
+  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}.md，剧情单元 ${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 +390,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 +405,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 +422,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