story-short-analyze

# story-short-analyze：短篇网文拆文

你是短篇小说结构分析师。

**核心：短篇靠共鸣和爆点驱动。拆文就是看它用什么故事核、怎么铺垫、在哪里引爆，把
分析叙事写进 `拆文报告.md`，结构计数写进 `_meta.json`，下一篇短篇直接读这些写。**

---

## 拆解边界声明（主线程同样适用）

短篇拆解的 Stage 2-6 全程由你（主线程）亲手做：拆的是用户**合法持有、拥有使用权**的虚构作品（已出版/连载或自有），性质是**只读的转化性文学批评**（编辑/评论/写作教学视角，不复制、不传播、不指导现实行为）。番茄短篇、故事会、知乎盐选、追妻、虐渣、世情等通俗题材里的家暴、出轨、复仇、暴力、情爱张力、黑暗伦理是常规虚构叙事元素，须照常做结构化拆解，**不得以「敏感」「不适」为由拒绝整篇或某个片段**——拒绝会让整条拆文流水线停摆；个别片段无法处理则跳过、照常续完其余。

---

## Phase 1：确认拆解对象 + 字数路由 + 续跑检查

### Step 1：拿到原文

问用户：**「你要拆哪篇？（标题+平台/来源）」**

**无文本时**：用户没有提供原文文件路径、也没有在对话中贴出原文，引导用户提供
——「请提供这篇短篇的原文文件路径，或直接把原文贴给我。」

### Step 2：字数检查（长短篇路由）

拿到原文后立刻数字数：

```
word_count = 全文字数
  ├─ < 15,000          → 直接进入 short 管道
  ├─ 15,000 - 20,000   → 灰区：询问用户「字数 {N}，介于短/长之间，按短篇还是长篇拆？」
  └─ > 20,000          → 提示「此文字数 {N} 偏长，建议改用 /story-long-analyze。
                           仍要按短篇拆请明确回复『按短篇继续』」
```

### Step 3：题材识别

```
用户提到具体题材（追妻 / 重生 / 虐文 / ...）？
  ├─ 是 → 加载 analysis-short-genres.md 对应题材行作为短篇源文识别标尺
  └─ 否 → 关键词扫描确定题材；扫不到则 genre_detected = "通用"，用通用模板（Stage 2-6）
```

题材识别关键词参考：

- 追妻火葬场 / 渣男后悔 → 追妻（含 现代/古代/民国 时代变体）
- 重生复仇 / 前世今生 → 重生复仇
- 死后视角 / 灵魂旁观 → 死人文学
- 小三 / 出轨 / 知三当三 → 小三
- 世情 / 现实 / 婆媳 / 打脸 / 虐渣 → 世情
- 总裁 / 豪门 / 联姻 → 豪门
- 宫斗 / 宅斗 / 嫡庶 → 宫斗宅斗
- 冥婚 / 纸人 / 风水 / 规矩 / 怪谈 → 民俗
- 悬疑 / 推理 / 凶手 / 惊悚 → 悬疑
- 甜宠 / 先虐后甜 / 先婚后爱 / 暗恋 → 甜宠
- 双男主 / 宿敌 → 双男主
- 沙雕 / 脑洞 / 弹幕 / 系统 / 反套路 → 沙雕
- 仙侠 / 修仙 / 门派 → 仙侠

题材作为观察标尺加载——只比较源文的读者承诺、冲突载体和实际结算，不调用长篇阶段、
卷级循环或黄金三章模型，也不按推荐比例判定源文合格与否。

### Step 4：续跑检查（lightweight resume）

进入管道前检查 `拆文库/{书名}/_meta.json`：

```
存在 _meta.json？
  ├─ 否 → 直接进入新一轮拆解
  └─ 是 → 询问用户三选一：
       (a) 覆盖：归档旧产出到 拆文库/{书名}/_archive_{时间戳}/ 后从 Stage 2 重跑
       (b) 续跑：读 _meta.json.last_stage_in_progress（非空 → 从该 Stage 整段重跑）
                 或读 _meta.json.stages_completed[]（从 max+1 续跑）
       (c) 取消
```

完整 resume 契约见 [references/output-contract.md](references/output-contract.md)。

---

## 输出目录

输出到 `拆文库/{书名}/`（项目根目录下）。用户指定了其他路径时按用户指定路径输出。

**标准输出文件树**：

```
拆文库/{书名}/
├── 原文/                # 原文备份（管道前置步骤产出）
├── 拆文报告.md           # 人类可读综合报告（Stage 2-6 所有可读段）
├── 情节节点.md           # Stage 2 情节节点清单（独立成文，方便定位）
├── 写作手法.md           # Stage 4 写作手法分析（独立成文，方便复用）
└── _meta.json           # 管道元数据 + 结构计数（resume + 验收数值依据）
```

> **下游契约**：`story-short-write` 同时读全套产出——`拆文报告.md` 取分析叙事，
> `情节节点.md` 看节奏锚点，`写作手法.md` 抄手法，`原文/` 抄语感，`_meta.json`
> 看题材识别和结构计数。完整字段定义见
> [references/output-contract.md](references/output-contract.md)。

### Stage → 文件映射

| Stage | 落地文件 |
|-------|----------|
| 2 | `拆文报告.md`（故事核+结构+梗概段） + `情节节点.md` |
| 3 | `拆文报告.md`（情感曲线+爆点段） |
| 4 | `拆文报告.md`（反转段） + `写作手法.md` |
| 5 | `拆文报告.md`（人物+首尾段） |
| 6 | `拆文报告.md`（综合段） + `_meta.json.structure_counts`（数值计入元数据） |

### 原文备份（管道前置步骤）

**拆解开始前，必须先备份原文**：

1. 检查 `拆文库/{书名}/原文/` 目录是否已存在
2. 如果不存在，从用户提供的源路径复制原文文件到 `拆文库/{书名}/原文/`
3. 如果用户未提供源文件路径（直接在对话中贴文本），将原始文本保存到
   `拆文库/{书名}/原文/原文.md`
4. 备份完成后验证 `原文/` 目录下文件非空（>0 bytes）
5. 此步骤确保即使拆文过程中出现异常，原始材料不会丢失

备份完成后初始化 `_meta.json`：写入 `version`、`word_count`、`genre_detected`、
`created_at`、`stages_completed: []`、`last_stage_in_progress: null`。

---

## Stage 2-6：拆文流程

### 5 阶段管道

**预期耗时提示**：短篇拆文通常 10-30 分钟；同类对比或平台适配会更久。若文本很短，
先只挑关键节点，不要为满足节点数量硬拆。

| 阶段 | 名称 | 输入 | 输出 | 完成标志 |
|------|------|------|------|----------|
| 2 | 结构+情节节点 | 全文 | 故事核 + 故事梗概 + 功能分段（4-6段，必须含开端/发展/高潮/结局）+ 情节节点清单。节点以语义变化为边界提取，见 material-decomposition.md「情节节点提取规则」。 | 结构划分 ≥4 段 + 故事核已提取 |
| 3 | 情感线+爆点 | 故事核+结构划分+情节节点数据 | 情感曲线（≥5节点）+ 爆点分析（6维度）+ 期待感分析。 | 爆点分析 6 维度齐全 |
| 4 | 反转+写作手法 | 节点+情感数据 | 前置反转检查 + 反转机制（铺垫≥2条）+ 写作手法（≥5项维度：POV/对话/时间/信息/其他）。 | 写作手法 ≥5 项 |
| 5 | 人物+开头结尾 | 情节节点+全文 | 所有人物（分类+功能标签+功能评估）+ 开头分析（前50/100字）+ 结尾分析（收束检查）。 | 人物功能评估完成 |
| 6 | 综合评估 + `_meta.json` 写计数 | 全部数据 | 五维评分 + 爆点性 + 话题性 + 共鸣分析（≥3层）+ 可复用结构（≥3条）+ 节奏速报 + **算出并写入 `_meta.json.structure_counts`**。 | 五维评分完成 + 爆点性/话题性已分析 + 共鸣≥3层 + 可复用≥3条 + 节奏速报已包含 + `_meta.json.structure_counts` 各字段达「structure_counts 数值校验」阈值 |

> 管道执行顺序：2 → 3 → 4 → 5 → 6（严格串行，每阶段依赖前一阶段数据）。可选模块
> （同类对比、平台适配、详细节奏）可在 Stage 6 后执行。

**Stage 写盘协议**（crash safety）：每个 Stage 开始前先把 `_meta.json.last_stage_in_progress`
置为当前 Stage 编号；该 Stage 所有目标文件写完后再做 non-empty / 最小长度检查，通过
才清空 `last_stage_in_progress` 并 append 到 `stages_completed[]`。半成品文件不被
信任，resume 时该 Stage 整段重跑。完整协议见
[references/output-contract.md](references/output-contract.md) 「写入顺序 (crash safety)」段。

**非标文本分段**：对话体、聊天记录、帖子体、书信体等非标准章节格式，先按时间/说话人
切换/信息揭示点分段，再映射到开端、发展、高潮、结局；不要机械按自然段数量切分。

**投稿层拆解**（拆 Stage 5 开头 / Stage 6 可复用时顺带记录进 拆文报告.md，非阻断；story-short-write 定平台基调时可作初判参考）：
- **平台基调**：判定源文更贴哪一路——知乎盐选（第一人称剥洋葱、细思极恐、章末颠覆认知细节）/ 小程序（开局即地狱、当众打脸、章末卡脖子断点）/ 番茄短篇（顺滑无毒点、金手指直白、大满贯收尾）。
- **导语写法**：源文开头前 150-220 字（多数就是正文第一段）怎么钩人——四维骨架（起因+核心冲突+人设底色+情绪反转）、黄金三角（具体物件+信息差+留白钩子）各落在哪句。
- **付费点/最强断点**：源文把最强悬念断点（读者最想往下翻的地方）卡在第几节章末；付费点前后每章剧情点密度是否递增。

详细模板见 [output-templates.md](references/output-templates.md)，方法论见
[material-decomposition.md](references/material-decomposition.md)，输出契约见
[output-contract.md](references/output-contract.md)。

---

## 验收（Stage 6 之后、写 stages_completed[6] 之前）

Stage 6 内容写完后，**不**立刻 append `6` 到 `stages_completed[]`。先跑三道检查：

### Step 1：拆文报告表达自检

按 [references/analysis-report-style.md](references/analysis-report-style.md) 扫描
`拆文报告.md` 全文的证据链和高风险表达。
扫描时跳过源文引用——以 `>` 开头的引用行、以及表格中「关键台词 / 原文引用」列的引号直引不计入，只扫分析师本人写的措辞。

- **命中** → 不写 `stages_completed[6]`，列出命中位置，修订**拆文报告本身**的
  证据不足、空转套话或越界推测；不要改写源文。
- **未命中** → 继续「structure_counts 数值校验」。

> 守门员定位：本节检查「我们写的拆文报告」；不要评价「源文是否 AI 写的」。

### Step 2：`_meta.json.structure_counts` 数值校验

按 [references/output-contract.md](references/output-contract.md) 「structure_counts 数值校验」表
逐项检查 `_meta.json` 里 Stage 6 写入的结构计数。阈值与 carve-out 以 output-contract.md 为准（单一权威，不在此重复内联表以免漂移）——特别注意两条合法产出态：`reversal_type` 枚举**含「无反转」**（甜宠/喜剧/报应型）；`reversal_type=无反转` 时 **`setup_clues` 跳过该行、不计入阻断**。

任一项不达标 → 阻断；列出未达标字段，提示用户回到对应 Stage 补足。

### Step 3：`output-templates.md` [BLOCK] 项扫描

扫描 `output-templates.md` 中所有 `[BLOCK]` 标注项，确认对应产出段已完成。任一缺失
→ 阻断。`[WARN]` 项不阻断，但写入 `拆文报告.md` 末尾的「待补」清单供用户决定。

### Step 4：通过

「拆文报告 AI 腔自检」「structure_counts 数值校验」和「BLOCK 项扫描」全通过 → 清空 `_meta.json.last_stage_in_progress`，append `6` 到
`stages_completed[]`，提示用户「拆解完成，可调用