Chapter Outliner - 章节大纲生成器

Overview

根据小说项目文件（outline.md, style.yml, characters/）和章节号，自动生成结构化的 15 节拍章节大纲，包含字数分配、角色参考和风格备注。

使用场景：

• 需要为具体章节创建详细写作大纲
• 需要确保章节符合 15 节拍结构
• 需要分配字数到各个节拍
• 需要整合角色档案和风格配置

15 节拍系统

CLI 使用

# 基本用法
python3 scripts/generate_outline.py --book-dir projects/my-novel --chapter 1

# 指定字数
python3 scripts/generate_outline.py \
  --book-dir projects/my-novel \
  --chapter 5 \
  --word-count 5000

# 输出到文件
python3 scripts/generate_outline.py \
  --book-dir projects/my-novel \
  --chapter 10 \
  --output outlines/chapter-10.md

# 简写
python3 scripts/generate_outline.py -d ./project -c 5 -w 3000 -o output.md

参数说明

项目目录结构

projects/my-novel/
├── outline.md          # 故事大纲（可选）
├── style.yml           # 风格配置（可选）
├── characters/         # 角色档案（可选）
│   ├── 主角.yml
│   └── 配角.yml
└── chapters/
    └── outlines/       # 章节大纲输出

输出大纲格式

# 第 1 章 大纲

**字数目标**: 3000 字
**生成时间**: 2026-04-04 23:30:00

## 章节概述
[来自 outline.md 的章节摘要]

## 15 节拍大纲

### 1. 钩子 (铺垫)
**目标字数**: 135 字
**目的**: 建立场景和基础信息

第 1 节拍 - 待填充

### 2. 设定 (铺垫)
**目标字数**: 157 字
**目的**: 建立场景和基础信息

第 2 节拍 - 待填充

...

## 角色参考

### 林风
私家侦探，35 岁，冷静敏锐...

字数分配规则

依赖

• Python 3.8+
• rich (终端渲染)
• PyYAML (配置文件解析)

安装依赖：

pip install -r scripts/requirements.txt

与其他技能集成

与 style-analyzer 集成

# 1. 分析参考文本风格
python3 ../style-analyzer/scripts/analyze_style.py \
  --input reference.txt \
  --output style.yml

# 2. 生成章节大纲（自动读取 style.yml）
python3 scripts/generate_outline.py \
  --book-dir projects/my-novel \
  --chapter 1

与 novel-writer 集成

# 1. 生成章节大纲
python3 scripts/generate_outline.py \
  --book-dir projects/my-novel \
  --chapter 5 \
  --output chapters/outlines/chapter-5.md

# 2. novel-writer 根据大纲生成正文

注意事项

• 项目文件（outline.md, style.yml, characters/）均为可选
• 缺少文件时会自动使用默认值
• 输出 Markdown 可直接用于 novel-writer 输入
• 15 节拍名称和阶段可自定义修改