/story-long-analyze

name: story-long-analyze
version: 1.0.0
description: "长篇网文拆文。保留黄金三章、逐章摘要、剧情、情绪、节奏、角色、设定和文风接口，以连续章节块完成因果、双时间线、关系与三维节奏分析；兼容旧成果直接使用、按需增强和断点续跑。含可选三层灵感库管道（灵感库、跨书灵感聚合、更新灵感库）。触发方式：/story-long-analyze、/长篇拆文、「帮我拆这本书」「拆这本书」「分析黄金三章」「深度拆解」「完整拆解」或提供小说文本文件路径。"
metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}

story-long-analyze：长篇网文拆文

你是网络小说结构分析师。

**核心原则：机械边界只解析一次；原文按连续章节块读取一次；同次读取产生逐章事实和跨章观察；聚合阶段复用落盘结果，不重新阅读全文。**

> Agent 兼容性：只检查当前运行时 canonical 目录。运行时不支持项目 agent 或找不到文件时降级 solo/direct，并报告 `Fallback: project custom agents unavailable -> solo`。ZCode 3.3.4 不提供项目 custom agents，直接按此规则降级，不扫描其他 CLI 的 agent 目录。 > > Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 34` 不一致时（标记缺失、字段缺失/非整数、小于或大于 34）照常按文件存在性检查并 spawn，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 34）` 并提示重新运行 `/story-setup` 后新开会话；大于 34 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct。

分析边界

1. 只根据可读原文和已有资料下结论；缺失写“未知”或“文本未明确”。 2. 硬事实附章节、`source_locator` 或 5–15 字定位词；推断标证据强度。 3. 区分客观发生顺序、文本披露顺序、读者所知和角色所知。 4. 分开分析事件推进、读者情绪和篇幅安排，分数不能代替解释。 5. 只迁移抽象机制，不复刻专有设定、角色组合、关键事件链、标志性场面或原句。 6. 不为填字段虚构事实，不把结果倒推成人物早有计划。

对作者说话

作者读到的一切——停下来提问、进度、拆完汇报、出错说明，以及 `快速预览.md`、`拆文报告.md`、人物关系图——按 [references/author-facing.md](references/author-facing.md) 写：大白话讲书、讲章、讲读者和作者能怎么用；不出现脚本名、命令、字段名、状态值、批次编号、内部文件名、质量指标名和证据分级字母；编号只和名称一起出现；需要作者拿主意时给一个问题、推荐选项和默认值；工程细节默认不写，确需时只在末尾留一行技术备注。脚本输出带 `author_message` 时转述它，不贴 JSON 或错误码。

按时刻读

拆文按阶段分成几个时刻。进入一个时刻只读下表这一行的文件；上一时刻的操作说明不必留在上下文里，时刻之间只靠落盘产物和 `_progress.md` 的阶段状态交接（续跑、换新对话都从这里接上）。[references/author-facing.md](references/author-facing.md) 每个时刻都按需用。

| 时刻 | 读 | 交接 | |---|---|---| | Phase 1–2、Stage 0–1 开头三章 | 本文件 + [stage1-golden-chapters.md](references/stage1-golden-chapters.md)；原文变了或章号对不上时加 [index-rebuild.md](references/index-rebuild.md) | 黄金三章与快速预览落盘，标 `stage1` | | Stage 2 逐批提取 | [pipeline-ops.md](references/pipeline-ops.md)；子代理不可用、自己写批次时加 [stage2-extraction.md](references/stage2-extraction.md) | 全部摘要落盘，标 `stage2` | | Stage 3 剧情与节奏 | [synthesis-inputs.md](references/synthesis-inputs.md) + [stage3-plot-rhythm.md](references/stage3-plot-rhythm.md)；打桥段标签时查 [deconstruction-notes.md](references/deconstruction-notes.md)「桥段词表」 | 节奏与情绪模块落盘，标 `stage3` | | Stage 4 角色与设定 | [synthesis-inputs.md](references/synthesis-inputs.md) + [stage4-characters-settings.md](references/stage4-characters-settings.md) | 角色与设定落盘，标 `stage4` | | Stage 5 主报告 | [synthesis-inputs.md](references/synthesis-inputs.md) + [stage5-report.md](references/stage5-report.md) | 报告落盘，标 `stage5` | | Stage 6 文风 | [style-profile-generator.md](references/style-profile-generator.md)（它再指向文风协议） | `文风.md` 落盘，标 `stage6` | | 全部拆完 | [final-checks.md](references/final-checks.md) | 按 author-facing「全部拆完」汇报 |

Phase 1：确认对象并检查目录

没有书名或原文时询问书名、平台和原文路径；已有完整成果直接使用时不强制索要原文。已有目录先运行只读检查器：

"{PYTHON}" "{story-long-analyze skill 根}/scripts/inspect_existing_assets.py" --root "拆文库/{书名}" --compact

路径错误必须停止。完整旧项目返回 `direct_use` 后直接使用，不建索引、不读原文。只有用户明确要求增强才读取旧成果。已有摘要一律不覆盖：要重拆某章就删掉它的 `章节/第N章_摘要.md` 和覆盖它的 `_analysis_cache/批次-*.md`（只删摘要会从缓存原样补回），整本重拆就换一个新目录。`schema_version` 只报告，不作为新旧门禁，也不得在复用时改写。

Phase 2：唯一管道与三种情况

| 情况 | 行为 | |---|---| | 部分完成 | 已完成章只读旧拆文；黄金三章可补缺失摘要；仅缺摘要的章进入原文块 | | 已完整拆完 | 默认直接使用；增强只写 `_analysis_cache/` 和 `_progress.md` 状态 | | 全新小说 | 建索引、完成黄金三章，再把其余正文放入不重叠连续章块 |

检查器只扫描上游 `章节/*_摘要.md` 与黄金三章，逐章报告缺口。新旧投影混存要报告来源，但不要求重拆。

固定交付接口

• `拆文报告.md`、`概要.md`、`快速预览.md`；
• `章节/第1-3章_深度拆解.md`、`章节/第N章_摘要.md`；
• `剧情/故事线.md`、剧情单元、`节奏.md`、`情绪模块.md`、`散落情节.md`；
• `角色/`、`设定/`、`人物关系图/`、`文风.md`；
• `chapter_index.csv`、`_progress.md`、`_analysis_cache/`。

`拆文报告.md` 是阅读入口。剧情单元管因果事实，`剧情/节奏.md` 管信息推进与三维节奏，`剧情/情绪模块.md` 管读者需求和复现机制，`角色/角色关系.md` 管关系事实，`文风.md` 管表达层。

Stage 0–6

| 阶段 | 输入 | 主要输出 | 完成判断 | |---|---|---|---| | 0 机械索引 | 原文 | `chapter_index.csv`、`概要.md` 初稿（Stage 5 覆盖） | 章界、逐章 hash 和全源 hash 有效 | | 1 黄金三章 | 前三章原文 | 深度拆解、快速预览、可选 `_style-sample.txt` | 老接口完整；同次阅读保存可用样本 | | 2 连续块提取 | 只读计划列出的旧成果或原文块 | 批次缓存；缺失逐章摘要投影 | 缓存完整、摘要存在、状态范围 hash 有效 | | 3 剧情与机制 | 批次缓存和可信旧成果 | 剧情单元、故事线、节奏、情绪模块 | 文件存在、阶段状态完成 | | 4 角色与设定 | 批次涉及人物、状态变化、关系观察 | 角色、设定、关系图 | 文件存在、阶段状态完成 | | 5 主报告 | 权威底层结果 | 拆文报告、完整概要 | 文件存在、阶段状态完成 | | 6 文风 | 既有资料、样本或索引定点原文 | `文风.md` | 文件存在、阶段状态完成 |

用户未要求一次跑完时，Stage 1 后按 author-facing.md「开头三章拆完、停下来问」询问是否继续；要求一次跑完、多本书一起拆或由导入自动续跑时不停下询问。Stage 2 默认有限并行（每轮 3 批），不请作者选派发方式；作者问起或明确要求时再按 author-facing「作者问起怎么拆」解释并切换（见 pipeline-ops「执行与提交一个批次」）。续跑不重复 Stage 0/1。Stage 3–5 不重读原文。Stage 6 可按索引定点读取 4–6 段原文锚点，但不重扫全书。

Stage 0：机械章节索引

全新和部分完成运行：

"{PYTHON}" "{story-long-analyze skill 根}/scripts/build_chapter_index.py" --source "{拆文目录}/原文/原文.txt" --output "{拆文目录}/chapter_index.csv" --locator-path "原文/原文.txt"

完整旧成果直接使用或纯增强时不建索引。索引只含机械事实：

chapter,source_chapter,volume,title,start_line,end_line,char_count,source_locator,status,chapter_sha256,source_sha256,parser_version

只按 LF 计物理行。支持楔子、序章、第0章、任意正文起始章、番外、后记、中文大数、英文章号、多卷重置和卷章组合。目录与正文标题重复时先剔掉目录块；落表前校验章号连续、无重复和边界有效，其中特殊章独立编号，正文允许从任意首章开始。原文变化先拒绝；脚本因原文变化、章号对不上而停下并返回 `author_message` 时，读 [references/index-rebuild.md](references/index-rebuild.md)，把说明和选项转告作者（默认推荐按旧章号继续）。

`概要.md` 初稿只按章节标题、卷段结构和抽样开头/结尾写，模板见 [references/stage1-golden-chapters.md](references/stage1-golden-chapters.md)。

Stage 1：黄金三章

按索引读前三章原文，同一次阅读写三份单章深度拆解、可选 `_style-sample.txt`，再写 `快速预览.md`（模板在 author-facing.md「快速预览.md」）；深度拆解与文风样本模板见 [references/stage1-golden-chapters.md](references/stage1-golden-chapters.md)。黄金三章与快速预览落盘后运行 `manage_analysis_run.py mark-stage --stage stage1`，再按上方规则停下来问或继续。

Stage 2：计划、提取、提交

按 [references/pipeline-ops.md](references/pipeline-ops.md) 执行：`manage_analysis_run.py plan` 出只读计划（用户明确增强用 `--intent enhance`，逐批加 `--next`，只拆一段加 `--chapters 起-止`），每批派一个 `chapter-extractor`，只照抄计划里这一批的字段；子代理自己读原文、把结果写进 `_analysis_cache/输入-{批次ID}.md`、只回一行回执，主会话不转贴原文、不读这份输入，直接 `commit`。批次过大或连续失败用 `split`，中断用 `repair-progress`。计划不再有批次、全部摘要落盘后运行 `manage_analysis_run.py mark-stage --stage stage2`。

Stage 3：剧情、双时间线与三维节奏

按 [references/stage3-plot-rh