# Short Drama Novel Analyze

> 把小说、连载网文或多集散稿拆成有据可查的原著拆解：支持全书或按创作者指定章节范围（如前 100 章、第一季）分批完成章节索引、改编价值快评、逐章情节提取、剧情单元与爽点梳理、人物与设定跨卷演进整理，给出结合目标制作形态的改编取舍建议与分集候选，移交 $short-drama-develop 定改编方案。用户说“导入这本小说”“拆这本书”“先拆前一百章”“分析原著”“这本书能不能改短剧”“把小说拆成分集候选”，或直接给出小说文件路径时使用。

- Skill: `zenstory-ai/short-drama-novel-analyze` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx get-skill add zenstory-ai/short-drama-novel-analyze`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zenstory-ai/short-drama-novel-analyze/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: zenstory-ai (https://skillmd.com/u/zenstory-ai)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/zenstory-ai/short-drama-novel-analyze

---


# 原著拆解分析

从小说原文中拆出有据可查的剧情作用，看每一段戏推动了谁的抉择、揭开了什么秘密、或是扭转了人物强弱关系，并结合目标制作形态评估怎样落进短剧或漫剧改编。支持整本拆解，也支持按创作者指定的章节范围（如前 100 章、第一卷、第一季）分批完整拆解。

## 快速开始

离线验证章节索引、抽样和原文变更检测：

```bash
python3 {技能目录}/scripts/selftest.py
python3 {技能目录}/scripts/novel_index.py index <原著.txt> --out <chapter-index.json>
```

## 开始前与材料前提

- 本技能可独立运行；完整职责范围与规则见 [阶段规范](references/stage-contract.md)。
- 只拆解创作者合法持有、拥有使用权的作品。`输入/` 只读，拆解时不改原文、不整段照抄原句（只记章节位置、起止行号和剧情作用概括，必要佐证只摘最短词句），交付文件不夹带原始全文。
- 通俗题材里的暴力、复仇、背叛、情感拉扯与暗黑冲突照常提取剧情作用；个别片段无法处理时跳过并记明行号范围，不中断整章或整批拆解。

## 先判断入口

1. **只有书名，没有原文**：请创作者提供文件路径或粘贴正文，不凭书名回忆情节。
2. **有原文，未建目录**：建立只读输入目录 `输入/` 与工作目录 `项目开发/source-analysis/_work/`，把原文复制到 `输入/` 后用 `novel_index.py` 建索引。
3. **已有部分拆解结果**：读 `项目开发/source-analysis/_progress.md` 从上次进度接着跑（分批拆解新区间时直接续跑新增章节）。

## 拆解流程

全部产出落在 `项目开发/source-analysis/`（先写进 `_work/` 核对无误后再整份替换写入正式路径，若项目启用了台账也可配合 `project_tool.py`）。

| 阶段 | 做什么 | 产出 | 停顿条件 |
|---|---|---|---|
| S0 | 建章节索引（脚本） | `_index.json`、`_progress.md` | 仅零章节或索引损坏时停 |
| S1 | 改编价值快评（长篇未定范围时抽样） | `triage.md` | 短篇或已指定范围**不暂停** |
| S2 | 目标区间逐章情节提取 | `chapters/ch-<N>-extract.md` | 目标区间缺章时补齐 |
| S3 | 剧情单元汇总与爽点梳理 | `story-units.md`、`rhythm-and-emotion.md` | — |
| S4 | 人物合并与设定跨卷演进整理 | `characters.md`、`world.md` | — |
| S5 | 结合制作形态的改编取舍与分集候选 | `adaptation-value.md`、`episode-candidates.jsonl` | 移交 `$short-drama-develop` |

### S0 章节索引

各阶段共用 [章节索引脚本](scripts/novel_index.py) 建立的章节边界，不各自重新切分：

```bash
python3 {技能目录}/scripts/novel_index.py index 输入/{原文文件} \
  --out 项目开发/source-analysis/_work/_index.next.json
python3 {技能目录}/scripts/novel_index.py verify \
  项目开发/source-analysis/_work/_index.next.json 输入/{原文文件}
```

校验通过后将 `_work/_index.next.json` 写入正式 `_index.json`。脚本支持可选 Markdown 标题前缀（`#`–`######`）、阿拉伯与中文数字章号，按 `章 / 回 / 集 / 话 / 話 / 幕 / 节` 由粗到细自动选定主编号单位（其余记入 `ignored_heading_units`，也可传 `--unit` 指定），剔除开头目录块并分卷核对。

- **区分致命错误与源书常见瑕疵**：网文源书常见的作者跳章号、重章号或简短卷首语归入输出 JSON 的 `warnings` 提醒，脚本保持退出码 `0` 正常放行；只有完全识别不到章节（无章标题散稿，可与创作者约定切分后手写 `sequence` / `line_start` / `line_end` 再过 `verify`）、第一章前遗漏大段楔子正文（可在索引开头补一条 `source_number: null` 记录覆盖第 1 行起的正文），或索引自身断号、行区间断裂时，`problems` 非空并返回非零退出码拦截。原文一旦修改须重建索引。

### S1 改编价值快评

未定范围的超长篇按 [改编价值快评](references/adaptation-triage.md) 跑 `sample --count 12` 写出 `triage.md`，汇报建议拆解区间并请创作者确认；短篇作品、创作者已指定拆解范围或明确要求直接拆完时，**不在 S1 暂停等拍板**，直接进入 S2。

### S2 逐章情节提取

按 [逐章提取与人物设定整理](references/chapter-extraction.md) 将本批目标区间内的每章拆进 `chapters/ch-<N>-extract.md`（支持并行子任务时每批 5–8 章）。写完后核对覆盖情况：

```bash
python3 {技能目录}/scripts/novel_index.py coverage \
  项目开发/source-analysis/_index.json 项目开发/source-analysis/chapters [--start <起> --end <止>]
```

全书拆解时直接跑 `coverage`，按创作者指定区间（如 `sequence` 1–100）分批拆解时传 `--start 1 --end 100`；确认返回 `complete: true`（目标章齐全且无 `unmatched_files` 错名文件）即可进入 S3。

### S3 剧情单元与爽点梳理

基于 S2 提取结果（细节不清时按行号回查原文），按 [改编价值与分集候选](references/adaptation-value.md#故事框架与剧情单元) 写出 `story-units.md` 与 `rhythm-and-emotion.md`（含 [爽点表](references/adaptation-value.md#爽点表) 相对先后排序），并在文件开头注明本批覆盖的起止章号范围。

### S4 人物与世界观设定

按 [逐章提取与人物设定整理](references/chapter-extraction.md#人物合并与设定质变记录) 合并有原文实据的同人异名，记录人物立场身份与世界观规则、战力体系的**跨卷质变节点**及首次出场章号（未明确处写「原文未明确」），产出候选名单 `characters.md` 与 `world.md`。

### S5 改编取舍与分集候选

按 [改编价值与分集候选](references/adaptation-value.md#三类判定) 结合目标制作形态评估各剧情单元（区分实拍与动态漫/漫剧对心理吐槽及密集对话的不同承载力），写出 `adaptation-value.md` 与轻量级 `episode-candidates.jsonl`，完成后汇报本批覆盖章数、预计可改集数与主要改编注意点，移交 `$short-drama-develop`（如需独立把关可调 `$short-drama-review` 的 `source_analysis` 范围）。

## 按需加载

- **何时做抽样快评、短篇与指定范围免停规则**：[改编价值快评](references/adaptation-triage.md)
- **单章提取格式、载体记录、同人合并与人物设定跨卷质变记录**：[逐章提取与人物设定整理](references/chapter-extraction.md)
- **故事框架、剧情单元、爽点表、结合制作形态的三类判定与分集候选切法**：[改编价值与分集候选](references/adaptation-value.md)
- **本阶段职责边界与 `NVA` 规则分级**：[阶段规范](references/stage-contract.md)

