https://github.com/hxsltim/nai
AI小说创作系统 - 基于多Agent协作的智能小说创作平台，支持世界观管理、角色管理、大纲管理和一致性保障
https://github.com/hxsltim/nai
agent ai chatgpt chromadb creative-writing fastapi langchain llm multi-agent-systems nextjs novel python rag typescript writing
Last synced: 3 months ago
JSON representation
AI小说创作系统 - 基于多Agent协作的智能小说创作平台，支持世界观管理、角色管理、大纲管理和一致性保障
- Host: GitHub
- URL: https://github.com/hxsltim/nai
- Owner: HXSLtim
- Created: 2025-11-16T13:40:44.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-11-16T13:57:24.000Z (8 months ago)
- Last Synced: 2025-11-16T15:21:47.038Z (8 months ago)
- Topics: agent, ai, chatgpt, chromadb, creative-writing, fastapi, langchain, llm, multi-agent-systems, nextjs, novel, python, rag, typescript, writing
- Language: Python
- Homepage: https://github.com/HXSLtim/Nai
- Size: 529 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AI小说创作系统
一个基于多Agent协作的智能小说创作平台，支持世界观管理、角色管理、大纲管理和一致性保障。
## 🚀 核心功能
- **多Agent协作写作**：三个专业Agent分工协作
- Agent A：世界观描写（环境、氛围、魔法体系）
- Agent B：角色对话（性格、心理、动作描写）
- Agent C：剧情控制（整合、推进、伏笔）
- **RAG检索增强**：混合检索策略
- 向量检索（语义相似度）
- BM25关键词检索（精确匹配）
- 元数据过滤（章节、时间线、角色）
- **一致性保障**：四层防护机制
- 规则引擎（硬规则验证）
- 知识图谱（关系验证）
- 时间线管理（时间验证）
- 情绪状态机（行为验证）
## 🏗️ 技术栈
**后端**
- FastAPI - 高性能API框架
- LangGraph - 多Agent编排
- LlamaIndex - RAG检索
- Qdrant - 向量数据库
- PostgreSQL - 关系数据库
- Redis - 缓存
- Neo4j - 知识图谱
**前端**
- Next.js 14 - React框架
- TailwindCSS - UI样式
- D3.js - 关系图谱可视化
**LLM**
- GPT-4o（复杂任务）
- GPT-4o-mini（简单任务）
## 📂 项目结构
```
Nai/
├── backend/ # 后端服务
│ ├── app/
│ │ ├── main.py # FastAPI入口
│ │ ├── api/ # API路由
│ │ ├── services/ # 业务逻辑
│ │ │ ├── agent_service.py # 多Agent服务
│ │ │ ├── rag_service.py # RAG检索服务
│ │ │ ├── consistency_service.py # 一致性检查服务
│ │ ├── models/ # 数据模型
│ │ └── core/ # 核心配置
│ ├── requirements.txt
│ └── Dockerfile
├── frontend/ # 前端界面
│ ├── app/ # Next.js页面
│ ├── components/ # React组件
│ ├── package.json
│ └── Dockerfile
├── docker-compose.yml # 容器编排
├── .env.example # 环境变量模板
└── README.md # 本文件
```
## 🚀 快速开始
### 1. 环境准备
```bash
# 克隆项目
cd Nai
# 复制环境变量
cp .env.example .env
# 编辑.env，填入OpenAI API密钥
# OPENAI_API_KEY=your_api_key_here
```
### 2. 启动服务
```bash
# 启动数据库（Qdrant + PostgreSQL + Redis）
docker-compose up -d
# 安装后端依赖
cd backend
pip install -r requirements.txt
# 启动后端
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
# 启动前端（新终端）
cd frontend
npm install
npm run dev
```
### 3. 访问系统
- 前端界面：http://localhost:3000
- 后端API文档：http://localhost:8000/docs
- Qdrant管理界面：http://localhost:6333/dashboard
## 📖 使用指南
### 创建小说项目
1. 在前端创建新小说项目
2. 定义世界观规则（魔法体系、地理等）
3. 创建角色（性格、关系、背景）
4. 规划大纲（章节、剧情点）
### 生成内容
1. 输入剧情提示词（如"主角在魔法塔顶与导师决裂"）
2. 系统自动执行三Agent工作流：
- Agent A生成世界观描写
- Agent B生成角色对话
- Agent C整合并推进剧情
3. 一致性检查
4. 输出最终段落
### 管理内容
- **世界观管理**：编辑魔法规则、地理设定、历史事件
- **角色管理**：更新角色性格、关系网、情绪状态
- **大纲管理**：调整章节结构、剧情走向、伏笔
## 🔧 配置说明
### 环境变量（.env）
```env
# OpenAI API
OPENAI_API_KEY=your_key
# 数据库
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DB=novel_db
POSTGRES_USER=postgres
POSTGRES_PASSWORD=password
# Qdrant
QDRANT_HOST=localhost
QDRANT_PORT=6333
# Redis
REDIS_HOST=localhost
REDIS_PORT=6379
# Neo4j（知识图谱）
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=password
```
## 📊 开发路线图
- [x] 技术方案设计
- [x] 项目结构初始化
- [ ] 后端核心模块开发
- [ ] FastAPI基础框架
- [ ] Qdrant集成
- [ ] LangGraph三Agent工作流
- [ ] LlamaIndex RAG检索
- [ ] 一致性检查系统
- [ ] 前端界面开发
- [ ] 小说管理界面
- [ ] 世界观管理界面
- [ ] 角色管理界面
- [ ] 大纲管理界面
- [ ] 实时生成界面
- [ ] 测试与优化
- [ ] 部署上线
## 📚 文档
详细技术文档请查看 `.claude/` 目录：
- `executive-summary.md` - 执行摘要
- `technology-comparison.md` - 技术选型对比
- `ai-novel-writing-system-analysis.md` - 完整技术方案
- `quick-reference.md` - 快速参考
## 🤝 贡献
欢迎提交Issue和Pull Request！
## 📄 许可证
MIT License
## 📞 联系方式
- **项目维护者**：hahage
- **邮箱**：a2778978136@163.com
- **GitHub**：HXSLtim
- **技术交流**：欢迎提交Issue或Pull Request
如有问题或建议，请通过以下方式联系：
- 提交GitHub Issue（推荐）
- 发送邮件至 a2778978136@163.com
- GitHub: https://github.com/HXSLtim/Nai
---
**开发时间**：2025-11-14
**版本**：Alpha 0.1.0
**状态**：开发中
**项目维护者**：hahage
**联系方式**：a2778978136@163.com