voocel/ainovel-cli

✨多agent实现全自动AI小说生成

它解決了什麼問題

ainovel-cli 是一個用於撰寫長篇小說的自動化引擎。它透過協調多個 AI agents 來處理從初始前提、大綱到草稿與編輯的所有工作，從而消除對持續人工干預的需求，確保數百個章節之間的一致性與敘事流暢度。

運作原理

該系統採用「決定論引擎 + 多代理協作」架構。一個中央 Engine 根據決策表管理狀態並將任務分配給專門的 agents，而 Arbiter 則負責語義判斷。

  • Agents:

    • Architect: 創建前提、大綱、角色設定和世界觀規則。
    • Writer: 處理單個章節的概念化、草稿撰寫與自我審查。
    • Writer's Workflow: 每個章節都遵循嚴格的順序：載入上下文、閱讀前文、規劃章節、撰寫草稿、檢查一致性，並提交最終版本。
    • Editor: 根據七個品質維度（例如：一致性、節奏、敘事連貫性）審查章節，並提供基於證據的反饋。
    • Arbiter: 一個用於結構化決策的輕量級函數（例如：選擇規劃器或處理用戶干預）。

  • 長篇管理: 為了避免超長篇小說出現「空洞」的大綱，它使用了「Compass」（長期方向）和「Rolling Planning」（僅針對當前及近期劇情線展開詳細章節規劃）。

  • 上下文管理: 它採用三層摘要系統（卷 $ ightarrow$ 劇情線 $ ightarrow$ 章節）和自適應壓縮流水線，以在 500 多個章節中保持連貫性。

  • 用戶干預: 用戶可以即時注入修改請求而無需暫停系統；引擎會評估影響並重寫受影響的章節。

適用對象

想要自動化生產長篇虛構作品（特別是網路小說等類型）的作者與創作者，以及那些希望在無需手動提示每個章節的情況下，對風格和一致性保有高度控制權的人。

重點功能

  • 決定論狀態機: 主迴圈由程式碼處理而非 LLMs，使行為可預測且可測試。
  • Rolling Planning: 透過逐一展開故事劇情線而非預先規劃所有內容，來防止敘事漂移。
  • uma-level Checkpoints: 支持在步驟層級（規劃/草稿/檢查/提交）進行精確的崩潰恢復。
  • Anti-AI Tone: 內建基準以避免常見的 AI 陳腔濫調，並允許用戶使用自然語言添加自定義規則。
  • 語義導入: 可以將現有小說「編譯」進系統以繼續撰寫。
  • 多 LLM 支援: 相容於各種供應商，包括 OpenRouter、Anthropic、Gemini、OpenAI 以及本地的 Ollama 實例。