GitHub - xiamuceer-j/MuMuAINovel: 一款基于 AI 的智能小说创作助手，帮助你轻松创作精彩故事

MuMuAINovel 📚✨

基于 AI 的智能小说创作助手

特性 • 快速开始 • 配置说明 • 项目结构

💬 加入交流群

欢迎扫码加入 QQ 交流群，一起交流 AI 小说创作心得、反馈问题、获取最新动态！

💖 支持项目

如果这个项目对你有帮助，欢迎通过以下方式支持开发：

☕ 请我喝杯咖啡

🌐 MuMuのAPI站点

在 MuMu の API 站点充值满 50 元及以上，也可以获得下方赞助专属权益。

🎁 赞助专属权益

权益 说明

📋 优先需求响应 您的功能需求和问题反馈将获得优先处理

🚀 Windows一键启动 获取免安装 EXE 程序，双击即可使用

💬 专属技术支持 加入赞助者内部群，获得远程协助和配置指导

☕ 赞助 / API 站点充值档位

金额 描述

¥5 🌶️ 一包辣条

¥10 🍱 一顿拼好饭

¥20 ☕ 一杯咖啡

¥50 🍖 一次烧烤

¥99 🍲 一顿海底捞

您的支持是我持续开发的动力！🙏

✨ 特性

• 🤖 多 AI 模型 - 支持 OpenAI、Gemini、Claude 等主流模型

• 📝 智能向导 - AI 自动生成大纲、角色和世界观

• 👥 角色管理 - 人物关系、组织架构可视化管理

• 📖 章节编辑 - 支持创建、编辑、重新生成和润色

• 🌐 世界观设定 - 构建完整的故事背景

• 🔐 多种登录 - LinuxDO OAuth 或本地账户登录

• 💾 PostgreSQL - 生产级数据库，多用户数据隔离

• 🐳 Docker 部署 - 一键启动，开箱即用

📸 项目预览

多图预警

登录界面

主界面

项目管理

赞助我 💖

📋 TODO List

✅ 已完成功能

• 灵感模式 - 创作灵感和点子生成

• 自定义写作风格 - 支持自定义 AI 写作风格

• 数据导入导出 - 项目数据的导入导出

• Prompt 调整界面 - 可视化编辑 Prompt 模板

• 章节字数限制 - 用户可设置生成字数

• 思维链与章节关系图谱 - 可视化章节逻辑关系

• 根据分析一键重写 - 根据分析建议重新生成

• Linux DO 自动创建账号 - OAuth 登录自动生成账号

• 职业等级体系 - 自定义职业和等级系统，支持修仙境界、魔法等级等多种体系

• 角色/组织卡片导入导出 - 单独导出角色和组织卡片，支持跨项目数据共享

• 伏笔管理 - 智能追踪剧情伏笔，提醒未回收线索，可视化伏笔时间线

• 提示词工坊 - 社区驱动的 Prompt 模板分享平台，一键导入优质提示词

• 拆书功能 - 目前呼声比较高的功能，一键拆书，给当年的ta一个圆满的结局

📝 规划中功能

......

💡 欢迎提交 Issue 或 Pull Request！

💻 硬件配置要求

最低配置（个人使用/开发环境）

组件 要求

CPU 2 核

内存 2 GB RAM

存储 10 GB 可用空间

网络 稳定互联网连接（用于调用 AI API）

推荐配置（小型团队/生产环境）

组件 要求

CPU 4 核

内存 8 GB RAM

存储 20 GB SSD

网络 稳定互联网连接

高并发配置（80-150 用户）

组件 要求

CPU 8 核

内存 16 GB RAM

存储 50 GB+ SSD

网络 高带宽连接

📌 说明

• Embedding 模型 ：约 400 MB 磁盘空间，运行时加载到内存

• PostgreSQL ：默认配置使用 256 MB shared_buffers，1 GB effective_cache_size

Docker 部署 ：建议预留额外 1-2 GB 内存给容器运行时

• 本项目主要依赖外部 AI API（OpenAI/Claude/Gemini），不需要本地 GPU

🚀 快速开始

前置要求

Docker 和 Docker Compose

• 至少一个 AI 服务的 API Key（OpenAI/Gemini/Claude）

Docker Compose 部署（推荐）

1. 克隆项目

git clone https://github.com/xiamuceer-j/MuMuAINovel.git

cd MuMuAINovel

2. 配置环境变量（必需）

cp backend/.env.example .env

编辑 .env 文件，填入必要配置（API Key、数据库密码等）

3. 确保文件准备完整

⚠️ 重要：确保以下文件存在

- .env（配置文件，必需挂载到容器）

- backend/scripts/init_postgres.sql（数据库初始化脚本）

4. 启动服务

docker-compose up -d

5. 访问应用

打开浏览器访问 http://localhost:8000

📌 注意事项

• .env 文件挂载 : docker-compose.yml 会自动将 .env 挂载到容器，确保文件存在

• 数据库初始化 : init_postgres.sql 会在首次启动时自动执行，安装必要的PostgreSQL扩展

• 自行构建 : 如需从源码构建，请先下载 embedding 模型文件（ 加群获取 ）

使用 Docker Hub 镜像（推荐新手）

1. 拉取最新镜像（已包含模型文件）

docker pull mumujie/mumuainovel:latest

2. 创建 docker-compose.yml（点击下方展开查看完整配置）

📄 点击展开 docker-compose.

yml 完整配置 services : postgres : image : postgres:18-alpine container_name : mumuainovel-postgres environment : POSTGRES_DB : ${POSTGRES_DB:-mumuai_novel} POSTGRES_USER : ${POSTGRES_USER:-mumuai} POSTGRES_PASSWORD : ${POSTGRES_PASSWORD:-123456} POSTGRES_INITDB_ARGS : " --encoding=UTF8 --locale=C " TZ : ${TZ:-Asia/Shanghai} volumes :

• postgres_data:/var/lib/postgresql

./backend/scripts/init_postgres.sql:/docker-entrypoint-initdb.d/init.sql:ro

ports :

restart : unless-stopped healthcheck : test : ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-mumuai} -d ${POSTGRES_DB:-mumuai_novel}"] interval : 10s timeout : 5s retries : 5 start_period : 10s networks :

command :

• " ${POSTGRES_PORT:-5432}:5432 "
• ai-story-network
• postgres
• -c

max_connections=${POSTGRES_MAX_CONNECTIONS:-200}

• -c

shared_buffers=${POSTGRES_SHARED_BUFFERS:-256MB}

• -c

effective_cache_size=${POSTGRES_EFFECTIVE_CACHE_SIZE:-1GB}

• -c

maintenance_work_mem=${POSTGRES_MAINTENANCE_WORK_MEM:-64MB}

• -c

checkpoint_completion_target=${POSTGRES_CHECKPOINT_COMPLETION_TARGET:-0.9}

• -c

wal_buffers=${POSTGRES_WAL_BUFFERS:-16MB}

• -c

default_statistics_target=${POSTGRES_DEFAULT_STATISTICS_TARGET:-100}

• -c

random_page_cost=${POSTGRES_RANDOM_PAGE_COST:-1.1}

• -c

effective_io_concurrency=${POSTGRES_EFFECTIVE_IO_CONCURRENCY:-200}

• -c

work_mem=${POSTGRES_WORK_MEM:-4MB}

• -c

min_wal_size=${POSTGRES_MIN_WAL_SIZE:-1GB}

• -c

max_wal_size=${POSTGRES_MAX_WAL_SIZE:-4GB}

mumuainovel : image : mumujie/mumuainovel:latest container_name : mumuainovel depends_on : postgres : condition : service_healthy ports :

volumes :

• " ${APP_PORT:-8000}:8000 "

./logs:/app/logs

./.env:/app/.env:ro

./storage/generated_covers:/app/backend/storage/generated_covers

environment :

应用配置

APP_NAME=${APP_NAME:-MuMuAINovel}

APP_VERSION=${APP_VERSION:-1.5.4}

APP_HOST=${APP_HOST:-0.0.0.0}

APP_PORT=8000

DEBUG=${DEBUG:-false}

数据库配置

DATABASE_URL=postgresql+asyncpg://${POSTGRES_USER:-mumuai}:${POSTGRES_PASSWORD:-123456}@postgres:5432/${POSTGRES_DB:-mumuai_novel}

DB_HOST=postgres

DB_PORT=5432

POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-123456}

PostgreSQL 连接池配置

DATABASE_POOL_SIZE=${DATABASE_POOL_SIZE:-30}

DATABASE_MAX_OVERFLOW=${DATABASE_MAX_OVERFLOW:-20}

DATABASE_POOL_TIMEOUT=${DATABASE_POOL_TIMEOUT:-60}

DATABASE_POOL_RECYCLE=${DATABASE_POOL_RECYCLE:-1800}

DATABASE_POOL_PRE_PING=${DATABASE_POOL_PRE_PING:-True}

DATABASE_POOL_USE_LIFO=${DATABASE_POOL_USE_LIFO:-True}

全局代理配置（可选）

HTTP_PROXY=${HTTP_PROXY:-}

HTTPS_PROXY=${HTTPS_PROXY:-}

NO_PROXY=${NO_PROXY:-localhost,127.0.0.1}

AI 服务配置

OPENAI_API_KEY=${OPENAI_API_KEY:-}

OPENAI_BASE_URL=${OPENAI_BASE_URL:-https://api.openai.com/v1}

GEMINI_API_KEY=${GEMINI_API_KEY:-}

GEMINI_BASE_URL=${GEMINI_BASE_URL:-}

ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY:-}

ANTHROPIC_BASE_URL=${ANTHROPIC_BASE_URL:-}

DEFAULT_AI_PROVIDER=${DEFAULT_AI_PROVIDER:-openai}

DEFAULT_MODEL=${DEFAULT_MODEL:-gpt-4o-mini}

DEFAULT_TEMPERATURE=${DEFAULT_TEMPERATURE:-0.7}

DEFAULT_MAX_TOKENS=${DEFAULT_MAX_TOKENS:-32000}

ALLOW_PRIVATE_AI_ENDPOINTS=${ALLOW_PRIVATE_AI_ENDPOINTS:-false}

ALLOWED_AI_HOSTS=${ALLOWED_AI_HOSTS:-}

LinuxDO OAuth 配置

LINUXDO_CLIENT_ID=${LINUXDO_CLIENT_ID:-11111}

LINUXDO_CLIENT_SECRET=${LINUXDO_CLIENT_SECRET:-11111}

LINUXDO_REDIRECT_URI=${LINUXDO_REDIRECT_URI:-http://localhost:8000/api/auth/linuxdo/callback}

LINUXDO_PROXY_URL=${LINUXDO_PROXY_URL:-}

FRONTEND_URL=${FRONTEND_URL:-http://localhost:8000}

本地账户登录配置

LOCAL_AUTH_ENABLED=${LOCAL_AUTH_ENABLED:-true}

LOCAL_AUTH_USERNAME=${LOCAL_AUTH_USERNAME:-admin}

LOCAL_AUTH_PASSWORD=${LOCAL_AUTH_PASSWORD:-admin123}

LOCAL_AUTH_DISPLAY_NAME=${LOCAL_AUTH_DISPLAY_NAME:-本地管理员}

会话配置

SESSION_EXPIRE_MINUTES=${SESSION_EXPIRE_MINUTES:-120}

SESSION_REFRESH_THRESHOLD_MINUTES=${SESSION_REFRESH_THRESHOLD_MINUTES:-30}

SESSION_COOKIE_SECURE=${SESSION_COOKIE_SECURE:-true}

restart : unless-stopped healthcheck : test : ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"] interval : 30s timeout : 10s retries : 3 start_period : 30s networks :

• ai-story-network

volumes : postgres_data : driver : local

networks : ai-story-network : driver : bridge

3. 启动服务

docker-compose up -d

4. 查看日志

docker-compose logs -f

5. 更新到最新版本

docker-compose pull docker-compose up -d

💡 提示

Docker Hub 镜像已包含所有依赖和模型文件，无需额外下载

本地开发 / 从源码构建

前置准备

⚠️ 重要：如果从源码构建，需要先下载 embedding 模型文件

模型文件较大（约 400MB），需放置到以下目录：

backend/embedding/models--sentence-transformers--paraphrase-multilingual-MiniLM-L12-v2/

#

📥 获取方式：

- 加入项目 QQ 群或 Linux DO 讨论区获取下载链接

- 群号：见项目主页

- Linux DO：https://linux.do/t/topic/1100112

后端

cd backend

python -m venv .venv

source .venv/bin/activate # Windows: .venv\Scripts\activate

pip install -r requirements.txt

配置 .env 文件

cp .env.example .env

编辑 .env 填入必要配置

启动 PostgreSQL（可使用 Docker）

docker run -d --name postgres \

-e POSTGRES_PASSWORD=your_password \ -e POSTGRES_DB=mumuai_novel \ -p 5432:5432 \ postgres:18-alpine

启动后端

python -m uvicorn app.main:app --host localhost --port 8000 --reload

前端

cd frontend

npm install

npm run dev # 开发模式

npm run build # 生产构建

⚙️ 配置说明

必需配置

创建 .env 文件：

PostgreSQL 数据库（必需）

DATABASE_URL=postgresql+asyncpg://mumuai:your_password@postgres:5432/mumuai_novel

POSTGRES_PASSWORD=your_secure_password

AI 服务

OPENAI_API_KEY=your_openai_key

OPENAI_BASE_URL=https://api.openai.com/v1

DEFAULT_AI_PROVIDER=openai

DEFAULT_MODEL=gpt-4o-mini

本地账户登录

LOCAL_AUTH_ENABLED=true

LOCAL_AUTH_USERNAME=admin

LOCAL_AUTH_PASSWORD=your_password

可选配置

LinuxDO OAuth

LINUXDO_CLIENT_ID=your_client_id

LINUXDO_CLIENT_SECRET=your_client_secret

LINUXDO_REDIRECT_URI=http://localhost:8000/api/auth/callback

LinuxDO 登录专用代理（可选，仅影响 OAuth token 与用户信息请求）

LINUXDO_PROXY_URL=http://127.0.0.1:7890

PostgreSQL 连接池（高并发优化）

DATABASE_POOL_SIZE=30

DATABASE_MAX_OVERFLOW=20

会话 Cookie Secure 标记

默认 true，适合 HTTPS 部署；如果使用 HTTP 访问并且浏览器不保存登录 Cookie，可设为 false

SESSION_COOKIE_SECURE=true

本地 / Docker 内网 LLM（默认关闭，保持 SSRF 防护）

ALLOW_PRIVATE_AI_ENDPOINTS=true

ALLOWED_AI_HOSTS=host.docker.internal,127.0.0.1

🔐 Cookie Secure 说明

• HTTPS 部署：建议保持 SESSION_COOKIE_SECURE=true ，浏览器只会通过 HTTPS 发送登录 Cookie。

HTTP 部署：如果登录后浏览器没有保存 Cookie，请在 .env 中设置 SESSION_COOKIE_SECURE=false ，然后重启后端或

Docker 容器

。

Docker Compose 示例默认使用 SESSION_COOKIE_SECURE=${SESSION_COOKIE_SECURE:-true}

，如需关闭必须在 .env 中显式配置。

🌐 LinuxDO 专用代理说明

• 如果只有 LinuxDO 授权登录在当前网络不可达，优先配置 LINUXDO_PROXY_URL ，不要配置全局 HTTP_PROXY / HTTPS_PROXY 。

• LINUXDO_PROXY_URL 只会用于 LinuxDO OAuth 的 token 交换和用户信息请求，不影响 AI 服务、SMTP、数据库等其他网络调用。

常见示例：

LINUXDO_PROXY_URL=http://127.0.0.1:7890

；

Docker 容器内访问宿主机代理时通常需要使用宿主机在 Docker 网络中的地址

，而不是容器内的 127.0.0.1 。

• 当前示例按 HTTP 代理配置；如果需要 SOCKS 代理，请先确保运行环境安装了 httpx 的 SOCKS 支持依赖。

🖥️ 本地 / Docker 内网 LLM 说明

• 默认会拒绝 localhost 、 127.0.0.1 、私网 IP 以及解析到内网的主机名（例如 host.docker.internal ），用于降低 SSRF 风险。

如果 AI 服务跑在本机 Ollama / llama.cpp，或

Docker 容器需要访问宿主机上的模型

，请在 .env 中设置 ALLOW_PRIVATE_AI_ENDPOINTS=true ，或把允许的主机名写入 ALLOWED_AI_HOSTS 。

• 即使开启本地放行，链路本地地址（如云厂商元数据 169.254.169.254 ）仍然会被拒绝。

• MCP 插件 URL 不受该开关影响，继续走严格的公网校验。

中转 API 配置

支持所有 OpenAI 兼容格式的中转服务：

New API 示例

OPENAI_API_KEY=sk-xxxxxxxx

OPENAI_BASE_URL=https://api.new-api.com/v1

其他中转服务

OPENAI_BASE_URL=https://your-proxy-service.com/v1

🐳 Docker 部署详情

服务架构

- postgres : PostgreSQL 18 数据库

• 端口: 5432

• 数据持久化: postgres_data volume

• 初始化脚本: backend/scripts/init_postgres.sql （自动挂载）

• 优化配置: 支持 80-150 并发用户

- mumuainovel : 主应用服务

• 端口: 8000

日志目录:

./logs

• 配置挂载: .env 文件

• 自动等待数据库就绪

• 健康检查: 每 30 秒检测一次

重要文件说明

文件 说明 是否必需

.env 环境配置（API Key、数据库密码等） ✅ 必需

docker-compose.yml 服务编排配置 ✅ 必需

backend/scripts/init_postgres.sql PostgreSQL 扩展安装脚本 ✅ 自动挂载

backend/embedding/models--*/ Embedding 模型文件 ⚠️ 自建需要

注意 : 使用 Docker Hub 镜像时，模型文件已包含在镜像中，无需额外下载

常用命令

启动服务

docker-compose up -d

查看状态

docker-compose ps

查看日志

docker-compose logs -f

停止服务

docker-compose down

重启服务

docker-compose restart

查看资源使用

docker stats

数据持久化

./postgres_data - PostgreSQL 数据库文件

./logs - 应用日志文件

端口配置

修改 docker-compose.yml 中的端口映射：

ports :

• " 8800:8000 " # 宿主机:容器

📁 项目结构

MuMuAINovel/ ├── backend/ # 后端服务 │ ├── app/ │ │ ├── api/ # API 路由 │ │ ├── models/ # 数据模型 │ │ ├── services/ # 业务逻辑 │ │ ├── middleware/ # 中间件 │ │ ├── database.py # 数据库连接 │ │ └── main.py # 应用入口 │ ├── scripts/ # 工具脚本 │ └── requirements.

txt # Python 依赖 ├── frontend/ # 前端应用 │ ├── src/ │ │ ├── pages/ # 页面组件 │ │ ├── components/ # 通用组件 │ │ ├── services/ # API 服务 │ │ └── store/ # 状态管理 │ └── package.json ├── docker-compose.yml # Docker Compose 配置 ├── Dockerfile # Docker 镜像构建 └── README.md

🛠️ 技术栈

后端 : FastAPI • PostgreSQL • SQLAlchemy • OpenAI/Claude/Gemini SDK

前端 : React 18 • TypeScript • Ant Design • Zustand • Vite

📖 使用指南

• 登录系统 - 使用本地账户或 LinuxDO 账户

• 创建项目 - 选择"使用向导创建"

• AI 生成 - 输入基本信息，AI 自动生成大纲和角色

• 编辑完善 - 管理角色关系，生成和编辑章节

API 文档

• Swagger UI: http://localhost:8000/docs

• ReDoc: http://localhost:8000/redoc

🤝 贡献

欢迎提交 Issue 和 Pull Request！

• Fork 本项目

• 创建特性分支 ( git checkout -b feature/AmazingFeature )

• 提交更改 ( git commit -m 'Add some AmazingFeature' )

• 推送到分支 ( git push origin feature/AmazingFeature )

• 提交 Pull Request

贡献者

感谢所有为本项目做出贡献的开发者！

📝 许可证

本项目采用 GNU General Public License v3.0

GPL v3 意味着：

• ✅ 可自由使用、修改和分发

• ✅ 可用于商业目的

• 📝 必须开源修改版本

• 📝 必须保留原作者版权

• 📝 衍生作品必须使用 GPL v3 协议

🙏 致谢

• FastAPI - Python Web 框架

• React - 前端框架

• Ant Design - UI 组件库

• PostgreSQL - 数据库

📧 联系方式

• 提交 Issue

• Linux DO 讨论

• 加入QQ群 QQ群

• 加入WX群 WX群

如果这个项目对你有帮助，请给个 ⭐️ Star！

Made with ❤️

Star History

History

— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。