kentjuno/ainovel-cli

ainovel‑cli – 基于AI的多智能体小说写作工具（越南语及多语言支持）

它是什么 – 一个用Go编写的命令行/终端用户界面（TUI）应用程序，通过协调多个LLM智能体（协调者、架构师、写作者、编辑者、仲裁者）自动撰写长篇小说。它自带完全本地化的越南语界面，支持用越南语或中文写作，并可完全离线运行（使用本地Ollama模型）或连接到云服务商（OpenRouter、Gemini、Claude、OpenAI、DeepSeek）。

核心功能

• 多智能体工作流 – 分离的智能体分别负责故事规划、草稿撰写、编辑和仲裁，支持逐步骤检查点保存与恢复。
• 两级滚动规划 – 随着故事推进，仅展开下一个篇章，使超长小说的上下文窗口保持可控。
• 提示词缓存与四级上下文压缩 – 在保留叙事状态的同时减少token使用量。
• 丰富的斜杠命令UI – /diag、/simulate、/import、/export、/sync等命令可让您检查系统健康状况、模仿目标写作风格、导入现有文本或将完成的作品导出为TXT或EPUB格式。
• 模型灵活性 – 您可以为不同角色混合使用不同提供商（例如，用强大的Claude模型进行编辑，用本地Qwen模型进行草稿撰写），并实时切换模型。
• 优先离线 – 使用Ollama，您可以在GPU（≥12 GB VRAM）上100%本地运行，使用开源模型如Qwen 2.5/3.5。
• 纯越南语界面 – 所有菜单、状态栏和错误信息均已翻译，而故事内容可生成为越南语（默认）或中文。

典型工作流程

1. 运行设置向导（首次启动）以选择提供商、输入API密钥或配置Ollama，并设置语言。
2. 启动TUI（docker compose run --rm ainovel 或 ./ainovel-cli）。
3. 提供一句话的设定以快速开始，或进入共创模式，逐步完善世界观和角色设定。
4. 使用斜杠命令进行干预、导入外部草稿、模拟期望作者的风格，或导出手稿。
5. 系统在每个工具步骤后保存检查点，因此崩溃或按下 Ctrl‑C 后可从断点处精确恢复。

安装方法

• Docker（推荐）：docker compose build && docker compose run --rm ainovel。
• 从源码构建：安装Go ≥ 1.21，克隆仓库，然后运行 go build -o ainovel-cli ./cmd/ainovel-cli，再执行 ./ainovel-cli。
• 本地LLM：使用大上下文窗口创建Ollama模型（例如 qwen2.5:14b，设置 num_ctx 65536）。
• 云LLM：在 config/config.json 中提供OpenRouter、Gemini、Claude、OpenAI或DeepSeek的API密钥。

目录结构（输出位于 workspace/ 或自定义的 NOVEL_DIR 下）：

novels/<title>/output/novel/
├─ chapters/      # 完成的Markdown章节
├─ drafts/        # 中间草稿
├─ reviews/       # 编辑质量报告
├─ summaries/     # 章节/卷的摘要
├─ premise.md
├─ characters.md
├─ world_rules.md
└─ meta/          # 检查点、进度、日志

技术栈

• 语言：Go
• 智能体核心：agentcore（工具调用与流式输出）
• LLM封装：litellm
• TUI框架：Bubble Tea + Lip Gloss
• 许可证：MIT

适合谁使用 – 希望获得AI辅助撰写长篇小说的写作者、尝试多智能体LLM流水线的爱好者，或希望获得复杂智能体编排系统示例的开发者。