novel-writer-skills

📚 Novel Writer Suite — AI 中文网络小说批量创作工具链

让 AI 成为你的网文主笔。 从大纲到成稿，自动化全流程。 已实战完成 50 章、70+ 万字的玄幻修仙小说《太初道果》第一卷创作。

---

🌟 项目概述

Novel Writer Suite 是一套专为中文网络小说设计的批量创作工具链，基于 OpenClaw 技能生态构建。从大纲解析、章节生成到质量审核，提供端到端的自动化写作方案。

与通用写作工具不同，我们深度适配中文网文：修仙、玄幻、都市、言情……支持单章 12,000-20,000 字超长输出，自动分段生成、上下文衔接、AI 味清除。

为什么选择我们？

---

🚀 快速开始

安装

# 克隆仓库
git clone https://github.com/Shine8592/novel-writer-skills.git

# 安装到 OpenClaw skills 目录
cp -r novel-writer-skills/* ~/.openclaw/workspace/skills/

# 重启 OpenClaw
openclaw gateway restart

三步完成一章

# ① 解析大纲 -> 逐章 prompt
python3 novel-outliner/scripts/parse_outline.py --outline 大纲.md --output prompts/

# ② 批量生成章节
python3 novel-writer/scripts/batch_generate.py --start 1 --end 50 --output chapters/

# ③ 质量审核
python3 novel-quality-checker/scripts/quality_check.py --dir chapters/ --full

---

📦 工具链架构

本套件包含 3 个独立技能模块，各司其职：

1️⃣ Novel Outliner — 大纲解析器

输入： 原始大纲（纯文本/JSON/Markdown） 输出： 每章独立写作 prompt + chapters.json

python3 novel-outliner/scripts/parse_outline.py --outline 大纲.md --output prompts/

核心能力：

• 自动识别大纲格式（文本/JSON/Markdown）
• 逐章拆解剧情、角色、备注
• 自动注入硬性约束（纯中文、零 AI 标记…）
• 前章结尾自动注入，保证章节衔接

输出结构：

prompts/
├── 0001_废物少年.txt
├── 0002_退婚之辱.txt
├── 0003_离开村庄.txt
├── ...
└── chapters.json    # 结构化汇总，供批量生成使用

---

2️⃣ Novel Writer — 批量生成引擎

输入： 大纲 / prompt 文件 输出： 完整章节文件（.md），每章 12,000-20,000 字

# 全卷批量生成
python3 novel-writer/scripts/batch_generate.py --start 1 --end 50 --output chapters/

# 指定范围
python3 novel-writer/scripts/batch_generate.py --start 23 --end 30 --output chapters/

# 强制使用特定 API
python3 novel-writer/scripts/batch_generate.py --start 1 --end 10 --api fyra --output chapters/

核心能力：

• 分段生成 — 自动拆分 12,000+ 字为多次调用（ModelScope 单次上限 ~8,000 字）
• 段落合并 — 智能去重结尾重叠（200 字窗口匹配）
• 多 API 容错 — ModelScope → Fyra → Ph8 自动降级
• 429 智能重试 — 限流自动等 30-60 秒重试
• 上下文衔接 — 读取前章结尾 300 字注入 prompt
• 进度追踪 — 每章生成后自动保存，断点续传

支持 API：

完整 API 配置见 novel-writer/references/api-config.md

输出结构：

chapters/
├── 0001_废物少年.md      (13,113 字)
├── 0002_退婚之辱.md      (12,000+ 字)
├── 0003_离开村庄.md      (12,000+ 字)
├── ...
└── 0050_第一卷终.md      (17,814 字)

---

3️⃣ Novel Quality Checker — 质量审核

输入： 章节文件 输出： 33 维度详细审核报告

# 快速检查（5 项核心）
python3 novel-quality-checker/scripts/quality_check.py --file chapters/0001_废物少年.md --quick

# 全量审核（33 维度）
python3 novel-quality-checker/scripts/quality_check.py --file chapters/0001_废物少年.md --full

# 批量扫描全书
python3 novel-quality-checker/scripts/quality_check.py --dir chapters/ --full

审核维度一览：

输出示例：

==================================================
  第01章 废物少年 质量审核: 31/33 通过
==================================================
  ✅ 字数达标(≥12000): 13113字
  ✅ 中文纯度(≥95%): 99.7%
  ✅ AI标记词(0个): 无
  ✅ 模板化结尾(无): 正常
  ✅ 重复率(<10%): 3.2%
  ⚠️ 对话比例(30-50%): 28%
  ❌ 章节大纲符合度: 第3阶段缺失"退婚现场"场景

---

📊 实战成果

本项目已实战完成 《太初道果》第一卷（玄幻修仙，6 卷 380 章计划）：

第一卷大纲示例

---

🏗️ 技术架构

                    ┌─────────────────────┐
                    │    小说大纲文件      │
                    │  (.md / .txt / JSON) │
                    └──────────┬──────────┘
                               │
                    ┌──────────▼──────────┐
                    │  Novel Outliner     │
                    │  大纲解析器          │
                    │  ↓ 逐章 prompt      │
                    └──────────┬──────────┘
                               │
                    ┌──────────▼──────────┐
                    │  Novel Writer       │
                    │  批量生成引擎        │
                    │  ↓ 分段生成 + 合并   │
                    └──────────┬──────────┘
                               │
                    ┌──────────▼──────────┐
                    │  Novel Quality      │
                    │  Checker            │
                    │  ↓ 33维度审核报告    │
                    └──────────┬──────────┘
                               │
                    ┌──────────▼──────────┐
                    │  合格章节 → 成品    │
                    │  不合格 → 退回重做   │
                    └─────────────────────┘

关键技术

---

📋 硬性约束（内置）

为了保证生成质量，系统在每章 prompt 中强制注入以下约束：

1. 纯中文 — 所有数字用中文写法（一、二、三十），零阿拉伯数字零英文
2. 零 AI 标记 — 不得出现"暗思涌起""心理描写""环境描写""命运的齿轮"等
3. 禁止模板化结尾 — 不得出现"真正的危机才刚刚开始""未完待续"
4. 忠于大纲 — 不自由发挥核心剧情，覆盖所有情节点
5. 字数达标 — 每章 12,000-20,000 字

---

🎯 适用场景

• ✅ 网文批量创作 — 修仙、玄幻、都市、言情等中文网文
• ✅ 大纲驱动写作 — 有明确大纲和章节规划
• ✅ 长篇小说 — 60-380 章的长篇连载
• ✅ 多 API 混合使用 — 不想依赖单一 API 服务
• ✅ 质量要求高 — 需要自动审核把关

不适用

• ❌ 单篇精修/人工润色（用专业编辑工具）
• ❌ 诗歌/散文等文学体裁
• ❌ 出版级校对排版
• ❌ 多语种多语言混写

---

🚀 工作流

┌─────────┐     ┌─────────┐     ┌─────────┐     ┌─────────┐     ┌─────────┐
│  构思   │ →   │  写大纲  │ →   │ Outliner │ →  │ Writer  │ →  │ Checker │
│         │     │         │     │  拆解    │     │  生成    │     │  审核    │
│  设定   │     │  分卷    │     │  Prompt  │     │  合并    │     │  报告   │
└─────────┘     └─────────┘     └─────────┘     └─────────┘     └─────────┘

典型使用流程

# 第一步：准备大纲
# 大纲格式见下方"大纲格式要求"

# 第二步：解析大纲 -> 逐章 prompt
python3 novel-outliner/scripts/parse_outline.py \
    --outline "太初道果_第一卷大纲.md" \
    --output "太初道果/prompts/"

# 第三步：批量生成
python3 novel-writer/scripts/batch_generate.py \
    --outline "太初道果/prompts/chapters.json" \
    --start 1 --end 50 \
    --output "太初道果/第1卷/"

# 第四步：质量审核
python3 novel-quality-checker/scripts/quality_check.py \
    --dir "太初道果/第1卷/" --full

# 第五步：修复不合格章节（如有）
# 退回重新生成，或手动修改

---

📁 目录结构

novel-writer-skills/
├── README.md                                    # 本文件
├── novel-outliner/                              # 大纲解析器
│   ├── SKILL.md                                 # 技能说明
│   └── scripts/
│       └── parse_outline.py                     # 解析脚本
├── novel-writer/                                # 批量生成引擎
│   ├── SKILL.md                                 # 技能说明
│   ├── scripts/
│   │   └── batch_generate.py                    # 批量生成脚本
│   └── references/
│       ├── api-config.md                         # API 配置
│       └── prompt-template.md                    # Prompt 模板
└── novel-quality-checker/                        # 质量审核
    ├── SKILL.md                                  # 技能说明
    └── scripts/
        └── quality_check.py                      # 审核脚本

---

📖 大纲格式要求

支持多种格式，推荐使用 Markdown 格式：

# 第一卷：觉醒篇（50章）

## 第01章 废物少年
林阎是青云村公认的废物，修炼三年仍停留在练气一重。
村民嘲笑，唯有村长对他不离不弃。
这天，他在后山砍柴时发现了异样...

## 第02章 退婚之辱
未婚妻家族来人退婚，当场羞辱林阎。
林阎立下三年之约：三年之内必踏上青云宗！
...

JSON 格式也完全支持：

{
  "chapters": {
    "1": {
      "title": "废物少年",
      "plot": "林阎是青云村公认的废物...",
      "characters": ["林阎", "村长"],
      "notes": "本章必须体现"废柴流"经典套路"
    }
  }
}

---

⚡ 常见问题

Q: API 限流怎么办？

系统内置多 API 容错降级 + 智能重试退避：

• 自动等 30-60 秒重试
• 切到备份 API 继续运行
• 断点续传，已保存的章节不会丢失

Q: 生成的章节质量如何保证？

33 维度自动审核，每章生成后自动扫描：

• 不合格项会详细标出，给出修改建议
• 建议退回重新生成（用相同 prompt 但更换 API）

Q: 可以自定义约束吗？

可以。在 novel-writer/scripts/batch_generate.py 中修改 HARD_CONSTRAINTS 常量，或在 prompt 中注入额外约束。

Q: 支持其他 AI 服务吗？

支持任何 OpenAI-Compatible API。只需在 novel-writer/references/api-config.md 中添加配置。

---

🤝 贡献

欢迎提交 Issue 和 Pull Request！

• 🐛 发现 Bug → New Issue
• 💡 功能建议 → New Issue
• 📖 改进文档 → 直接开 PR

---

📄 许可证

本项目基于 MIT 许可证 开源。详见 LICENSE 文件。

---

🙏 致谢

• OpenClaw — 技能平台生态
• ClawHub — 技能注册中心
• ModelScope — DeepSeek-V3.2 API 支持
• Fyra.im — Mistral/Moonshot API 备份

---

Novel Writer Suite — 让 AI 成为你的网文主笔 ✍️🔥️ 已有数百位创作者正在使用这套工具链开启高效创作之旅。