@oh-story/dsh 0.1.9 → 0.1.11

package/lib/oh-story/skills/story-long-write/references/artifact-protocols.md

@@ -1,20 +1,11 @@
 # 产物创建模板
 
-各产物的标准模板与创建指引。agent 在 Phase 2-3 过渡时按需加载此文件。
+大纲与卷纲的模板，出卷纲时（workflow-volume.md）读。
 
-**模板列表：**
-- 设定/关系.md
-- 设定/题材定位.md（含读者契约 + 终局底牌/升级台阶 + 对标登记字段）
+**模板列表：**（设定/关系、设定/题材定位的模板在 workflow-setup.md 文末；细纲模板与排纲底稿模板在 workflow-outline.md）
 - 大纲/大纲.md（全书鸟瞰 + 全书体量与阶段总览）
 - 大纲/卷纲_第X卷.md（含卷契约+终局储备+剧情单元+情绪弧线+反转规划）
-- 追踪/_tracking-state.json（唯一结构化权威状态）
-- 追踪/逐章记录/第NNN章.md（未来相关紧凑增量）
-- 追踪/伏笔.md
-- 追踪/时间线/作者真相.md + 读者已知.md（派生视图）
-- 追踪/角色状态/{角色名}.md
-- 追踪/上下文.md（续写状态卡，固定 7 栏）
-- 对标/{对标书名}/拆文报告.md
-- 对标/{对标书名}/原文/第XXX章_{章名}.md
+- 追踪/（首次写正文前由脚本生成，见文末「追踪体系」）
 
 **层级关系（全书 › 卷 › 剧情单元 › 章 › 情节点；故事线横向贯穿多个剧情单元）：**
 - 大纲.md = 全书鸟瞰（每卷一两句话定位）
@@ -22,151 +13,21 @@
 - 细纲_第XXX章.md = 单章蓝图（单元ID/位置 + 主角目标/关键选择 + 内容概括 + 多线情节安排 + 人物关系/出场顺序 + 情节细化 + 结尾设定/钩子）
 
 **概念对照（统一叫法，减少混淆）：**
-- **剧情单元** = 一段完整剧情（1.5-3 万字/数章，一个矛盾从起到收）。拆书侧就是 `剧情/{剧情单元名}.md`，本书侧就是卷纲里的**剧情单元卡**；理论叫法是「一级结构」。同一粒度，统一叫剧情单元。
-- **故事线** = 贯穿多个剧情单元的线（主线/感情线/成长线/夺宝线…），比剧情单元大一层。拆书侧是 `剧情/故事线.md`，本书侧是卷纲的**本卷故事线**表（L 编号）。剧情单元纵向切段，故事线横向贯穿，同一卷的两个视角。
+- **剧情单元** = 一段完整剧情（1.5-3 万字/数章，一个矛盾从起到收）。拆书侧就是 `剧情/{剧情单元名}.md`，本书侧就是卷纲里的**剧情单元卡**，统一叫剧情单元。outline-structure-theory.md 的「一级/二级/三级结构」指全书结构类型，不是单元名。
+- **故事线** = 贯穿多个剧情单元的线（主线/感情线/成长线/夺宝线…），比剧情单元大一层。拆书侧是 `剧情/故事线.md`，本书侧是卷纲的**本卷故事线**表（L 编号）。剧情单元纵向切段，故事线横向贯穿，同一卷的两个视角。故事线编号是 `L01` 式两位数，单元ID 是 `L1-03` 式（卷号＋连字符＋序号），别混用。
 - 「循环」一词只在**节奏义**保留（爽点循环、升级循环、小/中/大循环等），不再指代规划单元。
 
 ---
 
-## 对标/{对标书名}/拆文报告.md
-
-> **拆文库/对标关系**：`拆文库/` = analyze skill 的原始产出（数据源）。`对标/` = 写作项目的引用视图。首次引用时从 `拆文库/` 复制到 `对标/`。
-
-此文件由 `story-long-analyze` 拆解管道输出（快速预览报告或完整拆文报告）。write skill 的职责是**读取**，不创建。
-
-如需手动创建简版对标摘要（未使用 analyze skill 时）：
-
-```markdown
-# {对标书名} 对标摘要
-
-## 基本信息
-- 书名：{}
-- 作者：{}
-- 题材/类型：{}
-- 目标平台：{}
-- 成绩：{均订/在读/热度}
-
-## 核心发现
-- 开篇钩子：{类型 + 手法}
-- 爽点密度：{约 N 字/次}
-- 节奏模式：{描述}
-- 可借鉴套路：
-  1. {}
-  2. {}
-  3. {}
-
-## 不建议模仿（禁止照搬）
-- {}（只学结构，不抄桥段）
-```
-
-创建参考：`plot-special-topics.md` (对标书选择法则)
-
----
-
-## 对标/{对标书名}/原文/第XXX章_{章名}.md
-
-对标书章节原文，由用户手动放入或拆文管道导入。
-
-```markdown
-# 第{N}章 {章名}
-
-{本章完整原文内容}
-
----
-> 来源：{手动输入 / story-long-analyze 导入}
-> 原始字数：{约N字}
-```
-
----
-
-## 设定/关系.md
-
-```markdown
-# 角色关系图
-
-## 关系总览
-
-| 角色 A | 角色 B | 关系类型{亲情/爱情/友情/敌对/师生/主从/利益} | 情感倾向{正面/负面/中性/复杂} | 当前状态 | 起始章节 | 变化节点 |
-|--------|--------|---------------------------------------------|-----------------------------|---------|---------|---------|
-| {名} | {名} | {类型} | {倾向} | {描述} | 第{N}章 | {事件} |
-
-## 关系演变
-
-{角色A}<->{角色B}：
-- 起点：{初始关系}
-- 转折：{章节·事件·变化}
-- 当前：{现状}
-
-## 核心冲突关系
-
-{列出推动剧情的2-3对核心对立/合作关系}
-```
-
-创建参考：`character-relations.md` (人物关系类型 + 关系图绘制)
-
----
-
-## 设定/题材定位.md
-
-```markdown
-# 题材定位
-
-## 基本信息
-- 题材类型：{玄幻/都市/系统/...}
-- 目标平台：{起点/番茄/晋江/其他；story-review 据此选平台 rubric}
-- 核心梗：{一句话卖点}
-- 微创新点：{与同类题材的差异}
-
-## 读者契约（参 `reader-contract-and-progression.md`）
-- 核心读者承诺：{读者来追什么爽感/情绪/关系/事业}
-- 主角代理权承诺：{主角不可替代的判断、关键选择或贡献}
-- 利益安全线：{核心资产/卖点不得被没收、转赠、无交换暴露的边界}
-- 期待债：{开篇/本卷已承诺，何时以什么形式偿还}
-- 题材边界：{个人逆袭/群像/导师/制度合作等；高层级机构出现时先核对}
-
-## 终局底牌与升级台阶（防写无可写；开书填一次，日更只查。参 `reader-contract-and-progression.md`「终局储备与推进节奏」）
-- 终局底牌（一次性资源，标最早解锁卷）：头号宿敌={}·第{X}卷；终极真相/身世={}·第{X}卷；金手指上限={}·第{X}卷；身份/地位终点={}·第{X}卷；核心情感确定={无感情主线可删}·第{X}卷
-- 升级台阶：主体系{境界/等级/地图/势力层级}共{N}档 × 每档约{W}万字 应 ≥ 全书目标字数（不足则拉长体系/加地图层）；敌人/目标成梯队逐级解锁，禁止越级秒顶级
-- 透支红线：① 未到解锁卷就动用终局底牌 ② 某条升级线逼近天花板、后面没台阶接
-
-## 核心梗三分法
-- 表层卖点：{读者一眼看到的吸引力}
-- 深层爽点：{持续追读的情绪驱动力}
-- 长线钩子：{支撑全书的悬念/目标}
-
-## 对标分析（概要）
-> 完整对标数据见 `对标/` 目录。此表仅做快速概览。
-
-| 对标书 | 相似点 | 差异点 | 可借鉴 |
-|--------|-------|-------|-------|
-| {书名} | {点} | {点} | {点} |
-
-## 对标登记（多对标时必填；cross-book-recall 跨书召回按此排序与预算）
-- 主对标书：{书名；单对标可省，多对标必填}
-- 对标书列表：
-
-| 书名 | 题材类型 | 引用强度{辅/参考} | 用途 |
-|------|---------|-----------------|------|
-| {书名} | {类型} | {辅/参考} | {文风主对标/结构参考/…} |
-
-## 题材框架
-- 八节点位置：{当前处于哪个节点}
-- 关键转折节点：{列出}
-```
-
-创建参考：`long-genre-mechanics.md` (核心梗解析与运用 + 微创新与差异化设计)
-
----
-
 ## 大纲/大纲.md
 
-全书鸟瞰。顶部为「全书体量与阶段总览」（总章节数/目标字数/全书情绪曲线/阶段划分/各阶段节奏公式/关键节点与钩子链，结构见 [Phase 3：大纲搭建](workflow-setup.md#phase-3大纲搭建)），其后接卷级大纲一段式汇总：
+全书鸟瞰。顶部为「全书体量与阶段总览」（总章节数/目标字数/全书情绪曲线/阶段划分/各阶段节奏公式/关键节点与钩子链，结构见 [workflow-volume.md](workflow-volume.md)），其后接卷级大纲一段式汇总：
 
 ```markdown
 # 大纲
 
 ## 全书体量与阶段总览
-{按 Phase 3「全书体量与阶段总览」结构填写}
+{按 workflow-volume.md「全书体量与阶段总览」结构填写}
 
 ## 卷级大纲
 ### 第一卷：{卷名}（约 {X} 万字，{Y} 章）
@@ -211,13 +72,13 @@
 
 ## 剧情单元卡（1–3 万字为可调经验值；存于卷纲内；不另建单独文件）
 
-> 剧情单元 = 卷纲里的一级结构单元（见 outline-structure-theory.md「对标节奏迁移」），与下方「对标结构坐标」是同一单元的不同视角，不重复编排。单元长度按本书题材、既有兑现节奏与对标调整，不是硬门槛。规划各关键节点时消费权威文件的“关键节点四问”和期待所有权；无需主角亲自执行每个动作。高潮/兑现后可留短暂低压，以小而可见的收益/奖励承接下一轮压力。引入新地图/机构/能力/敌人/谜团时先检查换书债，不得借新鲜感逃避旧承诺。
+> 剧情单元卡与下方「对标结构坐标」是同一单元的不同视角（见 workflow-volume.md「对标节奏迁移」），不重复编排。单元长度按本书题材、既有兑现节奏与对标调整，不是硬门槛。规划各关键节点时按 `reader-contract-and-progression.md`「契约四问」检查；无需主角亲自执行每个动作。高潮/兑现后可留短暂低压，以小而可见的收益/奖励承接下一轮压力。引入新地图/机构/能力/敌人/谜团时按第 4 问检查，不得借新鲜感逃避旧承诺。
 
-### 剧情单元 {L卷号-序号}
-- 单元ID：{L卷号-序号}
+### 剧情单元 L{卷号}-{序号}
+- 单元ID：L{卷号}-{序号}（字母 L 开头，如 L1-03；不能写成 1-03，也别和故事线编号 L01 混）
 - 章节范围：{第A-B章}
-- 对标剧情参照：{{书名}《剧情标题》（类型/桥段标签；借什么：结构分布/情节点索引/兑现方式）；可列 2-3 条，无对标写「无」；**允许填「自创：{一句话理由}」**——单元内容形态不强制映射对标，自创单元照常过大纲安全七检与批末复核}
-- 单元节拍/章功能分配：{建立期待→尝试→加压/转向→决定性行动→兑现→余波；标对应章范围，可按题材删改；建卡时可按「对标剧情参照」剧情单元提炼的共性节拍填写，见 outline-structure-theory.md「按剧情批出细纲」}
+- 对标剧情参照：{{书名}《剧情标题》（类型/桥段标签；借什么：结构分布/情节点索引/兑现方式）；可列 2-3 条，无对标写「无」；**允许填「自创：{一句话理由}」**——单元内容形态不强制映射对标，自创单元照常过排纲自查与建纲批末复核}
+- 单元节拍/章功能分配：{建立期待→尝试→加压/转向→决定性行动→兑现→余波；标对应章范围，可按题材删改；建卡时可按「对标剧情参照」剧情单元提炼的共性节拍填写，见 workflow-outline.md「按剧情批出细纲」}
 - 单元承诺：{本单元向读者建立的情绪命题/期待，以及要偿还的期待债}
 - 单元情绪引擎：{核心情绪命题→承载对象/情绪缺口→受阻或缺口维持原因→本轮触发→主角不可替代的点火/转化动作→意义变化或可见兑现→题材/契约兑现；承载对象可为人物/关系/目标/规则/场景；不适用环节可写无/即时，但须保持因果闭合；机制按题材选，不强制误解/物件/反转}
 - 卷级贡献：{它如何服务本卷契约、阶段节奏或卷级目标}
@@ -228,37 +89,28 @@
 - 兑现方式与归属：{核心兑现如何发生，收益归谁、如何可见}
 - 本单元主推线/战果：{沿用卷契约划分——主推线1条承担高潮，其余线给战果，一战多得允许}
 - 本单元在跑的线：{按 L 编号列，主线之外至少 1 条；每条写「L0X 从哪一步推到哪一步」，不重述线本身。本单元不动的线不列}
-- 终局底牌边界：{本单元不得动用的未解锁宿敌/真相/身份/金手指上限；碰到就按权威文件透支两问改纲}
+- 终局底牌边界：{本单元不得动用的未解锁宿敌/真相/身份/金手指上限；碰到就按契约四问第 3 问改纲}
 - 禁止提前释放：{本单元不能提前解决/揭露/升级的内容}
 - 下一单元因果钩子：{自然推入下一单元的问题、代价、线索或新目标}
-- 风险等级：{契约安全 / 需补强 / 契约破坏；需补强时写清补强方式}
+- 契约风险：{契约安全 / 需补强 / 契约破坏；需补强时写清补强方式}
 
-> **段位契约（新建卷纲必须照此写；取段器按此解析）**：每个 `##`/`###`/`####` 标题的**下一行**写一行 `> 作用域：X`，X 取三值之一——
-> `卷级常任`（全卷有效，取段器恒定带出）／`单元级 {单元ID}`（只在该单元的闭包里出现）／`批次底稿 {单元ID}｜状态：在用|已退役`（排纲期工作底稿，批次完成且有效结论已下沉后改「已退役」，默认不再取出，--history 可查看）。
-> 四条纪律：**①全卷常任规则不许写在单元块里**——单元块只写本单元落点＋一行指针，规则本文放 `## 全卷常任裁定`（checker 会按「全卷／常任／全程生效」字样报 E4）。
+> **段位契约（新建卷纲必须照此写；取段器按此解析）**：每个 `##`/`###`/`####` 标题的**下一行**写一行 `> 作用域：X`，X 取二值之一——
+> `卷级常任`（全卷有效，取段器恒定带出）／`单元级 {单元ID}`（只在该单元的闭包里出现）。
+> 三条纪律：**①全卷常任规则不许写在单元块里**——单元块只写本单元落点＋一行指针，规则本文放 `## 全卷常任裁定`（checker 会按「全卷／常任／全程生效」字样报 E4）。
 > **②被推翻的内容不留旧文**——改成 `⊘ 已退役 → 见 {何处}` 起头的行，取段器默认不输出，读到的一定是当前有效值。
-> **③每批建完把过程性底稿改为「已退役」**。
-> **④批次底稿不是写作期输入**——写正文走 `--stage write`，底稿一概不给。底稿里凡有**写作期约束力**的条目（跨章祈使：全程不许／往后任何章／此后不再…），
-> **建纲当场就要下沉**到该单元的单元级段（排纲纪律／时间轴／账链）或直接写进细纲；`--check` 的 W1 告警专盯这类句子，逐条确认下沉过再放行。
-> 底稿仅用于排纲期（批末交作者裁定、下一批供给自查的输入）。
-> 落盘后跑 `outline_view.py --check --strict {卷纲路径}`，问题数归零；读取方式见 SKILL.md「卷纲不整读（取段器）」。
+> **③排纲底稿不进卷纲**——供给自查、建纲追加写在 `大纲/排纲底稿_{单元ID}.md`（模板见文末），底稿里凡有写作期约束力的条目（跨章祈使：全程不许／往后任何章／此后不再…），**建纲当场就写进**该单元的单元级段或细纲。老卷纲里的 `批次底稿 {单元ID}｜状态：在用|已退役` 段仍可读（排纲时 `--stage outline` 取出，`--check` 的 W1 告警盯其中的跨章祈使），新卷纲不再写。
+> 落盘后跑 `outline_view.py --check --strict {卷纲路径}`，问题数归零；读取方式见 SKILL.md「卷纲不整读」。取段器输出闭包：全部卷级常任段＋该单元的单元级段，逐章表按单元章区间裁行，退役行默认不输出（看历史加 `--history`）；未声明作用域的段会被保守纳入并告警。老卷纲里还留着「作用域：批次底稿」段的，排纲时加 `--stage outline` 一并取出，写正文不加。
 
 ## 全卷常任裁定
 > 作用域：卷级常任
 
 {对本卷每个剧情单元生效的规则本文写在这里，单元卡与排纲纪律只写落点、不复读规则。编号列出，单元侧按「常任 N ＋本单元落点」引用}
 
-#### 供给自查（本单元出细纲前产出，见 workflow-setup.md「按剧情批出细纲」步骤 3）
-{六行答完落此处：对手供给 / 角色供给 / 能力与金手指供给 / 刻度供给 / 场景与底图供给 / 故事线供给。B 级发明各列一行「发明了什么＋落在哪个设定文件」；C 级提案列候选＋影响面待作者裁定；无缺口写「无缺口」。批末 `check-outline-contract.js --supply` 验证本小节存在}
-
-#### 建纲追加（本批建完后回填，见 workflow-setup.md「按剧情批出细纲」步骤 5）
-{逐章落笔时才发现的缺口，一条一行，**不与上面六行混写**（批前预见与当场发现分列）。格式：`第 N 章排到哪一步发现缺什么 ／ A・B・C ／ 落在哪个设定文件或提案编号`。一条也没有写「无追加」。下一批做供给自查时以本小节为固定输入}
-
 ## 核心矛盾
 {一句话：本卷要解决什么问题或达到什么目标}
 
 ## 对标结构坐标
-{有对标书时填；无则写"无对标，按八节点占比自排"。迁移步骤见 outline-structure-theory.md「对标节奏迁移」；对标关键情节优先取自被参照剧情单元的「情节点索引」}
+{有对标书时填；无则写"无对标，按八节点占比自排"。迁移步骤见 workflow-volume.md「对标节奏迁移」；对标关键情节优先取自被参照剧情单元的「情节点索引」}
 - 主对标卷段：{对标书}第{A}-{B}章（核心矛盾对应：{一句话}）
 
 | 归一化位置 | 本卷章区间 | 对标关键情节 | 本卷对应（换素材） | 类型{逆转/转折/激励} |
@@ -275,7 +127,7 @@
 |------|------------|-----------------------------------------|--------------|---------|
 | 第{N}章 | {高压/推进/修炼试错/关系回收/低压生活/信息整理} | {基调} | {N} | {事件} |
 
-> 章节定位可留空，留空按普通推进章处理（即退化为现状）。情绪强度是情感烈度，和章节定位的爆发压力是两回事——关系/泪目章可低压力但高情绪强度。一卷要有高低层次，低压 + 过场克制（合计不超约 15%，题材分档见 outline-structure-theory.md），别全程同一力度；逐行看相邻章情绪基调，别同一母题连超 2-3 章。章节定位与底线见 outline-structure-theory.md「章节定位与张弛」。
+> 章节定位可留空，留空按普通推进章处理（即退化为现状）。情绪强度是情感烈度，和章节定位的爆发压力是两回事——关系/泪目章可低压力但高情绪强度。一卷要有高低层次，低压 + 过场克制（合计不超约 15%，题材分档见 outline-structure-theory.md），别全程同一力度；逐行看相邻章情绪基调，别同一母题连超 2-3 章。章节定位与底线见 workflow-volume.md「章节定位与张弛」。
 
 ## 人物弧线
 | 角色 | 本卷起点 | 本卷终点 | 关键转变 |
@@ -320,42 +172,12 @@
 
 ## 大纲/细纲_第XXX章.md
 
-细纲是正文写作的章节蓝图，而不是只列事件和钩子的清单。**模板唯一权威副本**见 [Phase 3：大纲搭建](workflow-setup.md#phase-3大纲搭建) 的「细纲（全书每章）」模板（含单元ID/位置、主角目标/关键选择、任务卡点、结构公式、契约风险行，以及不含逐点字数的情节点表格）；本文件不再保留模板副本。新建、补建、回填都按权威模板补齐，未知字段写 `[待补充]`，不为补齐字段杜撰副线或人物关系。
-
-`目标情绪` 与 `主角目标/关键选择` 要写实际内容，不能留 `[待补充]`：隔离实验里只补这两个字段就能复现补齐全部字段的正文收益，补满其余字段与只补这两个不可区分。其余字段未知时仍按上文写 `[待补充]`。
-
-落盘后运行 `node scripts/check-outline-contract.js --json --project {书目录} --chapter {N}` 做结构验收：它只判字段、四个小节、五段式、情节点表结构（五列 `# / 情节点 / 功能标签 / 分辨率 / 执行边界`；加分辨率列之前的四列旧表仍收）和字数目标口径是否在场，不判内容好坏。exit 1 时只按 `repair_scope` 补报告点名的字段并复验，最多两轮；仍失败就报告检查 ID 停下，不改其他章。exit 2、脚本缺失或 node 不可用时如实报告验收未完成，不得声称细纲已合规。本检查只在新建/补建/回填时执行；既有项目的旧细纲不因此阻断写正文。
+模板、字段规则与落盘验收见 [workflow-outline.md](workflow-outline.md)。
 
 ---
 
 ## 追踪体系
 
-追踪产物由 `scripts/tracking_commit.py` 统一生成，完整 schema 和事务字段见 [tracking-transaction.md](tracking-transaction.md)。以下文件不得由模型各自追加或局部 Edit：
-
-### `追踪/_tracking-state.json`
-
-唯一结构化权威状态。记录 schema、最后提交章、导入截止章、`state_revision`、续写上下文结构，以及全部角色、伏笔和时间线当前状态。日更通过 `tracking_commit.py check` 的紧凑输出取章号和修订号，不把完整 state 加入正文 prompt。所有 Markdown 都从本文件确定性派生，程序不反向解析 Markdown。
-
-### `追踪/逐章记录/第NNN章.md`
-
-本章未来相关连续性记录，目标 ≤1536 字节、硬上限 3072 字节，只含：实际结果、角色变化、伏笔变化、时间/揭示、连续性约束、下一章承诺。过程日志、质检统计、参照章和提示词记录不进入。它不承诺单独无损重建全部当前状态；完整当前语义以 `_tracking-state.json` 为准。
-
-### `追踪/伏笔.md`
-
-每个 ID 只保留一行当前状态：内容、埋设章、计划回收章、状态、重要度、最近变更章。变化历史由对应逐章增量承担。尚未实际埋设的未来伏笔规划留在大纲；当前表只接受 `已埋 / 已回收 / 已过期 / 放弃`。
+规划阶段不建 `追踪/`，首次写正文前才初始化；各文件的分工、字段与体积上限见 [tracking-transaction.md](tracking-transaction.md)，全部由 `tracking_commit.py` 生成，不得各自追加或局部 Edit。
 
-### `追踪/角色状态/{角色名}.md`
-
-只为核心、会复用角色建立动态快照，含截至章节、身份、位置、当前目标、身心状态、能力资源、关键关系、已知信息和未结事项。目标 ≤4096 字节、硬上限 8192 字节；超过目标先合并失效能力、旧关系和已结事项，不把角色履历塞进当前快照。静态原始人设仍在 `设定/角色/{角色名}.md`；路人、一次性角色不建动态文件。
-
-### `追踪/时间线/`
-
-- `_tracking-state.json.timeline`：同一事件登记故事时间、客观事实、读者当前认知、实际揭示状态/章节。
-- `作者真相.md`：从 `_tracking-state.json.timeline` 派生，作者侧可见全部客观事实和认知差。
-- `读者已知.md`：从 `_tracking-state.json.timeline` 派生，只显示读者已经知道/相信的内容，不泄露客观真相。
-
-未来揭示计划写卷纲/细纲，不写进既成事实登记；`未揭示` 事件的 `reveal_chapter` 必须为空。
-
-### `追踪/上下文.md`
-
-续写状态卡不超过 12288 字节，固定 7 栏：`当前位置 / 长期约束 / 核心角色状态 / 活跃伏笔 / 近三章速记 / 下一章承诺 / 连贯性风险`。它是当前语义检查点之一；不放文风、质量计数、普通待办、索引统计和长期概要。
+---

package/lib/oh-story/skills/story-long-write/references/author-memory-maintenance.md

@@ -0,0 +1,75 @@
+# 作者记忆维护
+
+[author-memory.md](author-memory.md) 的少见时刻补充：记一条、确认、替换、忘掉和优先级仍按那份协议，本文件只在下列情况读——作者说「整理作者记忆」，或回执 `warnings`／查询 `omitted_ids` 提示超编；写入因 `作者画像.md` 写满失败；书根就是工作区，或工具报 `state.book`、单书布局错误；要做存量迁移 `migrate`、多事件原子 `commit`、派生视图 `check`；冲突候选要落定；碰到升级前留下的旧条目。
+
+作者记忆借鉴“原始证据 → 候选 → 已确认画像 → 变更记录”的记忆管道，但把决定权留给作者。
+
+## 文件
+
+```text
+{工作区}/.story/作者记忆/          # 项目级 store：global / genre / workflow 条目，编号 AP
+├── _author-memory-state.json  # 唯一结构化权威
+├── 作者画像.md               # 仅 active，供作者查看与管理
+├── 待确认.md                 # pending / conflict，不参与约束
+└── 变更记录.md               # 最近 100 次、最新在前的事务记录
+{书}/.story/作者记忆/            # 书级 store：只存这本书的 book 条目，编号 BP，同样四个文件
+```
+
+三个 Markdown 文件都从 state 确定性生成，禁止手改；完整历史保留在 state，变更记录只展示最近 100 次。`作者画像.md` 是人类管理视图，普通写作 agent 不整份注入，而是调用 `query` 取得本次相关的紧凑上下文。
+
+## 任务映射表
+
+各 skill 入口的 `query` 命令按此表选 kind；写入时的预算提醒也按这四类任务组合估算。
+
+| 任务 | query kinds | 注入位置 |
+|---|---|---|
+| 正文初稿 / 续写 | `prose_style` + `story_design` | 主会话与实际正文 agent |
+| 去 AI 味 / 改写 | `prose_style` | 主会话与实际改写 agent |
+| 设定 / 大纲 | `story_design` + `workflow` + `interaction` | 主会话，不传正文 agent |
+| 审稿 | `delivery` + `interaction` + 必要的 `prose_style` | 主会话，不降低 rubric |
+
+审稿匹配项只用于交付格式、协作方式和“作者有意采用的表达选择”说明；问题严重度和 PASS/FAIL 仍由 rubric 决定。
+
+## 注入预算与容量
+
+- **写入不因注入预算失败**：`record` / `commit` 照常成功、给回执；工具按上表四类任务组合估算最坏查询情形（全局条目＋各 scope 维度最重的单一切片，切片按大小写无关归并、轻重按写作时真正读到的字段算，与真实查询同一把尺），装不进 2048 字节的组合在返回的 `warnings` 里点名将被略过的条目及其断言首句。
+- 写入落盘后另一级 store 读不出来（书目录不存在、`--book` 与书级记录不符等）也照常给回执，`warnings` 注明本次提醒没算上它。写书级条目时「本书＋全局」按实际条目精确计算；写项目级条目时只看得到项目级 store，顺手传 `--book-root` 就把当前这本书也算进提醒。
+- 查询按 **重要度 → 本书例外 → 最近更新** 排序装填（同一范围的条目必在同一 store，「最近」按该 store 的修订号比，不跨 store 比较），先丢的恒是重要度较低的条目——`importance` 决定超编时谁留在 prompt 里。装不下的条目跳过而不中断（一条长的不挡后面的短条），漏下的 ID 按同一优先级报进 `omitted_ids`（最多列 20 条，`omitted` 是真实总数）。
+- 注入预算之外还有一道硬上限：`作者画像.md` 超过 12288 字节时写入会直接失败并要求先整理。active 条目攒到几十上百条才会碰到（远在注入预算之后），碰到就走「整理作者记忆」；`forget` 这类减量操作在满编时照常可用。
+
+## 整理作者记忆
+
+作者说「整理作者记忆」，或回执 `warnings`／查询 `omitted_ids` 提示超编、写入因画像写满失败时：读项目级与当前书的 `作者画像.md`（每条都标了范围、重要度、把握和确认次数，重要度就是超编时的去留依据），提出合并同义条（`replace` 多合一）、退役过时条（`forget`）、给错标成 `high` 的条目下调重要度、把超长断言压缩成一句话的提案；项目级画像里还有「本书：」条目时，「对该书运行 `migrate --book-root`」列为默认提案项。清单用原话逐条列给作者确认（编号只放括号里），确认后按 store 各汇成一份 `commit` 事务提交（一份事务只写一个 store）。合并时保住每条的否定词、限定词和适用范围——合不动就退役其中一条，不要靠删限定词把两条凑成一条。整理只由作者发起或确认，不自动执行。
+
+## 冲突候选
+
+冲突候选（`conflict`）不能绕过旧规则直接 `decide=activate`。作者选新说法：用 `replace`，`old_ids` 同时列旧 active 条目和这条冲突候选，新条目直接 active、两条旧的标 `superseded`；作者留旧规则：对候选 `decide=reject`。旧条目被 `replace` / `forget` 撤下后，它不再是任何候选的冲突对象，冲突对象清空的候选退回 `pending`。
+
+## 单书布局
+
+书根就是工作区（`--book-root` 与 `--workspace` 同一目录）时，书级 store 改住 `{工作区}/.story/作者记忆/书级/`，与项目级各自一份 state；首次建立的书名优先取项目级存量本书条目里唯一的书名，再取目录名。旧版曾把书级 state 写在项目级位置，此后项目级读写都报 `state.book`；带 `--book-root {工作区}` 运行任一命令（含 `query`）会先把它原样移进 `书级/`，不改内容。这个目录其实是某个工作区里的一本书时（上一层叫 `长篇/` 或 `短篇/`，或某个祖先有 `.active-book` 或项目级 state），工具直接报错、不动任何文件，按报错改传 `--workspace`。
+
+## 存量迁移
+
+不做双读：升级前写进项目级 store 的 book 条目不再参与查询与预算估算，也不再接受新的 book 写入；它们仍在 `作者画像.md` 里可见、可 `decide` / `forget`。对每本书运行一次 `migrate --book-root {书目录}` 即可整批搬回来：断言、证据、确认次数、重要度原样保留，换成 `BP` 编号，原 `AP` 条目标 `superseded` 并注明去向；与全局条目的冲突关系在迁移后不再成立，这类候选退回 `pending`。书级每个源条目一笔事务，重跑只补没做完的一半。「整理作者记忆」看到项目级画像里还有「本书：」条目时，把迁移列为默认提案项。
+
+## 旧条目
+
+- 升级前写下的长断言不受 120 字节新建上限约束：原样重申它会**强化**原条目（确认次数 +1），不会因超长被拒；只有真正新建条目才校验 120 字节。
+- 存量 state 里推断类旧来源的条目照常可读、可确认、可退役；新写入仍只接受 `explicit_user`、`accepted_suggestion`、`manual`。
+
+## 其他命令
+
+先依次尝试 `python3`、`python`、`py -3` 找到 Python 3，再从当前 skill 根运行本地副本（`record` / `query` 见 author-memory.md）：
+
+```text
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py init    --workspace {工作区} [--book-root {书目录}]
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py commit  --workspace {工作区} [--book-root {书目录}] --input {工作区}/.story/work/作者记忆-事务.json
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py migrate --workspace {工作区} --book-root {书目录}
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py check   --workspace {工作区} [--book-root {书目录}]
+```
+
+- `commit`：高级批量入口，只在需要把多个动作绑定成一次原子提交时用（如整理作者记忆）。顶层传 `schema_version`、唯一 `transaction_id`、当前 `expected_state_revision` 和含 1–32 项的 `operations`（每项与单事件的 `operation` 同形）。一份事务只写一个 store；先在内存完成 schema、引用、容量和所有视图校验，操作按数组顺序应用，任一步失败则整份事务零写入，最后原子替换 state。过期修订会在任何写入前失败。事务文件在成功前必须保留，成功后删除；显式记忆请求按 author-memory.md「回执怎么告诉作者」转告。
+- `migrate`：把项目级 store 里某本书的存量 book 条目整批搬进 `--book-root` 的书级 store，幂等，中途失败直接重跑；返回 `migrated`（源→新编号），没有存量时为空。
+- `check`：从 state 重建并逐字核验所有派生视图；传 `--book-root` 时两级一起核验。
+- `init`：显式初始化 store；平常不需要，首次 `record` 会随事务创建。

package/lib/oh-story/skills/story-long-write/references/author-memory.md

@@ -1,6 +1,6 @@
 # 作者记忆协议
 
-作者记忆用于保存跨会话复用的创作偏好，不保存小说世界里的事实。它借鉴“原始证据 → 候选 → 已确认画像 → 变更记录”的记忆管道，但把决定权留给作者。
+作者记忆保存跨会话复用的创作偏好，不保存小说世界里的事实，决定权留给作者。本文件管最常见的时刻：作者说出一条偏好，或要确认、替换、忘掉某条。少见情况读 [author-memory-maintenance.md](author-memory-maintenance.md)：整理作者记忆与超编、画像写满、单书布局与 `state.book` 报错、存量迁移、多事件 `commit`、`check`、冲突候选落定、升级前的旧条目。
 
 ## 边界与优先级
 
@@ -17,95 +17,73 @@
 
 作者记忆不能把本书事实写进 `.story/作者记忆/`，不能覆盖当前请求，不能降低审稿 rubric，也不能让去 AI 味改动剧情意图。小说事实继续由各书的 `追踪/` 和 `设定/` 管理。
 
-## 文件与所有权
+## 存放与路由
 
-工作区级目录：
+两级 store，记忆随书走：`{工作区}/.story/作者记忆/` 存 global / genre / workflow 条目（编号 `AP`），`{书}/.story/作者记忆/` 只存本书的 book 条目（编号 `BP`）。每级各有 `作者画像.md`（生效条目）和 `待确认.md`（候选，不参与约束），都从 state 生成，禁止手改；不存在时写作、审稿、去味照常继续，首次 `record` 自动创建。
 
-```text
-{工作区}/.story/作者记忆/
-├── _author-memory-state.json  # 唯一结构化权威
-├── 作者画像.md               # 仅 active，供作者查看与管理
-├── 待确认.md                 # pending / conflict，不参与约束
-└── 变更记录.md               # 最近 100 次、最新在前的事务记录
-```
-
-三个 Markdown 文件都从 state 确定性生成，禁止手改；完整历史保留在 state，变更记录只展示最近 100 次。`作者画像.md` 是人类管理视图，普通写作 agent 不整份注入，而是调用 `query` 取得本次相关的紧凑上下文。`query` 要显式传 `--book`、已知的 `--genre` / `--workflow`；只传 kind 不会返回本书或题材项。作者记忆不存在时，普通写作、审稿和去味任务直接继续，不自动初始化空目录；首次 `record` 会随事务创建。
-
-工作区必须显式传给脚本。优先使用已经包含 `.story/作者记忆/` 的最近祖先；首次初始化时使用承载多本书、`.active-book`、`长篇/`、`短篇/` 或 `拆文库/` 的创作工作区根。不要把用户主目录当默认工作区。
-
-## 什么时候读取
-
-长篇、短篇、去 AI 味开始前，如果 state 已存在，用 `query` 按本书、题材、流程和类型筛选 active 条目。查询输出固定不超过 2048 字节。不要先查询全部再让 agent 自行筛选，按任务直接选择 kind：
+- `--workspace` 必须显式传，指创作工作区根——承载多本书、`.active-book`、`长篇/`、`短篇/` 或 `拆文库/` 的那一层；已有记忆时，是项目级 state（不带 `book` 字段）所在的最近祖先。`长篇/`、`短篇/` 下的书目录永远不当 `--workspace`，也不要把用户主目录当默认工作区。
+- `--book-root` 是当前书的项目目录（`.active-book` 指向、或含 `设定/`、`正文/` 的那一层，如 `{工作区}/长篇/{书名}/`）；书名默认取书级 state 记的名字，首次取目录名，`--book` 可覆盖。书根就是工作区时读维护文件「单书布局」。
+- ID 前缀就是 store：`decide` / `forget` 看 `item_id`（`AP` 项目级，`BP` 书级），`remember` / `replace` 看 `scope.level`（`book` 书级，其余项目级）。书级操作必须传 `--book-root`，没传直接报错，不会退而写进项目级。
+- `replace` 与 `conflicts_with` 不能跨 store：本书例外按优先级覆盖全局规则，不算冲突，直接 `remember` 为 book 条目；要把全局规则改成本书规则，拆成 `forget` ＋ `remember` 两个事件。
 
-| 任务 | query kinds | 注入位置 |
-|---|---|---|
-| 正文初稿 / 续写 | `prose_style` + `story_design` | 主会话与实际正文 agent |
-| 去 AI 味 / 改写 | `prose_style` | 主会话与实际改写 agent |
-| 设定 / 大纲 | `story_design` + `workflow` + `interaction` | 主会话，不传正文 agent |
-| 审稿 | `delivery` + `interaction` + 必要的 `prose_style` | 主会话，不降低 rubric |
+## 查询
 
-审稿匹配项只用于交付格式、协作方式和“作者有意采用的表达选择”说明；问题严重度和 PASS/FAIL 仍由 rubric 决定。
+各 skill 入口已写好本任务的 `query` 命令（长篇正文由组装脚本代查）；没写命令的长篇设定、大纲等任务查 `story_design` + `workflow` + `interaction`，结果只给主会话、不传正文 agent。四类任务的映射表见维护文件。state 存在才查（两级都不存在时返回空结果、零写入）；结果合并项目级与 `--book-root` 所指书级（不传就拿不到本书条目），`--kind` 必传，输出不超过 2048 字节。
 
-待确认项不进入 prompt 约束，也不应为了确认它们中断当前任务。只有用户主动查看作者画像、候选积累到适合回顾的节点，或新偏好与 active 条目冲突时，才集中呈现。
+普通创作只做一次本地 `query`，完整画像、证据、候选和 journal 不进 prompt。查询项是低优先级倾向，不是逐条打卡清单：自然吸收，不复述画像、不刻意提高词面命中率，不为命中牺牲连贯、节奏、字数或本书既定笔调。**`omitted_ids` 非空＝记忆超编**，不是「没有更多了」：转告作者并建议「整理作者记忆」，不得改读完整画像规避预算。待确认项不进 prompt，也不为确认它们中断任务；只在作者主动查看、候选积累到适合回顾的节点，或新偏好与 active 条目冲突时集中呈现。
 
-## 可靠性与负荷边界
+## 记不记、记成什么
 
-- 明确“记住 / 确认 / 替换 / 忘掉”的请求走单事件 `record`，不要求 agent 手工读取修订号或拼多操作事务。成功响应会给出 `Author Memory Receipt: rN · APxxx`；没有回执就不得声称“已经记住”。
-- 普通创作只做一次本地 `query`，没有 state 时返回空结果且不创建文件；有记忆时也只返回相关 active 条目，硬上限 2048 字节。完整画像、证据、候选和 journal 不进入正文 prompt。
-- 查询项是低优先级倾向，不是逐条打卡清单。自然吸收即可，不复述画像、不刻意提高词面命中率，也不得为命中偏好牺牲正文连贯、节奏、字数或本书既定笔调。
-- 不安装会记录全部用户消息的 prompt hook。自然语言是否属于长期习惯仍需 agent 判断；这样不能承诺隐式偏好 100% 捕获，但避免把一次性要求、私人对话和小说事实静默写入长期记忆。需要确定写入时，用户可明确说“记住：……”，并以回执验收。
-
-## 捕获判定
+不装记录全部用户消息的 prompt hook，不在作者没开口时观察他，只记作者明确表达的偏好。是否属于长期习惯由 agent 判断，拿不准就只执行不记录；作者可明说“记住：……”，以回执验收。
 
 | 输入证据 | 处理 |
 |---|---|
 | “以后都这样”“我一直习惯……”等直接、稳定、范围清楚的原话 | `active`，`source=explicit_user` |
 | 用户明确接受助手提出的长期做法 | `active`，`source=accepted_suggestion` |
-| 同类修改反复出现，但用户没说这是长期规则 | `pending`，`source=repeated_correction` |
-| 从成稿或操作轨迹推断出的模式 | `pending`，`source=inferred_pattern` |
+| 作者原话像长期偏好但范围或稳定性含糊 | `pending`，取当前最窄合理范围；待确认只来自作者自己的话 |
+| 同类修改反复出现、从成稿或操作轨迹看出的模式 | 不记录、不推断；作者没开口的偏好不进记忆 |
 | “这一章别……”“这次给我……”等一次性要求 | 只执行，不记录 |
 | 角色、时间线、伏笔、世界观、当前剧情走向 | 写项目设定/追踪，不写作者记忆 |
 | 助手自己生成的文字、默认模板、工具告警、rubric 结论 | 不自我学习 |
 
-保留用户的否定词、限定词和适用范围，`quote` 写原话，`assertion` 只做不改变语义的紧凑归纳。范围规则：
+保留否定词、限定词和适用范围：`quote` 写原话，`assertion` 只做不改变语义的紧凑归纳，**新建条目限一句话（≤120 字节，约 40 个字）**，写不下就压缩措辞、不切限定词；背景写进 `reason`（不进 prompt），不另开字段。
+
+**一条偏好就是一条记录，例外和限定不许拆出去单列。** 「以后少用破折号，对话里也别用，除非表示打断」整条写成「破折号少用、对话里也不用，只在表示打断时保留」：超编时条目逐条被丢，拆开就可能只丢掉例外，把作者说过的限定变成绝对禁令。只有原话塞了**几条互不依赖**的偏好（如「多用短句」＋「章末留钩子」）才拆。
+
+范围：“本书 / 这个角色 / 这次连载” → `book`；“都市文 / 这类题材” → `genre`；交稿、检查、确认节奏等操作习惯 → `workflow`；“以后 / 一贯 / 我习惯”且无更窄限定 → `global`；含糊但可能稳定 → 最窄合理范围并置 `pending`。
 
-- “本书 / 这个角色 / 这次连载” → `book`；
-- “都市文 / 这类题材” → `genre`；
-- 交稿、检查、确认节奏等操作习惯 → `workflow`；
-- “以后 / 一贯 / 我习惯”且无更窄限定 → `global`；
-- 范围含糊但可能稳定 → 取当前最窄合理范围并置 `pending`。
+类型：`prose_style`、`story_design`、`workflow`、`delivery`、`interaction`。置信度与重要度均为 `low | medium | high`；超编时先丢重要度低的，按偏好的实际分量填，不要一律 `high`。`source` 只接受 `explicit_user`、`accepted_suggestion`、`manual`，工具拒绝推断类来源。
 
-类型可选：`prose_style`、`story_design`、`workflow`、`delivery`、`interaction`。置信度与重要度均为 `low | medium | high`。
+## 确认、替换、忘掉与冲突
 
-## 冲突、撤回与强化
+- 同一类型、范围、归纳文本再出现，脚本强化原条目（累加证据与确认次数），不重复建条。
+- 新偏好与同一 store 的 active 条目矛盾：以 `conflict` 记候选，`conflicts_with` 列冲突 ID，本轮仍按当前要求执行；本书例外与全局规则不算冲突。冲突候选不能直接 activate，落定见维护文件「冲突候选」。
+- pending 用 `decide=activate|reject`。同一范围的规则改版用 `replace`，新条目启用、旧条目标 `superseded`；只有作者明确撤销或改变旧规则范围才跨范围替换。
+- 作者说“忘掉 / 这不再是我的习惯”用 `forget`，保留历史证据但不再加载。active 条目的语义不可原地偷改，语义变化必须 replace，历史才可审计。
 
-- 同一类型、范围、归纳文本再次出现时，脚本强化原条目，累加证据和确认次数，不重复建条目。
-- 新偏好与 active 条目矛盾时，先以 `conflict` 记候选，并在 `conflicts_with` 列出冲突 ID；当前任务仍按本轮明确要求执行。
-- 同一范围的规则改版用 `replace`，启用新条目并将旧条目标成 `superseded`。本书例外用 `remember` 新建 book 条目，保留 global 习惯；只有作者明确撤销或改变旧规则范围时才跨范围替换。
-- pending 可以用 `decide=activate|reject`；冲突候选不能绕过旧规则直接 activate。
-- 作者说“忘掉 / 这不再是我的习惯”时用 `forget`，保留历史证据但不再加载。
-- active 条目的语义不可原地偷改；语义变化必须 replace，历史才可审计。
+## 回执怎么告诉作者
+
+回复就两行纯文本，不加代码块或引用格式：第一行用一句人话说记住了什么、管哪本书或哪类场合，如「记住了：《{书名}》的对话一律用「」，以后写这本书都照这个来；想改随时说。」；第二行是机器回执作凭证，如「技术备注：Author Memory Receipt: r1 · BP001」。
+
+- 确认、替换、忘掉同理：「好，这条生效了：……」「换成了：……，原来的「……」不再用」「忘掉了：……」。只进待确认时说「这条先记在待确认里，你说"确认"才生效」；有冲突时用原话说明跟哪条旧习惯冲突。
+- `warnings` / `omitted_ids` 不原样贴：说「你的习惯攒得有点多，写正文时这几条可能顾不上：「……」」，并建议说「整理作者记忆」。不提字节、prompt、kind、scope；编号只能跟着原话出现。
 
 ## 运行工具
 
-先依次尝试 `python3`、`python`、`py -3` 找到 Python 3，再从当前 skill 根运行本地副本：
+依次尝试 `python3`、`python`、`py -3` 找到 Python 3，从当前 skill 根运行本地副本：
 
 ```text
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py init   --workspace {工作区}
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py record --workspace {工作区} --input {单事件.json}
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py query  --workspace {工作区} [--kind prose_style] [--book {书名}] [--genre {题材}] [--workflow {流程}]
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py commit --workspace {工作区} --input {事务.json}
-{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py check  --workspace {工作区}
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py record --workspace {工作区} [--book-root {书目录}] --input {工作区}/.story/work/作者记忆-事件.json
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py query  --workspace {工作区} --book-root {书目录} --kind {类型}（必传，可重复） [--genre {题材}] [--workflow {流程}]
 ```
 
-- `record`：常用单事件入口，自动读取当前修订、首次自动初始化；`event_id` 相同且内容相同会幂等返回原回执，内容不同会失败。
-- `query`：只读相关 active 条目；`--kind` 可重复，不存在 state 时返回空结果且零写入。返回的 `omitted > 0` 时收窄 kind / book / genre / workflow 后重查，不得改读完整画像规避预算。
-- `commit`：高级批量入口；先在内存完成 schema、引用、容量和所有视图校验，最后原子替换 state。事务文件在成功前必须保留；过期修订会在任何写入前失败。
-- `check`：从 state 重建并逐字核验所有派生视图。
+- 子命令都可加 `--book {书名}`；写某本书时一律带 `--book-root`。事件 JSON 写在 `{工作区}/.story/work/`（不写系统 `/tmp`），成功后删掉；book 条目的 `scope.value` 填书名（书级 store 已记的名字，首次取目录名）。
+- 明确的“记住 / 确认 / 替换 / 忘掉”都走单事件 `record`：自动读该 store 当前修订、首次自动初始化，不手工读修订号或拼多操作事务。同一 `event_id` 同内容幂等返回原回执，内容不同则失败；返回的 `store` / `book` 说明写到了哪一级。
+- 成功才有 `Author Memory Receipt: rN · APxxx`，没有回执不得声称“已经记住”。**写入不因注入预算失败**：`warnings` 只是提醒（另一级 store 读不出来也在这里注明），按上节转告；有回执就是已记住，不要换 `event_id` 重试。
 
-## 事务格式
+## 事件格式
 
-常用单事件新增或强化：
+新增或强化（`record` 输入；book 范围传 `--book-root`）：
 
 ```json
 {
@@ -117,11 +95,11 @@
       "kind": "prose_style",
       "scope": {"level": "global", "value": null},
       "assertion": "对话尽量短，用动作承接情绪，不用大段解释",
-        "quote": "以后对话都短一点，情绪放动作里，别让角色长篇解释。",
-        "source_ref": "conversation:2026-08-25",
-        "source": "explicit_user",
-        "confidence": "high",
-        "importance": "high",
+      "quote": "以后对话都短一点，情绪放动作里，别让角色长篇解释。",
+      "source_ref": "conversation:2026-08-25",
+      "source": "explicit_user",
+      "confidence": "high",
+      "importance": "high",
       "status": "active",
       "reason": "用户以“以后”明确声明长期偏好",
       "conflicts_with": []
@@ -130,36 +108,10 @@
 }
 ```
 
-把文件交给 `record`。待确认项的 `status` 用 `pending`；冲突候选用 `conflict` 并填写 active ID。确认或拒绝候选时，把下列对象作为新事件的 `operation`：
+待确认用 `"status": "pending"`；冲突候选用 `conflict` 并填同一 store 的 active ID。确认、替换、忘掉时，把下列对象换进新事件的 `operation`（`BP` 编号传 `--book-root`）；`replace.preference` 字段同上但不传 `status`、`conflicts_with`，新条目直接 active：
 
 ```json
 {"action":"decide","item_id":"AP002","decision":"activate","quote":"对，这就是我的长期习惯。","reason":"作者明确确认"}
-```
-
-用新规则替代一个或多个旧条目时，`replace.preference` 与上例字段相同，但不传 `status`、`conflicts_with`，新条目直接 active；下列对象同样作为 `operation`：
-
-```json
-{
-  "action": "replace",
-  "old_ids": ["AP001"],
-  "preference": {
-    "kind": "prose_style",
-    "scope": {"level": "global", "value": null},
-    "assertion": "以后对话允许更长的试探，但避免解释设定",
-    "quote": "把以前对话都要短的习惯替换掉：以后可以让对话慢一点，多试探，但还是别拿台词讲设定。",
-    "source_ref": "conversation:2026-08-25",
-    "source": "explicit_user",
-    "confidence": "high",
-    "importance": "high",
-    "reason": "作者明确替换原有全局规则，不是新增本书例外"
-  }
-}
-```
-
-撤回条目的 `operation`：
-
-```json
+{"action":"replace","old_ids":["AP001"],"preference":{"kind":"prose_style","scope":{"level":"global","value":null},"assertion":"以后对话允许更长的试探，但避免解释设定","quote":"……","source_ref":"conversation:2026-08-25","source":"explicit_user","confidence":"high","importance":"high","reason":"作者明确替换原有全局规则，不是新增本书例外"}}
 {"action":"forget","item_id":"AP003","quote":"忘掉这个偏好。","reason":"作者明确撤回"}
 ```
-
-需要把多个动作绑定成一次原子提交时才用高级 `commit`：顶层传 `schema_version`、唯一 `transaction_id`、当前 `expected_state_revision` 和含 1–32 项的 `operations`。操作按数组顺序应用，任一步失败则整份事务零写入。成功后删除临时输入文件；显式记忆请求还要把工具返回的回执原样告诉用户。

package/lib/oh-story/skills/story-long-write/references/banned-words.md

@@ -6,7 +6,7 @@
 
 ## 默认优先检查的句式（先对照本书文风）
 
-写网文最毒的 AI 句式，作者一旦养成就会反复出现。Gate A 第一遍扫描必须命中：
+写网文最毒的 AI 句式，作者一旦养成就会反复出现。以下是优先检查的句式：
 
 | 毒级 | 句式 | 错误例 | 修法 |
 |------|------|--------|------|
@@ -21,7 +21,7 @@
 | ★★★ | 抽象命运/开端收束："命运……棋局/獠牙" / "这一刻终于明白" / "反击才刚刚开始" | "命运终于露出獠牙；属于他的反击才刚刚开始" | 回到角色当下可见的文件、动作、对话或物理后果 |
 | ★★ | 章末预告 "他不知道的是……" | "他不知道的是，更大的风暴即将来临" | 用具体钩子物件/事件收束，避免空泛预告 |
 
-> 凡命中 ★★★★★ 一处即视为重度AI味的强证据；★★★★ 命中 ≥2 处即触发中度复扫。
+> ★★★★★ 命中一处就要改；轻/中/重分档只按去 AI 味诊断的密度指标定。
 
 `check-ai-patterns.js` 的 `formulaic-parallelism` 还会提示「至于X不X，怎么X」和同动词「不V A，不V B」。这两类可能是功能性口语，因此只做 advisory；Gate B 必须连同台词读语境复核，若只是复述细纲/前文就压成一次判断，不能因 hook 豁免台词而跳过。