AI小说生成

快速开始

```bash

安装

go install github.com/voocel/ainovel-cli/cmd/ainovel-cli@latest

本地开发运行

go run ./cmd/ainovel-cli

首次运行，自动进入引导流程（选择 Provider → 输入 API Key → Base URL → 模型名）

ainovel-cli ```

进入 TUI 后，启动阶段支持两种前置交互：

• 快速开始：一句话直接进入创作
• 共创规划：与 AI 多轮对话澄清需求，右侧实时同步整理出的创作指令草稿；AI 每轮主动提供 1-3 条引导建议，按数字键一键填入输入框，按 Ctrl+S 进入正式创作

两种模式最终都会收敛为同一份创作指令，再进入同一套创作引擎。

干预示例

配置文件

首次运行时自动引导生成配置文件 ~/.ainovel/config.json，后续可直接编辑该文件调整设置。删除配置文件后重新运行会再次进入引导流程。

也可以手动创建配置文件，参考 ~/.ainovel/config.example.jsonc（引导时自动生成）。

{
  "provider": "openrouter",
  "model": "google/gemini-2.5-flash",
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx",
      "base_url": "https://openrouter.ai/api/v1",
      "models": ["google/gemini-2.5-flash", "google/gemini-2.5-pro"]
    }
  },
  "style": "default"
}

配置文件查找顺序（后者覆盖前者）

1. ~/.ainovel/config.json — 全局配置
2. ./ainovel.json — 项目级覆盖（可选）
3. --config path/to/config.json — 命令行指定

覆盖规则说明：

• 标量字段按后者覆盖前者，例如 provider、model、style
• providers 和 roles 按 key 合并，同名项内部按字段覆盖
• 未填写的字段会继承上层配置，例如项目级配置只写 base_url 时会保留全局配置中的 api_key
• 当前不支持用空字符串显式清空上层已有值；如需清空，请直接编辑更高优先级的配置文件

providers.<name>.models 为可选字段，用于声明该 provider 下允许在 TUI /model 面板中切换的模型列表；如果未配置，系统会回退为当前配置文件里已经出现过的该 provider 模型。