Skip to content

XTmingyue/harnessNovel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

  

AI Agent for Long-form Web Novel Writing

长篇网络小说写作 AI Agent

Python 3.9+ License: GPL-3.0

English | 中文


让 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-v4-flash
DATA_BUILDER_BASE_URL=https://api.deepseek.com
DATA_BUILDER_API_KEY=your-api-key

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

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

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

快速开始

# 1. 初始化工作区(自动拆书:章节切分→批次摘要→智能分卷→世界观提取),自动在当前目录下创建my-novels目录
novel init 我的新小说 --txt 参考小说.txt

# 2. 生成新小说大纲 + 全书世界观
novel novel-outline 我的新小说 --direction "灵感输入"

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

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

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

注意

  • 参考小说的格式目前仅支持txt格式,编码需采用utf-8

命令参考

命令 说明
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 — 探索者

公众号二维码

Star History

Star History Chart

License

GPL-3.0

About

长篇网络小说自动化写作 AI Agent,支持Chatgpt、gemini、Deepseek等国内外模型接入,采用拆书 + 仿写的模式,从新世界观、大纲、卷纲设计,到章节片段完善&章纲设计,有效解决 AI 写作中的「前后矛盾」、「容易遗忘」、「缺乏特色」和「AI味重」等问题,支持 百万字量级 连载创作。

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages