harnessNovel 0.1.2

长篇网络小说写作 AI Agent

  

长篇网络小说写作 AI Agent

---

让 AI 真正学会写好网文

一个专注于高质量网文创作的 AI 辅助工具。通过「拆书 + 仿写」的双阶段流程，显著提升 AI 生成小说的创作水准。

---

项目背景

目前市面上大多数 AI 小说写作工具普遍存在以下痛点：

• 世界观构建薄弱：纯依赖大模型生成，在上下文不足的情况下，难以独立构建逻辑自洽、细节丰富、经得起推敲的世界观。
• 严重平均化，缺乏创造力与特色：模型通过海量平均语料训练，倾向于输出"最平均"的内容，导致人物脸谱化、情节套路化，缺乏独特性。
• 缺乏专业审美与判断力：AI 训练过程缺少小说好坏的定义和区分，无法理解优秀作品与普通作品的差异，因此生成的内容往往是小说，但和优秀小说还有距离。

harnessNovel 的解决方案：先拆书，再仿写。

不让 AI 凭空创作，而是让它先系统学习一部优秀小说的精华，再基于此进行有根基的创新创作。

核心功能

结构化拆书

支持对优秀网文进行多粒度拆解，提取：

• 全书大纲
• 完整世界观设定（规则、势力、体系、背景等）
• 卷纲设计
• 章节核心摘要
• 关键情节节奏与情感节点

高质量仿写

以拆书结果作为高质量上下文，结合用户灵感生成：

• 全书大纲
• 世界观框架
• 卷纲
• 详细章纲
• 正文内容

文风 & 写作规范 从多部小说中深度分析并提炼文风特征与写作规范，帮助去除写作的AI味。

• 语言风格（遣词造句习惯、修辞偏好）
• 叙述节奏与视角控制
• 情感表达方式与细节描写密度
• 对话风格与人物声线
• 整体行文规范

灵活的大模型支持

支持 Claude、GPT-4o、DeepSeek、Qwen 等主流模型。

工作流程

1. 拆书阶段：选择高质量小说，一键拆解成结构化知识。
2. 仿写阶段：输入你的核心灵感 + 拆书结果，让 AI 在"站在巨人肩膀上"的基础上进行创作。
3. 迭代优化：随时调整大纲、世界观、章节内容，逐步完善作品。

特性

• 全流程自动化：从拆书分析到正文生成，5 条命令完成完整长篇小说
• 参考仿写：基于参考小说的节奏、结构、张力曲线生成新内容，而非凭空创作
• 批次摘要：每 20 章一个批次，保持长线情节连贯性
• 渐进式世界观：全书世界观 → 每卷世界观，随情节推进细化设定
• 断点续写：所有阶段自动跳过已生成内容，支持中断后继续

环境要求

• Python 3.9+
• LLM API：需支持 OpenAI 兼容接口（DeepSeek、智谱 GLM、Kimi 等）

安装

pip install harnessNovel

安装后 novel 命令全局可用。

配置

novel config

执行后会自动创建全局配置文件 ~/.harnessNovel/.env，编辑该文件填入你的 API Key：

# 参考小说批次摘要提取（建议 flash 模型，速度快、成本低）
DATA_BUILDER_MODEL=deepseek-chat
DATA_BUILDER_BASE_URL=https://api.deepseek.com
DATA_BUILDER_API_KEY=your-api-key

# 仿写辅助任务：世界观提取（建议 flash 模型）
ADAPTIVE_BUILDER_LITE_MODEL=deepseek-chat
ADAPTIVE_BUILDER_LITE_BASE_URL=https://api.deepseek.com
ADAPTIVE_BUILDER_LITE_API_KEY=your-api-key

# 仿写核心任务：大纲、卷纲、章纲、正文（建议 pro 模型，质量高）
ADAPTIVE_BUILDER_MODEL=deepseek-chat
ADAPTIVE_BUILDER_BASE_URL=https://api.deepseek.com
ADAPTIVE_BUILDER_API_KEY=your-api-key

也可通过同名环境变量覆盖配置。三组配置可使用不同的模型和服务商。

快速开始

# 1. 初始化工作区（自动拆书：章节切分→批次摘要→智能分卷→世界观提取）
novel init 我的新小说 --txt 参考小说.txt

# 2. 生成新小说大纲 + 全书世界观
novel novel-outline 我的新小说

# 3. 生成卷纲 + 每卷世界观
novel volume-outline 我的新小说 --volume 1

# 4. 生成批次摘要 + 逐章章纲
novel chapter-outlines 我的新小说 --volume 1

# 5. 生成正文
novel write 我的新小说 --volume 1

命令参考

命令	说明
novel config	初始化全局配置文件
novel list	列出所有工作区
novel init <ws> --txt <path> [--batch-size N]	创建工作区，自动拆书 + 世界观提取
novel novel-outline <ws> [--direction TEXT] [--direction-file PATH]	生成新小说大纲和全书世界观
novel volume-outline <ws> [--volume N] [--force]	生成卷纲和每卷世界观
novel chapter-outlines <ws> [--volume N] [--force]	两阶段生成：批次摘要 → 逐章章纲
novel write <ws> [--volume N] [--start N] [--max N]	串行生成正文

参数说明

• --txt <path>：参考小说文件路径（仅 init）
• --batch-size N：每批处理章节数，默认 20（仅 init）
• --direction TEXT：创作方向，如"改为现代都市背景"（仅 novel-outline）
• --direction-file PATH：从文件读取创作方向（仅 novel-outline）
• --volume N：指定卷号，默认 1
• --start N：起始章节号，默认 1（仅 write）
• --max N：最大生成章节数（仅 write）
• --force：强制重新生成，覆盖已有内容

关于作者

飞鸟 one the way — 探索者

License

GPL-3.0