@lemoncat7/dsh-partner 2.8.1 → 2.8.2

package/resources/skills/story-creation/upstream/skills/story-import/references/deep-analysis.md

@@ -0,0 +1,47 @@
+# 深度分析时刻：导入场景怎么驱动拆解管道
+
+Phase 2 只读本文件，再按篇幅进入对应 analyze skill；拆书的方法、产物结构、分批、恢复与质量检查全部由 analyze skill 自己的流程负责，本文件只写导入场景的取值。篇幅、原文位置、题材和写作环境都读导入记录（`{书目录}/.story/work/导入记录.md`），不回翻对话、不重新问作者。
+
+| 篇幅 | 进入 | 产物目录 |
+|------|------|---------|
+| 长篇 | `/story-long-analyze` 的统一管道（旧成果直用 / 按需增强 / 全新或部分续跑） | `拆文库/{导入书名}/` |
+| 短篇 | `/story-short-analyze` 的拆解管道（Stage 2-6） | `拆文库/{导入书名}/` |
+
+## 长篇：先兼容识别，再决定是否续跑
+
+先运行 story-long-analyze Phase 1 的只读检查器（`inspect_existing_assets.py`），登记实际文件和覆盖范围；检查建议不能覆盖下列语义规则：
+
+新生成或按当前契约续跑的长篇进度保持 `schema_version: 2`；旧成果直接使用不以缺少该字段为失败。
+
+- **旧成果已完成且足以重建写作工程**：直接进入 Phase 3。旧 `_progress.md` 版本、缺少 `chapter_index.csv`，或缺少本次新增字段，都不能单独成为重拆理由。
+- **旧成果可以导入，但缺少当前写作/对标功能需要的 `剧情/节奏.md`、`剧情/情绪模块.md` 等资料**：先用现有逐章、剧情、关系、报告和文风做 Stage 3+ 按需增强，不回读原文。不得重跑已完成章节，也不得用空壳文件让门禁通过。
+- **只完成一部分或新旧产物混存**：验证并保留已完成部分，从首个缺失的连续章节块续跑，最后统一聚合。进度记录与实际文件冲突时，以可验证文件为准并记录冲突。
+- **全新导入**：运行 Stage 0-6 完整管道。
+
+导入需要自动完成本次判定出的必需范围，不把 Stage 1 停靠询问甩给作者。全新导入命中「完整拆解、一次跑完」路径；旧成果增强或部分续跑只执行缺失 Stage/章节块。原有用途当前不消费新增分析时，缺少新增字段只记录能力限制，不阻断导入。
+
+- 措辞示例（全新）：启动深度分析时声明「以『完整拆解、一次跑完、不要停下询问』模式拆解本书，确保 Stage 2-6 全部产出」。
+- 措辞示例（旧成果）：声明「先复用并校验现有成果，只补当前导入缺失的章节或分析，不覆盖用户原成果」。
+- **兜底**：若全新导入实际仍停在 Stage 1，自动选择继续；若旧成果任务停靠，则按已登记的缺失范围继续，不能扩大成全书重跑。
+- 派发：导入记录写着分析助手可用时，属自动续跑，按 story-long-analyze 的「有限并行」档派 `chapter-extractor`（每轮 3 批），每个连续章节批次只调用一次，同次生成逐章事实与跨章观察；作者明确要求时改用串行或不限批次顺序。作者选了直接导入（或 ZCode）时，Stage 2 由主会话按相同连续章节块契约串行处理，不能退回每章一次独立调用；产物仍完整，仅速度变慢。
+- 超过 200 章的作品按 [import-special-cases.md](import-special-cases.md)「超过 200 章的作品」分批拆解。
+
+## 短篇：单一全量管道
+
+story-short-analyze 的拆解管道（Stage 2-6）本身**无 Stage 1 停靠点**，一次跑完即可。它的 Phase 1 四个 Step 都要跑，按下表的导入场景取值执行，不整段跳过：
+
+| Phase 1 步骤 | 导入场景下的处理 |
+|-------------|----------------|
+| Step 1：拿到原文 | 用导入记录里的源文件，不重新问 |
+| Step 2：字数检查（长短篇路由） | 篇幅已在导入 Phase 1 判定并经作者确认，直接答「按短篇继续」，不重新路由 |
+| Step 3：题材识别 | **照常跑**，题材标尺必须加载；导入记录里已确认的题材类型直接代入，不重复提问 |
+| Step 4：续跑检查（`拆文库/{导入书名}/_meta.json` 已存在时三选一） | 先看旧产出是否可直接复用：`stages_completed` 已含 6 且 `拆文报告.md` / `情节节点.md` / `写作手法.md` / `原文/` 均非空、来源与本次导入源一致 → 直接进 Phase 3，不重跑也不归档。否则本轮首次进入 Phase 2 → 按 (a) 覆盖：先把旧产出归档到 `拆文库/{导入书名}/_archive_{时间戳}/`，再从 Stage 2 重跑；同一轮导入内重试同一本书 → 按 (b) 续跑。不把三选一甩给作者，也不跳过归档 |
+
+`_meta.json` 的 `genre_detected` 由 Step 3 产出，是拆文契约的阻断级必填字段，下游 story-short-write 靠它选题材标尺——**不要跳过 Step 3 直接从原文备份起跑**。
+
+- 措辞示例：启动深度分析时声明「《{导入书名}》篇幅已确认为短篇（题材 {题材类型}，全文约 {N} 字），Step 2 直接按短篇继续，Step 4 按覆盖并归档处理，题材识别照跑，确保 Stage 2-6 全部产出」。
+- **兜底**：若运行环境仍抛出「此文字数 {N} 偏长，建议改用 `/story-long-analyze`」或灰区提问「介于短/长之间，按短篇还是长篇拆？」，一律按导入记录里锁定的判定逐字回「按短篇继续」，**绝不把路由询问甩给作者**。
+
+## 交付
+
+拆解管道自带的质量检查通过、产物落在 `拆文库/{导入书名}/` 后，在导入记录勾「深度分析」。拆书流程自带的完工汇报（长篇「全部拆完」、短篇「可以运行 /story-short-write 写下一篇」）在导入里不用，由这里交代：向作者用一两句故事话说拆到了什么（几章、主要人物、主线一句），末尾按 [SKILL.md 的换上下文规则](../SKILL.md#时刻表与交接) 建议新开对话。拆书中断时不在这里另做恢复：重新进入同一拆解管道，由它按自己的进度文件续跑。

package/resources/skills/story-creation/upstream/skills/story-import/references/format-and-structure.md

@@ -0,0 +1,168 @@
+# 正文格式与小节结构
+
+> 写作前必读。以下格式是当前仓库约定的默认正文交付格式；用户或目标平台有明确要求时，以用户/平台要求覆盖。
+>
+> **适用范围**：段落格式（戏剧单元/镜头优先，短段为底色，长段用于完整推理、氛围和情绪链）和对话格式适用于所有体裁。小节(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/resources/skills/story-creation/upstream/skills/story-import/references/import-report.md

@@ -0,0 +1,64 @@
+# 汇报与激活时刻
+
+Phase 5 只读本文件和导入记录（`{书目录}/.story/work/导入记录.md`）。前面每个时刻已按自己的清单验收后才勾进度，这里不重读迁移规则。
+
+## Step 1：收尾自检
+
+这是你自己的自检，不念给作者：全部通过就不提；没通过先回到对应时刻修，修不了才用故事话告诉作者影响和办法。
+
+- 导入记录的进度全部勾上（短篇没有细纲与追踪两项）。
+- **长篇**：`正文/` 章节文件数等于导入范围章数；每章都有 `大纲/细纲_第XXX章.md`，且对全部细纲再跑一次 `node {story-import skill 根}/scripts/check-outline-contract.js --json {书目录}/大纲/细纲_第*.md` 通过；再跑一次 `{PYTHON} {story-import skill 根}/scripts/tracking_commit.py check --project {书目录}`（按 `python3` → `python` → `py -3` 探测）通过；原文没分卷时卷划分已经作者确认；`拆文库/{导入书名}/` 未被复制到 `对标/`。
+- **短篇**：`正文.md`、`设定.md`、`小节大纲.md` 都在，未误建 `追踪/`、`大纲/`、`正文/`。
+
+## Step 2：导入完成报告
+
+报告写给作者：导进来了什么、哪几处请他核对、要他拍板的事、下一步怎么说。字段名、脚本名、校验结果、字数口径、伏笔/事件编号不进报告；编号只能跟着故事描述出现（如「玉佩的来历（F003）」）。核对项要落到具体人和事，一次最多 5 条。
+
+**长篇**：
+
+<!-- author-report -->
+```md
+=== 《{导入书名}》导入完成 ===
+导进来了：第 1–{N} 章，约 {Y} 万字{；第 {N+1} 章只写了一半，按你的决定{接着残章写 | 先补完}}。项目在 `{项目目录}`。
+
+我整理出了：
+- 人物：{M} 个角色档案，主要人物写到第 {N} 章时的处境已记下（如「{角色}：{一句话现状}」）
+- 大纲：全书大纲、{V} 卷卷纲、每章细纲
+- 还没收的线：{K} 条（如「{伏笔的故事描述}」）
+- 时间线：真相和读者目前知道的分开记，续写时不会提前泄底
+- 设定：{设定文件数} 份世界观资料
+- 对标书：{没有绑定 | 已接入《{对标书名}》 | 没接上：原因和补救}
+
+请你核对：
+1. {最拿不准的一处，写成具体问题，如「第 5 章的黑衣人和第 2 章的车夫是同一人吗？」}
+2. {如「还没收的线里有没有漏的？我列的是：……」}
+
+需要你决定：{仅在有待定事项时写，如「原文没分卷，我按剧情分成 3 卷（1–40 / 41–95 / 96–{N} 章），这样分可以吗？」}
+
+下一步：说「日更」就从第 {N+1} 章接着写；想先检查导入质量，说「审一下」。
+```
+
+**短篇**：
+
+<!-- author-report -->
+```md
+=== 《{短篇标题}》导入完成 ===
+导进来了：全文约 {Y} 字，分成 {N} 个小节。项目在 `{项目目录}`。
+
+我整理出了：
+- 设定：核心框架和续写要守住的人物、情绪基调
+- 小节大纲：{N} 节，每节讲了什么
+- 对标书：{没有绑定 | 已接入《{对标书名}》 | 没接上：原因和补救}
+
+请你核对：
+1. {标了 [待补充] 的地方，写成问题，如「女主最后原谅他了吗？原文没写明」}
+2. {核心反转前埋的线索我找到的是：……，有没有漏的？}
+
+下一步：{没写完：运行 `/story-short-write` 说「接着写」，从第 {N+1} 节往下写 | 已完本：想改稿说「审一下」}。
+```
+
+## Step 3：项目激活
+
+- 设置 `.active-book` 指向导入的书名/标题目录，在导入记录勾「汇报与激活」。
+- 确认项目可以被对应写作 skill 识别（长篇 → story-long-write，短篇 → story-short-write）。
+- 可选验证：如果当前运行时的 canonical 目录已部署 story-explorer agent，可 spawn 交叉验证迁移数据完整性；Antigravity 检查 `.agents/agents/story-explorer/agent.md` 并用 `invoke_subagent` + `TypeName: "story-explorer"`。Prompt：`项目目录：{dir}\n查询类型：progress\n查询参数：导入验证`

package/resources/skills/story-creation/upstream/skills/story-import/references/import-special-cases.md

@@ -0,0 +1,34 @@
+# 导入的特殊情况
+
+只在下面几种情况读；普通导入不读。
+
+## 流程答疑
+
+用户问「导入续写先装环境还是先导入」「已有小说怎么续写」「导入流程」这类问题时，先直接给结论，再继续收集原文——避免用户只想确认流程却被直接要求贴原文：
+
+1. **推荐顺序**：先 `/story-setup` 装好写作环境，新开或刷新会话后运行 `/story-import`，最后用 `/story-long-write 日更` 或 `写第N章` 续写。
+2. **也可以直接 `/story-import`**：导入会在深度分析前检查写作环境；没装时给「先去装」或「直接导入，慢一点」两种选择。
+3. **已导入过的当前协议项目**（书名目录下有 `追踪/_tracking-state.json`）：不要重复跑完整导入；直接进入书名目录，确认 `.active-book` 指向正确书目，再用 `/story-long-write 日更` 或 `/story-long-write 写第N章`。书目录下有 `{书目录}/.story/work/导入记录.md` 且进度没勾完时，是上次导入做到一半：从第一个未完成的进度接着做。
+4. **v0.7.2 及更早的旧追踪项目**（有 `追踪/` 和正文，但没有 `追踪/_tracking-state.json`）：日更会停下要求重新导入，但**不需要重跑全书拆解**，只重建追踪，见下一节。
+
+## 旧追踪项目迁移
+
+书名目录下有 `追踪/` 与正文、但没有 `追踪/_tracking-state.json` 时，项目停在 v0.7.2 及更早的追踪结构上。正文和 `设定/`、`大纲/`、`拆文库/` 都不受影响，**只需重建 `追踪/`**，不重跑深度分析、不碰正文：
+
+1. 数清最后一个完整章号 `N`（`正文/第NNN章_*.md` 的最大值）。
+2. 从旧 `追踪/` 现有文件（角色状态、伏笔、时间线等，文件名按项目实际情况）和最近 3-5 章正文，重建当前状态：核心角色快照、未回收伏笔、已揭示时间线事件、长期约束、下一章承诺。角色快照的反推方法见 [character-state-reverse.md](character-state-reverse.md)。
+3. 按 [import-tracking.md](import-tracking.md) 构造初始化事务（其中点名的 tracking-initialization.md 完整读取），`last_chapter` 写 `N`（第 1..N 章不伪造逐章记录），执行 `tracking_commit.py init`。
+4. `init` 会把旧追踪结构按原样整体移入 `追踪/_旧追踪存档/` 再建当前协议——旧内容不删除、不参与解析，留给作者查阅。
+5. 跑 `tracking_commit.py check` 确认通过，再回 `/story-long-write 日更` 续写。
+
+重建结果以第 2 步的证据为准；拿不准的字段留空或写进 `continuity_risks`，不杜撰。用户明确要求重拆全书时才走完整导入。
+
+## 超过 200 章的作品
+
+仅长篇。短篇为单文件全量迁移，无增量导入需求。拆解可以分批，追踪初始化必须一次覆盖全部已写章节：
+
+1. **拆解分批**：首期只深拆前 50 章 + 全书概要，后续按需补拆更多章节到 `拆文库/`。
+2. **追踪一次到位**：初始化事务的 `last_chapter` 写**最后一个已写完的章号 N**，不是首期拆解的 50。`imported_through_chapter` 由 `init` 一次写定、之后不再推进，逐章事务只接受 N+1 起的章号；第 1..N 章不伪造逐章记录，续写从 N+1 开始。若 init 时误写成 50，第 51..N 章仍可逐章 `append` 补上（一章一份事务，章号必须连续），只是要为已写好的旧章逐章构造事务；不要删 `追踪/` 重来——`_旧追踪存档/` 也在里面。
+3. **简化摘要**：未深拆的章节每章写一份约 200 字的简化摘要（谁做了什么、局面怎么变、章尾留下什么等待），固定落在 `{书目录}/.story/work/简化摘要/第NNN章.md`（三位补零）。细纲任务包在拆文库没有该章摘要时自动取这里；追踪初始化反推当前状态也从这里取证。
+
+首期深拆范围写进导入记录「范围」一行，细纲与追踪时刻据此取证据。

package/resources/skills/story-creation/upstream/skills/story-import/references/import-tracking.md

@@ -0,0 +1,95 @@
+# 追踪初始化时刻（仅长篇）
+
+Phase 4 只读本文件、[tracking-initialization.md](tracking-initialization.md)（初始化事务的原始 JSON 与导入边界，完整读取）和 [character-state-reverse.md](character-state-reverse.md)（核心角色快照反推）。导入截止章、残稿决定、卷划分读导入记录（`{书目录}/.story/work/导入记录.md`）；证据只取已落盘的 `拆文库/{导入书名}/` 与项目 `大纲/`，不重读原文。续写时的逐章事务与导入无关，不读。
+
+导入项目必须通过本 skill 自带的 `scripts/tracking_commit.py init` 一次性生成追踪状态，禁止模型分别写最终文件。
+
+## 语义准备顺序
+
+1. **导入截止章**：把最后完整章 N 写入初始化事务的 `last_chapter`。工具在 meta 记录 `imported_through_chapter=N`；导入旧章没有日更事务，不得为第 1..N 章伪造逐章增量，也不额外生成一份重复当前状态的叙事基线。
+2. **核心角色当前快照**：从拆书产物反推主角、反派、核心配角的截至 N 章状态，按角色写入 `character_snapshots`，工具生成 `追踪/角色状态/{角色名}.md`；算法见 character-state-reverse.md。
+3. **伏笔当前行**：从有正文证据的铺垫/回收事件生成 `foreshadow`（识别方法见下）。每个 ID 只保留当前状态一行；尚未实际埋设的未来设计留在大纲，不写 `伏笔.md`。
+4. **事实与读者认知**：把关键事件生成到 `timeline_events`（提取方法见下）。同一事件同时写客观事实、读者截至 N 章已知内容和实际揭示状态；未来计划揭示章不得伪装成已发生事实。
+5. **续写状态卡输入**：准备当前位置、长期约束、活跃核心角色、近三章速记、下一章承诺和连贯性风险。`上下文.md` 由工具生成固定 7 栏，不把文风、文件索引、普通待办或质检计数塞进续写状态卡。
+6. **执行初始化**：事务写到 `{书目录}/.story/work/init.json`（成功前保留，不写系统 `/tmp`、书根、`大纲/` 或 `正文/`）。按当前平台探测 Python 3（`python3` → `python` → `py -3`），执行：
+
+   > 项目 `追踪/` 里已有不属于当前协议的早期文件时不必手工清理：`init` 会先把它们按原样整体移入 `追踪/_旧追踪存档/`，再在原地建当前协议。旧内容保留供作者查阅，不参与解析，当前状态完全由本次导入输入决定；校验失败的 `init` 不移动任何文件。`init` 只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
+
+   ```text
+   {PYTHON} {story-import skill 根}/scripts/tracking_commit.py init --project {书目录} --input {书目录}/.story/work/init.json
+   {PYTHON} {story-import skill 根}/scripts/tracking_commit.py check --project {书目录}
+   ```
+
+半成品最后一章为残稿时，`last_chapter`、角色快照和其他当前语义检查点一律截至最后完整章；残稿处理策略（导入记录里作者的决定）写入 `continuity_risks`，不把未完成动作登记成既成事实。
+
+以 demo《让你管账号，你高燃混剪炸全网》导入至第 10 章为例：续写状态卡要写清江晨的手机原版《诸君，且听龙吟》被专业团队高清重拍，但高层看片后认为新版“缺了灵魂”，最终继续采用原版；江晨快照应体现其军宣创作价值已获周薄森、张耀祖确认；读者时间线只写读者已经看到的看片会结论，钟嘉嘉“只猜对了一半”背后的培养安排若尚未揭示，只能出现在作者真相，不能泄露到读者视图。
+
+## 条目形状与容量
+
+在 tracking-initialization.md 的骨架上填条目（导入时 `last_chapter` 写 N）：
+
+```json
+{
+  "foreshadow": [
+    {"id": "F027", "summary": "专业团队仍拍不出江晨原版的灵魂", "planted_chapter": 10,
+     "planned_resolution_chapter": null, "status": "已埋", "importance": "中"}
+  ],
+  "timeline_events": [
+    {"id": "E010", "story_time": "实弹训练两天后",
+     "objective_fact": "文工团高层否决专业重拍版，决定沿用江晨手机拍摄的原版视频",
+     "reader_knowledge": "读者已看到周薄森指出专业版缺了灵魂，张耀祖当场拍板用回原版",
+     "reveal_status": "已揭示", "reveal_chapter": 10, "characters": ["江晨", "周薄森", "张耀祖"]}
+  ],
+  "context": {
+    "recent_chapters": [{"chapter": 10, "summary": "专业重拍版被判缺了灵魂，高层拍板用回手机原版"}]
+  }
+}
+```
+
+- 伏笔 `id` 形如 `F001`，`status` 取 已埋/已回收/已过期/放弃，`importance` 取 高/中/低；`planted_chapter` 不晚于 N。事件 `id` 形如 `E001`，`reveal_status` 取 未揭示/部分揭示/已揭示：`未揭示` 的 `reveal_chapter` 必须为 `null`，部分/完全揭示只能填已经发生的实际章节。
+- `context` 在 init 时收六项：`position`、`long_term_constraints`、`active_character_names`、`continuity_risks`、`recent_chapters`（最多 3 章，按章号升序）、`next_chapter_commitments`。
+- `character_snapshots` 里的角色就是核心角色；四个列表不限条数，单角色文件目标 ≤4096 字节，硬上限 8192 字节，超过在任何写入前拒绝。`active_character_names` 最多 6 人且必须已有快照；`long_term_constraints` 最多 6 条。
+- `上下文.md` ≤12288 字节，只含 7 个顶层区块：当前位置、长期约束、核心角色状态、活跃伏笔（最多 8 条）、近三章速记、下一章承诺、连贯性风险。
+- 报错按提示改事务本身再跑；排查字段全集时才查 [tracking-transaction.md](tracking-transaction.md)。导入后续写时角色状态怎么更新见 [state-tracking.md](state-tracking.md)，本时刻不读。
+
+## 伏笔提取
+
+| 情节点类型 | 伏笔可能性 | 提取方式 |
+|-----------|-----------|---------|
+| 铺垫 | 高 | 直接提取为伏笔 |
+| 信息揭示（部分） | 中 | 检查后续是否有呼应 |
+| 物品首次出现 | 中 | 检查后续是否有使用 |
+| 角色秘密 | 高 | 标记为角色伏笔 |
+| 未解决的悬念 | 高 | 从章尾标记提取 |
+
+状态推断：铺垫点在后续章节有「揭示」或「解决」类情节点 → 已回收；无后续呼应 → 已埋；半成品最后几章的铺垫 → 已埋，摘要里注明「接近断点」。
+
+## 时间线提取
+
+从情节点和时间标记中提取：明确日期（“天元三年春”）直接记录；相对时间（“三日后”）推算；事件间隔（“翌日”）连续标记；季节标记（“入冬”）推断季节。按章节顺序排列，同一章内按情节点序号排列；时间标记缺失时标注 `[推断]`。
+
+## 验收
+
+初始化成功后应得到：
+
+```text
+追踪/
+├── _tracking-state.json
+├── 上下文.md
+├── 逐章记录/                 # 导入旧章不补造文件，续写从第 N+1 章开始
+├── 角色状态/{角色名}.md
+├── 伏笔.md
+├── 时间线/
+│   ├── 作者真相.md
+│   └── 读者已知.md
+```
+
+- [ ] `tracking_commit.py check` 通过，`_tracking-state.json` 与全部派生视图一致
+- [ ] `_tracking-state.json.imported_through_chapter` 等于最后完整导入章
+- [ ] `追踪/伏笔.md` 每个 ID 至多一行，未来尚未埋设的设计没有混入
+- [ ] `_tracking-state.json.timeline` 已登记关键事实与读者认知，`读者已知.md` 无真相泄露
+- [ ] `追踪/角色状态/{角色名}.md` 已覆盖全部核心角色并对齐 character-state-reverse.md
+- [ ] `追踪/逐章记录/` 空目录已创建，且没有为导入章伪造日更记录
+- [ ] `追踪/上下文.md` 顶层恰好固定 7 栏且 ≤12288 字节
+
+通过后在导入记录勾「追踪初始化」，`init.json` 可删除；汇报末尾按 [SKILL.md 的换上下文规则](../SKILL.md#时刻表与交接) 建议新开对话。

package/resources/skills/story-creation/upstream/skills/story-import/references/length-routing.md

@@ -0,0 +1,134 @@
+# 篇幅分流判断规则
+
+Phase 1「基本信息确认」环节使用本规则判定导入书是长篇还是短篇，判定结果决定后续走哪条迁移路径。
+
+---
+
+## 判定优先级
+
+判定按以下顺序执行，命中即停止，不再向下判断。
+
+| 优先级 | 信号来源 | 判定规则 |
+|--------|---------|---------|
+| 1 | 用户显式声明 | 用户说「这是长篇 / 短篇」→ 以用户为准，直接锁定 |
+| 2 | 结构信号 + 字数校验 | 检测到明确章节分隔符且章节数 ≥ 5 → 长篇；全文无章节分隔、单文件单篇 → 按下方细则表按字数分三档判定（字数阈值沿用优先级 3 的建议值） |
+| 3 | 字数兜底 | 仅在 1、2 均不明确时启用，见下方「字数兜底规则」 |
+| — | 冲突处理 | 信号之间发生矛盾时，不自动决策，回到 Phase 1 向用户复述并请用户拍板 |
+
+---
+
+## 优先级 1：用户显式声明
+
+Phase 1 信息确认时向用户提问：**「这是长篇还是短篇？」**
+
+- 用户明确回答 → 锁定类型，跳过后续检测。
+- 用户未回答或说「不确定」→ 进入优先级 2 结构信号检测。
+
+---
+
+## 优先级 2：结构信号 + 字数校验
+
+### 章节分隔符识别
+
+复用 `structure-mapping-long.md` 的分隔符识别表：
+
+| 分隔符模式 | 示例 |
+|-----------|------|
+| `第X章` / `第X章 ` / `第X章：` / `第X章 XXX` | 第1章 初入江湖 |
+| `Chapter X` | Chapter 1 |
+| 纯数字编号 + 标题 | 1. 觉醒 |
+
+### 判定规则
+
+| 检测结果 | 判定 |
+|---------|------|
+| 有明确章节分隔符，且识别到章节数 ≥ 5 | 强长篇信号 → 判定为**长篇** |
+| 全文无任何章节分隔符，单文件单篇，且总字数 < 20000 | 强短篇信号 → 判定为**短篇** |
+| 全文无任何章节分隔符，单文件单篇，20000 ≤ 总字数 < 30000 | 判定为**短篇**，但 Phase 1 复述时告知：已超过短篇拆解管道 20000 字的建议上界，请用户确认仍按短篇导入 |
+| 全文无任何章节分隔符，单文件单篇，但总字数 ≥ 30000 | 结构与字数信号相反 → 不自动判定，见下方「冲突处理」请用户拍板 |
+| 有章节分隔符，但章节数 < 5 | 结构信号不明确 → 进入优先级 3 字数兜底 |
+| 分隔符模式模糊（如仅有单个标题行） | 结构信号不明确 → 进入优先级 3 字数兜底 |
+
+---
+
+## 优先级 3：字数兜底
+
+**仅在优先级 1、2 均无法给出明确判定时使用。** 当前导入契约按短篇通常 8000-20000 字的区间取 30000 字作建议上界，并保留题材差异余量。
+
+| 条件 | 判定 | 备注 |
+|------|------|------|
+| 总字数 < 30000 且无章节结构 | **短篇** | — |
+| 总字数 ≥ 30000 | **长篇** | — |
+| 章节数 ≥ 5（任意字数） | **长篇** | — |
+| 总字数 < 30000 但章节数 ≥ 5 | 初判**长篇**，但须提示用户 | 见下方「分章短篇连载」 |
+
+> **建议值说明**：30000 字阈值是估算值，不同平台和题材的短篇上限有差异。执行时列入 open-questions，建议用户复核是否适用于当前导入书。
+
+### 分章短篇连载
+
+检测到总字数 < 30000 但章节数 ≥ 5 时，在确认环节提示用户：
+
+> 「检测到分章结构（共 {N} 章），但总字数约 {X} 字，低于 30000 字。可能是分章短篇连载。确认按长篇导入，还是按短篇处理？」
+
+用户拍板后锁定类型。
+
+---
+
+## 冲突处理
+
+当不同信号之间出现矛盾时，**不自动决策**，回到 Phase 1 向用户复述检测结果：
+
+| 典型冲突场景 | 处理方式 |
+|------------|---------|
+| 用户说「短篇」但检测到 20 章 | 复述：「检测到 20 章章节结构，通常属于长篇。确认按短篇导入？」由用户拍板 |
+| 用户说「长篇」但全文无章节分隔且字数 < 30000 | 复述：「全文无章节分隔，总字数约 {X} 字，通常属于短篇。确认按长篇导入？」由用户拍板 |
+| 用户未声明、全文无章节分隔、单文件单篇，但字数 ≥ 30000 | 复述：「全文无章节分隔，但总字数约 {X} 字，已超过短篇常见上界。按长篇导入建工程，还是仍按短篇处理？」由用户拍板 |
+| 结构信号与字数信号方向相反 | 展示两项信号，请用户决定 |
+
+用户拍板的结果写进导入记录（`{书目录}/.story/work/导入记录.md` 的「篇幅」），后续时刻以此为准，不再重新判定。
+
+---
+
+## 判定结果与后续路径
+
+判定完成后，迁移路径按以下对应关系分流：
+
+| 判定结果 | 迁移路径 | 映射规则参考文件 |
+|---------|---------|----------------|
+| **长篇** | 长篇迁移路径（Phase 3-L） | `structure-mapping-long.md` |
+| **短篇** | 短篇迁移路径（Phase 3-S） | `structure-mapping-short.md` |
+
+> 注：`structure-mapping-long.md` 对应长篇迁移映射规则，`structure-mapping-short.md` 对应短篇迁移映射规则。
+
+---
+
+## 快速判定流程图
+
+```
+Phase 1 问用户：「长篇还是短篇？」
+         │
+         ├─ 用户明确回答 ──────────────────────────► 锁定类型
+         │
+         └─ 未回答 / 不确定
+                  │
+                  ▼
+         检测章节分隔符
+                  │
+                  ├─ 有分隔符且章节数 ≥ 5 ──────────► 长篇
+                  │
+                  ├─ 无分隔符，单文件单篇，< 20000 ─► 短篇
+                  │
+                  ├─ 无分隔符，单篇，20000 ≤ 字数 < 30000 ─► 短篇（复述时告知超出建议上界）
+                  │
+                  ├─ 无分隔符，单文件单篇，≥ 30000 ─► 提示用户裁定
+                  │
+                  └─ 信号不明确
+                            │
+                            ▼
+                   字数兜底判定（30000 字阈值）
+                            │
+                            ├─ < 30000 且无章节结构 ─► 短篇
+                            ├─ ≥ 30000 ─────────────► 长篇
+                            ├─ 章节数 ≥ 5 ──────────► 长篇
+                            └─ < 30000 但章节数 ≥ 5 ─► 提示用户裁定
+```

package/resources/skills/story-creation/upstream/skills/story-import/references/outline-reverse-rules.md

@@ -0,0 +1,79 @@
+# 细纲反推规则与模板（长篇导入）
+
+本文件是逐批反推细纲任务包的正文，由 `build_outline_brief.py` 整份放进任务包，不单独加载。
+
+## 反推原则
+
+- 对本批每一章，从任务包里该章的摘要要点反推 `大纲/细纲_第XXX章.md`；要点写「摘要未写」又必须写实际内容时，回看该章正文相关段落补证据，不改正文。
+- 字数目标写任务包里测好的历史长度（`visible_chars_v1` 下的实际长度），不是重新决定创作目标，不自己估算。
+- 单元ID 取任务包附的卷纲「剧情单元（反推）」行里包含本章的单元；单元内第几拍判断不出写 `[待补充]`。
+- 钩子、人物关系变化、辅线/感情线、行动成本/收益归属等无法由原文摘要稳定判断的字段统一标 `[待补充]`；只反推有证据的蓝图，不为补齐字段编造关系或副线。已写成的历史章「本章禁止提前释放」写「无」；目标情绪与主角目标/关键选择不接受 `[待补充]`。
+
+## 字段映射
+
+| 摘要字段 | 细纲字段 | 转换方式 |
+|---------|---------|---------|
+| 关键事件 + 局面结果 | 核心事件 | 合并为“谁采取什么行动 → 局面如何变化”；旧摘要没有 `局面结果` 时只用 `关键事件` |
+| 章节字数 | 字数目标 + 字数口径 | 写任务包里测好的 `actual` 与 `visible_chars_v1` |
+| `基调：` + 状态变化 | 目标情绪 | 写成「前状态→后状态」：用基调枚举（紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他）加本章状态变化归纳，不只写一个情绪词；必须写实际内容 |
+| 关键事件 + 主角行动 | 主角目标/关键选择 | 原文里主角本章要什么、做了什么判断或选择；必须写实际内容 |
+| 所属剧情单元 | 单元ID/位置 | 取反推卷纲「剧情单元」表里包含本章的单元ID；单元内第几拍判断不出写 `[待补充]` |
+| （历史章） | 本章禁止提前释放 | 已写成的章节写「无」 |
+| 章尾钩子 | 章首承接证据 | 作为下一章开篇需要承接的等待；新的章首钩子设计目标仍标 `[待补充]` |
+| 爽点类情节点 | 爽点 | 从情节点类型推断；没有则写“无显性爽点 / [待补充]” |
+| 情节点起承转合 + 因果 | 内容概括（起因/发展/转折/高潮/结尾） | 按情节点顺序归纳，用因果链校正起因与转折；证据不足写 `[待补充]` |
+| 主线/支线/任务线索 | 情节安排（主线/辅线/事件线/感情线/逻辑线） | 从剧情单元索引与摘要反推；无证据的辅线/感情线写“无”或 `[待补充]`，不得杜撰 |
+| 涉及 + 状态变化 | 人物关系和出场顺序 | `涉及` 给出候选人物，`状态变化` 只写有证据的“前 → 后”；关键物件从证据或旧情节点补充，缺失写 `[待补充]` |
+| 全部情节点 | 情节细化 / 情节点序列 | 按表格逐行写（# / 情节点 / 功能标签 / 执行边界）；保持原顺序，功能或边界不明写 `[待补充]`，不反推逐点字数配额 |
+| 胜负/反转/收益损失 | 行动成本（可无）/收益归属 | 有明确证据才填写；行动成本可无、不硬造；否则 `[待补充]` |
+| 章尾钩子 + 局面结果 | 结尾设定和钩子 | 结尾设定写原文落到最后的具体动作或画面，章尾钩子写已存在的等待；未来设计仍标 `[待补充]` |
+
+## 细纲模板
+
+```markdown
+## 细纲（第 N 章）
+
+### 第 N 章：{章名}
+- 核心事件：{从摘要中提取}
+- 字数目标：{任务包里的 actual} 字
+- 字数口径：visible_chars_v1
+- 单元ID/位置：{反推卷纲里本章所属剧情单元ID；单元内第几拍，判断不出写 [待补充]}
+- 目标情绪：{前状态→后状态，从基调与状态变化归纳，不只写一个情绪词；必须写实际内容}
+- 主角目标/关键选择：{原文里主角本章要什么、做了什么判断或选择；必须写实际内容}
+- 章首钩子：[待补充]
+- 爽点：{从情节点推断；无明确证据写 [待补充]}
+- 本章禁止提前释放：无
+
+#### 内容概括（五段式）
+- 起因：{从情节点归纳；未知写 [待补充]}
+- 发展：{从情节点归纳；未知写 [待补充]}
+- 转折：{从情节点归纳；未知写 [待补充]}
+- 高潮：{从情节点归纳；未知写 [待补充]}
+- 结尾：{原文最后落在什么动作/画面/台词上；未知写 [待补充]}
+
+#### 情节安排（多线）
+- 主线推进：{从剧情单元索引/摘要反推}
+- 辅线推进：{无证据写“无”或 [待补充]}
+- 事件线 / 任务线：{外部事件链}
+- 感情线 / 关系线：{有证据才写；否则“无显性”或 [待补充]}
+- 逻辑线：原因 → 行动 → 结果 → 后果/新问题
+
+#### 人物关系和出场顺序
+- 出场顺序：{摘要中角色/势力/关键物件出现顺序}
+- 人物关系变化：{本章前 → 本章后；未知写 [待补充]}
+- 视角/信息差：{谁知道什么；读者知道什么；主角误判什么；未知写 [待补充]}
+
+#### 情节细化
+- 情节点序列（逐行填下表；从摘要情节点反推）：
+
+| # | 情节点（谁做了什么） | 功能标签 | 执行边界 |
+|---|---|---|---|
+| 1 | {} | {功能不明写 [待补充]} | {从原文确认本点没有释放什么；未知写 [待补充]} |
+- 行动成本（可无）/收益归属：{有证据才写；行动成本可无、不硬造；未知写 [待补充]}
+
+#### 结尾设定和钩子
+- 结尾设定：{原文落到最后的具体动作或画面；未解决问题；下一章推动力；未知写 [待补充]}
+- 章尾钩子：[待补充]
+```
+
+每章一个文件，文件名 `大纲/细纲_第XXX章.md`（三位补零，与 `正文/第XXX章_*.md` 同号）。