# Chai Fen Sao Miao

> 小说拆分扫描工具。对给定的小说文件进行结构扫描和章节拆分。 当用户提到"拆分扫描"、"扫描小说结构"、"拆分章节"时使用。

- Skill: `anarcadia/chai-fen-sao-miao` (Agent Skill)
- Install (CLI): `npx skillmds@latest add anarcadia/chai-fen-sao-miao`
- Raw SKILL.md: https://api.skillmd.com/api/skills/anarcadia/chai-fen-sao-miao/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: anarcadia (https://skillmd.com/u/anarcadia)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/anarcadia/chai-fen-sao-miao

---


# 拆分扫描

小说拆分扫描工具。对给定的小说文件进行结构扫描和章节拆分。

## 使用方式

用户提供小说文件路径，执行以下流程：

1. **扫描阶段**：调用 Python 脚本扫描小说结构
2. **报告阶段**：展示扫描结果，询问用户拆分粒度
3. **拆分阶段**：按用户指定的层级执行拆分
4. **完成报告**：展示拆分结果

## 执行步骤

### 步骤1：扫描结构

执行命令：
```bash
python3 {WORKSPACE}/novel_splitter.py --scan "文件路径"
```

### 步骤2：展示报告并询问用户

根据扫描结果，向用户展示检测到的章节层级，询问：
- 希望按哪个层级拆分？（卷/章/节/话等）

### 步骤3：执行拆分

执行命令：
```bash
python3 {WORKSPACE}/novel_splitter.py --split [层级] "文件路径"
```

### 步骤4：报告完成

告知用户：
- 输出目录位置
- 生成的文件数量
- 是否有异常情况

## 输入参数

用户输入 - 小说文件路径（支持 txt、epub、md 格式）

## 输出目录结构

```
Factory/拆书/{书名}/
├── {书名}.txt           # 源文件（拆分后自动移入）
├── 拆分/
│   ├── 001_第一章_xxx.md
│   ├── 002_第二章_xxx.md
│   └── ...
├── 概括/                # 后续概括生成
├── 人物和设定/          # 后续分析生成
└── 全书概括.md          # 后续概括生成
```

## 注意事项

- 如果未检测到标准章节结构，提示用户可能需要手动指定或检查文件
- 无法识别的内容会合并到前一个已识别章节
- 支持的拆分层级：卷、部、篇、章、集、回、话、节
- **项目目录命名**：统一使用 `{书名}/` 格式（不带书名号），与源文件名保持一致
- **源文件处理**：拆分完成后，源文件自动移动到项目目录下，保持与目录同名
- **防嵌套机制**：
  - 脚本会自动检测并避免创建嵌套目录结构
  - 如果检测到已存在的嵌套目录（如 `书名/《书名》/`），会自动合并到父目录
  - 支持检测和清理带书名号的嵌套目录（《》、「」等）