Aerdelan/MirrorNovel

MirrorNovel – AI驅動的長篇小說創作平台

是什麼

• 一個全端的Web/桌面/行動應用程式，讓作者能借助大型語言模型創作小說（包含傳統網路小說與輕小說風格）。
• 工作流程為 大綱 → 藍圖 → 章節正文 → 修潤，每一步皆即時串流至UI，作者可即時觀看模型的「思考」過程，並在任何時刻中斷。

核心功能

功能	你將獲得
全書或單章模式	一次完成整本書創作，或專注於單一章節。
流式生成（SSE）	大綱、藍圖、正文、修潤與編輯過程在生成時即推送至瀏覽器，附帶即時令牌使用計數器。
連續性引擎	持久化的章節摘要、伏筆線索、角色狀態、情感曲線與未解問題被儲存，並在各章節間自動重用。
寫作人格（Persona）	選擇預設、編輯模板，或讓AI生成控制語氣、節奏與風格的人格；每本小說會快照保存人格，後續修改不會影響既有文字。
專家審查模式	每章完成後系統自動執行連續性檢查，並可自動修復問題區域。
修潤與編輯引擎	兩階段「去AI化」重寫（附帶差異檢視），以及三階段工作流程（結構 → 風格 → AI移除）。
導入並繼續	上傳 .txt 檔案或貼上現有正文；AI提取上下文（角色、情節點等）並繼續故事。
多模型路由	每個任務類型（大綱、寫作、推理、修潤、記憶）可指向任意OpenAI相容端點或Ollama伺服器。
管理控制台	用於使用者管理、模型路由設定與資料概覽的儀表板。
多平台客戶端	Vue 3 Web UI、基於Electron的Windows桌面客戶端，以及uni-app行動應用（Android APK）。

如何運作

• 前端：作者用的Vue 3 SPA，獨立的Vue 3管理SPA，以及uni-app行動建構。全部透過REST與Server-Sent Events（SSE）與後端通訊。
• 後端：使用Node.js撰寫的Express 4 API，使用Mongoose將小說、章節、人格、摘要等儲存在MongoDB中。
• AI層：調用任意OpenAI相容的Chat Completion服務（或本地Ollama），支援按任務路由。支援深度思考模型（如GLM-thinking、DeepSeek-R1）；推理預算與正文預算分離，避免「令牌浪費」。
• 桌面客戶端：一個捆綁靜態Web資源並代理API呼叫的Electron外殼，使用NSIS打包為Windows安裝程式。

快速開始（開發用）

# 克隆並安裝所有部分
git clone https://github.com/Aerdelan/MirrorNovel.git
cd MirrorNovel

# 伺服器端相依性
cd server && npm install && cp .env.example .env   # 編輯 .env：MongoDB、JWT密鑰、模型密鑰

# 客戶端、管理端與行動端相依性
cd ../client && npm install
cd ../admin && npm install
cd ../app && npm install

# 在三個獨立終端中執行三個服務
cd ../server && npm run dev   # API運行於 :3000
cd ../client && npm run dev   # 作者UI運行於 :5173
cd ../admin && npm run dev    # 管理UI運行於 :5174

需求：Node ≥ 18，MongoDB ≥ 6，以及一個OpenAI相容模型端點（或Ollama）。

桌面分發

• 每個標籤都會透過GitHub Actions自動上傳預建的Windows安裝程式（MirrorNovel Setup x.y.z.exe，約79 MB）與便攜式 win-unpacked 資料夾。
• 安裝程式未簽署；首次執行時Windows SmartScreen會發出警告。
• 桌面應用僅為外殼——它仍連接至遠端後端（預設為官方伺服器），可在 偏好設定 中設定。

部署提示

• 建構Vue客戶端（npm run build），並使用Nginx/Caddy提供靜態檔案。
• 使用程序管理器（PM2、systemd、Docker-Compose）執行Express API。將 /api 代理至API，並保持SSE逾時時間較長。
• 保護MongoDB實例，將JWT密鑰與模型密鑰保留在倉儲外，啟用HTTPS，並為認證端點添加速率限制。

授權

• 倉儲採用 LICENSE 檔案中列出的授權（README中未顯示確切的SPDX識別碼）。使用者還必須遵守所連接的任何第三方模型服務條款。

---

MirrorNovel 是一個真正的開源AI輔助寫作平台，結合了流式LLM生成、長程敘事記憶與多平台UI，協助作者創作長篇小說。