@oh-story/dsh 0.1.15 → 0.1.17

package/lib/drama/skills/short-drama-write/assets/episode-card.json

@@ -1,55 +0,0 @@
-{
-  "episode_id": "EP001",
-  "sources": {
-    "episode-map": {
-      "owner": "short-drama-develop",
-      "artifact": "项目开发/episode-map.jsonl"
-    }
-  },
-  "contract_authority": {
-    "mode": "development_projection",
-    "source_ref": {
-      "src": "episode-map",
-      "record_id": "EP001"
-    },
-    "projected_fields": [
-      "/incoming_state",
-      "/hook",
-      "/objective",
-      "/opposition",
-      "/turn",
-      "/local_dramatic_result",
-      "/information_release",
-      "/premise_device_disclosure",
-      "/outgoing_pressure",
-      "/handoff_state",
-      "/setup_ids",
-      "/payoff_ids"
-    ]
-  },
-  "execution_plan": {
-    "viewpoint_and_audience_alignment": "__FILL__",
-    "opening_action_carrier": "__FILL__",
-    "turn_carrier": "__FILL__",
-    "payoff_carrier": "__FILL__",
-    "outgoing_pressure_carrier": "__FILL__",
-    "scene_jobs": [
-      {
-        "scene_id": "SC001",
-        "agenda_collision": "__FILL__",
-        "dramatic_result": "__FILL__",
-        "external_pressure": "__LOW_MEDIUM_HIGH_WITH_REASON__",
-        "emotional_load": "__LOW_MEDIUM_HIGH_WITH_REASON__",
-        "visible_change": "__FILL__",
-        "source_contract_fields": [
-          "/objective",
-          "/opposition"
-        ]
-      }
-    ],
-    "production_requirements": []
-  },
-  "source_refs": [],
-  "open_questions": [],
-  "creator_status": "draft"
-}

package/lib/drama/skills/short-drama-write/assets/voice-record-sheet.jsonl.md

@@ -1,89 +0,0 @@
-# `voice-record-sheet.jsonl` 填写模板
-
-每行一条待录台词。这份表是**剧本的投影，不是第二份台词权威**：`line_text` 必须逐字
-等于 `source_ref` 指向的剧本块，需要改词就改剧本再重新投影，不在这里改。示例值不是
-默认答案；不适用的字段删掉，不要添加媒体任务、供应商或接口。
-
-录音的顺序几乎从不是剧情顺序——通常按人物集中录，所以**配音者失去的正是上下文**。
-本表存在的理由就是把上下文补回去：他此刻知道什么、对谁说、上一句是谁说的、这一句要
-达成什么。缺了这些，剩下的只是一串没有处境的句子。
-
-第一行声明本表引用的上游快照，一个快照只写一次：
-
-```json
-{"record_type": "sources", "schema_version": "1.0.0", "sources": {"screenplay-index": {"owner": "short-drama-write", "artifact": "剧集/EP001/screenplay-index.jsonl"}}}
-```
-
-其后每行一条待录台词，`source_ref` 用 `src` 指向上面声明的快照，加 `record_id` 指向其中的剧本块：
-
-```json
-{
-  "line_id": "VLINE-EP001-SC001-003",
-  "episode_id": "EP001",
-  "scene_id": "EP001-SC001",
-  "speaker": "CHAR-<id>",
-  "speaker_display": "<剧本里逐字写的那个名字>",
-  "line_text": "<逐字等于剧本块原文的冒号之后部分>",
-  "source_ref": {
-    "src": "screenplay-index",
-    "record_id": "BLK-EP001-SC001-D03"
-  },
-  "channel": "sync | dubbed | VO | OS",
-  "lip_sync_constrained": true,
-  "addressed_to": ["CHAR-<id>"],
-  "preceding_line_id": "VLINE-EP001-SC001-002",
-  "speaker_knows_now": "<此刻他知道什么、还不知道什么>",
-  "tactic": "<质问 | 试探 | 收回 | 交换 | 拖延……：这一句要达成什么>",
-  "pronunciation_notes": [
-    {
-      "surface": "<多音字、生僻字、专名或数字>",
-      "reading": "<确定读法>",
-      "decided_by": "creator | <role>:<stable-id>"
-    }
-  ],
-  "target_seconds": null,
-  "unresolved": []
-}
-```
-
-## 字段为什么是这些
-
-| 字段 | 不写会怎样 |
-|---|---|
-| `source_ref` | 剧本改一句而表没跟上，录出来的是旧词；绑定了块 ID 才能切出剧本原字节逐字比对 |
-| `speaker` 与 `speaker_display` | 前者是资产身份用于绑定，后者是剧本里逐字写的名字；只留一个就必然有一处对不上 |
-| `channel` 与 `lip_sync_constrained` | 同期与配音、画内与 VO 的可改余地完全不同，混在一起就只能按最严的来。`channel` 必须与它投影的块一致：`[VO]` / `[OS]` 块只能记为同名声道或 `dubbed`，画内对白块不能记成 VO/OS——校验器判定，诊断码 `VOICE_CHANNEL_DISAGREES_WITH_BLOCK` |
-| `addressed_to` / `preceding_line_id` | 集中录制时配音者不知道在对谁说、接谁的话，语气只能靠猜 |
-| `speaker_knows_now` | 同一句话在"已经知道"和"还不知道"下是两种读法，这是最常见的重录原因 |
-| `tactic` | 情绪词（"愤怒"）不可执行；策略可执行。见对白工艺的策略库 |
-| `pronunciation_notes` | 专名与多音字在录音棚里是最贵的中断；决定要在进棚前做完并留痕 |
-| `target_seconds` | 有画面时长约束的行要提前知道，不要在混录时才发现塞不下 |
-
-## 诊断码
-
-`voice_sheet_check.py` 报出的全部代码。它只判逐字投影与结构，不判配音表演。
-
-| 代码 | 分级 | 判定者 | 含义 |
-|---|---|---|---|
-| VOICE_LINE_HAS_NO_ID | structural_invariant | validator | 配音行没有 `line_id` |
-| VOICE_LINE_ID_REPEATS | structural_invariant | validator | `line_id` 重复 |
-| VOICE_CHANNEL_INVALID | structural_invariant | validator | `channel` 不是 sync / dubbed / VO / OS |
-| VOICE_CHANNEL_DISAGREES_WITH_BLOCK | structural_invariant | validator | `channel` 与它投影的块不符：画外音块记成画内，或画内对白记成 VO/OS |
-| VOICE_SOURCE_REF_MISSING | structural_invariant | validator | `source_ref` 没有指向任何上游快照 |
-| VOICE_SOURCE_REF_UNDECLARED | structural_invariant | validator | `src` 在本文件 `sources` 里没有对应条目 |
-| VOICE_SOURCE_REF_UNRESOLVABLE | structural_invariant | validator | `record_id` 在剧本索引里找不到 |
-| VOICE_SOURCE_IS_NOT_DIALOGUE | structural_invariant | validator | 配音行投影的块不是台词，也不是 `[VO]`/`[OS]` |
-| VOICE_BLOCK_SPAN_INVALID | structural_invariant | validator | 索引记的块跨度装不进这份剧本，或落在半个字符上（索引已过期） |
-| VOICE_BLOCK_IS_UNPARSEABLE | structural_invariant | validator | 台词块不符合文档写明的行语法 |
-| VOICE_LINE_TEXT_DIVERGED | structural_invariant | validator | `line_text` 与剧本原字节不一致——**以剧本为准** |
-| VOICE_SPEAKER_DIVERGED | structural_invariant | validator | `speaker_display` 与剧本里写的名字不一致 |
-| SOURCE_ENTRY_IS_INCOMPLETE | structural_invariant | validator | `sources` 里的条目缺 `owner` 或 `artifact` |
-
-## 边界
-
-- **本表不拥有台词文字、说话人和信息权限**，它们属于剧本；本表也不拥有逐镜的音频实现
-  （空间化、层级、与画面的对位），那属于视频提示词环节，本表只引用不复制。
-- 表里出现与剧本不一致的文字时，**剧本为准**，把差异作为 `unresolved` 记下来交给
-  负责人，不要就地"顺一下"。
-- 本表不生成音频、不调用任何语音服务，也不从文字判断成品音质；实际 TTS 交给
-  `$short-drama-produce`，并须在看到本次任务预览后明确确认。

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

@@ -1,75 +0,0 @@
-# 作者记忆维护
-
-[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` 里点名将被略过的条目及其断言首句。2048 字节量的是交给执行者的 `lines`（每条一行「- 断言（编号）」，含换行），不是 JSON 外壳：`items` 里的编号、类型、范围只给主会话和脚本判断用，不进执行者 prompt。
-- 写入落盘后另一级 store 读不出来（书目录不存在、`--book` 与书级记录不符等）也照常给回执，`warnings` 注明本次提醒没算上它。写书级条目时「本书＋全局」按实际条目精确计算；写项目级条目时只看得到项目级 store，顺手传 `--book-root` 就把当前这本书也算进提醒。
-- 查询按 **重要度 → 本书例外 → 最近更新** 排序装填（同一范围的条目必在同一 store，「最近」按该 store 的修订号比，不跨 store 比较），先丢的恒是重要度较低的条目——`importance` 决定超编时谁留在 prompt 里。装不下的条目跳过而不中断（一条长的不挡后面的短条），漏下的 ID 按同一优先级全数报进 `omitted_ids`，断言首句报进 `omitted_summaries`、重要度报进 `omitted_importance`，供主会话用原话告诉作者哪几条没带上；长篇写章由组装脚本把这句话拼好写进核对报告，章末汇报照模板原样说。
-- 注入预算之外还有一道硬上限：`作者画像.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/references/author-memory.md

@@ -1,117 +0,0 @@
-# 作者记忆协议
-
-作者记忆保存跨会话复用的创作偏好，不保存小说世界里的事实，决定权留给作者。本文件管最常见的时刻：作者说出一条偏好，或要确认、替换、忘掉某条。少见情况读 [author-memory-maintenance.md](author-memory-maintenance.md)：整理作者记忆与超编、画像写满、单书布局与 `state.book` 报错、存量迁移、多事件 `commit`、`check`、冲突候选落定、升级前的旧条目。
-
-## 边界与优先级
-
-加载优先级从高到低：
-
-1. 安全、用户授权范围、明确的平台交付要求、字数与文件协议；句长、视角、修辞和标点偏好不属于不可覆盖的硬门禁；
-2. 用户在当前请求中的明确要求；
-3. 当前书的 `设定/文风.md`、题材定位、细纲和其他项目设定；
-4. 作者记忆中的本书偏好；
-5. 作者记忆中的题材、流程和全局偏好；
-6. 对标素材、通用方法和默认值。
-
-按表达维度取最窄适用要求：低优先级只补缺项，不与高优先级要求并列执行。通用 references 自称“必须/禁用”不改变此顺序；审稿不因作者有意采用的表达本身扣分，真实可读性与因果问题仍照常评价。
-
-作者记忆不能把本书事实写进 `.story/作者记忆/`，不能降低审稿 rubric，也不能让去 AI 味改动剧情意图。小说事实继续由各书的 `追踪/` 和 `设定/` 管理。
-
-## 存放与路由
-
-两级 store，记忆随书走：`{工作区}/.story/作者记忆/` 存 global / genre / workflow 条目（编号 `AP`），`{书}/.story/作者记忆/` 只存本书的 book 条目（编号 `BP`）。每级各有 `作者画像.md`（生效条目）和 `待确认.md`（候选，不参与约束），都从 state 生成，禁止手改；不存在时写作、审稿、去味照常继续，首次 `record` 自动创建。
-
-- `--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` 两个事件。
-
-## 查询
-
-各 skill 入口已写好本任务的 `query` 命令（长篇正文由组装脚本代查）；没写命令的长篇设定、大纲等任务查 `story_design` + `workflow` + `interaction`，结果只给主会话、不传正文 agent。四类任务的映射表见维护文件。state 存在才查（两级都不存在时返回空结果、零写入）；结果合并项目级与 `--book-root` 所指书级（不传就拿不到本书条目），`--kind` 必传；交给执行者的只有 `lines`（每条一行原话＋编号，单次查询 ≤2048 字节）。
-
-普通创作只做一次本地 `query`，完整画像、证据、候选和 journal 不进 prompt。查询项是低优先级倾向，不是逐条打卡清单：自然吸收，不复述画像、不刻意提高词面命中率，不为命中牺牲连贯、节奏、字数或本书既定笔调。**`omitted_ids` 非空＝记忆超编**，不是「没有更多了」：照 `omitted_summaries` 转告作者并建议「整理作者记忆」，不得改读完整画像规避预算。待确认项不进 prompt，也不为确认它们中断任务；只在作者主动查看、候选积累到适合回顾的节点，或新偏好与 active 条目冲突时集中呈现。
-
-## 记不记、记成什么
-
-不装记录全部用户消息的 prompt hook，不在作者没开口时观察他，只记作者明确表达的偏好。是否属于长期习惯由 agent 判断，拿不准就只执行不记录；作者可明说“记住：……”，以回执验收。
-
-| 输入证据 | 处理 |
-|---|---|
-| “以后都这样”“我一直习惯……”等直接、稳定、范围清楚的原话 | `active`，`source=explicit_user` |
-| 用户明确接受助手提出的长期做法 | `active`，`source=accepted_suggestion` |
-| 作者原话像长期偏好但范围或稳定性含糊 | `pending`，取当前最窄合理范围；待确认只来自作者自己的话 |
-| 同类修改反复出现、从成稿或操作轨迹看出的模式 | 不记录、不推断；作者没开口的偏好不进记忆 |
-| “这一章别……”“这次给我……”等一次性要求 | 只执行，不记录 |
-| 角色、时间线、伏笔、世界观、当前剧情走向 | 写项目设定/追踪，不写作者记忆 |
-| 助手自己生成的文字、默认模板、工具告警、rubric 结论 | 不自我学习 |
-
-保留否定词、限定词和适用范围：`quote` 写原话，`assertion` 只做不改变语义的紧凑归纳，**新建条目限一句话（≤120 字节，约 40 个字）**，写不下就压缩措辞、不切限定词；背景写进 `reason`（不进 prompt），不另开字段。
-
-**一条偏好就是一条记录，例外和限定不许拆出去单列。** 「以后少用破折号，对话里也别用，除非表示打断」整条写成「破折号少用、对话里也不用，只在表示打断时保留」：超编时条目逐条被丢，拆开就可能只丢掉例外，把作者说过的限定变成绝对禁令。只有原话塞了**几条互不依赖**的偏好（如「多用短句」＋「章末留钩子」）才拆。
-
-范围：“本书 / 这个角色 / 这次连载” → `book`；“都市文 / 这类题材” → `genre`；交稿、检查、确认节奏等操作习惯 → `workflow`；“以后 / 一贯 / 我习惯”且无更窄限定 → `global`；含糊但可能稳定 → 最窄合理范围并置 `pending`。
-
-类型：`prose_style`、`story_design`、`workflow`、`delivery`、`interaction`。置信度与重要度均为 `low | medium | high`；超编时先丢重要度低的，按偏好的实际分量填，不要一律 `high`。`source` 只接受 `explicit_user`、`accepted_suggestion`、`manual`，工具拒绝推断类来源。
-
-## 确认、替换、忘掉与冲突
-
-- 同一类型、范围、归纳文本再出现，脚本强化原条目（累加证据与确认次数），不重复建条。
-- 新偏好与同一 store 的 active 条目矛盾：以 `conflict` 记候选，`conflicts_with` 列冲突 ID，本轮仍按当前要求执行；本书例外与全局规则不算冲突。冲突候选不能直接 activate，落定见维护文件「冲突候选」。
-- pending 用 `decide=activate|reject`。同一范围的规则改版用 `replace`，新条目启用、旧条目标 `superseded`；只有作者明确撤销或改变旧规则范围才跨范围替换。
-- 作者说“忘掉 / 这不再是我的习惯”用 `forget`，保留历史证据但不再加载。active 条目的语义不可原地偷改，语义变化必须 replace，历史才可审计。
-
-## 回执怎么告诉作者
-
-回复就两行纯文本，不加代码块或引用格式：第一行用一句人话说记住了什么、管哪本书或哪类场合，如「记住了：《{书名}》的对话一律用「」，以后写这本书都照这个来；想改随时说。」；第二行是机器回执作凭证，如「技术备注：Author Memory Receipt: r1 · BP001」。
-
-- 确认、替换、忘掉同理：「好，这条生效了：……」「换成了：……，原来的「……」不再用」「忘掉了：……」。只进待确认时说「这条先记在待确认里，你说"确认"才生效」；有冲突时用原话说明跟哪条旧习惯冲突。
-- `warnings` / `omitted_ids` 不原样贴：说「你的习惯攒得有点多，写正文时这几条会带不上：「……」」（`warnings` 是最坏估算，改说「可能带不上」），并建议说「整理作者记忆」。不提字节、prompt、kind、scope；编号只能跟着原话出现。
-
-## 运行工具
-
-依次尝试 `python3`、`python`、`py -3` 找到 Python 3，从当前 skill 根运行本地副本：
-
-```text
-{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 {流程}]
-```
-
-- 子命令都可加 `--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
-{
-  "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": []
-    }
-  }
-}
-```
-
-待确认用 `"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":"作者明确确认"}
-{"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":"作者明确撤回"}
-```