@oh-story/dsh 0.1.15 → 0.1.17

package/lib/oh-story/skills/story-import/references/format-and-structure.md

@@ -1,168 +0,0 @@
-# 正文格式与小节结构
-
-> 写作前必读。以下格式是当前仓库约定的默认正文交付格式；用户或目标平台有明确要求时，以用户/平台要求覆盖。
->
-> **适用范围**：段落格式（戏剧单元/镜头优先，短段为底色，长段用于完整推理、氛围和情绪链）和对话格式适用于所有体裁。小节(beat)结构仅适用于短篇；小节不设统一最低字数。长篇按 `visible_chars_v1` 测量同口径细纲 `字数目标`：内部带 ±12%，用户带 ±15%。
-
----
-
-## 章节标记
-
-默认格式（按灵活度排序）：
-
-| 格式 | 平台适用 | 示例 |
-|------|----------|------|
-| `###1.` | 短篇默认 | `###1.` `###2.` `###3.` |
-| `###第一章` | 部分平台 | `###第一章` `###第二章` |
-| `1.`（纯数字） | 知乎 | `1.` `2.` `3.`（无 ### 前缀） |
-
-**规则**：全文统一一种格式，不要混用。短篇推荐 `###1.` 或纯数字，简洁高效。
-
----
-
-## 段落格式
-
-### 核心规则：戏剧单元优先
-
-默认交付排版是**按戏剧单元/镜头自然断段，段落紧密排列**。不要把固定字数当成强制切刀；先判断“一件事/一个推理链/一个情绪变化”是否完成。
-
-- 一段承载一个戏剧单元：一个动作链、一个线索发现、一次视线切换、一轮心理判断，或一条连续的氛围/推理/情绪链。
-- 场景结束、一件事结束、新动作、新物件、新信息、新对话另起一段；同一瞬间的发生、感知、反应应织在一起，不拆成动作层/感知层/反应层。
-- 正文相邻段落之间**只允许一个换行符 `\n`**；不得出现空行或连续换行 `\n\n`（紧密排列）。
-- 无缩进（平台渲染器自行处理，不需要 `　　` 或空格）。
-- 长度只作诊断：读起来拥挤、混入多个拍点、或手机屏上难以跟读时才拆；完整推理、氛围铺陈、情绪递进未结束时，允许稍长段保留连贯性。
-
-### 段落节奏（长短交错 + 疏密有别）
-
-短段快读，是网文手机阅读的底色；长段负责承载完整推理、氛围和情绪沉淀。**忌通篇同长度**，也忌把每段按同一字数阈值切开：
-
-- **长短交错**：高潮、打脸、反转压到最短（单句成段）；推理链、环境压迫、情绪沉淀、章节收束可保留较长段，让读者读完一个完整变化。
-- **疏密有别（详略）**：爽点、转折 beat 写密（感知、动作、细节铺满）；过场、连接 beat 写疏（1-2 句带过，不平均用力）。每个 beat 一样长、一样细，正是 AI 腔的来源。
-- **不过度碎片化**：连续多个极短段若仍属于同一镜头/同一件事，应合并成自然段，避免像提纲或诗行。
-
-### 主语与角色名节奏
-
-角色名不宜一味省略，也别每句都点名。按“主语重置”使用：
-
-- 段首、场景切换、多人同场、或主语可能混淆时，用主角名/角色名建立视角。
-- 同一段或同一动作链内，优先混用代词、动作承接和合理省略，避免每句都以同一角色名开头。
-- 关键转折、情绪爆点、身份反差或读者需要重新盯住主角时，可以再次点名强化。
-- 审查主语节奏看“读起来是否打磕巴”，不按全章出现次数一刀切；只有连续句/连续段无主语重置却反复点名，才算主语过密。
-
----
-
-## 对话格式
-
-### 对话标记
-
-按目标平台/用户要求选择；未指定时使用默认格式：
-
-| 优先级 | 格式 | 适用平台 |
-|--------|------|----------|
-| 首选 | `"说话内容"` | 短篇默认、番茄 |
-| 平台/项目指定 | `「说话内容」` | 知乎盐言短篇、部分古言、日式或用户指定 |
-
-**默认用 `""`**；用户或平台指定盐言风格时改为 `「」`，不要把 `「」` 视为错误。
-
-### 对话规则
-
-1. 对话**独立成行**，不嵌在叙述段落中
-2. 对话标签按需：高频或公式化的「他说」「她道」「他笑了笑说」用动作描写替代；普通「说」低频使用可保留（与「8 条绝对禁止」中「避免对话标签机械化」一条一致）
-3. 两人对话连续出现时，省略标签，靠内容区分说话人
-
-**正确示例**：
-```
-她把杯子放下。
-"你走吧。"
-他没有动。
-"我说，你走吧。"
-```
-
-**也合法（普通「说」低频使用）**：
-```
-她把杯子放下。
-"你走吧。"她说。
-他没有动。
-"我说，你走吧。"
-```
-
-**错误示例**：
-```
-她把杯子放下，说道："你走吧。"他没有动，她又说："我说，你走吧。"
-```
-
----
-
-## 语气标点谱系
-
-标点服务语气、人物声线和情绪节奏，不能通篇句号化，也不能为了“丰富”随机堆砌符号。先判断当前句子的功能，再选择标点：
-
-| 语气 / 功能 | 标点策略 | 防线 |
-|---|---|---|
-| 压迫 / 冷静 / 克制 | 短句、逗号、句号，必要时用冒号压出判断落点 | 不人工加感叹号；克制不是每句都平铺句号 |
-| 质问 / 试探 / 反问 | 问号 + 短促追问片段，配合动作停顿 | 避免每句话都以 `？` 结尾 |
-| 惊讶 / 爆发 / 打脸 | 真正爆点可用 1 个感叹号，连续爆发最多 1-2 处 | 禁止 `!!!`、整段喊叫式感叹 |
-| 犹豫 / 吞咽 / 未说完 | 逗号、句号、短句断开、动作 beat | 不用 `……` 制造停顿；优先用动作和句长变化 |
-| 被打断 / 拖长音 | 不使用 `——`；改用动作打断、换行、短句或未完成动作 | 正文和对话都禁止 `——` / `—` / `--` |
-| 信息揭示 / 判断落点 | 冒号、分号或单句成段制造落点 | 保持手机阅读友好，不写论文式分号串 |
-
-执行规则：
-- 写对话时先看角色关系和权力位置：强势角色常短句收束，试探角色多问号和半句，崩溃角色才允许少量感叹/省略。
-- 写叙述时用句长、逗号停顿和单句成段制造节奏；默认不用破折号硬造节奏；本书文风明确授权的功能性用法保留。
-- 精修时检查两类问题：**通篇句号化**（语气全被压平）与**随机标点堆砌**（问号/感叹号不承载情绪功能，或用省略号/破折号硬造停顿）。
-- 引号风格按项目/平台约定；知乎盐言的 `「」` 是合法对话格式，`quote-mode keep` 时不得擅自改掉。
-
----
-
-## 小节（beat）结构
-
-### 基本规则
-
-- 用数字编号（`1` `2` `3`）分割小节，每个小节是一个完整的叙事 beat
-- 小节长度服从其叙事职责，不设统一最低字数；整篇按锁定的交付范围控制，长篇章节按细纲「字数目标」处理
-- 小节数由情节阶段和转场需要决定；不为平均分配字数拆分完整动作链，也不把承担不同职责的小节硬合并
-- 每小节推进一个明确的情节点
-
-### 小节内部结构
-
-每个小节至少完成第 1 项，其余按本节职责选用：
-
-1. **一个主事件** + **一个或多个真实推进**（风险、信息、关系、资源、决定、行动或读者理解至少改变一项；相关情节点可由同一动作链或对话同时兑现，不为数量新增阻碍、对话或冲突）
-2. **情绪或压力落点**（确有变化时写清读者感受如何变化；任务、推理、手艺或等待链不强配情绪转折）
-3. **读者模型或下一步变化**（新信息、旧信息改义、决定、行动或后果均可，不强配新事实）
-4. **对白按功能使用**（需要时改变信息、策略、权力、关系或下一步行动；独自发现、核验证据、等待、手艺等场景可以无对白）
-5. **推进单元按需揉进信息维度**：发生是主干，感知和反应只在提供新信息时织入同一镜头（参考 writing-craft.md 场景写法）
-
-
-### 小节之间的衔接
-
-- 小节结尾留一个钩子（悬念/未解决的情绪/新问题）
-- 下一节开头快速接续，不要重新铺垫
-- 情绪跨节递进：每一节的情绪强度 ≥ 上一节。例外：峰值情绪（反转节）后允许维持 1 节不降，但不允许骤降
-
----
-
-## 平台对话格式覆盖表
-
-| 平台 | 章节标记 | 对话格式 | 特殊要求 |
-|------|----------|----------|----------|
-| 知乎盐言 | `1.` | `「」` | 导语即正文开头几段，不另标 |
-| 番茄 | `###第一章` | `""` | 首段需有吸引力 |
-| 红果 | `###1.` | `""` | 无 |
-
-**通用原则**：用户未指定平台时，默认使用短篇通用格式（`###1.` + `""`）；用户或平台指定盐言风格时，`「」` 是允许的。
-
----
-
-## 8 条绝对禁止
-
-以下规则在写作全程执行，不因题材或风格而变：
-
-1. **禁止机械按字数分段**：不要因为超过某个字数就强拆；先判断段落是否仍是一个完整戏剧单元。若混入多个动作/信息/视线切换才拆，完整推理、氛围、情绪链可保留稍长段
-2. **禁止段间空行**：正文相邻段落之间只允许一个换行符 `\n`，不得出现空行或连续换行 `\n\n`
-3. **避免对话标签机械化**：高频或公式化的「他说」「她道」「他笑了笑说」用动作/上下文替代；普通“说”可保留
-4. **禁止缩进**：不使用 `　　`（全角空格）或半角空格缩进
-5. **禁止正文段落 Markdown 渲染**：除统一的小节/章节标记（如 `###1.`）外，正文段落中不使用加粗 `**`、斜体 `*`、标题 `#`、分隔线 `---` 等 Markdown 语法
-6. **默认停顿写法**：正文默认用句号、逗号、换行、动作 beat 或短句承担停顿；本书明确选择的功能性破折号/省略号按调用方文风裁决与书级白名单保留。标点偏好不属于不可覆盖的文件结构协议。
-7. **禁止通篇句号化或随机标点堆砌**：标点必须跟语气/人物声线/情绪功能匹配；该质问时用问号，该爆发时少量感叹；犹豫、吞咽、未说完用动作或句长变化表达，不用 `……` / `——` 硬造停顿，也不得无功能地乱撒 `？`/`！`
-8. **禁止正文混入章节元信息**：章节号只允许出现在标题/小节标记/文件名/追踪记录中。正文叙述、对话、心理描写里不得出现 `第[一二三四五六七八九十百千万两0-9]+章|上一章|上章|前一章|本章|这一章|前文|后文|伏笔|细纲|读者` 这类写作工程词；要改成角色能感知的事件锚点或相对时间，例如把“比第一章那三秒开火更疼”改成“比那三秒开火更疼”。例外：角色在故事世界内真实阅读/讨论“第X章”文本，或真实身为作者/读者并谈论读者身份时，可保留相应词。

package/lib/oh-story/skills/story-import/references/state-tracking.md

@@ -1,43 +0,0 @@
-# 角色状态记录格式
-
-> story-import 反推角色状态（character-state-reverse.md）时按本格式写 `追踪/角色状态/{角色名}.md`。
-
-动态状态按核心角色拆成 `追踪/角色状态/{角色名}.md`，由 `tracking_commit.py` 根据事务 JSON 整份覆盖；静态原始人设仍在 `设定/角色/{角色名}.md`。只为后续会复用的主角、反派、核心配角建快照，不为路人、一次性功能角色建文件。
-
-## 格式
-
-```markdown
-# 江晨｜当前状态
-
-- 截至章节：第10章
-- 身份：火箭军文工团宣传兵；军宣爆款创作者
-- 位置：火箭军文工团高层看片会
-- 当前目标：完成五天百万粉任务，持续做出真正能打的军宣内容
-- 身心状态：专业团队反向验证原版价值，军内认可继续抬升
-
-## 能力与资源
-- 前世 MCN 爆款运营经验
-- 《中国军魂》伴奏
-- 大师级导演能力
-
-## 关键关系
-- 钟嘉嘉持续提供军报资源
-- 周薄森和张耀祖已明确认可其创作能力
-
-## 已知信息
-- 《军报》采访稿已经过审
-- 原版视频将继续作为正式军宣内容
-
-## 未结事项
-- 五天百万粉任务尚未结算
-- 钟嘉嘉所谓“只猜对一半”仍未解释
-```
-
-## 更新规则
-
-1. 每章只记录身份、位置、目标、身心状态、能力资源、关系、已知信息、未结事项中真正发生变化的内容。
-2. 核心复用角色发生变化时，在同一事务的 `character_changes` 写变化，并在 `character_snapshots` 提交其**截至当前已写最后一章**的完整快照；工具以快照是否存在判断核心/临时角色，整份覆盖核心角色小文件，不追加历史。
-3. 修订旧章时，从修订章检查到最后已写章，按各维度和各关系对象重算当前状态，再提交完整快照；不得把最后一条单维度变化当成角色全状态。
-4. 无变化可不提交快照；核心角色重新进入当前场景时直接读取其已有小文件，并由事务工具把必要信息带入续写状态卡。
-5. 角色变化历史属于 `逐章记录/第NNN章.md`，当前快照不重复保存逐章履历。
-6. 完整 JSON 字段、4096 字节目标与 8192 字节硬上限见 [tracking-transaction.md](tracking-transaction.md)。

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

@@ -1,146 +0,0 @@
-# 追踪状态协议
-
-`追踪/` 使用“一个结构化权威状态 + 多个确定性派生视图”。模型只提交一份语义 JSON，不分别 `Write/Edit/echo >>` 多个追踪文件。
-
-## 权威层与派生层
-
-| 层级 | 文件 | 语义 |
-|---|---|---|
-| 唯一权威 | `_tracking-state.json` | schema、最后提交章、导入截止章、状态修订号、上下文结构、角色/伏笔/时间线，以及已提交章节的简短字数记录 |
-| 章节记录 | `逐章记录/第NNN章.md` | 本章对未来连续性有用的紧凑变化；目标 ≤1536 字节，硬上限 3072 字节；导入范围内修订写成覆盖记录 |
-| 派生视图 | `上下文.md`、`角色状态/{角色名}.md`、`伏笔.md`、`时间线/作者真相.md`、`时间线/读者已知.md` | 完全从 `_tracking-state.json` 生成；禁止手改，不作为程序输入 |
-
-Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown。`check` 直接从 `_tracking-state.json` 重渲染并逐文件比较。未来“第几章揭示”的计划写在卷纲/细纲，不写成时间线既成事实。
-逐章记录只是便于人阅读的紧凑变化记录，不承诺单独无损重建全部当前状态；完整当前语义以 `_tracking-state.json` 为准。
-
-## 运行工具
-
-先按运行环境探测 Python 3 解释器（依次尝试 `python3`、`python`、`py -3`）。追踪事务脚本使用当前 skill 根目录；字数与章节闭环统一使用 `story-long-write` skill 根目录：
-
-```text
-{PYTHON} {当前 skill 根}/scripts/tracking_commit.py init   --project {书项目根} --input {书项目根}/.story/work/init.json
-{PYTHON} {当前 skill 根}/scripts/tracking_commit.py check  --project {书项目根}
-{PYTHON} {当前 skill 根}/scripts/tracking_commit.py draft  --project {书项目根} --chapter {N}
-{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter check   --project {书项目根} --chapter {N} [--min-chars {下限} --max-chars {上限}]
-{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter commit  --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
-{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter accept-current-length --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
-```
-
-- `init`：只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
-- `draft`：按当前 state 把逐章事务预填到 `.story/work/第NNN章/tracking.json`（修订号、模式、章名、`context` 四项当前值），并输出各文本字段的字数上限与在场核心角色的当前快照。新章（append）调用方只填 `delta` 与有变化角色的快照；已提交章（revision）的 `delta` 与相关角色快照按该章现有逐章记录预填（伏笔、时间线取当前值），调用方在上面改成修订后的完整记录，不清空重写。
-- 作者字数范围：细纲可写一行 `字数范围：2000-2600`（作者明确给了上下限时）；本轮临时给的范围用 `--min-chars` / `--max-chars`（两者同给，优先于细纲）。`wordcount check` / `checkpoint` 与 `chapter check` / `commit` / `accept-current-length` 都认，给了就同时替代默认 ±12% 内部带与 ±15% 用户带，结果里 `band_source` 为 `author`，提交的字数记录多一项 `author_range`。
-- `wordcount measure` / `wordcount checkpoint`：纯测量入口；不写正文、不写 tracking、不做语义判断。长篇正文只在前组写完后由主会话带 `--project` 调用一次 `checkpoint`（目标与字数范围读细纲，见 workflow-chapter 步骤 6），整章长度由 `chapter check` 收口；`remaining_user_range` 按生效区间（作者区间或默认用户带）计算。
-- `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。顶层 `status`：`ready`（可提交，exit 0）/ `needs_decision`（长度带外，按 `available_actions` 交作者，exit 0）/ `blocked`（有 blocking 正文问题，exit 1）/ `invalid`（正文为空等，exit 1）/ `tool_unavailable`（找不到 node 或检测脚本，见 `quality.tool_errors`，不是正文问题，exit 3）。参数错误或文件缺失输出 `story-chapter-error/v1`（`status: error`，exit 2）。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及回到生效区间所需的删除字数。`quality.semantic_advisories` 是语义类 advisory 条数（检测器标 `review: mechanical` 的不计）。
-- `chapter commit`：再次读取当前文件、重新计数并重跑 blocking quality；只接受生效区间内的章节，把简短字数记录与逐章事务一起原子提交。新章与修订都走它。
-- `chapter accept-current-length`：只接受带外但 quality pass 的章节；接受动作发生时重新读取、重新计数并立即原子提交，不保存可陈旧的历史决议。低于字数目标一半（`BELOW_ACCEPT_FLOOR`），或超长却还没做过那一次压缩（`COMPRESSION_REQUIRED`），都拒绝；作者明确拍板时加 `--force`。
-- `check`：严格验证 state schema、逐章记录连续性/规范名/体积、固定 7 栏、角色快照硬上限、派生文件集合，以及所有派生视图与 state 的逐字一致性。
-
-每本书由 `追踪/.tracking-commit.lock` 串行写事务，`expected_state_revision` 再拒绝基于旧状态构造的 stale transaction。两个不同事务并发时至多一个修订成功。字数记录也在锁内对当前正文和目标重新验证，正文或目标变化会让预先构造的记录直接失败。
-
-事务 JSON 是临时输入，不是项目产物：只写在书目录 `.story/work/` 下（逐章事务放 `.story/work/第NNN章/tracking.json`），不写系统 `/tmp`、书根、`大纲/` 或 `正文/`；成功前必须保留，提交成功后即可删除（`storyctl.py chapter commit` / `accept-current-length` 成功时自动删除该章目录；直接调用 `tracking_commit.py commit` 时由调用方删除。已有字数记录的章节正文或目标改过后，`tracking_commit.py commit` 拒绝修订事务，须走 `storyctl.py chapter commit`）——之后 `check` 失败按下文提交 `mode=revision` 新事务修复，不需要原事务。若文件写入失败，`_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`——删掉那个手写文件后重跑原事务即可。
-
-本工具不解析旧 `_tracking-meta.json`、`时间线/事件库.json` 或更早追踪结构，不提供语义兼容层。`init` 遇到这类旧文件时，先把它们按原样整体移入 `追踪/_旧追踪存档/`，再在原地建当前协议：旧内容留给作者查阅，不参与解析，当前状态完全以 init 输入为准。校验失败的 `init` 不移动任何文件。`commit` 与 `check` 仍直接拒绝旧结构——它们只在已建协议的项目上运行。
-
-## 初始化事务
-
-仅新书或导入初始化时，执行 `init` 前必须完整读取 [tracking-initialization.md](tracking-initialization.md)，按其中原始 JSON 与导入边界构造事务。已有项目续写直接使用下方逐章事务，不重复读初始化示例。
-
-调用方的逐章 JSON 不写 `wordcount`；正式入口 `chapter commit` 或 `chapter accept-current-length` 在提交当下生成并注入。最终 state 只为已提交章节保留 `metric / target / actual / status / resolution / body_sha256`（生效了作者字数范围时另加 `author_range`），不保存 MEASURE/RESOLVE 事件、ID 链、policy fingerprint 或独立 chapter state。
-
-## 逐章事务
-
-```json
-{
-  "schema_version": 1,
-  "mode": "append",
-  "chapter": 10,
-  "chapter_title": "专业团队拍得还不如他拍的好？",
-  "expected_state_revision": 9,
-  "delta": {
-    "result": "专业团队重拍的高清版在高层看片会上被判定缺了灵魂，张耀祖拍板继续采用江晨的手机原版。",
-    "character_changes": [
-      {"name": "江晨", "change": "作品价值获军内高层确认，从爆款新人升为不可替代的军宣创作者"}
-    ],
-    "foreshadow_changes": [
-      {
-        "action": "upsert",
-        "id": "F027",
-        "summary": "专业团队仍拍不出江晨原版的灵魂，继续验证其创作能力不可复制",
-        "planted_chapter": 10,
-        "planned_resolution_chapter": null,
-        "status": "已埋",
-        "importance": "中"
-      }
-    ],
-    "timeline_events": [
-      {
-        "action": "upsert",
-        "id": "E010",
-        "story_time": "实弹训练两天后",
-        "objective_fact": "文工团高层否决专业重拍版，决定沿用江晨手机拍摄的原版视频",
-        "reader_knowledge": "读者已看到周薄森指出专业版缺了灵魂，张耀祖当场拍板用回原版",
-        "reveal_status": "已揭示",
-        "reveal_chapter": 10,
-        "characters": ["江晨", "周薄森", "张耀祖"]
-      }
-    ],
-    "constraints": ["后续继续用作品落地效果和围观反应放大江晨的高光，不能只写系统奖励数字"],
-    "next_chapter_commitments": ["结算五天百万粉任务，并承接老兵主题的新任务"]
-  },
-  "context": {
-    "position": {
-      "volume": "第一卷·军宣整顿",
-      "volume_start_chapter": 1,
-      "story_time": "实弹训练两天后",
-      "scene": "火箭军文工团高层看片会"
-    },
-    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
-    "active_character_names": ["江晨"],
-    "continuity_risks": ["钟嘉嘉说江晨只猜对一半，未公开的培养安排不能被当成读者已知事实"]
-  },
-  "character_snapshots": {
-    "江晨": {
-      "identity": "火箭军文工团宣传兵；军宣爆款创作者",
-      "location": "火箭军文工团高层看片会",
-      "goal": "完成五天百万粉任务，持续做出真正能打的军宣内容",
-      "state": "专业团队反向验证原版价值，军内认可继续抬升",
-      "abilities_resources": ["前世MCN爆款运营经验", "《中国军魂》伴奏", "大师级导演能力"],
-      "relationships": ["钟嘉嘉持续提供军报资源", "周薄森和张耀祖已明确认可其创作能力"],
-      "knowledge": ["《军报》采访稿已经过审", "原版视频将继续作为正式军宣内容"],
-      "open_threads": ["五天百万粉任务尚未结算", "钟嘉嘉所谓只猜对一半仍未解释"]
-    }
-  }
-}
-```
-
-约束：
-
-- 构造事务前运行 `check`，把当前 `state_revision` 原样写入 `expected_state_revision`；若状态已经变化，重新读取 state 并重构事务。
-- `context` 的允许字段随子命令不同：`init` 收 `position`、`long_term_constraints`、`active_character_names`、`continuity_risks`、`recent_chapters`、`next_chapter_commitments` 六项；`commit` 只收前四项。`recent_chapters` 与 `next_chapter_commitments` 在 commit 时由工具从当前视图和本章 `delta` 派生，手填会在任何写入前被拒（`context contains unsupported fields: ...`，exit 2）。照 init 示例套 commit 事务是最容易踩的一处。
-- `character_snapshots` 中出现的角色视为核心复用角色，必须同时出现在 `character_changes`；已经建立快照的核心角色再次变化时必须提交新快照。
-- 角色快照的四个列表不限制条数，只限制单项长度和最终文件总字节：目标 ≤4096 字节，超过警告；硬上限 8192 字节，超过则在任何写入前拒绝。
-- 没有快照的角色变化视为临时角色，不建立状态文件；`context.active_character_names` 最多 6 人且必须已有当前快照。
-- `context.long_term_constraints` 最多 6 条：要加第 7 条先合并语义重叠项或请作者取舍，不自动删旧约束；永久生效的设定裁定进它，短期强承诺进 `next_chapter_commitments`，过程决策不进续写状态卡。
-- `context.long_term_constraints` 和 `context.continuity_risks` 是整份提交的当前值。凡是上一版有、本次没有的条目，必须逐条列进 `delta.retired_context_items`，否则工具在任何写入前拒绝——漏写不会被当成删除。实际退役的条目由工具写进本章逐章记录的 `## 本章退役登记`，随后仍可回查。
-- 不再复用的核心角色写进 `delta.retired_characters`：工具删除其当前快照与 `角色状态/{角色名}.md`，并在逐章记录留档。同一事务里不能既退役又提交快照，也不能退役仍列在 `context.active_character_names` 的角色。角色阵亡/退场这一章，把变化照写进 `character_changes` 即可，本章退役的角色不必再交一份马上要删的快照，逐章记录仍按核心角色标注。退役只表示不再进入热上下文，正文与逐章记录不受影响。
-- 两类退役都只能在 `mode=append` 提交。退役表示「从此刻起离开当前状态」，而修订事务的逐章记录属于被改写的旧章，落在那里会谎报退役发生的章节；`mode=revision` 必须原样重交当前全部上下文条目，需要退役就放到下一次 append。
-- `伏笔.md` 只呈现已经埋设过的当前状态。未来规划仍留在大纲。
-- `timeline_events.action` 可为 `upsert/delete`。`未揭示` 的 `reveal_chapter` 必须为 `null`；部分/完全揭示只能填写已经发生的实际章节。
-- `mode=revision` 时，逐章记录必须重算为修订后该章仍然成立的完整连续性记录（用 `draft` 预填的草稿改，漏写的项会从记录里消失，工具在 stderr 警告被清空的栏目；原有的退役登记原样保留）；当前角色、伏笔、时间线和上下文则提交受影响对象截至最新已写章的当前值。
-- 修订导入截止章内的正文时，会新增或覆盖该章的逐章记录；`imported_through_chapter` 不变。
-
-## 续写状态卡固定格式
-
-`上下文.md` ≤12288 字节，由 state 整份生成，只含以下 7 个顶层区块：
-
-1. `## 当前位置`
-2. `## 长期约束`
-3. `## 核心角色状态`
-4. `## 活跃伏笔`
-5. `## 近三章速记`
-6. `## 下一章承诺`
-7. `## 连贯性风险`
-
-其中活跃角色最多 6 人、活跃伏笔确定性选取最多 8 条、近章只保留 3 章。这些是下一章热上下文容量，不是完整角色状态的容量限制。

package/lib/oh-story/skills/story-long-analyze/references/deconstruction-notes.md

@@ -1,270 +0,0 @@
-# 长篇拆文参考
-拆书方法论、结构设计、卖点循环、题材实战要点的速查手册。配合 SKILL.md 与各 Stage 的规则文件使用。
-
-## 管道阶段映射
-
-| 本文件章节 | 适用管道阶段 | 用途 |
-|-----------|-------------|------|
-| 核心情绪控制 | Stage 1（黄金三章）| 判断开篇情绪是否到位 |
-| 题材边界与核心梗 | Stage 0（概要提取）| 识别题材类型和核心梗 |
-| 拆书方法论 | Stage 1-2（三章+连续章节块）| 拆解视角和提取方法 |
-| 结构设计与节奏 | Stage 3（聚合分析）| 节奏地图和情绪曲线构建 |
-| 卖点循环设计 | Stage 3（聚合分析）| 爽点循环模式识别 |
-| 桥段词表 | Stage 3（聚合分析）| 给剧情模块打桥段标签 |
-| 经典作品拆解 | Stage 1-2 | 对标拆解参考框架 |
-| 拆书实操技巧 | Stage 2（连续章节块提取）| 情绪折线图、期待分析 |
-| 对标书选择 | Stage 0（概要提取）| 确定拆解对象 |
-| 抽象拆书法 | Stage 3（聚合分析）| 三幕式结构归纳 |
-| 影视拉片与情绪控制 | Stage 2-3 | 情绪曲线精细化分析 |
-| 多线叙事与结构循环 | Stage 3（聚合分析）| 多线交织识别 |
-| 题材实战 | Stage 0-1（概要+三章）| 题材特有爽点形态 |
-| 人设塑造 | Stage 4（设定+关系）| 角色档案和出场设计 |
-| 素材转化 | Stage 0-5（全流程）| 拆文结果转化为写作指导 |
-
----
-
-## 核心情绪控制
-
-### 自检规则
-
-拆解或审查时标记：文本是否偏离核心梗、是否出现只服务表达欲但不服务读者期待的段落。偏离核心梗时，输出为留存风险而不是主观评价。
-
-### 核心情绪崩溃案例
-
-| 问题 | 教训 |
-|------|------|
-| 主角独断万古身边人死绝 | 读者代入后"天下无敌啥也得不到"，憋屈 |
-| 换地图杀光所有配角 | 留存/追读风险显著升高，读者难以接受代入资产清零 |
-| 所有人牺牲成工具人 | 高开低走，核心情绪崩坏 |
-
-修正：悲情通过创造挫折体现，非杀死重要角色；换地图可让原有人遇险给主角行动理由。
-
-### 刀人原则
-
-- 刀人是手段非目的，对笔力要求极高
-- 必须刀人时，埋伏笔留弥补空间
-- 项目没有足够铺垫、补偿机制和后续情绪回收方案时，不要刀重要角色
-- 悲情强度必须由目标平台近期样本校准；默认不让悲情覆盖核心爽感或安全感
-
-### 强情绪样本校验
-
-若目标平台近期样本高频出现强情绪文，拆解时记录：触发情绪、释放节奏、噱头位置、留存证据。没有近期样本时，不把强情绪当作硬性趋势，只作为候选假设。
-
----
-
-## 题材边界与核心梗
-
-### 核心梗 = 读者需求，偏离 = 抛弃读者
-
-| 偏离类型 | 后果 |
-|----------|------|
-| 核心对比消失（都市高武→普通） | 在读直降 |
-| 核心机制不升级（网游困在新手村） | 限制上限 |
-| 题材串味（玄幻混诡异/悬疑跑偏到玄幻） | 两边读者都不讨好 |
-| 后期三观偏离 | 受众筛选过严重 |
-
-### 核心梗延伸四维度
-
-以"逆袭系统（早到流）"为例：1.任务数量 2.奖励难度 3.等级阶层+隐藏触发 4.奖励触发新戏剧性任务。仅用前两点戏剧性快速消耗殆尽，四点结合才持续。
-
-### 核心梗密度参考
-
-《美食赋我词条》11章内核心梗应用5次，密度极高。
-
----
-
-## 拆书方法论
-
-### 六原则
-
-有目的 / 有方法 / 拆出理论 / 摒弃好恶 / 扬长避短 / 拆自己喜欢的书
-
-### 流程
-
-概括一句话 → 识别结构单元（起承转合，递进扩大） → 抽离框架+情绪链条 → 借鉴框架非抄内容
-
-### 条件框架提取法
-
-剧情提炼为条件（如：展露部分天赋+两方势力争夺+信息差制造慧眼识珠），替换人物/背景/金手指后复用，保留情绪相似。
-
-### 抽象五步法
-
-概括 → 拆为信息团（情绪转折点） → 按上行/下行/转折归类 → 提取通用条件框架 → 用素材填充
-
-### 感情线拆法：双标法
-
-同一件事（送可乐），男配送女主拒绝，男主送女主接受。三要素：①差不多同一件事前后连续 ②女主态度截然不同 ③男主不清楚。
-
----
-
-## 结构设计与节奏
-
-### 情绪拉扯工具
-
-| 技巧 | 做法 |
-|------|------|
-| 熟悉情绪套路 | 选套路→搞人设→填剧情 |
-| 期待断掉续上 | 引入新角色/新事件重新拉起 |
-| 装逼打脸底层 | 鄙视链+人际关系舞台+正向反向传播 |
-| 复合型配角 | 主角"白手套"：替主角发声+绝对支持+搞笑 |
-
-### 望远镜拉期待法
-
-倒计时结构：不断描写"发现→观测→打捞→失败→坠落"——读者都知道子弹会射向主角→巨大期待。
-
-### 分卷节奏（天才俱乐部案例）
-
-每二三十万字一卷，有明确核心与目标；卷内多线头纠缠打破线性"起承转合"；"起"必须抛钩子；每卷结尾为下卷埋线。
-
-### 时代适应
-
-从强冲突开场→人情冷暖+基础需求展开；文风更细腻；画面剪辑感极强；套路熟悉但两三章速战速决。
-
----
-
-## 卖点循环设计
-
-### 完美循环（天灾信使）
-
-开小号装逼打脸赚好处→拿好处做主线任务→获得奖励→给小号提升武力→新地图装逼打脸→循环。关键：每次内容不同；情感进展拉住期待感；最终暴露小号身份=装出去的逼兜回主角。
-
-### 信息密集型循环（苟在初圣宗）
-
-按"轮回"拆分，每轮回=完整故事。力量体系不崩即可无限拉长。
-
-### 直播流循环
-
-有目标（确定性预期）→ 有对抗（短平快胜负）→ 有阶段性（任务升级）→ 整活正反馈
-
----
-
-## 经典作品拆解
-
-| 作品/作者 | 核心拆解点 |
-|-----------|-----------|
-| 遮天（辰东） | 九龙拉棺倒计时+同学打脸+前女友回归+进荒古禁地（不断切换期待类型） |
-| 夜无疆（辰东） | 大病初愈+无粮+邻居救济→画面剪辑感→熟悉套路两三章速战速决 |
-| 我吃西红柿 | "没有特点"=普适性强；敢写升级突飞猛进+敌人摧枯拉朽；前提三观正 |
-| 赘婿（香蕉） | 写诗装逼教科书：铺设人际→构架舞台→诗作逐层传播→多轮震惊→态度闭环 |
-| 炮火弧线 | 煽情+身临其境；军文核心=国与国、信仰与信仰 |
-
----
-
-## 拆书实操技巧
-
-### 从期待出发
-
-- 先知先觉类金手指使用场景：介绍世界观/提升实力/装逼前/对比高手前/介绍新人物前
-- 过渡情节写收获/暧昧/小情节，无冲突可跳到冲突前一秒
-
-### 情绪折线图
-
-横轴=章节，纵轴=情绪正负。控制节奏=控制"富有戏剧性的信息团"出现速度。信息团=能造成情绪转折的情节。
-
-### 逐段功能标注法
-
-对照原文逐段标记叙事功能（铺垫/转折/高潮/过渡），追踪情绪走向、困境设计、伏笔衔接，输出可复用框架；禁止复制剧情内容或表达。
-
----
-
-## 对标书选择
-
-| 错误 | 原因 |
-|------|------|
-| 只拆一本对标书 | 至少5本同网站同题材同类型参考 |
-| 只拆唯一头部爆款 | 头部作品可能依赖不可复制的作者品牌或历史流量，优先选择同平台同题材、数据稳定、非唯一头部的可复制样本 |
-| 跨网站对标 | 不同网站读者群体不同，写法差异大 |
-
-流程：广泛收集同题材样本→定方向→定参考书5-10本→定对标书
-
----
-
-## 抽象拆书法：三幕式
-
-| 幕 | 核心 |
-|----|------|
-| 第一幕-建立 | 暗示矛盾→主角+金手指→惊人意外→情绪上下拉扯→主线确立 |
-| 第二幕-对抗 | 新世界→更强对手→中点反转→情绪拉扯（下行后必有上行） |
-| 第三幕-决战 | 线索收束→矛盾极限→关键选择（体现人物弧光）→决战+主题升华 |
-
----
-
-## 影视拉片与情绪控制
-
-- 人物态度转变=最能体现情绪
-- 打斗间穿插反应但控制字数，否则截断节奏
-- 用情绪展示境况（感叹/震惊/窃喜）表现优劣
-- 每个动作段落要带出情绪变化
-
----
-
-## 多线叙事与结构循环
-
-### 多线拆解维度
-
-事件节点（新人物/冲突爆发）/ 情绪链条节点（一句话概括）/ 事业线 / 感情线
-
-感情线模板（单角色）：相遇态度→关键转折→态度递进（厌恶→好奇→心动→沦陷）→推倒引爆点
-
-### 循环层次感
-
-同一框架循环时每次内容必须不同（地图/角色/冲突/情感细节更新）。力量体系不崩可无限拉长。
-
----
-
-## 题材实战
-
-| 题材 | 核心要点 |
-|------|----------|
-| 历史文 | 本质=类同人写法；书名"朝代+开局事件"；核心梗=先知先觉震惊名人+改变历史 |
-| 军事文 | 卖点=煽情+身临系境；核心矛盾=国与国/信仰/意识形态 |
-| 种田/脑洞 | 密集小爽点（收藏/能力/面板/震惊）；面板设定要细致 |
-| 直播流 | 目标（确定性预期）+对抗（短平快）+阶段性+爽点写法：先告诉读者打算怎么装逼，再装个更大的 |
-| 两界穿梭 | 书名即卖点；核心梗=在A世界低调用B世界资源；长生凡人流：时间尺度大+配角代际更替 |
-| 重生流 | 天然期待感；前世被辜负→这一世报复；爽点可重复使用每次形式不同；番茄标准=简单直给打标签 |
-
----
-
-## 桥段词表
-
-给 Stage 3 的 `剧情/{标题}.md` 打「桥段标签」用的常见桥段词。命中就标，逗号分隔；不在表内但本书确有的桥段照实写，不硬凑、宁缺毋滥。**可扩展种子，不是封闭枚举。**
-
-| 题材 | 常见桥段 |
-|------|----------|
-| 都市/言情 | 打脸、扮猪吃虎、马甲掉落、先婚后爱、追妻火葬场、破镜重圆、替身、契约婚姻、萌宝助攻 |
-| 玄幻/修仙 | 废柴逆袭、扮猪吃虎、越级战斗、夺宝、护短打脸、绝境翻盘、机缘逆天 |
-| 历史/种田 | 先知先觉、改变历史、科举经商崛起、攒钱起家、技能点亮 |
-| 悬疑/无限 | 信息差、反转打脸、规则怪谈、身份揭穿、复盘解谜 |
-| 系统流 | 任务奖励、签到、面板升级、强制任务、积分兑换 |
-| 重生/穿越 | 前世复仇、改命、身份调换、双重生、未卜先知 |
-| 世情/家庭 | 极品亲戚、婆媳争斗、偏心打脸、维权反击、自我觉醒 |
-| 直播/两界 | 直播整活、低调用资源、两界差价、围观震惊 |
-
----
-
-## 人设塑造
-
-### 第一章立人设
-
-小事件展示性格→贴标签确立；紧急事件快速带入剧情；女角色第一步反应要体现性格。
-
-### 日常体现人设
-
-重复出现符合人设的行为；配角功能化（嫉妒型：得意→嫉妒；崇拜型：质疑→佩服）；配角情绪转变要写出。
-
-### 开篇逻辑
-
-被动入局→交流了解世界观→陷入困境→明确目标→展示金手指→通过金手指收获
-
----
-
-## 素材转化
-
-从热点提取：识别核心冲突→定主线方向→用经典框架填充素材。
-
-### 文体决定行文
-
-| 文体 | 行文 |
-|------|------|
-| 打脸爽文 | 节奏快、描写少、言语凝练 |
-| 感情流 | 细水长流、细腻描写 |