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，帮助作者创作长篇小说。