ainovel-cli

输入一个点子，自动产出整本小说

ainovel-cli 是一个基于 Go 语言开发的多智能体（Multi-Agent）AI 小说生成命令行工具。它通过编排多个具有不同角色的 AI 智能体（如规划者、写作者、编辑者等）协作完成长篇小说的自动创作，解决了传统单次 LLM 调用难以生成连贯长文、情节容易失控的问题。核心能力包括：自动规划章节大纲、分章节生成内容、角色一致性维护、情节连贯性检查，以及支持多种 OpenAI 兼容的 LLM 后端。用户只需提供初始创意或简要设定，工具即可全自动完成从大纲到成稿的完整小说创作流程，并输出为 Markdown 等文本格式。项目采用模块化架构，便于扩展自定义智能体角色和流程。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2050

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队voocel

所属国家

官网地址

GitHubhttps://github.com/voocel/ainovel-cli

定价模式free

价格说明开源项目，本地部署，完全免费。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型agents,ai,ai-agents,go,llm,novel,openai

GitHub 星标★ 2050

30天Star增速

HF 下载量

上线时间2026-03-07 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

macOS / Linux 可直接用一键脚本安装（无需预装 Go）
Windows 或手动安装需从 GitHub Releases 下载对应平台安装包
首次运行需准备一个 OpenAI 兼容服务的 API Key（如 OpenRouter / Anthropic / Gemini / OpenAI）
使用 go install 方式安装需本机已安装 Go 环境

安装与启动步骤

1一键安装 CLI

macOS / Linux 推荐用官方脚本安装，脚本会从同一 Release 下载 SHA256 清单，校验通过后才安装二进制。
```
curl -fsSL https://raw.githubusercontent.com/voocel/ainovel-cli/main/scripts/install.sh | sh
```
2安装指定版本

如需固定版本，在脚本后追加版本号参数；也可把 main 换成对应 tag 路径安装该版本。
```
curl -fsSL https://raw.githubusercontent.com/voocel/ainovel-cli/v1.2.3/scripts/install.sh | sh -s -- v1.2.3
```
3或用 Go 安装

已有 Go 环境时可以用 go install 直接装最新版，无需运行安装脚本。
```
go install github.com/voocel/ainovel-cli/cmd/ainovel-cli@latest
```
4首次运行进引导

直接执行命令会进入引导流程：依次选择 Provider、输入 API Key、Base URL、模型名，并生成配置文件。
```
ainovel-cli
```
5手写配置文件

也可手动创建 ~/.ainovel/config.json，参考仓库根目录 config.example.jsonc；写入 provider、model、api_key、base_url 等字段。
```
mkdir -p ~/.ainovel
```
6无界面跑长篇

在服务器 / NAS / CI 上用 headless 模式，配合 --prompt 传入一句话需求即可全自动创作。
```
ainovel-cli --headless --prompt "写一本东方玄幻长篇，主角从边陲小城起步"
```

关键配置

配置项	必填	说明	示例
`provider`	是	指向 providers 里的 key 名，表示当前默认使用哪个账号	`openrouter`
`model`	是	传给 Provider 的默认模型名，未配 roles 的角色都用它	`google/gemini-2.5-flash`
`providers..api_key`	是	对应 Provider 的密钥，TUI 中输入时会隐藏显示	`sk-or-v1-xxx`
`providers..base_url`	否	接口地址；只填域名时默认补 OpenAI 的 /v1	`https://openrouter.ai/api/v1`
`reasoning_effort`	否	默认推理强度，可选 off/low/medium/high/xhigh/max	`medium`
`roles`	否	为 architect / writer / editor 分别指定模型与推理强度	`{"writer":{"provider":"anthropic","model":"claude-sonnet-4"}`

如何确认成功

首次运行出现引导流程（选 Provider → 输入 API Key → Base URL → 模型名），并生成 ~/.ainovel/config.json 即成功。

常见问题

Q：Windows 怎么安装？

A：前往 GitHub Releases（latest）页面下载对应平台的压缩包，解压后使用；一键安装脚本仅适用于 macOS / Linux。

Q：怎么切换模型和推理强度？

A：进入 TUI 用 /model 在已保存模型间切换，并调整推理强度；/config 只负责编辑 Provider 定义（协议、API Key、Base URL、模型库）。

Q：如何让不同智能体用不同模型？

A：在 roles 里为 architect / writer / editor 分别配置 provider、model、reasoning_effort；未配置的角色沿用默认模型，Arbiter 固定用 default 模型。

Q：全局配置和项目配置哪个生效？

A：先读 ~/.ainovel/config.json，再用 ./.ainovel/config.json 覆盖；标量字段后者覆盖前者，providers 与 roles 按 key 合并、同名项按字段覆盖。

Q：想逐章验收怎么办？

A：默认全自动；在 TUI 输入 /review on 开启逐章验收，之后每次 /next 只放行一个新章节，返工和崩溃恢复不会误消耗许可。

注意事项

安装脚本会先校验 GitHub Release 的 SHA256 清单，通过后才提取安装二进制。
~/.ainovel/ 与项目级 ./.ainovel/ 目录含 API Key，项目级目录已默认加入 .gitignore，注意不要提交。
项目级 provider 若指向全局 providers 中不存在的账号，必须在项目级同时补上 api_key / base_url，否则启动报“未配置凭证”。
README 提到 Docker 镜像适合在服务器 / NAS 运行 headless 长任务并建议挂载配置与作品目录，但节选的 docker run 命令不完整，请以官方 README 为准。

核心亮点

多智能体协作机制，模拟专业写作团队分工，显著提升长文连贯性
全自动流水线，从大纲到章节生成无需人工干预，节省大量时间
基于 Go 编译为单一二进制，安装部署简单，依赖少

不足之处

命令行交互方式对非技术用户不友好，缺乏图形界面
生成质量高度依赖底层 LLM 能力，需自行配置 API Key
文档/社区待观察

适用场景

网文作者用 AI 辅助快速生成长篇初稿
创意写作者探索 AI 协作式小说创作流程
开发者集成多智能体写作能力到自有应用

替代项目

AI-Writer、NovelAI、Sudowrite

项目介绍

ainovel-cli 是智能体领域的开源项目，由 voocel 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,050）位列前 30%，在智能体分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,645 增加到 2,050，净增 405。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。本地部署，完全免费。

它主要面向的使用场景是：网文作者用AI辅助快速生成长篇初稿。同类可对比的替代方案包括 AI-Writer、NovelAI、Sudowrite。

上一篇：first-tree

下一篇：YT-Assets