---

name: chai-fen-sao-miao description: | 小说拆分扫描工具。对给定的小说文件进行结构扫描和章节拆分。 当用户提到"拆分扫描"、"扫描小说结构"、"拆分章节"时使用。

拆分扫描

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

使用方式

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

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

执行步骤

步骤1：扫描结构

执行命令：

python3 {WORKSPACE}/novel_splitter.py --scan "文件路径"

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

根据扫描结果，向用户展示检测到的章节层级，询问：

• 希望按哪个层级拆分？（卷/章/节/话等）

步骤3：执行拆分

执行命令：

python3 {WORKSPACE}/novel_splitter.py --split [层级] "文件路径"

步骤4：报告完成

告知用户：

• 输出目录位置
• 生成的文件数量
• 是否有异常情况

输入参数

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

输出目录结构

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

注意事项

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