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 辅助内容创作领域的实用软件项目。