Skip to content

About

自动化ai写作工具

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

21 Commits

Folders and files

Repository files navigation

# NovelForge v2.3.1

> 长篇小说全自动写作系统 — 代码驱动 + AI 监控

NovelForge 是一个代码驱动的长篇小说自动写作系统。Python 脚本负责流程执行(写作循环、审核、审计、记忆更新),OpenClaw AI 负责监控和兜底。两者结合,代码保证步骤不被偷省,AI 保证决策不出错。

## 核心特性

### 写作方法论(融合 InkOS)

- **25 条核心规则**:人物塑造铁律、叙事技法、逻辑自洽、语言约束
- **六步走心理分析**:当前处境→核心动机→信息边界→性格过滤→行为选择→情绪外化
- **创作宪法 14 条**:Show don't tell、盐溶于汤、全员智商在线...
- **代入感六支柱**:标签化、熟悉感、共鸣、欲望、五感、人设活化
- **黄金三章纪律**:开篇硬约束,决定读者是否追读
- **信息边界铁律**:角色只能基于已知信息行动,防止信息越界
- **反例→正例对照表**:具体的去 AI 味修改示例

### 质量保障体系

- **AI 痕迹 5 维度检测**:段落等长、套话密度、公式化转折、列表结构、高疲劳词
- **硬规则 Spot-fix**:破折号、违禁句式、分析术语、章节号指称自动修正
- **18 维度审计**:3 层分级(每章/每 5 章/每 20 章),覆盖角色名、时间线、资源、信息越界、伏笔回收、支线停滞、节奏张弛等
- **审计→修订循环**:warning 级审计问题自动触发修订
- **内容审核**:衔接、矛盾、人设、大纲、信息边界、违禁项

### 记忆系统

| 文件 | 用途 |
|------|------|
| 全局记忆.docx | 世界观核心规则、角色档案 |
| 线索台账.docx | 角色状态、物品道具、伏笔、时间线 |
| 角色信息边界.docx | 每个角色知道什么、不知道什么 |
| 资源账本.docx | 物品归属、数量、状态追踪 |
| 情感弧线.docx | 角色情绪变化追踪 |
| 近期摘要.docx | 最近 8 章摘要(滑动窗口) |
| 章节大纲索引.docx | 按章拆分的大纲 |
| 写作进度.docx | 断点续写状态 |

### 流程保障

- **材料确认**:启动前 AI 检查材料完整性、逻辑矛盾
- **精简上下文**:按相关性筛选台账条目,避免 token 爆炸
- **4 轮异常处理**:原始重试→精简重试→冷却重试→暂停
- **截断检测**:输出被 token 限制截断时自动重写
- **阶段审核**:每 50 章触发台账审查
- **终审**:全书完成后 3 轮终审
- **断点续写**:中断后从断点继续
- **崩溃保护**:原子写入(先写 .tmp 再替换),防止文件损坏

## 系统架构

```text
┌─────────────────────────────────────┐
│  OpenClaw AI(监控者)               │
│  - 收集材料、检查完整性              │
│  - 配置并启动脚本                    │
│  - 监控终端输出                      │
│  - 异常介入、兜底处理                │
│  - 终审报告                          │
└──────────────┬──────────────────────┘
               │ 启动命令
               ▼
┌─────────────────────────────────────┐
│  Python 脚本(执行者)               │
│  - 自动写作循环                      │
│  - Spot-fix / AI 痕迹检测            │
│  - 18 维度审计                       │
│  - 记忆系统更新                      │
│  - 4 轮异常处理                      │
│  - 阶段审核 / 终审                   │
└──────────────┬──────────────────────┘
               │ 调用 API
               ▼
┌─────────────────────────────────────┐
│  LLM API(写手)                     │
│  - 生成正文                          │
│  - 生成元数据                        │
│  - 审核内容                          │
└─────────────────────────────────────┘

快速开始

安装依赖

pip install openai python-docx

方式一:独立运行(不使用 OpenClaw)

python novelforge_v2.3.1.py

按提示输入 API 配置、项目信息、故事圣经和章节大纲即可。

方式二:配合 OpenClaw 使用(推荐)

  1. 将文件放入 OpenClaw skill 目录:
~/.openclaw/skills/novelforge-writer/
├── SKILL.md                  ← AI 读取的指令文件
└── novelforge_v2.3.1.py      ← 写作脚本
  1. 在 OpenClaw 中发送"开始写",AI 会自动收集材料、配置脚本、启动运行并持续监控。

  2. 脚本支持命令行参数模式,AI 通过以下命令启动脚本:

python novelforge_v2.3.1.py --auto \
  --base-url "API地址" \
  --api-key "API密钥" \
  --model "模型名" \
  --name "小说名" \
  --chapters 500 \
  --words 2500 \
  --bible "故事圣经文件路径" \
  --outlines "章节大纲文件路径" \
  --mode new

触发词

触发词 动作
开始写 启动新项目
继续写 断点续写
从第X章开始 导入模式(从文件夹读取已完成章节)
暂停 暂停写作
查看进度 显示写作进度
重写第X章 手动重写指定章节
修改全局记忆 修改记忆文件
修改线索台账 修改台账文件
修改第X章大纲 修改大纲
阶段审核 查看阶段审核报告
终审 查看终审报告

输出结构

桌面/小说名/
├── 原始材料/
│   ├── 故事圣经.docx
│   └── 章节大纲.docx
├── 记忆系统/
│   ├── 全局记忆.docx
│   ├── 线索台账.docx
│   ├── 近期摘要.docx
│   ├── 章节大纲索引.docx
│   ├── 角色信息边界.docx
│   ├── 资源账本.docx
│   ├── 情感弧线.docx
│   └── 写作进度.docx
├── 章节/
│   ├── 第001章.docx
│   ├── 第002章.docx
│   └── ...
└── 审核记录/
    ├── 第050章阶段审核.docx
    ├── 终审报告.docx
    └── ...

工作流程

材料收集(AI)→ 材料检查(AI)→ 启动脚本(AI)
  ↓
脚本接管 ─────────────────────────────┐
  ├── 初始化记忆系统                    │
  ├── 逐章循环 ────────────────────┐   │
  │   ├── 构建精简上下文           │   │
  │   ├── 调用 LLM 生成正文        │   │
  │   ├── Spot-fix(硬规则修正)    │   │
  │   ├── AI 痕迹检测 + 修订        │   │
  │   ├── 内容审核 + 重写           │   │
  │   ├── 18 维度审计 + 修订        │   │
  │   ├── 保存章节                  │   │
  │   ├── 更新记忆系统              │   │
  │   └── 每 50 章阶段审核 ────────┘   │
  ├── 终审(最多 3 轮)                 │
  └── 完成                              │
  ↓                                     │
AI 监控(异常介入 / 终审报告)──────────┘

配置项

在脚本运行时交互输入,或通过命令行参数指定:

参数 默认值 说明
--name 我的小说 项目名称,决定输出文件夹名
--chapters 500 总章节数
--words 2500 每章目标字数(±300)
--base-url - API Base URL
--api-key - API Key
--model - 模型名称
--bible - 故事圣经文件路径
--outlines - 章节大纲文件路径
--mode new 运行模式:new / resume / import
--start 1 导入模式的起始章节号
--folder - 导入模式的已完成章节文件夹路径
--style - 写作风格要求
--special - 其他特殊要求
--review - 自定义审核标准

内部配置项(在代码 Config 类中):

参数 默认值 说明
recent_summary_window 8 近期摘要保留章节数
batch_review_interval 50 阶段审核间隔(每 N 章触发)
chapter_retry_max 3 单章审核最大重试次数
final_review_max_rounds 3 终审最大轮数
max_audit_revise_attempts 2 审计修订最大次数
transition_word_interval 1000 转折词密度阈值(每 N 字允许 1 次)

版本历史

v2.3.1

  • 修复 v2.3.0 已知 bug,合并双版本修复
  • 修复前向引用崩溃(from __future__ import annotations)
  • 修复 AIInterface 参数校验,空值直接报错
  • 修复 docx 读取异常保护
  • 修复进度解析异常回退
  • 修复入口层配置错误友好提示
  • 修复正则思考标签转义
  • save_chapter / save_review_record 改为真正原子写入
  • save_chapter / format_check 用正则判断标题,不再假设第一段是标题
  • _write_file / _save_original 按行拆分写入 docx
  • _split_content_and_metadata 改用正则匹配元数据,容忍空格差异
  • recent_summary_window 3 → 8
  • check_warnings 高频词阈值 c>3 → c>8,加 stop words
  • 资源审计正则对齐实际账本格式
  • 导入模式逐章分析加 try/except
  • 新增命令行参数模式(--auto),支持 AI 直接调用脚本
  • 新增 SKILL.md,配合 OpenClaw 实现代码驱动 + AI 监控架构

v2.3.0

  • 融合 InkOS 写作方法论(25 条规则 + 六步走 + 创作宪法 + 代入感六支柱 + 黄金三章 + 信息边界铁律)
  • 新增 AI 痕迹 5 维度检测 + 自动修订循环
  • 新增硬规则 Spot-fix(破折号、违禁句式、分析术语、章节号)
  • 新增 18 维度审计系统(3 层:每章/每 5 章/每 20 章)
  • 新增审计→修订循环
  • 新增精简上下文(按相关性筛选,避免 token 爆炸)
  • 新增角色信息边界追踪
  • 新增资源账本
  • 新增情感弧线
  • 新增崩溃保护(atomic_write)
  • 新增反例→正例对照表
  • 新增支线停滞检测

v2.2.5

  • 材料确认流程
  • 4 轮异常处理
  • 阶段审核(每 50 章)
  • 终审(3 轮)
  • 截断检测
  • 导入模式
  • 交互式 CLI

v2.2.2

  • InkOS 方法论
  • AI 检测
  • 审计系统

依赖

openai
python-docx

许可

MIT

About

自动化ai写作工具

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages