lingfengQAQ/webnovel-writer

解決的問題

Webnovel Writer 旨在解決長篇網路小說創作中的一致性問題。它能防止 AI 在數百章的創作過程中忘記角色動機、世界觀規則、情節要點（伏筆）和時間線，確保敘事的連貫性與邏輯嚴密性。

工作原理

該專案作為 Claude Code 的外掛程式運行，實現了一個將「寫作行為」與「事實記錄行為」分離的「故事系統」。它使用專業代理（Context、Reviewer 與 Data 代理）流水線來管理創作過程：

1. 規劃與初始化：設置故事骨架、世界觀設定與整體大綱。
2. 寫作流水線：在寫作章節之前，檢索必要的上下文；寫作完成後，提取新事實並將其提交到永久記錄中。
3. 一致性管理：使用 RAG（檢索增強生成）系統，並可選配嵌入（embedding）與重排序（reranking）來查詢角色狀態與情節要點。
4. 狀態投影：事實被投影到唯讀視圖中，如狀態 JSON、摘要與長期記憶草稿本。
5. 視覺化：唯讀儀表板允許作者瀏覽實體關係圖與專案狀態。

適用對象

使用 AI 輔助長期連載故事創作，並需要一個系統來在海量文本中保持嚴格敘事一致性的網路小說作者。

亮點

• 端到端工作流：整合了初始化、規劃、寫作、審核與查詢的指令。
• 基於事實的提交：使用 CHAPTER_COMMIT 系統，確保每個新的情節要點都被正式記錄與索引。
• 多維度審核：根據節奏、一致性、OOC（角色崩壞）行為與「酷點」（讀者滿意度）對章節進行審核。
• RAG 整合：支援透過 OpenAI 相容的嵌入與重排序 API 進行語義搜尋，並提供 BM25 關鍵字搜尋作為備案。
• 類型模板：包含 37 個內建的中文網路小說類型模板。
• 視覺化儀表板：提供用於追蹤實體圖與故事進度的唯讀介面。