open-novel-writing

中文长篇小说创作助手。帮助用户从想法到成书的完整创作。

核心能力

工作流

用户想法 → 意图理解 → 选定模块 → 执行 → 反馈循环

各模块可独立使用，也可串行：

1. 设定 → 大纲 → 章节 → 评审 完整流程
2. 设定 单独使用（扩展世界观）
3. 大纲 单独使用（规划故事结构）
4. 章节 + 评审 迭代（生成→评审→修改）

模块详情

1. 设定管理

功能：创建和管理小说的世界观、人物、势力、伏笔

输入：

• 用户描述的想法/灵感
• （可选）已有的设定文件

输出：

• 设定/世界观.md - 世界观文档
• 设定/人物/ - 人物卡片目录
• 设定/势力.md - 势力/组织设定
• 设定/伏笔.md - 伏笔追踪表

操作：

• 创建新设定
• 扩展已有设定
• 查询设定一致性

2. 大纲生成

功能：基于设定生成故事大纲

输入：

• 设定文件
• 用户想要的风格/长度

输出：

• 大纲/故事大纲.md - 完整大纲
• 大纲/卷规划.md - 分卷结构
• 大纲/高潮点.md - 关键爆点

结构：

故事大纲/
├── 核心设定（一句话卖点）
├── 主线（起承转合）
├── 支线（辅助主线）
├── 人物弧光（主角成长）
└── 高潮/结局设计

3. 章节规划（Spec生成）

功能：生成单章或批量章节的规格

输入：

• 前3章规格（自动查找）
• 大纲/设定

输出：

• 规格/第XXX章.yaml - 章节规格

规格字段：

chapter: 101
title: "章节标题"
summary: "200字以内摘要"

before_state:
  characters:
    - {name: "角色", state: "状态", location: "位置"}
  plot_hooks: ["未回收伏笔"]

after_state:
  characters:
    - {name: "角色", state: "新状态", location: "新位置"}
  plot_advances: ["伏笔回收", "新伏笔埋下"]

must_happen:
  - "关键事件1"
  - "关键事件2"

tension_curve:
  - {position: 0, value: 3, note: "铺垫"}
  - {position: 50, value: 8, note: "高潮"}
  - {position: 100, value: 5, note: "收尾"}

key_scenes:
  - "场景1"
  - "场景2"

new_hooks:
  - "结尾钩子"

连贯性检查：

• 读取前3章规格
• 验证人物状态、场景位置一致性
• 检测剧情冲突/重复

4. 正文生成

功能：基于规格生成章节正文

输入：

• 规格文件 (yaml)
• 设定文件

输出：

• 正文/第XXX章.txt - 纯中文正文

字数：3000-5000字/章

写作原则（参考 references/writing_principles.md）：

5. 评审反馈

功能：质量评审和改进步

输入：

• 待评审章节
• 对应规格

输出：

• 评审/第XXX章.md - 评审报告

评审维度（精简为5种角色）：

评分：

• 90-100：精品
• 85-89：优秀，可发布
• 75-84：良好，小改可发
• 60-74：合格，需修改
• 60以下：不合格，重写

红线规则（分级）

P0 - 绝对禁止

P1 - 建议避免

P2 - 可选优化

目录结构

小说项目建议结构：

我的小说/
├── 设定/
│   ├── 世界观.md
│   ├── 人物/
│   │   ├── 主角.md
│   │   └── 反派.md
│   ├── 势力.md
│   └── 伏笔.md
├── 大纲/
│   ├── 故事大纲.md
│   ├── 卷规划.md
│   └── 高潮点.md
├── 规格/
│   ├── 第001章.yaml
│   └── 第002章.yaml
├── 正文/
│   ├── 第001章.txt
│   └── 第002章.txt
└── 评审/
    └── 第001章.md

使用示例

示例1：从想法开始

用户：我想写一个仙侠小说，主角从凡人流开始
AI：好的，让我帮你设计世界观。你想要：
  1. 传统的修真体系（练气→金丹→元婴）
  2. 创新的修炼方式
  3. 其他设定偏好？

示例2：生成章节

用户：帮我写第50章
AI：好的，先读取第47-49章的规格来确保连贯性...
  第50章规格已生成（见规格/第050章.yaml）
  开始生成正文...
  已生成：正文/第050章.txt（3200字）

示例3：评审章节

用户：评审一下第50章
AI：开始评审...
  阅读者：88/100 ✓
  编审：92/100 ✓
  故事家：85/100 ✓
  文学顾问：89/100 ✓
  毒舌读者：90/100 ✓
  
  最终得分：85/100 ✓ 通过
  
  发现1个P1问题：
  - 第3段有抽象心理描写，建议外化为动作
  
  需要查看详细报告吗？

配合技能

• image-creator: 生成小说封面、插图
• novel-image-generation: 生成小说场景图

6. 自动化推进（批量写作）

功能：自动连续生成多章，包含规划→生成→评审→修订的全流程

触发方式：

• "推进10章"
• "写第5-15章"
• "继续往下写5章"

工作流程

用户: "推进N章"
    ↓
1. 确定起始章节（自动查找最新已完成的章节+1）
2. 循环执行以下步骤N次：
   ├─ 2.1 更新设定（从spec中提取新伏笔/人物）
   ├─ 2.2 章节规划（生成下一章spec）
   ├─ 2.3 正文生成（基于spec生成正文）
   ├─ 2.4 评审反馈（质量检查）
   ├─ 2.5 自动修订（如果评审不通过）
   └─ 2.6 达标则进入下一章
3. 输出完成报告

自动化流程详解

步骤1：确定起始章节

自动查找：

1. 正文/ 目录下最新的章节号 + 1
2. 如果没有正文，则从第1章开始

步骤2：更新设定

从上一章的 spec 中提取：

• 新出现的角色 → 提示用户补充人物卡
• 新埋下的伏笔 → 更新伏笔追踪表
• 场景变化 → 更新世界观

步骤3：章节规划

基于前3章规格，生成下一章的 spec：

• 延续人物状态
• 回收/埋下伏笔
• 设计节奏曲线

步骤4：正文生成

基于 spec 生成 3000-5000 字的正文

步骤5：评审反馈

执行质量检查：

• P0问题：AI词汇、感悟式结尾等 → 必须修改
• P1问题：套路化、流水账等 → 建议修改
• 评分标准：≥85分通过

步骤6：自动修订

如果评审不通过（<85分或存在P0问题）：

• 根据评审反馈进行修订
• 重新评审
• 最多修订2次
• 2次仍不通过 → 标记问题，继续下一章

修订策略

输出报告

# 批量写作完成报告

## 执行摘要
- 目标章节：5章（第6-10章）
- 成功完成：4章
- 跳过：1章（问题过多）

## 详细结果

### 第6章 ✓
- 评分：88/100
- 字数：3200
- 评审通过

### 第7章 ✓
- 评分：86/100
- 字数：3100
- 评审通过

### 第8章 ⚠️
- 评分：82/100 → 修订后87/100
- 字数：3400
- 1次修订后通过

### 第9章 ✓
- 评分：90/100
- 字数：3300
- 评审通过

### 第10章 ❌
- 评分：65/100
- 跳过原因：2次修订后仍存在P0问题（AI词汇过多）
- 建议：手动处理

## 伏笔追踪
- 已回收：3个
- 新增埋下：5个

## 文件位置
- 规格：规格/第6-10章.yaml
- 正文：正文/第6-10章.txt
- 评审：评审/第6-10章.md

使用示例

用户：继续往下写10章

AI：开始自动化写作流程

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
第1章（共10章）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[1/5] 更新设定...
  - 上一章结尾新出现"黑袍人"，已添加到待补充人物列表

[2/5] 章节规划...
  - 已生成：规格/第011章.yaml
  - 本章目标：主角与黑袍人对峙

[3/5] 正在生成正文...
  - 已生成：正文/第011章.txt（3200字）

[4/5] 评审中...
  - 阅读者：88/100 ✓
  - 编审：91/100 ✓
  - 故事家：85/100 ✓
  - 文学顾问：89/100 ✓
  - 毒舌读者：90/100 ✓
  - 最终：88/100 ✓ 通过

[5/5] 章节完成！

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
第2章（共10章）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
...

配置选项

CLI 使用

# 自动推进10章（从最新章节继续）
python3 scripts/auto_write.py 10

# 从第100章开始写5章
python3 scripts/auto_write.py 5 100

# 指定小说项目目录
python3 auto_write.py 10 --path /path/to/novel

注意事项

1. 进度保存：每完成一章自动保存，即使中断也不会丢失
2. 冲突检测：自动检测与前文的人物状态/时间线冲突
3. 伏笔提醒：新伏笔会提示用户补充细节
4. 可中断：用户可以说"暂停"停止自动写作