@oh-story/dsh 0.1.4 → 0.1.6

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

@@ -2,17 +2,30 @@
 name: story-long-write
 version: 1.0.0
 description: "长篇网文写作。从大纲到正文，辅助长篇网络小说的创作，包括世界观、人物、情节线管理。触发方式：/story-long-write、/写长篇、「帮我开书」「写大纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。"
-metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claudecode"}}
+metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
 ---
 # story-long-write：长篇网文写作
 
 你是网络小说创作教练。你的任务是帮用户从零开始写一本长篇网络小说，从选题确认到大纲搭建再到正文输出。
 
+## 章节 Reference Gate（强制，先读后写）
+
+任何创建或修改长篇故事文件的动作前，先判断场景并完成本轮门禁。**只读本 SKILL.md 不算完成；`rg` 检索或局部摘读也不算完整读取。**
+
+必须分块读到 EOF：
+
+1. 开书/补纲先完整读取 `references/workflow-setup.md`；写指定章读取 `references/workflow-chapter.md`；日更/大修先读取 `references/workflow-daily.md` 或 `references/workflow-revision.md`，进入正文前再完整读取 `workflow-chapter.md`。
+2. 主会话直接写正文时，首次落笔前完整读取 `references/long-format.md`、`references/writing-craft.md`、`references/long-chapter-quality.md`、`references/long-chapter-hooks.md`；交给 narrative-writer 时，由该 agent 按自己的 reference 表完成同等写前读取，主会话不得用未读 reference 的临时 prompt 替代。
+3. 悬疑、惊悚、异常线索章加读 `references/long-suspense.md`；身份/认知/立场反转章加读 `references/long-reversal.md`。
+4. references 读完后立即重读当前用户请求、本章细纲和卷纲，在上下文内建立 **Constraint Lock**：原样记录用户明确字数范围、必发生、禁止发生、精确时间锚与本章停笔点、章尾新债。references 只提供技法，不得覆盖这些项目事实；用户明确范围优先于自动 ± 比例带。交付前逐项复核：字数带外按 `workflow-chapter.md` 的收口流程交用户处置，不自动补字；其余项越界不算完成。
+
+任一必需路径不存在、不可读或未读完时立即停止，报告准确路径，**不得先写正文再补读**。门禁按当前任务、当前会话重新执行；旧会话的“读过”不能沿用。
+
 ---
 
-> 运行环境兼容性：Claude Code / OpenCode / Codex / ZCode / OpenClaw 是内置适配目标；NarraFork、Web AI、自定义 Agent 等能读取项目文件的环境，可按本 skill 执行长篇流程。检查专业 agent 时按 `.claude/agents/{agent}.md` → `.opencode/agents/{agent}.md` → `.codex/agents/{agent}.toml` 查找；找不到、Codex 返回 `unknown agent_type`，或检测到 `.zcode/`（ZCode 3.3.4 不执行项目 custom agents）时，直接 solo/direct 执行并报告 fallback。
+> 内置适配 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: 25` 不一致时（标记缺失、字段缺失/非整数、小于或大于 25）**照常按文件存在性检查并 spawn**，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 25）` 并提示重新运行 `/story-setup` 后新开会话；大于 25 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
+> 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`。
 
 ## 核心方法
 
@@ -21,18 +34,19 @@ metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claud
 1. **先定情绪，再定故事**。每个场景都必须服务于一个明确的情绪目标。说不清交付什么情绪的场景不该存在。
 2. **从验证过的模式出发**。先问"什么被验证过有效，我如何重新交付"，少从"我想写什么"直接起步。扫榜找方向，拆文找模块，对标找节奏。
 3. **用模块组装，不要重新发明**。每个题材都有验证过的剧情模式——反转怎么铺、爽点怎么爆、感情怎么拉扯。找到对的模块，把对标书的具体角色看成功能位（对手/盟友/催化剂），再映射到你的角色。用你自己的素材填充这些功能位。
-4. **只加载必需信息**。写每章时只加载"不知道就会写错"的信息。涉及角色的状态、待回收的伏笔、相关设定。其余留在文件系统里。
+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)，不混入追踪。
 
 | 题材 | 核心情绪 | 重点参考 |
 |------|---------|---------|
-| 打脸/逆袭 | 爽感释放 | genre-writing-formulas.md |
-| 身份反转 | 震撼+痛快 | reversal-toolkit.md |
+| 打脸/逆袭 | 爽感释放 | plot-emotion-system.md + style-combat-face.md |
+| 身份反转 | 震撼+痛快 | long-reversal.md |
 | 感情拉扯 | 意难平 | emotional-methods.md |
-| 悬疑/惊悚 | 紧张+好奇 | hooks-suspense.md |
-| 日常装逼 | 期待感 | hooks-chapter.md |
+| 悬疑/惊悚 | 紧张+好奇 | long-suspense.md |
+| 日常装逼 | 期待感 | long-chapter-hooks.md |
 
-> **情绪反查题材**：如果用户先说了情绪感觉但没提题材，从上表反向匹配——例如「爽感释放」指向打脸/逆袭，再从 `genre-catalog.md` 找该题材下的细分方向。
+> **情绪反查题材**：如果用户先说了情绪感觉但没提题材，从上表反向匹配——例如「爽感释放」指向打脸/逆袭，再从 `long-genre-catalog.md` 找该题材下的细分方向。
 
 ---
 
@@ -243,7 +257,7 @@ metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claud
 
 | 场景 | 加载文件 |
 |------|---------|
-| 确定题材类型 | `references/genre-catalog.md` |
+| 确定题材类型 | `references/long-genre-catalog.md` |
 | 判断市场方向 | `references/genre-readers.md` |
 | 特殊题材考量 | `references/plot-special-topics.md` |
 | 女频长篇（题材/文案/平台/感情线） | `references/female-audience-writing.md` |
@@ -254,7 +268,7 @@ metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claud
 |------|---------|
 | 设定人物 | `references/character-basics.md` |
 | 设计关系 | `references/character-relations.md` |
-| 题材框架与定位 | `references/genre-catalog.md` + `references/genre-core-mechanics.md` |
+| 题材框架与定位 | `references/long-genre-catalog.md` + `references/long-genre-mechanics.md` |
 | 创建 artifact | `references/artifact-protocols.md` |
 | 读者契约与主角高光 | `references/reader-contract-and-progression.md` |
 
@@ -268,19 +282,19 @@ metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claud
 | 节奏与升级感 | `references/outline-rhythm.md` |
 | 小纲与卡文 | `references/plot-core-methods.md` |
 | 选择叙事框架 | `references/plot-frameworks.md` |
-| 题材写作公式 | `references/genre-writing-formulas.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/reversal-toolkit.md` |
+| 反转设计 | `references/long-reversal.md` |
+| 细纲结构验收 | `scripts/check-outline-contract.js`（新建/补建后跑，只判字段与表结构） |
 
 ### Phase 4：正文写作
 
 | 场景 | 加载文件 |
 |------|---------|
-| 章节钩子 | `references/hooks-chapter.md` |
-| 悬念设计 | `references/hooks-suspense.md` |
-| 段落级钩子 | `references/hooks-paragraph.md` |
+| 章节钩子 | `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` |
@@ -289,7 +303,7 @@ metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claud
 | 人物深化 | `references/character-design-methods.md` |
 | 情绪技法 + 叙事单元 | `references/plot-emotion-system.md` + `references/emotional-methods.md` |
 | 写作技法全程参考 | `references/writing-craft.md` |
-| 格式与结构规范 | `references/format-and-structure.md`（仅对话/段落格式适用长篇） |
+| 格式 | `references/long-format.md`（章节、段落、对话、标点与工程元信息） |
 | 状态追踪协议 | `references/state-tracking.md` |
 | 当前剧情单元与契约校准 | `references/reader-contract-and-progression.md` |
 
@@ -297,7 +311,7 @@ metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claud
 
 | 场景 | 加载文件 |
 |------|---------|
-| 质量检查 | `references/quality-checklist.md` + `references/reader-contract-and-progression.md` |
+| 质量检查 | `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` |
@@ -308,16 +322,16 @@ metadata: {"openclaw":{"source":"https://github.com/worldwonderer/oh-story-claud
 
 | 主题 | 权威文件（先读） | 配套文件（按角度补充） |
 |------|-----------------|----------------------|
-| 爽点（按意图分流） | **`references/plot-emotion-system.md`**（爽点设计体系：本质/六种类型/倒推法——"怎么设计爽点"先读这个） | 翻盘/高潮式爽点→`references/plot-core-methods.md`（假胜→崩解）· 打脸/装逼释放→`references/style-combat-face.md`· 题材打脸逆袭公式→`references/genre-writing-formulas.md`· 爽文循环/多层→`references/outline-methods.md`·`references/outline-conflict.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/reversal-toolkit.md`**（反转类型/铺垫/有效性自检） | `references/plot-core-methods.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/quality-checklist.md`（成稿检查） |
+| 去AI味 | **`references/anti-ai-writing.md`**（AI指纹/核心规则/Show Don't Tell） | `references/banned-words.md`（禁用词扫描）· `references/long-chapter-quality.md`（成稿检查） |
 
 ---
 

package/lib/oh-story/skills/story-long-write/references/anti-ai-writing.md

@@ -282,6 +282,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 | 升华式收尾 | 结尾对仗拔高、金句点题 -> 用一个动作或一句留白收住，把"意思"压进画面里 |
 | 抽象命运/开端收束 | 「命运终于露出獠牙」「早已布好的棋局」「这一刻终于明白」「属于他的反击才刚刚开始」-> 改成角色当下可见的文件、动作、对话或物理后果；`check-ai-patterns.js` 报 `abstract-summary-tic` 时优先处理 |
 | 套词密度过高 | 仿佛/一丝/一抹/深吸一口气/平静无波/指节泛白等成串复现（`cliche-density-tic`）-> 不是同义词轮换，整段回到角色当下证据：文件、动作、对话、物理后果 |
+| 套式反应细节 | 指尖轻叩、袖口里攥紧、指节泛白、目光移开、“语气平静得像在念……”等反应成片（`stock-reaction-tic`）-> 逐处做删除测试；只标注情绪而不改变选择、关系、物件或动作结果的删掉，不换部位和同义动作；有伤势、动作失败或情节后果的身体细节可留 |
 | 比喻密度过高 | 像/好像/仿佛/如同等比喻标记成片复现（`metaphor-density-tic`）-> 保留最能传递信息或情绪的一两个，其余改回具体动作、物件、声音、后果；不要换成新比喻 |
 | 系统公告公文腔过密 | 方括号规则/面板/公告行里硬规则词成片（`system-notice-formality-tic`）-> 保留为角色看见的屏幕/公告/规则载体；只在载体内部白话化部分硬词，或补角色当场看懂的具体后果，不改成叙述者解释 |
 
@@ -575,7 +576,7 @@ AI 喜欢把事情凑成三个以显"完整"。-> 砍到只剩最有力的一条
 - [ ] **标点不压平**：没有把质问、爆发、犹豫全部压成句号；也没有随机堆砌 `？`/`！`，或用 `……`/`——` 硬造停顿
 - [ ] **Show Don't Tell**：用行为代替形容词，用细节代替总结
 - [ ] **句长达标**：叙述默认是逗号长句（逗号之间 8-12 字、整句 20-30 字，规则 3）；短句只作偶尔的孤立重拍，用完回到逗号长句；没有连着的 ≤5 字碎片，没有通篇短句像提纲
-- [ ] **detector advisory 逐条复核**：`micro-action-tic` / `abstract-summary-tic` / `cliche-density-tic` / `metaphor-density-tic` / `reasoning-chain-tic` / `system-notice-formality-tic` / `overcompressed-prose-tic` / `low-connective-density-tic` / `action-list-tic` 命中时按脚本给出的修法处理：先通读判断是不是机械复现，确属再改；功能性写法保留或标 `[需复核]`，不做同义词轮换、不机械注水
+- [ ] **detector advisory 逐条复核**：`micro-action-tic` / `stock-reaction-tic` / `abstract-summary-tic` / `cliche-density-tic` / `metaphor-density-tic` / `reasoning-chain-tic` / `system-notice-formality-tic` / `overcompressed-prose-tic` / `low-connective-density-tic` / `action-list-tic` 命中时按脚本给出的修法处理：先通读判断是不是机械复现，确属再改；功能性写法保留或标 `[需复核]`，不做同义词轮换、不机械注水
 - [ ] **不做硬指标投机**：不为反检测强制每句换行、50-60 字一行、对话 50%-60%、英文点省略号，或把 `地/得` 全改成 `的`
 - [ ] **任务卡点服从原文边界**：抽象总结若改成角色办事被卡住，必须来自原文已有任务/证据/手续/物件缺口；不新增原文没有的事件链
 - [ ] **去AI三遍法执行**：轻度只做Pass1，中度做Pass1+2，重度完整三遍

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

@@ -154,7 +154,7 @@
 - 关键转折节点：{列出}
 ```
 
-创建参考：`genre-core-mechanics.md` (核心梗解析与运用 + 微创新与差异化设计)
+创建参考：`long-genre-mechanics.md` (核心梗解析与运用 + 微创新与差异化设计)
 
 ---
 
@@ -259,13 +259,17 @@
 |------|---------|---------|---------------------|
 ```
 
-创建参考：`outline-methods.md` (大纲三层结构法) + `outline-rhythm.md` (升级感三步设计法) + `emotional-arc-design.md` (六种弧线速查) + `reversal-toolkit.md` (五种反转类型)
+创建参考：`outline-methods.md` (大纲三层结构法) + `outline-rhythm.md` (升级感三步设计法) + `emotional-arc-design.md` (六种弧线速查) + `long-reversal.md` (反转类型与长线层级)
 
 ---
 
 ## 大纲/细纲_第XXX章.md
 
-细纲是正文写作的章节蓝图，而不是只列事件和钩子的清单。**模板唯一权威副本**见 [Phase 3：大纲搭建](workflow-setup.md#phase-3大纲搭建) 的「细纲（全书每章）」模板（含单元ID/位置、主角目标/关键选择、任务卡点、结构公式、契约风险行、五列情节点表格（含密/铺/疏与目标字数区间）与「目标字数合计」行）；本文件不再保留模板副本，避免双模板漂移。新建、补建、回填都按权威模板补齐，未知字段写 `[待补充]`，不要为了补齐字段杜撰副线或人物关系。契约/推进字段只加在章纲摘要层，长规则统一参 `reader-contract-and-progression.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 不可用时如实报告验收未完成，不得声称细纲已合规。本检查只在新建/补建/回填时执行；既有项目的旧细纲不因此阻断写正文。
 
 ---
 

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

@@ -0,0 +1,163 @@
+# 作者记忆协议
+
+作者记忆用于保存跨会话复用的创作偏好，不保存小说世界里的事实。它借鉴“原始证据 → 候选 → 已确认画像 → 变更记录”的记忆管道，但把决定权留给作者。
+
+## 边界与优先级
+
+加载优先级从高到低：
+
+1. 安全、平台、字数、文件协议等硬性门禁；
+2. 用户在当前请求中的明确要求；
+3. 当前书的 `设定/文风.md`、题材定位、细纲和其他项目设定；
+4. 作者记忆中的本书偏好；
+5. 作者记忆中的题材、流程和全局偏好；
+6. 对标素材、通用方法和默认值。
+
+作者记忆不能把本书事实写进 `.story/作者记忆/`，不能覆盖当前请求，不能降低审稿 rubric，也不能让去 AI 味改动剧情意图。小说事实继续由各书的 `追踪/` 和 `设定/` 管理。
+
+## 文件与所有权
+
+工作区级目录：
+
+```text
+{工作区}/.story/作者记忆/
+├── _author-memory-state.json  # 唯一结构化权威
+├── 作者画像.md               # 仅 active，供作者查看与管理
+├── 待确认.md                 # pending / conflict，不参与约束
+└── 变更记录.md               # 最近 100 次、最新在前的事务记录
+```
+
+三个 Markdown 文件都从 state 确定性生成，禁止手改；完整历史保留在 state，变更记录只展示最近 100 次。`作者画像.md` 是人类管理视图，普通写作 agent 不整份注入，而是调用 `query` 取得本次相关的紧凑上下文。作者记忆不存在时，普通写作、审稿和去味任务直接继续，不自动初始化空目录；首次 `record` 会随事务创建。
+
+工作区必须显式传给脚本。优先使用已经包含 `.story/作者记忆/` 的最近祖先；首次初始化时使用承载多本书、`.active-book`、`长篇/`、`短篇/` 或 `拆文库/` 的创作工作区根。不要把用户主目录当默认工作区。
+
+## 什么时候读取
+
+长篇、短篇、去 AI 味开始前，如果 state 已存在，用 `query` 按本书、题材、流程和类型筛选 active 条目。查询输出固定不超过 2048 字节。不要先查询全部再让 agent 自行筛选，按任务直接选择 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 决定。
+
+待确认项不进入 prompt 约束，也不应为了确认它们中断当前任务。只有用户主动查看作者画像、候选积累到适合回顾的节点，或新偏好与 active 条目冲突时，才集中呈现。
+
+## 可靠性与负荷边界
+
+- 明确“记住 / 确认 / 替换 / 忘掉”的请求走单事件 `record`，不要求 agent 手工读取修订号或拼多操作事务。成功响应会给出 `Author Memory Receipt: rN · APxxx`；没有回执就不得声称“已经记住”。
+- 普通创作只做一次本地 `query`，没有 state 时返回空结果且不创建文件；有记忆时也只返回相关 active 条目，硬上限 2048 字节。完整画像、证据、候选和 journal 不进入正文 prompt。
+- 查询项是低优先级倾向，不是逐条打卡清单。自然吸收即可，不复述画像、不刻意提高词面命中率，也不得为命中偏好牺牲正文连贯、节奏、字数或本书既定笔调。
+- 不安装会记录全部用户消息的 prompt hook。自然语言是否属于长期习惯仍需 agent 判断；这样不能承诺隐式偏好 100% 捕获，但避免把一次性要求、私人对话和小说事实静默写入长期记忆。需要确定写入时，用户可明确说“记住：……”，并以回执验收。
+
+## 捕获判定
+
+| 输入证据 | 处理 |
+|---|---|
+| “以后都这样”“我一直习惯……”等直接、稳定、范围清楚的原话 | `active`，`source=explicit_user` |
+| 用户明确接受助手提出的长期做法 | `active`，`source=accepted_suggestion` |
+| 同类修改反复出现，但用户没说这是长期规则 | `pending`，`source=repeated_correction` |
+| 从成稿或操作轨迹推断出的模式 | `pending`，`source=inferred_pattern` |
+| “这一章别……”“这次给我……”等一次性要求 | 只执行，不记录 |
+| 角色、时间线、伏笔、世界观、当前剧情走向 | 写项目设定/追踪，不写作者记忆 |
+| 助手自己生成的文字、默认模板、工具告警、rubric 结论 | 不自我学习 |
+
+保留用户的否定词、限定词和适用范围，`quote` 写原话，`assertion` 只做不改变语义的紧凑归纳。范围规则：
+
+- “本书 / 这个角色 / 这次连载” → `book`；
+- “都市文 / 这类题材” → `genre`；
+- 交稿、检查、确认节奏等操作习惯 → `workflow`；
+- “以后 / 一贯 / 我习惯”且无更窄限定 → `global`；
+- 范围含糊但可能稳定 → 取当前最窄合理范围并置 `pending`。
+
+类型可选：`prose_style`、`story_design`、`workflow`、`delivery`、`interaction`。置信度与重要度均为 `low | medium | high`。
+
+## 冲突、撤回与强化
+
+- 同一类型、范围、归纳文本再次出现时，脚本强化原条目，累加证据和确认次数，不重复建条目。
+- 新偏好与 active 条目矛盾时，先以 `conflict` 记候选，并在 `conflicts_with` 列出冲突 ID；当前任务仍按本轮明确要求执行。
+- 作者选定新规则时用 `replace`，一次性启用新条目并把旧条目标成 `superseded`。
+- pending 可以用 `decide=activate|reject`；冲突候选不能绕过旧规则直接 activate。
+- 作者说“忘掉 / 这不再是我的习惯”时用 `forget`，保留历史证据但不再加载。
+- active 条目的语义不可原地偷改；语义变化必须 replace，历史才可审计。
+
+## 运行工具
+
+先依次尝试 `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 {工作区}
+```
+
+- `record`：常用单事件入口，自动读取当前修订、首次自动初始化；`event_id` 相同且内容相同会幂等返回原回执，内容不同会失败。
+- `query`：只读相关 active 条目；`--kind` 可重复，不存在 state 时返回空结果且零写入。返回的 `omitted > 0` 时收窄 kind / book / genre / workflow 后重查，不得改读完整画像规避预算。
+- `commit`：高级批量入口；先在内存完成 schema、引用、容量和所有视图校验，最后原子替换 state。事务文件在成功前必须保留；过期修订会在任何写入前失败。
+- `check`：从 state 重建并逐字核验所有派生视图。
+
+## 事务格式
+
+常用单事件新增或强化：
+
+```json
+{
+  "schema_version": 1,
+  "event_id": "conversation-2026-08-25-message-42",
+  "operation": {
+    "action": "remember",
+    "preference": {
+      "kind": "prose_style",
+      "scope": {"level": "global", "value": null},
+      "assertion": "对话尽量短，用动作承接情绪，不用大段解释",
+        "quote": "以后对话都短一点，情绪放动作里，别让角色长篇解释。",
+        "source_ref": "conversation:2026-08-25",
+        "source": "explicit_user",
+        "confidence": "high",
+        "importance": "high",
+      "status": "active",
+      "reason": "用户以“以后”明确声明长期偏好",
+      "conflicts_with": []
+    }
+  }
+}
+```
+
+把文件交给 `record`。待确认项的 `status` 用 `pending`；冲突候选用 `conflict` 并填写 active ID。确认或拒绝候选时，把下列对象作为新事件的 `operation`：
+
+```json
+{"action":"decide","item_id":"AP002","decision":"activate","quote":"对，这就是我的长期习惯。","reason":"作者明确确认"}
+```
+
+用新规则替代一个或多个旧条目时，`replace.preference` 与上例字段相同，但不传 `status`、`conflicts_with`，新条目直接 active；下列对象同样作为 `operation`：
+
+```json
+{
+  "action": "replace",
+  "old_ids": ["AP001", "AP002"],
+  "preference": {
+    "kind": "prose_style",
+    "scope": {"level": "book", "value": "雾港来信"},
+    "assertion": "本书对话允许更长的试探，但避免解释设定",
+    "quote": "这本书可以让对话慢一点，多试探，但还是别拿台词讲设定。",
+    "source_ref": "conversation:2026-08-25",
+    "source": "explicit_user",
+    "confidence": "high",
+    "importance": "high",
+    "reason": "作者明确用本书新规则替代旧候选"
+  }
+}
+```
+
+撤回条目的 `operation`：
+
+```json
+{"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

@@ -14,8 +14,8 @@
 | ★★★★ | 无情绪声线："声音不大，却带着……" / "语气毫无波澜" / "平静无波" / "声音平直/平平/听不出情绪" | "她声音不大，却带着不容置疑的力量" | 直接写台词内容、声音特征或动作 |
 | ★★★★ | "他/她知道……" | "他知道这一切都来不及了" | 用行为展示认知 |
 | ★★★ | "仿佛/犹如/宛若……一般" | "仿佛能穿透一切一般" | 删掉或白描 |
-| ★★★ | "眼中闪过一丝……" / "嘴角勾起一抹……" | "眼中闪过一丝悲伤" | 他垂下眼 / 他嘴角一扯 |
-| ★★★ | "心中涌起一股……" / "心头一震" | "心中涌起一股暖流" | 用身体反应 |
+| ★★★ | "眼中闪过一丝……" / "嘴角勾起一抹……" | "眼中闪过一丝悲伤" | 删掉；写他当场说的话或做出的决定 |
+| ★★★ | "心中涌起一股……" / "心头一震" | "心中涌起一股暖流" | 写它改变了什么：选择、台词、物件或后果 |
 | ★★★ | 抽象命运/开端收束："命运……棋局/獠牙" / "这一刻终于明白" / "反击才刚刚开始" | "命运终于露出獠牙；属于他的反击才刚刚开始" | 回到角色当下可见的文件、动作、对话或物理后果 |
 | ★★ | 章末预告 "他不知道的是……" | "他不知道的是，更大的风暴即将来临" | 用具体钩子物件/事件收束，避免空泛预告 |
 
@@ -132,8 +132,8 @@
 
 | 原文类型 | 替换方法 | 示例 |
 |----------|----------|------|
-| 抽象情绪词 | 具体动作 | "紧张" → "手在抖" |
-| "感到XX" | 外化表现 | "感到愤怒" → "攥紧拳头" |
+| 抽象情绪词 | 先看上下文是否已成立；再选选择、台词、物件、后果或一句直写 | “紧张”若不影响下一步可直写或删；若导致签名作废，就写作废的结果 |
+| "感到XX" | 删除“感到”后按场景决定是否还要情绪句 | “他感到愤怒”可写“他火了”，也可直接写他撤回报价；不要默认换成攥拳 |
 | 形容词堆砌 | 白描手法 | "美丽动人的笑容" → "她笑了" |
 | 书面表达 | 口语化 | "不容置疑" → "就是" |
 | 解释性描写 | 留白 | "他因为害怕而..." → "他退后一步" |
@@ -145,3 +145,5 @@
 **替换不复用**：右列是方向示例，不是标准答案。同一禁用词在一章内多次命中时，各处给不同的具体化写法；同一个替换写法反复出现（每次都「垂下眼」、每个动作都补「了一下」），替换产物本身就成为新的模板指纹。
 
 **套词密度优先处理**：`check-ai-patterns.js` 报 `cliche-density-tic` 时，说明禁用词不是零星误用，而是聚成了模板腔。处理顺序不是同义词替换，而是先删抽象总结，再把情绪/判断落到角色当下可见的动作、物件、对话和具体后果。
+
+**套式反应逐处删除测试**：`stock-reaction-tic` 报警时，不代表禁止身体描写。逐处问：删掉后信息、选择、关系、物件或动作结果是否受损？无损就删，不把“指尖轻叩”换成“目光微沉”。伤势、动作失败、人物习惯或情节后果明确时可以保留。

package/lib/oh-story/skills/story-long-write/references/cross-book-recall.md

@@ -54,9 +54,9 @@ description: 多对标跨书召回
 
 | 拆文字段 | 含义 | 写作参考 |
 |---------|------|---------|
-| `beats` | 结构段（开端/发展/高潮/结局） | 当前 skill 的题材结构文件；短篇优先 genre-styles 题材包 / `genre-writing-formulas.md` |
-| `hooks` | 钩子数 | `hooks-chapter.md` / `hooks-suspense.md`；短篇开头密度补 short-craft |
-| `setup_clues` | 反转铺垫线索 | `reversal-toolkit.md` |
-| `character_archetypes` | 反差人物 | 当前 skill 的人物/题材风格文件；短篇优先 genre-styles 题材包 / genre-writing-techniques |
-| `reusable_structures` | 可复用手法 | `genre-writing-formulas.md`；短篇可补 short-craft |
-| `reversal_type` | 反转类型（7 枚举） | `reversal-toolkit.md` 对应骨架 |
+| `beats` | 结构段（开端/发展/高潮/结局） | `outline-methods.md` + 当前 `genre-prose-cards/` 题材卡 |
+| `hooks` | 钩子数 | `long-chapter-hooks.md` / `long-suspense.md` |
+| `setup_clues` | 反转铺垫线索 | `long-reversal.md` |
+| `character_archetypes` | 反差人物 | `character-basics.md` / `character-design-methods.md` + 当前题材卡 |
+| `reusable_structures` | 可复用手法 | `outline-methods.md` / `plot-core-methods.md`，按结构功能选择 |
+| `reversal_type` | 反转类型（7 枚举） | `long-reversal.md` 对应骨架 |

package/lib/oh-story/skills/story-long-write/references/genre-prose-cards.md

@@ -8,7 +8,7 @@
 
 正文写作采用三件套：**通用正文要求 + 单题材正文提示卡 + 本书文风**。
 
-- 通用正文要求只维护一份：严格消费细纲，按情节点预算写，缓慢推进，严禁提前写后续剧情，写完做字数、钩子、禁用词、退化校验。
+- 通用正文要求只维护一份：严格消费细纲，按情节点义务写，缓慢推进，严禁提前写后续剧情，写完做确定性字数、钩子、禁用词、退化校验。
 - 题材卡只管题材层稳定核心：世界观/生活逻辑、读者期待、核心爽点/情绪、常见场面、常见钩子和禁止漂移。
 - 本书文风只管句长、标点、潜台词、锚点片段和笔调；它不覆盖题材卡，也不覆盖 `剧情/情绪模块.md` / `剧情/节奏.md`。
 - 三者冲突时：章节细纲与连续性 > 情绪/节奏权威召回 > 题材卡 > 本书文风 > 通用技巧。

package/lib/oh-story/skills/story-long-write/references/genre-readers.md

@@ -2,7 +2,7 @@
 
 > **用途**：读者心理需求、题材生命力规律、跨网站适配、平台差异、书名/简介技法、代入感管理。选题和定位时对照使用。
 > **语气**：指令式——每个规律都要转化为选题、定位、书名、文案或开篇的可执行约束。
-> **配合**：题材结构骨架见 genre-writing-formulas.md，核心梗设计见 genre-core-mechanics.md。
+> **配合**：长篇题材结构见 `long-genre-catalog.md`，声线见 `genre-prose-cards.md`，核心梗设计见 `long-genre-mechanics.md`。
 
 ---
 

package/lib/oh-story/skills/{story-setup/references/agent-references/hooks-chapter.md → story-long-write/references/long-chapter-hooks.md}

@@ -1,6 +1,6 @@
-# 章级钩子：章首/章尾钩子选择与写作
+# 长篇章级钩子：章首/章尾选择与跨章期待
 
-> 写每章开头或结尾时加载。先看决策路由，选对钩子类型，再套模板。
+> 写长篇章首或章尾时加载。先按章节功能和跨章期待选类型，再决定落点与篇幅。
 
 ---
 
@@ -210,7 +210,7 @@
 - 前置小无敌：打脸前必须把道具/人物/实力准备好，没有则读者担惊受怕，嘲讽变虐主
 - 铺垫比打脸重要：铺垫到位后主角站着不说话都能装逼
 - 打脸对象层级决定爽感层级：路人甲震惊不叫爽，有分量的人震惊才叫爽
-- 章末钩子约 100 字即可显著提升完读率
+- 章末钩子只写到期待成立为止；篇幅服从信息复杂度，不设固定百字配额
 
 ---
 
@@ -218,8 +218,8 @@
 
 写完章首/章尾后对照：
 
-- [ ] 章首前 100 字有钩子（不是风景/天气开头）
+- [ ] 章首尽早出现可识别的行动、异常或未闭合期待；不按固定百字位置机械卡点
 - [ ] 章尾有让读者想翻下一页的东西
 - [ ] 钩子强度与章节阶段匹配（日常章不必强钩子）
 - [ ] 连续两章不用同一种钩子
-- [ ] 钩子约 100 字，点到即止，不拖沓
+- [ ] 钩子没有为凑长度重复解释，落点与本章功能、下一章承接一致

package/lib/oh-story/skills/story-long-write/references/{quality-checklist.md → long-chapter-quality.md}

@@ -1,5 +1,5 @@
 
-# 网文质量检查清单
+# 长篇章节质量检查清单
 
 ## 目录
 
@@ -56,6 +56,7 @@
 - [ ] 没有突然塞入大量新设定
 - [ ] 伏笔有推进
 - [ ] 故事引擎还在运转
+- [ ] 对照本章批准细纲，没有新增会影响后续的独立事件、人物决定、关系变化、揭示或支线；闲话、即时反应和服务既有情节点的微连接不算，新的饭局、承诺、选择、结果或后续义务属于 blocking
 
 ### 水（filler）检测
 以下信号出现 = 可能水了：

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

@@ -0,0 +1,42 @@
+# 长篇正文格式
+
+> 只约束长篇章节的段落、对话、标点与工程元信息。短篇 `###1.` 小节、8–15 节全文结构和 500–800 字/节口径不适用。
+
+## 章节与段落
+
+- 章节标题、编号和文件名服从项目既有格式；正文内部不再重复章节号。
+- 按戏剧单元、镜头变化、新行动、新信息或新对话自然断段，不按固定字数切段。
+- 短段是节奏工具，不是默认模板；完整推理、氛围和情绪因果可以使用长段。
+- 爽点、转折和关键选择写密，过场、赶路与已知信息连接写疏；不要让每个 beat 一样长。
+- 段首需要时点名角色，段中使用代词、省略或动作承接；不要每句机械重复角色名。
+- 正文相邻段落之间只允许一个换行符 `\n`，不得出现空行或连续换行 `\n\n`。
+- 正文不缩进，不使用 `　　`（全角空格）或半角空格开头。
+
+## 对话
+
+- 引号风格服从项目/平台约定，全章统一；未指定时使用半角双引号。
+- 对话独立成行，动作承接放在同一角色的话前后，不把每句都标成“他说/她道”。
+- 问号用于真实疑问、质问或反问；感叹号只留给爆发峰值，不连用。
+- 停顿、犹豫、吞咽、打断或拖长用动作、短句、换行或未完成句承担；正文和对话不使用省略号、破折号作万能停顿。
+- 台词必须改变信息、关系、策略或权力位置；整段设定讲解改成问答、试探、反驳或行动后果。
+
+## 长篇章级约束
+
+- 章级 `字数目标` 与 `visible_chars_v1` 是唯一字数口径；内部带 ±12%，用户带 ±15%，以确定性工具测量。
+- 字数不足先检查细纲中批准的情节点是否全部落地，不新增独立事件、角色、规则、反转或伏笔凑字。
+- 字数超标优先删除重复解释、重复反应、流程和无功能微动作，不删除批准情节点、因果、选择、兑现与钩子。
+- 章节可以包含多个场景或 beat，数量由细纲和因果决定；不套短篇全文小节数。
+
+## 工程元信息隔离
+
+- 标题行以外，正文叙述、对话和心理描写不得出现“本章、上一章、前文、后文、伏笔、细纲、读者”等写作工程词。
+- 需要承接时改成角色可感知的事件锚点或相对时间；角色在故事世界内真实讨论章节/读者身份时例外。
+- 正文不使用加粗、斜体、分隔线或检查报告；合法章节标题除外。
+
+## 交付检查
+
+- [ ] 段落按镜头与行动变化断开，不是固定句数模板，段间没有空行、没有缩进。
+- [ ] 引号、问号、感叹号和停顿方式全章一致。
+- [ ] 长篇字数按章级细纲和确定性口径处理，没有短篇小节阈值。
+- [ ] 正文没有写作工程元信息、自检或说明。
+