kentjuno/ainovel-cli

ainovel‑cli – AI驅動的多代理小說寫作工具（越南語與多語言支援）

這是什麼 – 一個以 Go 編寫的命令列 / 終端使用者介面（TUI）應用程式，透過多個 LLM 代理（協調者、建築師、作家、編輯者、仲裁者）協調自動撰寫長篇小說。它內建完整的越南語介面，支援以越南語或中文撰寫，並可完全離線運行，使用本地的 Ollama 模型，或連接雲端服務提供商（OpenRouter、Gemini、Claude、OpenAI、DeepSeek）。

主要功能

• 多代理工作流程 – 分離的代理負責故事規劃、撰寫、編輯與仲裁，支援步驟級別的檢查點與恢復。
• 雙層滾動規劃 – 隨著故事推進，僅擴展下一個情節段落，讓極長小說的上下文窗口保持可控。
• 提示快取與四層上下文壓縮 – 在保留敘事狀態的同時，減少 token 使用量。
• 豐富的斜線指令介面 – /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 流程的愛好者，或尋找複雜代理協調系統範例的開發者。

這是一個非常有創意的專案，將多代理系統應用於小說創作，並以越南語為主要介面，極具獨特性與實用性。— @username