npm - @oh-story/dsh - Versions diffs - 0.1.4 → 0.1.5 - Mend

@oh-story/dsh 0.1.4 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (479) hide show

package/lib/oh-story/skills/{story-setup/references/agent-references/genre-catalog.md → story-long-write/references/long-genre-catalog.md} RENAMED Viewed

@@ -1,6 +1,6 @@
-# 题材框架速查
+# 长篇题材框架速查
-> **用途**：拆文和写大纲时对照使用。你是一个熟练的网文结构分析师，按照下方路由表选择对应框架，严格执行结构比例和情绪节拍。
+> **用途**：长篇选题和大纲设计时对照使用。节点占比用于检查整卷/全书功能分配，不是每章硬配额；短篇结构转交 `story-short-write`。
 ---
@@ -31,9 +31,9 @@
 | 还需要什么 | 加载 |
 |-----------|------|
-| 核心梗设计与循环机制 | `genre-core-mechanics.md` |
+| 核心梗设计与循环机制 | `long-genre-mechanics.md` |
 | 读者心理与期待管理 | `genre-readers.md` |
-| 对应题材写作公式 | `genre-writing-formulas.md` |
+| 对应长篇题材卡 | `genre-prose-cards.md` 索引及 `genre-prose-cards/` 对应题材卡 |
 ---
@@ -62,18 +62,6 @@
 | 7.反复拉扯 | 多次求复合被拒 | 20% | 爽(打脸) |
 | 8.结局 | 开放/回头/悲剧 | 15% | 释放 |
-### 短篇（压缩三幕）
-**核心**：先虐后爽，后悔的男人+不回头的女人
-| 幕 | 占比 | 内容要点 |
-|----|------|----------|
-| 建压 | 40% | 冷暴力/出轨(具体事件)→最后忍让→平静离开 |
-| 爆点 | 35% | 丈夫后悔→妻子新生活→追妻被拒→信息差释放 |
-| 落定 | 25% | 火葬场→妻子最终选择→一句话定调 |
-**技法**：前期虐越狠后期越爽；妻子至少被拒绝两次；丈夫视角悔恨比妻子视角坚强更有冲击；钩子=信息差+打脸
 ---
 ## 重生复仇
@@ -101,16 +89,6 @@
 | 7.反派下场 | 逐一报应 | 10% | 爽(宣泄) |
 | 8.新生活 | 选择新方向 | 10% | 治愈/释然 |
-### 短篇（压缩三幕）
-| 幕 | 占比 | 内容要点 |
-|----|------|----------|
-| 建压 | 35% | 重生节点→前世闪回→第一个不同选择→信息差建优势 |
-| 爆点 | 40% | 逐步拆解仇人→两个打脸名场面→仇人反击落空→前世未知真相 |
-| 落定 | 25% | 终极复仇→弥补遗憾→新生开始 |
-**技法**：不能太顺利要有变数；打脸分层递进；前世闪回有选择不倒完；钩子=信息差+暗牌+打脸
 ---
 ## 小三/婚恋
@@ -133,16 +111,6 @@
 | 7.报应 | 10% | 爽(宣泄) |
 | 8.新生活 | 10% | 治愈 |
-### 短篇（压缩三幕）
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 40% | 暗示裂痕→蛛丝马迹→确认→冷静(不是崩溃) |
-| 爆点 | 35% | 暗中布局→表面周旋(戏剧张力)→摊牌 |
-| 落定 | 25% | 法律/揭露/经济独立→渣男下场→新生 |
-**技法**：发现过程要有悬念；妻子要有策略不是傻白甜；钩子=信息差+暗牌+倒计时
 ---
 ## 世情
@@ -165,16 +133,6 @@
 | 7.报应 | 15% | 爽(宣泄) |
 | 8.善有善报 | 10% | 治愈 |
-### 短篇（压缩三幕）
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 40% | 困境→暴露事件→周围人态度→忍还是争 |
-| 爆点 | 35% | 冲突升级→背叛/落井下石→反击→反转 |
-| 落定 | 25% | 解决→人心揭示→成长→留白 |
-**技法**：靠细节不靠大事件；人物不能非黑即白；钩子=代价+弱者+反转
 ---
 ## 仙侠/玄幻
@@ -199,16 +157,6 @@
 **关键维度**：力量体系清晰不崩 | 金手指独特有限制随成长 | 战斗有策略非纯数值 | 地图逐层展开 | 升级节奏均匀
-### 短篇（压缩三幕）
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 35% | 世界规则+主角位置→困境→核心设定→人物出场 |
-| 爆点 | 40% | 修炼转折→正面交锋→大阴谋→关键反转 |
-| 落定 | 25% | 终极对决(有策略有代价)→矛盾解决→仙侠留白 |
-**技法**：世界观压缩到最少用事件带出；等级/功法3-5个概念足矣；冲突落在"情"非"力"；钩子=暗牌+反转+代价
 ---
 ## 死人文学
@@ -231,16 +179,6 @@
 | 7.因果终结 | 10% | 释放 |
 | 8.余韵结局 | 10% | 意难平 |
-### 短篇（压缩三幕）
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 35% | 死亡事实→死者视角→最放不下的事→生者状态 |
-| 爆点 | 40% | 回忆现实交叉→真相→反转→最扎心时刻 |
-| 落定 | 25% | 放手或执念→生者继续或崩塌→安静画面→一句话/意象 |
-**技法**：核心是"来不及"；死者第一人称最有冲击；情绪克制越克制越扎心；钩子=代价+信息差+弱者
 ---
 ## 都市高武
@@ -263,14 +201,6 @@
 **关键**：金钱驱动反复挂钩 | 换地图用过渡人物连接 | 10万字前数据偏弱是常态 | 前三章=底层处境→金手指→第一次展示
-### 短篇（压缩三幕）
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 35% | 经济困境→被压制→金手指触发 |
-| 爆点 | 40% | 实力提升→碾压→更强对手出现但不惧 |
-| 落定 | 25% | 解决对手→阶段性胜利→暗示更大世界 |
 ---
 ## 霸总/甜宠
@@ -292,14 +222,6 @@
 **关键**：甜的密度决定粘性 | 宠要"别人做不到的方式" | 阻力不能太强(虐就跑偏)不能太弱(没张力) | 女主要独立闪光点
-### 短篇（压缩三幕）
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 30% | 女主困境→相遇→男主展露兴趣 |
-| 爆点 | 40% | 宠溺(闺蜜震惊标配)→超出预期→危机轻松化解 |
-| 落定 | 30% | 感情确认→极致甜场景→暗示幸福 |
 ---
 ## 同人流派
@@ -388,14 +310,6 @@
 **关键**：大部分读者是"云爱好者"爽感优先于还原度 | 现代认知信息差=最大金手指 | 架空可降低门槛 | 盘点+历史共鸣感强
-### 短篇（压缩三幕）
-| 幕 | 占比 | 要点 |
-|----|------|------|
-| 建压 | 30% | 穿越到关键时刻→面临危机 |
-| 爆点 | 45% | 利用现代知识/信息差解决→打脸质疑者 |
-| 落定 | 25% | 历史轨迹改变→获得新地位 |
 ---
 ## 文娱/娱乐圈
@@ -449,14 +363,14 @@
 ---
-## 通用拆文提醒
+## 长篇设计提醒
 | 检查项 | 说明 |
 |--------|------|
 | 题材识别 | 属于哪个框架？有无跨框架混搭？ |
-| 节奏比例 | 长篇：实际vs推荐8节点占比差多少？短篇：三幕占比差多少？ |
-| 反转位置 | 在百分之多少出现？ |
-| 钩子密度 | 每2000字至少一个？ |
+| 节奏比例 | 节点功能是否在对应卷/全书阶段出现，偏移是否有题材或人物因果支持？ |
+| 反转位置 | 是否在阶段旧认知已经支撑过行动、且揭示后仍有后果空间时出现？ |
+| 钩子密度 | 高压、推进、低压章节是否形成张弛，期待链有没有断？ |
 | 字数效率 | 有无废段落？哪些可删？ |
 | 情绪落点 | 读完最后一句是什么感觉？ |
@@ -464,15 +378,15 @@
 ## 质量检查清单
-每次使用本手册完成拆文或大纲后，逐项核对：
+每次使用本手册完成长篇定位或大纲后，逐项核对：
 | # | 检查项 | 通过标准 |
 |---|--------|----------|
 | 1 | **题材定位正确** | 已通过路由表确认框架，无模棱两可 |
-| 2 | **结构比例达标** | 长篇8节点/5阶段各节点占比偏差不超过5%；短篇三幕占比偏差不超过5% |
+| 2 | **结构功能完整** | 8节点/5阶段承担的功能齐全；实际比例服从题材、卷功能与人物因果，不按固定 ±5% 判死 |
 | 3 | **情绪节拍完整** | 压抑→爆发→释放的完整情绪弧线存在，无断层 |
 | 4 | **人物弧线明确** | 主角有清晰的起点和终点变化；反派有独立动机不是工具人 |
-| 5 | **钩子密度足够** | 每2000字至少一个悬念/反转/信息差钩子 |
+| 5 | **期待链不断** | 章节强弱符合定位；回收旧期待前已经建立下一层期待，不按固定字数配钩子 |
 | 6 | **金手指自洽** | 金手指规则明确，使用有限制，后期不崩 |
 | 7 | **信息差利用到位** | 有读者知道但角色不知道、或角色知道但对手不知道的信息差设计 |
 | 8 | **技法匹配题材** | 已对照对应题材的"技法"条目，无遗漏 |

package/lib/oh-story/skills/{story-setup/references/agent-references/genre-core-mechanics.md → story-long-write/references/long-genre-mechanics.md} RENAMED Viewed

@@ -2,7 +2,7 @@
 > **用途**：核心梗三层递进设计（主题→题材→情绪），微创新五法、冲突网络、金手指匹配、事业线/爱情线设计。构思和验证大纲时对照使用。
 > **语气**：指令式——每个原则都是"必须做到"的硬规则，违反就有明确后果。
-> **配合**：题材结构骨架见 genre-writing-formulas.md，读者画像见 genre-readers.md。
+> **配合**：长篇题材结构与声线见 genre-prose-cards.md，读者画像见 genre-readers.md。
 ---

package/lib/oh-story/skills/{story-short-write/references/reversal-toolkit.md → story-long-write/references/long-reversal.md} RENAMED Viewed

@@ -1,4 +1,4 @@
-# 反转设计工具箱
+# 长篇反转设计
 > 操作手册：反转类型、嵌套反转、误导技巧、打脸节奏。按决策路由选用，按设置/揭示步骤执行，用自检清单验收。
 > 反转类型枚举与拆文 `_meta.json.reversal_type` 字段一致：视角/身份/动机/时间线/信息/认知/无反转。
@@ -175,7 +175,7 @@
 **写法要点**：
 1. 不为"显得有设计感"硬加反转
 2. 报应型：每个报应要让读者等过、铺过，兑现时才解气
-3. 甜宠型：升温节拍密集，每节给一个甜点/反差点
+3. 甜宠型：在关系阶段节点给甜点/反差点，不为每章硬塞反转
 > 拆文时遇到此类，`reversal_type` 填「无反转」，`setup_clues`（反转铺垫）一项跳过阈值（见 analyze output-contract 的「structure_counts 数值校验」）。
@@ -183,19 +183,19 @@
 ## 嵌套反转
-一篇短篇可叠 2-3 层反转，必须主次分明。
+长篇可在单元、卷和全书三层安排反转，但每层只能有一个主认知变化；下位反转服务上位谜团，不能不断推翻世界规则。
 ### 双层嵌套
 ```
 读者以为：A（铺垫阶段）
-第一层反转：其实是 B！（70%处）
-第二层反转：B 也是假的，其实是 C！（90%处）
+第一层反转：其实是 B！（阶段假答案）
+第二层反转：B 解释了局部，但 C 才是更高层机制！（卷末认知升级）
 ```
 **执行要求**：
 - 第一层反转必须足够有说服力，让读者接受B就是真相
-- 第一层后给1-2段「消化时间」
+- 第一层后给至少一个行动后果或关系变化，不在同一场景立刻翻回去
 - 第二层要能同时解释A和B，比第一层更震撼
 示例：
@@ -208,36 +208,22 @@
 ### 三层嵌套（慎用）
-**使用条件**：只有15000字以上能装下三层。
-**执行要求**：
-- 间隔递减：第一层50-60%，第二层75-80%，第三层90-95%
-- 第三层必须最短最狠——一句话就够
-- 最后一层必须回答前面所有疑问
-- 每层都要有情感冲击，不只是信息冲击
-- 题材限制：只适合高智商悬疑、精心设计的复仇
+只在“单元假答案 → 卷级机制 → 全书真相”确有不同叙事职责时使用。每层必须改变角色下一步行动，并留下可回溯证据；若只是连续换答案，砍到两层。
 ---
 ## 反转时机
-### 最佳揭示位置
-| 反转类型 | 最佳位置 | 原因 |
-|----------|----------|------|
-| 身份反转 | 65-75% | 留够时间展示身份变化后的新冲突 |
-| 视角反转 | 70-80% | 需要足够篇幅建立错误认知 |
-| 动机反转 | 75-85% | 动机要在角色做出关键选择前揭示 |
-| 时间线反转 | 80-90% | 时间线需要最长铺垫 |
-| 信息反转 | 70-80% | 揭示后需要展示连锁反应 |
-| 认知反转 | 75-90% | 感情色彩要全程积累够才翻得动 |
+### 揭示位置按叙事层级决定
-### 时机铁律
+| 层级 | 合适时机 | 揭示后必须发生什么 |
+|------|----------|--------------------|
+| 场景/单章 | 当前行动获得可验证结果时 | 角色立刻调整选择或关系 |
+| 单元 | 阶段目标看似完成、旧解释无法覆盖新证据时 | 开启下一阶段目标并支付代价 |
+| 卷级 | 本卷承诺已兑现、读者能回看证据链时 | 改写对主线机制的理解，保留全书真相 |
+| 全书 | 核心矛盾具备结算条件时 | 完成因果、情绪与收益归属结算 |
-- 禁止在50%之前揭示——铺垫不够，反转没力度
-- 禁止在95%之后揭示——揭示后没有展开空间
-- 最优区间：70-85%
-- 双反转：第一个在55-65%，第二个在80-90%
+不要把全书百分比当铁律。反转太早或太晚的判断标准是：旧认知是否已经支撑过真实行动、揭示后是否还有足够篇幅展示后果。
 ---
@@ -282,7 +268,7 @@
 - [ ] 揭示方式自然，不靠角色大段独白解释
 ### 节奏
-- [ ] 反转揭示不超过300字（快速、干脆）
+- [ ] 揭示场景没有被解释独白淹没；复杂机制可以分行动、证据和后果多拍展示
 - [ ] 揭示后有足够篇幅展示反转影响
 - [ ] 反转后结尾在反转产生的情绪上收束
@@ -310,7 +296,7 @@
 ### 超额收获反转
 反转后收获超出预期，产生二次惊喜：
-- 短篇：主角以为只解决一个问题，结果连带解决了隐藏的更大问题
+- 长篇：主角解决阶段问题，同时获得通向更高层矛盾的资源、身份或证据
 - 网游文模式：Boss爆三样——立刻能用的 / 送人拉关系的 / 暂时用不到但一看很厉害的
 ### 情绪拉扯反转标准流程
@@ -338,7 +324,7 @@
 ### 打脸节奏铁律
-- 压抑不能太长——连输8场写3万字不行，改成连输4场+略写
+- 压抑长度服从单元功能；连续失败必须带来信息、能力、关系或策略积累，不能只换场景重复受挫
 - 压的同时必须给读者信心暗示（主角自信到自大："我们还是联赛前四！"）
 - 比起主角被欺负，读者更厌恶主角自暴自弃
 - 高潮部分要拉长，最大化利用（球迷反应、解说员、赛后跟进）

package/lib/oh-story/skills/story-long-write/references/{hooks-suspense.md → long-suspense.md} RENAMED Viewed

@@ -1,4 +1,4 @@
-# 悬念编排操作手册
+# 长篇悬念编排
 悬念构建、强度分级、多线周期、分层钩子、期待接力、震惊分层的完整操作指南。
@@ -86,11 +86,11 @@
 ### 三段钩子设计（单章内）
-按章节进度分配悬念节奏：
+按章节功能安排，而不是把每章机械切成固定百分比：
-1. **种**（前 30%）：埋下钩子种子
-2. **养**（中 50%）：逐步加压，让读者意识到不对劲
-3. **收**（末 20%）：引爆或延迟引爆
+1. **种**：在本章第一个有效场景中提出异常、目标或未完成动作。
+2. **养**：用行动受阻、新证据或关系变化加压；过渡章可以只推进一拍。
+3. **收**：本章兑现一项状态变化，并把尚未解决的问题交给下一章。
 延迟引爆 = 比引爆更强的钩子，用于拉到下一章。
@@ -102,7 +102,7 @@
 - 确保读者脑中有三个好奇的东西：两长一短
 - 长期待收回后变短期爆发，同时新的长期待已铺好
-- 短篇中：一个主悬念 + 一个副悬念，结尾同时引爆
+- 长篇中：短期、中期、远期悬念不能在同一章全部引爆；每次回收至少保留或新建一条更长的期待线。
 ### 持续拉期待操作框架

package/lib/oh-story/skills/story-long-write/references/opening-design.md CHANGED Viewed

@@ -177,7 +177,7 @@
 ```
 出了{医院/法院/某场所}，{天气映射心情}。
-{主角}{一个微动作暗示内心}。
+{主角}{一个会改变现场的选择、台词、任务动作或后果；必要时才用身体细节}。
 脑海中闪过{某人}的话——
 "{冲击性的一句话}"
 {主角的反应}。

package/lib/oh-story/skills/story-long-write/references/outline-structure-theory.md CHANGED Viewed

@@ -301,7 +301,7 @@
 题材分级（上面占比是均衡 / 长书基线，按题材分档）：番茄短平快 / 男频事业线，高压可到 30% 以上、呼吸章压到 5% 上下都正常，别拿基线去「补呼吸、砍高压」反而掉追读；女频 / 世情 / 追妻，人设关系容量大、关系 / 低压章可更多，但仍走情绪折线、不必每章三折。低压 / 关系章定位是看点（主角身边人的日常本身是订阅点），不是填充。
-与字数预算的衔接：章节定位只改密 / 疏配比的下限，不改 Σ 契约。高压章靠多密点达到 Σ∈[章目标, ×1.1]；低压生活 / 信息整理 / 纯过场章靠铺点（120-150）与疏点（40-60）凑字、允许 0 密点，但关系回收章要保 ≥1 个情感密点（250-320），否则关系写塌。写后字数 <90% 定位欠账时，高压 / 推进章补密点重写，低压 / 过场章补铺垫 / 互动 / 表演 beat，不强塞爽点密点——低密点是设计，不是欠账。
+与字数目标的衔接：章节定位决定节拍功能与展开取舍，但不把每个情节点换算成固定字数，也不靠增点凑目标。写后由程序按双层长度带验收：明显欠长先判断已批准义务是否未实现，容量不足或不明确就协商自然长度、补纲或目标，绝不自动补写；明显超长可做一次不新增语义、逐项保留批准情节点与章尾钩子的净删型压缩，复检仍带外就停止，不进入循环删改。
 ---

package/lib/oh-story/skills/story-long-write/references/style-genre-modules.md CHANGED Viewed

@@ -30,7 +30,7 @@
 正文写作采用「通用正文要求 + 题材正文提示卡 + 本书文风」三件套，不再为每个题材复制一整套正文 prompt。
-- **通用正文要求**由 `story-long-write` Phase 4 负责：严格消费细纲，按情节点预算写，缓慢推进，不提前写后续剧情，完成字数/钩子/禁用词/退化校验。
+- **通用正文要求**由 `story-long-write` Phase 4 负责：严格消费细纲，按情节点义务写，缓慢推进，不提前写后续剧情，完成确定性字数/钩子/禁用词/退化校验。
 - **题材正文提示卡**只管题材层的稳定核心：世界观或生活逻辑、读者期待、核心爽点/情绪、节奏密度、场景颗粒、禁止漂移。项目优先从 `genre-prose-cards.md` 索引匹配，再读取 `genre-prose-cards/{题材}.md` 单卡，本文件只作通用流派补充。
 - **本书文风**来自 `设定/文风.md` 或对标 `文风.md`：只管句长、标点、潜台词、锚点片段和笔调，不覆盖题材核心与章节意图。
 - 三者冲突时：章节细纲与连续性 > 题材正文提示卡 > 本书文风 > 通用技巧建议。

package/lib/oh-story/skills/story-long-write/references/tracking-transaction.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | 层级 | 文件 | 语义 |
 |---|---|---|
-| 唯一权威 | `_tracking-state.json` | schema、最后提交章、导入截止章、状态修订号、上下文结构、全部当前角色/伏笔/时间线状态 |
+| 唯一权威 | `_tracking-state.json` | schema、最后提交章、导入截止章、状态修订号、上下文结构、角色/伏笔/时间线，以及已提交章节的简短字数记录 |
 | 章节记录 | `逐章记录/第NNN章.md` | 本章对未来连续性有用的紧凑变化；目标 ≤1536 字节，硬上限 3072 字节；导入范围内修订写成覆盖记录 |
 | 派生视图 | `上下文.md`、`角色状态/{角色名}.md`、`伏笔.md`、`时间线/作者真相.md`、`时间线/读者已知.md` | 完全从 `_tracking-state.json` 生成；禁止手改，不作为程序输入 |
@@ -15,21 +15,27 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 ## 运行工具
-先按运行环境探测 Python 3 解释器（依次尝试 `python3`、`python`、`py -3`），再用当前 skill 根目录执行：
+先按运行环境探测 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 commit --project {书项目根} --input {逐章事务.json}
 {PYTHON} {当前 skill 根}/scripts/tracking_commit.py check  --project {书项目根}
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py wordcount checkpoint --file {前半段临时文件} --target {目标} --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}
 ```
 - `init`：只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
-- `commit`：读取唯一权威状态，在内存中完成合并、引用检查、全部视图渲染和容量检查；随后写逐章记录与派生视图，最后原子替换 `_tracking-state.json` 作为唯一提交点。
+- `wordcount checkpoint`：纯测量；返回当前实际字数、用户带与剩余用户区间，不写正文、不写 tracking、不做语义判断。每章最多调用一次。
+- `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 的逐字一致性。
-同一本书只允许工作流串行提交，不支持多个 Agent 或终端并发写。`expected_state_revision` 用于拒绝基于旧状态构造的顺序 stale transaction，不是并发锁。
+每本书由 `追踪/.tracking-commit.lock` 串行写事务，`expected_state_revision` 再拒绝基于旧状态构造的 stale transaction。两个不同事务并发时至多一个修订成功。字数记录也在锁内对当前正文和目标重新验证，正文或目标变化会让预先构造的记录直接失败。
-事务 JSON 在成功前必须保留。若文件写入失败，`_tracking-state.json` 尚未推进；修正环境后直接重跑**同一份** `commit`。append 重跑只接受内容完全相同的既有逐章记录，不维护 `dirty/pending/repair` 状态机。
+事务 JSON 是临时输入，不是项目产物：成功前必须保留；提交成功且紧随其后的 `check` 通过后立即删除，不能把 `init_transaction.json`、`chapter_*_transaction.json` 等输入长期留在书项目根目录。若文件写入失败，`_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`——删掉那个手写文件后重跑原事务即可。
@@ -65,6 +71,8 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。
+调用方的逐章 JSON 不写 `wordcount`；正式入口 `chapter commit` 或 `chapter accept-current-length` 在提交当下生成并注入。最终 state 只为已提交章节保留 `metric / target / actual / status / resolution / body_sha256`，不保存 MEASURE/RESOLVE 事件、ID 链、policy fingerprint 或独立 chapter state。
 ## 逐章事务
 ```json

package/lib/oh-story/skills/story-long-write/references/workflow-chapter.md CHANGED Viewed

@@ -4,14 +4,16 @@
 项目文件结构、产物映射表、缺失文件处理、对标分析权威优先级在 `SKILL.md` Phase 4 开头，本文件不重复（SKILL.md 恒在上下文里）。
+本文件提到的 agent 都只检查当前端 canonical 目录；Antigravity 使用 `.agents/agents/agent-name/agent.md`（`agent-name` 为目标 agent 名）和 `invoke_subagent` + 同名 `TypeName`，其余端使用各自 Agent 工具。
 ---
 ## 单章写作流程
 当用户准备写某一章时：
-1. **检查细纲**：读取 `大纲/细纲_第{N}章.md`，并从对应 `大纲/卷纲_第X卷.md` 读取当前剧情单元（单元ID/位置、卷契约、本卷主推线/战果、终局底牌边界、风险等级）。如果不存在或缺少当前章节蓝图的必需字段，**必须先补建细纲再写正文**，不允许跳过细纲直接写作。补建时参考卷纲中本章对应的事件规划和上下文，补齐阶段位置、结构公式、禁止提前释放、内容概括、情节安排、人物关系/出场顺序、情节细化、结尾设定；无法从已有证据判断的字段写 `[待补充]`，不杜撰副线或关系。
-2. **读取上下文**（按需选择；缺失时遵循各项及SKILL.md Phase 4 的「缺失文件处理」，仅明确标为可选的非主产物跳过。可选快捷路径：如果项目已部署 story-explorer agent（优先检查 `.claude/agents/story-explorer.md` 是否存在；不存在时再检查 `.opencode/agents/`，再不存在时检查 `.codex/agents/`），可 spawn `Agent(subagent_type: "story-explorer", prompt: "项目目录：{dir}\n查询类型：context_load\n查询参数：准备写第 {N} 章\n追踪状态：last_committed_chapter={check 的值}，state_revision={check 的值}")` 一次获取上下文）：
+1. **检查细纲**：读取 `大纲/细纲_第{N}章.md`，并从对应 `大纲/卷纲_第X卷.md` 读取当前剧情单元（单元ID/位置、卷契约、本卷主推线/战果、终局底牌边界、风险等级）。如果不存在或缺少当前章节蓝图的必需字段，**必须先补建细纲再写正文**，不允许跳过细纲直接写作。补建时参考卷纲中本章对应的事件规划和上下文，补齐阶段位置、结构公式、禁止提前释放、内容概括、情节安排、人物关系/出场顺序、情节细化、结尾设定；无法从已有证据判断的字段写 `[待补充]`，不杜撰副线或关系。补建后按 `artifact-protocols.md` 跑 `check-outline-contract.js` 结构验收，失败只补点名字段再复验。
+2. **读取上下文**（按需选择；缺失时遵循各项及SKILL.md Phase 4 的「缺失文件处理」，仅明确标为可选的非主产物跳过。可选快捷路径：对应 agent 已部署时 spawn story-explorer 一次获取上下文。Prompt：`项目目录：{dir}\n查询类型：context_load\n查询参数：准备写第 {N} 章\n追踪状态：last_committed_chapter={check 的值}，state_revision={check 的值}`）：
    - (1) `正文/第{N-1}章_*.md` — 上一章正文
    - (2) `大纲/细纲_第{N}章.md` — 本章细纲（含钩子设计）
    - (2a) `大纲/卷纲_第X卷.md` — 当前剧情单元、卷契约与终局储备（主推线/战果、终局底牌边界）
@@ -38,7 +40,7 @@
      - (f) **结构化模块召回**：从对标的结构化子目录（角色/剧情/设定）中按本章情节检索相关模块；若与 `剧情/情绪模块.md` / `剧情/节奏.md` 冲突，权威文件优先，记录 `conflict`
      - (g) 输出"主对标召回摘要 + 副对标召回摘要 + selected_emotion_module + rhythm_reference + genre_prose_card + 文风召回指令 + 原文锚点片段引用"，作为 narrative-writer 的输入。**多对标书时**参 `references/cross-book-recall.md`：主对标提供文风、原文锚点与 selected_emotion_module / rhythm_reference；副对标/参考对标按阶段预算提供结构化摘要，不限制登记书目，不读取副书 `文风.md` / 原文，超过预算时裁条目不裁书目记录。
      - **快捷路径**：项目已部署 story-explorer agent 时，可一次性召回文风/模块材料。
-       - 检查顺序：`.claude/agents/story-explorer.md` → `.opencode/agents/` → `.codex/agents/`。
+       - 按本文件顶部规则确认 story-explorer 已部署。
        - 查询类型：`benchmark_style_load`；传入项目目录、章节号、目标基调/字数和爽点类型。
        - 需要返回：`style_profile_path`、`style_profile_summary`、`selected_emotion_module`、`rhythm_reference`、来源路径、匹配章节、锚点片段、`gaps`。
        - `gaps.missing_primary_contract` 为 true 时先按 `repair_action` 修复，不进入正文生成。
@@ -52,12 +54,15 @@
 	     - 检查任务卡点：本章如果有“办事被卡住”，它必须卡出信息、关系、代价、选择或伏笔变化；没有就不强补。
 	     - 契约风险检查：按 `references/reader-contract-and-progression.md` 判定 契约安全 / 需补强 / 契约破坏；若高光/收益被配角、机构或偶然性拿走且没有可见交换，先修纲再写。
      - 例：「快节奏打脸——账单暴露→逼问→反证→公开代价；读者等了三章，这章必须一拳到位。」
-4. **资料研究**（按需）：如果写作中遇到需要查证的外部事实（历史年代、地理方位、职业细节等），如果项目已部署 story-researcher agent（优先检查 `.claude/agents/` 下的 `story-researcher.md` 是否存在；不存在时再检查 `.opencode/agents/`，再不存在时检查 `.codex/agents/`），spawn `story-researcher` agent 搜索并输出到 `参考资料/` 目录。如 agent 不可用，由主线程直接执行。研究完成后再继续写作。
+4. **资料研究**（按需）：遇到需查证的外部事实且 story-researcher 已部署时，spawn 搜索并输出到 `参考资料/`；不可用则主线程直接执行。研究完成后再继续写作。
 5. **标题预检**：写正文前从细纲读取章名；如与既有章节同名或明显重复，先按本章核心事件改名，并同步细纲标题与正文文件名。
-	6. **写作**：第 1 章如果以内心戏、设定认知或独处开场，必须先把内心变化外化为可见事件（决定、误判、对话、物件变化、外部压力），再按字数目标展开；不得用大段心理独白凑字。若第 1 章低于目标，或正文代入感/推进感偏薄，优先回到细纲补有用子事件、对话交锋或选择代价，不要补解释性内心戏；任务卡点只在角色本来有要办的事、且能卡出信息/关系/代价/选择/伏笔变化时使用，没有就不强补。
+6. **写作与唯一 checkpoint**：将批准情节点按叙事顺序分成连续两组，同一 session 先写前组临时 segment，再且只运行一次 `{PYTHON} {skill 根}/scripts/storyctl.py wordcount checkpoint --file {前组临时文件} --target {字数目标} --chapter {N}`。把 `actual`、`remaining_user_range` 和后组原始情节点交回 writer，并明确：
+   - 只完成剩余情节点，不得为字数新增独立事件、人物决定、关系变化、揭示或支线。
+   - 剩余情节点完成即停，即使仍欠长也不加剧情。
+   两段完成后一次组装最终正文；不做逐点配额、字数 retry、完整重写或落盘后扩写。
    - **正文元信息隔离**：`章节：第{N}章`、`上一章：正文/第{N-1}章_*.md`、`匹配第K章`、`细纲文件` 等只用于定位材料。标题行以外的正文不得出现 `第[一二三四五六七八九十百千万两0-9]+章|上一章|上章|前一章|本章|这一章|前文|后文|伏笔|细纲|读者` 这类写作工程词。需要承接前文时，改成角色能感知的事件锚点或相对时间，例如“比第一章那三秒开火更疼”必须写成“比那三秒开火更疼”。例外：角色在故事世界内真实阅读/讨论“第X章”文本，或真实身为作者/读者并谈论读者身份时，可保留相应词。
 7. **正文执行**：
-   - 先检查 narrative-writer agent：`.claude/agents/narrative-writer.md` → `.opencode/agents/` → `.codex/agents/`。
+   - 按本文件顶部规则确认 narrative-writer 已部署。
    - 如可用，spawn `Agent(subagent_type: "narrative-writer", prompt: ...)`，prompt 只传本章必需材料：
      - 项目目录、章节、细纲文件、上一章、输出路径。
      - 写前准备输出：本节速记、情绪目标、涉及角色、参考技法。
@@ -65,22 +70,23 @@
      - `selected_emotion_module`、`rhythm_reference` 及来源路径。
      - `genre_prose_card`（题材正文提示卡摘要，只含本章相关条目）。
      - 文风路径、文风召回指令、原文锚点片段。
+     - `author_preferences`：作者记忆 `query` 结果中匹配本章的 `prose_style` / `story_design` 项；无则不传，禁止把完整画像或待确认项塞进 prompt；作为低优先级倾向自然吸收，不逐条展示或最大化命中，不牺牲连贯、节奏和字数。
      - 阶段位置、本章结构公式、本章可释放信息、本章禁止提前释放信息。
-     - 字数目标、情节点预算、格式硬约束。
-     - 细纲优先边界（内容层）：只展开本章细纲，不自造新剧情；每条情节点都要独立落地，不许漏、不许两条并一句；若字数目标靠现有情节点无法达标，返回 `outline_underfilled` 欠账点，由主会话补纲/确认后再写。
+     - 字数目标、`visible_chars_v1` 口径、格式硬约束；前组后由机器给出一次剩余用户区间，不让 writer 心算或填写逐情节点配额。
+     - 细纲优先边界（内容层）：只展开本章细纲，不自造新剧情；每条情节点都要独立落地，不许漏、不许两条并一句。不得仅为追字数自动补纲、扩写或重写；实际长度统一留到步骤 8 测量。
      - 正文形状（形状层）：落地位置、顺序、拆成几处由子代理编排，可打散重排、把相邻几条缝进同一个连续动作；不要一条一段平推，不把细纲措辞原样搬进叙述。
    - 不把本文件整套规则复制进 prompt；细节以已加载 references 和 narrative-writer 模板为准。
-   - agent 输出写入 `正文/第XXX章_章名.md`。如 agent 未部署，由主线程直接写作。
-8. **字数验证**（写作完成后的第一件事）：用跨平台 Python 字符统计本章实际字数，探测顺序 `python3/python/py`；不要用 `wc -c` 或模型估算，Windows 不直接假定 `python3` 命令可用。macOS/Linux 可用 `wc -m` 备选。
-   - 字数 < 细纲目标 90%：对照情节点预算找欠账点。密点（爽点/打脸/反转）被写薄时，重写到该点目标区间内；低压/关系/信息整理章则补细纲内已有铺垫、互动或表演节拍，不硬塞爽点。若现有细纲没有足够可展开内容，停止并输出 `outline_underfilled` 欠账点，先补纲/确认，不能让正文自造新剧情。
-   - 字数 > 章目标×1.1：压过场、合并疏点、删多余过渡，不删主线爽点凑数。
-   - 90% 只是放行下限，目标仍是 `[章目标, 章目标×1.1]`；重写后重新统计，落进区间再进入步骤 9。
-9. **检查**：章尾是否有往下看的理由（低压/过场章弱钩子或留阶段目标即可，不强求爽点）、爽点是否到位（按章节定位，高压/推进章必查）。两条可证伪核对（不达标→修复）：① 爽点出手前是否有可指认的危机/期待段落（指到具体情节点）？指不出=空洞 → 回步骤 8 补铺垫情节点（plot-emotion-system 倒推法）；② 装逼/打脸/揭露章，在场配角是否写出差异化反应（集体震惊/各异），还是只写主角动作？没有 → 补在场配角反应（plot-core-methods）
+   - agent 在同一 session 内按上述流程写两个临时 segment；主会话确认二者只消费批准情节点后，组装并写入 `正文/第XXX章_章名.md` 一次。如 agent 未部署，由主线程执行同一流程。
+8. **非对称收口**：运行 `{PYTHON} {skill 根}/scripts/storyctl.py chapter check --project {项目根} --chapter {N}`；文件变更重跑，不存决议。
+   - 带内 + pass → `chapter commit`；fail / `invalid` → 停止。
+   - `under` + pass → 展示 `accept-current-length / revise-outline-or-target / discard`，不补/重试；接受命令会重读、重数、原子提交。
+   - `over` + pass → 删除区间随 `compress-once` 交 narrative-writer；一次净删，零新语义/契约改动。会话核对情节点与钩子后复检；带内提交，否则上述三动作。
+9. **检查**：章尾是否有往下看的理由（低压/过场章弱钩子或留阶段目标即可，不强求爽点）、爽点是否到位（按章节定位，高压/推进章必查）。两条可证伪核对（不达标→只修复细纲已批准内容）：① 爽点前是否有可指认的危机/期待段落？② 装逼/打脸/揭露章，在场配角是否有差异化反应？质量修复后重跑步骤 8，但不得借质量修复补新剧情追字数。
 10. **元信息扫描**：检查标题行以外的正文，命中 `第[一二三四五六七八九十百千万两0-9]+章|上一章|上章|前一章|本章|这一章|前文|后文|伏笔|细纲|读者` 时必须改写为场景内表达；只有角色在故事世界内真实阅读/讨论“第X章”文本，或真实身为作者/读者并谈论读者身份时例外。
 	11. **禁用词扫描**：先过**最毒句式速查**（实测最易漏，命中即改）：①「不是A，(而)是B」全家族——含「没有X，没有Y(，只是Z)」排比否定、「是B，不是A」反序、「他没X，也没有Y。他只是Z」先抑后扬，；②声线反差「声音不大/不高…却…」；③「，带着……」万能状语；④预告/总结收尾「没人知道…」「(这)才刚刚开始/开头」「正朝着…压过去」「即将拉开序幕」「这一刻…」；⑤叙述里短词加引号强调（他是被请来"把关"的）。再复核 detector 的 `formulaic-parallelism` advisory：跨段「不是A。/也不是B。/只是C。」、`至于X不X，怎么X`、同动词 `不V A，不V B` 即使写在台词里也不能跳过，确属人物当场的功能性表达才保留。然后对照 `references/banned-words.md` 全表：一级词（高频AI腔）命中即替换；二级词（低频/语境相关）高频出现时替换，偶发可参考 `references/anti-ai-writing.md` 定性裁定
-12. **更新追踪**：按 workflow-daily「每章提交一次追踪事务」构造 JSON，执行 `scripts/tracking_commit.py commit`。工具先在内存完成全部合并/渲染/容量校验，再生成逐章记录、角色/伏笔/时间线/上下文派生视图，最后原子替换 `_tracking-state.json`。失败按类型处理：**写入失败**（工具不可用、权限被拒、磁盘满）时 `_tracking-state.json` 未推进，保留原事务 JSON 直接重跑同一 `commit`；**校验失败**要按报错改事务本身再提交，重跑同一份结果不变；**派生视图被手改**导致 `check` 报不一致时，重新提交该章的 `mode=revision` 事务让工具整份重建（`expected_state_revision` 取 `追踪/_tracking-state.json` 的 `state_revision` 字段——`check` 失败时只往 stderr 打 ERROR，不输出 JSON）。任何情况都不手改派生文件。本章首次引入会复用的具名角色/势力时，仍按 `references/workflow-setup.md` 的 Phase 3 规则补建静态 `设定/` 档案。
+12. **更新追踪**：最终 `chapter check` 后取最新 `state_revision`，按 workflow-daily 构造不含 `wordcount` 的逐章 JSON。长度在用户带内执行 `storyctl.py chapter commit`；用户接受当前自然长度则执行 `storyctl.py chapter accept-current-length`。两条命令都在提交前重新读取正文和目标、重新计数、重跑 blocking quality，并把简短字数记录与追踪事务一起原子提交。写入失败保留原事务重跑；校验失败重构事务。派生视图损坏按 tracking 文档用 revision 修复，禁止手改。本章首次引入复用角色/势力时，仍按 workflow-setup Phase 3 补建静态档案。
 13. **中途快照**（长篇写作安全网）：每连续写完 3 章，在继续前执行以下快照操作：
-   - 执行 `scripts/tracking_commit.py check`，确认 `_tracking-state.json` 有效、逐章记录连续且未超限、所有派生视图一致、续写状态卡恰好 7 栏且 ≤12288 字节
+   - 执行 `scripts/tracking_commit.py check`，确认 `_tracking-state.json` 有效、逐章记录连续且未超限、所有派生视图一致、续写状态卡恰好 7 栏且 ≤12288 字节；通过后删除本章逐章事务 JSON 与临时 segment，失败时保留事务 JSON 供原样重跑
    - 用 `ls -la 正文/` 确认最近 3 个章节文件已成功写入磁盘且大小正常（>100 bytes）
    - 如果发现文件缺失或大小异常，立即重新写入
    - 快照完成后可继续写作
@@ -98,27 +104,27 @@
 | 任务卡点 | 角色办事被卡住，必须卡出信息/关系/代价/选择/伏笔变化；删掉无损就压缩或删除 |
 | 爽点释放 | 铺垫要充分、释放要干脆，读者等得越久释放越要爽 |
 | 爽点密度 | 高压/推进章每 3000-5000 字一个「爽」的情绪节点；低压/关系/修炼/信息整理章不强求，但每章仍要有往下看的理由（见 references/outline-structure-theory.md「章节定位与张弛」） |
-| 公式约束 | 参考 genre-writing-formulas.md 中的创作公式 |
+| 长篇结构约束 | 参考 genre-prose-cards.md 与当前题材卡的长线约束 |
 | 章尾 | 每章结尾都要有让读者想翻下一页的东西 |
 | 情绪验证 | 写完每章回头检查：读者到这里应该感受到什么？感受到了吗？没感受到 → 按章节定位补：高压/推进章补冲突或钩子，低压/关系章补关系或情绪质感，别一律加爽点 |
-## 字数验收权威
-长篇每章只按本章细纲的 `字数目标` 与步骤 8 的统一 90% 放行下限验收。节奏类型只决定情节点疏密和展开方式，不再叠加另一套静态最低字数。
+## 字数测量权威
-**细纲缺 `字数目标` 时**：按 3000 字/章代入，走同一条 90% 放行下限，并提示补纲。这是唯一兜底值，不按节奏类型分档。
+字数权威默认是细纲 `字数目标` + `visible_chars_v1`：内带 ±12%，用户带 ±15%；**本轮用户明确给出上下限时，原样范围优先于自动比例带**。无节奏下限，缺目标即 `invalid`。带内提交，`under` 不补，`over` 最多净删一次；仍带外由用户接受、改目标/细纲或放弃。下一章只看 tracking 提交。
 ---
 ## 质量检查
-检查三个维度：(1) **情绪交付**——每章是否交付了细纲中规划的目标情绪？(2) **契约风险**——按 `references/reader-contract-and-progression.md` 检查因果权 + 结算权、关键节点四问、期待所有权、期待债、终局储备（透支两问）与换书债；章级推进按权威文件的七类状态分档（快节奏保留可见事件/爽点下限），强弱相对本书题材与对标判断，标记 契约安全 / 需补强 / 契约破坏；契约破坏 先修正文或修后续纲。(3) **技术质量**——一致性、格式、禁用词。参考 [references/quality-checklist.md](quality-checklist.md) 中的通用检查和长篇专项清单。
+检查三个维度：(1) **情绪交付**——每章是否交付了细纲中规划的目标情绪？(2) **契约风险**——按 `references/reader-contract-and-progression.md` 检查因果权 + 结算权、关键节点四问、期待所有权、期待债、终局储备（透支两问）与换书债；章级推进按权威文件的七类状态分档（快节奏保留可见事件/爽点下限），强弱相对本书题材与对标判断，标记 契约安全 / 需补强 / 契约破坏；契约破坏 先修正文或修后续纲。(3) **技术质量**——一致性、格式、禁用词。参考 [references/long-chapter-quality.md](long-chapter-quality.md) 中的通用检查和长篇专项清单。
+**新增独立剧情 blocking**：新饭局、承诺、选择、关系变化、支线或后续义务均阻断；闲话、微连接允许。命中不自动修、不重试、不提交，并提示偏纲。
 **正文元信息扫描**：按上方步骤 10 清掉标题行以外的写作工程词，再进入其他检查。`check-degeneration.js` 会确定性复扫这一项。
 **写后同轮清零**：正文落盘不是汇报时机——每章落盘后必须在**同一轮**内跑完上方步骤 10-11 扫描、下方确定性收尾脚本与 narrative-writer 审查，blocking 清零才算本章完成；不得先汇报"已写完"再等指示。写后 hook 会对落盘正文自动扫描确定性毒句式并把命中推回——那是兜底网不是替代，hook 报出的命中当轮清零。**唯一豁免**：用户显式说"本章不去味/跳过检查"——豁免时在该章标题行下加一行 `<!-- 去味:跳过 -->`（写后 hook 的毒句式推回与写下一章前的欠账拦截都认这个标记；其余网照常）。
-**确定性收尾**：本批正文写完后，主会话对实际落盘文件运行 `node scripts/check-ai-patterns.js --check --fail-on=blocking 正文/第XXX章_*.md` 与 `node scripts/check-outline-copy.js 正文/第XXX章_*.md`（细纲照搬复扫）。blocking 命中先回正文改写并复扫；advisory 与细纲重合逐条读原文判断，确属问题才改，功能性写法标 `[需复核]`——每条都要有结论，不为归零机械改写；细纲重合里判定保留的补进细纲「复沓锚句」，下章起不再复报。其中 `formulaic-parallelism` 必须连同对话一起复核，不能因为 hook 不阻断台词就略过。
+**确定性收尾**：本批正文写完后，主会话对实际落盘文件运行 `node scripts/check-ai-patterns.js --check --fail-on=blocking 正文/第XXX章_*.md` 与 `node scripts/check-outline-copy.js 正文/第XXX章_*.md`（细纲照搬复扫）。blocking 命中先回正文改写并复扫；advisory 与细纲重合逐条读原文判断，确属问题才改，功能性写法标 `[需复核]`——每条都要有结论，不为归零机械改写；细纲重合里判定保留的补进细纲「复沓锚句」，下章起不再复报。其中 `formulaic-parallelism` 必须连同对话一起复核，不能因为 hook 不阻断台词就略过；`stock-reaction-tic` 必须按 `writing-craft.md`「反套话四问」逐处做删除测试，交付摘要写明候选数、删除数及每个保留项的叙事功能，不能只写“已检查”。
 随后运行 `node scripts/normalize-punctuation.js 正文/第XXX章_*.md`（默认 `--quote-mode keep`）清理无功能省略号、破折号、双连字符和独立分隔线；盐言「」不受影响。narrative-writer agent 不运行这些脚本。
 **退化防护**：正文落盘后运行 `node scripts/check-degeneration.js --check 正文/第XXX章_*.md`。blocking（复读、截断、拒绝语、tier1 工程词泄漏）只重写受影响章节，最多 2 次；仍失败就报告证据让用户定夺。
@@ -126,15 +132,14 @@ advisory 只提示可疑处，先看脚本给出的例外；故事内系统/界
 ### Agent 调用：consistency-checker
-质量检查阶段，如果项目已部署 consistency-checker agent（优先检查 `.claude/agents/consistency-checker.md` 是否存在；不存在时再检查 `.opencode/agents/`，再不存在时检查 `.codex/agents/`），spawn `Agent(subagent_type: "consistency-checker", prompt: "项目目录：{dir}\n检查范围：{本次写作的章节}\n检查类型：事实冲突+伏笔断线+角色属性不一致")` 执行一致性检查，获取 S1-S4 分级报告。如 agent 不可用，由主线程参照 quality-checklist.md 直接检查。
+质量检查阶段，consistency-checker 已部署时，仅按当前运行时的 canonical agent 目录检查并 spawn，获取 S1-S4 报告。Prompt：`项目目录：{dir}\n检查范围：{本次写作的章节}\n检查类型：事实冲突+伏笔断线+角色属性不一致`。不可用则主线程参照 long-chapter-quality.md 直接检查。
 ### Agent 调用：narrative-writer（去AI味审查）
-质量检查阶段，如果项目已部署 narrative-writer agent（优先检查 `.claude/agents/` 下的 `narrative-writer.md` 是否存在；不存在时再检查 `.opencode/agents/`，再不存在时检查 `.codex/agents/`），可 spawn `Agent(subagent_type: "narrative-writer", prompt: "项目目录：{dir}\n任务描述：审查+去AI味\n检查范围：{本次写作的章节}\n删除优先：每条 AI 味项先判能否删除——删后不丢伏笔/钩子/角色/情节/必要信息的直接删，会丢才润色（删除受比例上限与字数下限约束，跌破下限改降AI重写）\n检查项按你自己的 7 Gate、禁止事项与写完后对话自检全量执行，其中否定翻转句式和台词里的工整否定清单不因脚本豁免台词而跳过")` 执行文字质量审查和去AI味检查。如 agent 不可用，由主线程直接执行，检查项对照 `references/anti-ai-writing.md` 与 `references/banned-words.md`。
+质量检查阶段，narrative-writer 已部署时可 spawn 文字质量与去AI味检查。Prompt：`项目目录：{dir}\n任务描述：审查+去AI味\n检查范围：{本次写作的章节}\n作者偏好：{本章 query 命中的 prose_style/story_design 项}\n删除优先：每条 AI 味项先判能否删除——删后不丢伏笔/钩子/角色/情节/必要信息的直接删，会丢才润色（删除受比例上限与字数下限约束，跌破下限改降AI重写）\n检查项按你自己的 7 Gate、禁止事项与写完后对话自检全量执行，其中否定翻转句式和台词里的工整否定清单不因脚本豁免台词而跳过`。不可用则主线程按 `references/anti-ai-writing.md` 与 `references/banned-words.md` 执行。
 检查后若正文修订改变了连续性事实，必须构造 `mode=revision` 的同章追踪事务并执行 `scripts/tracking_commit.py commit`：
 - 伏笔变化用 `foreshadow_changes` 更新同一 ID 的当前行，不追加重复历史；
 - 时间线变化写入 `timeline_events`，由 `_tracking-state.json` 统一派生 `作者真相.md` 与 `读者已知.md`，不得把作者秘密泄露到读者视图；
 - 核心角色状态变化同时提交该角色截至当前章的完整快照；
-- 事务失败后保留原事务 JSON，修正写入环境并重跑同一 `commit`；成功后执行 `check`，确认 state 与全部派生视图一致再继续写作。
+- 事务失败后保留原事务 JSON，修正写入环境并重跑同一 `commit`；成功后执行 `check`，确认 state 与全部派生视图一致，删除该临时事务 JSON 后再继续写作。