@oh-story/dsh 0.1.4 → 0.1.6

package/lib/oh-story/skills/story-review/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-review/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-review/references/{quality-checklist.md → review-quality.md}

@@ -1,5 +1,5 @@
 
-# 网文质量检查清单
+# 审稿质量检查清单
 
 ## 目录
 
@@ -189,38 +189,39 @@
 ```
 
 检查规则：
-- 每 300 字至少 1 个小冲突
-- 虐点间隔不超过全文的 30%
-- 最大爽点必须出现在全文的 70-85% 位置
-- 结尾必须有情绪落点
+- 每个场景或小节应改变风险、信息、关系、资源、决定、行动或读者理解之一，或让上一个选择的后果落地
+- 压力可以来自任务、证据、等待、手艺、空间和关系，不把直接冲突当成固定字数配额
+- 最大爽点放在前因汇合、主角选择和证据足以支撑的位置，并为后果留出篇幅；不按固定百分比挪动
+- 结尾应有情绪落点、局部兑现或明确余波，不强制同一种收法
 
 ### 对话密度检查
 
-| 指标 | 合格标准 | 警戒线 |
-|------|----------|--------|
-| 对话占全文比 | 45-65% | <30%（太干）或>75%（太水） |
-| 每章对话条数 | 12-18条/千字 | <8条（缺交互）或>25条（碎片化） |
-| 伤人性对话占比 | 35-45%（虐文）/ 20-30%（爽文） | 虐文<20%（不够痛）/ 爽文>40%（太压抑） |
+| 检查项 | 通过标准 | 需复核信号 |
+|--------|----------|------------|
+| 对白功能 | 改变信息、策略、权力、关系或下一步行动 | 删掉对白后场景没有任何变化 |
+| 无对白场景 | 由任务、物件、证据、空间、等待或手艺推动 | 只有解释和情绪复述，没有可见动作或新信息 |
+| 对话节奏 | 话轮长度服从人物权力和现场压力 | 连续微型问答、换说法重复、每句都配动作标签 |
+| 对白占比/条数 | 只作同题材、同平台样本的观察数据 | 不设跨题材通过阈值，不为抬高占比补对白 |
 
-### 主角冷静度检查（打脸/复仇文专用）
+### 主角筹码与情绪检查（打脸/复仇文专用）
 
-| 检查项 | 标准 |
-|--------|------|
-| 主角是否有标志性冷静动作？ | 必须有（端水杯/整理西装/转笔等） |
-| 主角是否有情绪失控场面？ | 复仇文最多1次，且必须在前30% |
-| 反派是否比主角更歇斯底里？ | 必须是——反差是爽感来源 |
-| 主角台词是否短于反派？ | 平均短30-50%——越短越有力 |
-| 是否有"审判式对话"？ | 至少2处（主角提问→对方自爆） |
+| 检查项 | 通过标准 |
+|--------|----------|
+| 主角的冷静是否可见？ | 通过取证、选择、延迟回应或资源调度体现；不强配端水杯、整理西装、转笔等标志动作 |
+| 情绪失控是否成立？ | 次数和位置服从累积压力；失控必须改变行动、关系或代价，不按百分比禁用 |
+| 主角与反派的反差来自哪里？ | 来自筹码、判断、行动后果或信息差，不强制反派歇斯底里 |
+| 台词长短是否体现权力？ | 长短、打断、沉默和回避随现场筹码变化，不设固定比例 |
+| 审判式对话是否必要？ | 只在提问能迫使对方选择、暴露矛盾或改变关系时使用，不设最低处数 |
 
 ### 证据链完整性检查（复仇/打脸文专用）
 
 | 检查项 | 标准 |
 |--------|------|
-| 证据是否分章释放？ | 至少分3次揭露，不能一次全给 |
+| 证据是否按判断变化释放？ | 每次释放都应改变行动或读者模型；完整证据链可在同一场景集中落地，不设次数 |
 | 每个证据是否有铺垫？ | 前文必须埋过线索 |
-| 反派是否每次都先得意再被打脸？ | 必须是——先扬后抑 |
+| 反派反应是否有因果？ | 由其筹码、误判和损失决定，不重复“先得意再被打脸”模板 |
 | 最终证据是否最致命？ | 最后一个证据要改变全局认知 |
-| 是否有"定时炸弹"证据？ | 至少1个主角提前布局的证据 |
+| 是否需要"定时炸弹"证据？ | 仅在提前布局符合主角能力、时间线和取证条件时使用 |
 
 ### 毒点/代入感/震惊/开头/结尾/情绪/期待感速查
 

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

@@ -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