Deng-m1/MaliangAINovalWriter

马良写作 AINoval — AI novel writer for Chinese webnovels（网文）| 多智能体AI小说创作平台：三级大纲、知识图谱一致性、30万字连载

📚 Maliang AI Novel Writer (AINoval)

是什麼 – 一個開源的、基於網頁的平台，協助中文網路小說作者（以及此類平台的運營者）利用大型語言模型（LLM）撰寫長篇小說。它整合了富文本編輯器、AI驅動的綱要/場景生成、世界觀建構工具，以及用於管理使用者、模型、成本與內容審核的完整管理員控制台。

🎯 核心功能

功能	你能獲得
AI驅動的寫作助手	一鍵續寫、擴展、潤色、翻譯、角色與情節生成。支援 OpenAI、Anthropic Claude、Google Gemini，以及任何透過私人 API 金鑰相容 OpenRouter 的模型。
分層內容模型	支援四層結構——作品 → 卷 → 章 → 場景——便於組織長達數十萬字的小說。
世界觀建構引擎	結構化的「設定樹」（角色、地點、物品、勢力等），可由 AI 生成或編輯，支援快照版本控制，並可視化為關係圖譜。
提示詞與預設管理	使用者可儲存系統級與個人提示詞，將其與模型參數打包為可重複使用的預設，並在編輯器工具列中調用。
LLM 可觀測性與成本追蹤	每次模型呼叫皆被記錄（提示、回應、延遲、Token 使用量）。管理員可查詢日誌、查看使用者/模型統計，並審計費用。
管理儀表板	獨立的 Flutter Web 管理介面，支援使用者/RBAC 管理、公開模型池設定、定價表、訂閱/積分處理、內容審核工作流程與知識萃取任務。
AI驅動的劇情綱要生成器（Next Outline）	為當前場景生成多個可能的延續，支援個別重生成選項，並可將選定綱要直接套用至文稿中。
知識萃取 / 「分書」功能	利用 AI 分析現有小說（透過上傳或第三方「番茄小說」服務），萃取風格、劇情、角色、世界觀等元知識，建構個人知識庫。
分析與儀表板	實時字數統計、寫作連擊、Token 消耗趨勢與功能使用圖表，幫助作者監控生產力與預算。

🛠️ 技術堆疊

層級	技術
前端（作者 UI）	Flutter Web，Flutter Quill 富文本編輯器，flutter_bloc / Provider 狀態管理，fl_chart 圖表，Dio HTTP，Hive & shared_preferences 本地快取
前端（管理 UI）	獨立的 Flutter Web 應用（`lib/admin_main.dart`），使用相同技術堆疊，額外添加表格、圖表與對話框的自訂元件
後端	Spring Boot 3（WebFlux，反應式），Java 21，Spring Security + JWT，RabbitMQ 用於非同步任務
AI 編排	LangChain4j（LLM 鏈的 Java 封裝），支援 OpenAI、Anthropic、Gemini、OpenRouter 與自訂端點
資料庫	MongoDB（反應式）用於核心資料，Chroma 向量儲存用於基於嵌入的知識萃取
儲存/服務	阿里雲 OSS & 短信（可設定），Docker-compose 部署，可選向量儲存，RabbitMQ
容器化	Docker 鏡像包含編譯後的 Spring-Boot JAR 與預先建構的 Flutter Web 資產；`docker-compose.yml` 也啟動 MongoDB。

🚀 快速上手（Docker 一鍵部署）

克隆倉儲 並進入專案根目錄。
複製範例環境檔案：
```
cp deploy/open/production.env.example deploy/open/production.env
```
編輯檔案——設定你的 MongoDB URI、JWT 密鑰，以及你想使用的 LLM API 金鑰。
放置伺服器 JAR 檔案（從發布頁下載）至 deploy/dist/ainoval-server.jar。

建構並執行：

docker compose -f deploy/open/docker-compose.yml build
docker compose -f deploy/open/docker-compose.yml up -d

建立管理員帳戶（容器啟動後執行一次初始化腳本）：
```
# Windows
.\deploy\init-admin.bat
# Linux/macOS
chmod +x deploy/init-admin.sh && ./deploy/init-admin.sh
```
預設憑證為 admin / 123456，請立即更改。
開啟 http://localhost:18080/ 進入作者介面，或 http://localhost:18080/admin 進入管理控制台。

👥 適合誰使用？

使用對象	為何有幫助
個人作者	AI 輔助的草稿、潤色與綱要生成可加快寫作速度，並維持長期故事的一致性。
寫作團隊 / 工作室	共享設定樹與知識庫，搭配 RBAC，允許多位作者協作完成一部連載作品。
平台運營者	管理介面提供對模型池、成本追蹤、訂閱/積分系統與內容審核的完全控制。
研究者 / 愛好者	開源程式碼、Docker 部署與以 Java 為中心的 AI 堆疊（LangChain4j）使其成為實驗 LLM 驅動創意工具的理想沙盒。

🤝 貢獻方式

專案遵循標準的 fork-branch-PR 工作流程。問題在 GitHub 上追蹤，社群聊天使用 QQ 群（ID 1062403092）。程式碼採用 Apache 2.0 授權。

📌 總結

Maliang AINoval 是一個全端、生產就緒的 AI 小說寫作平台，結合現代化的 Flutter-Web 編輯器與 Spring-Boot 後端，支援多模型 LLM 編排、結構化世界觀建構，以及全面的管理與可觀測性工具。它是一個真正專注於 AI 輔助內容創作領域的實用軟體專案。