{"id":33345931,"url":"https://github.com/hxsltim/nai","last_synced_at":"2026-04-08T16:01:50.062Z","repository":{"id":324547114,"uuid":"1097597112","full_name":"HXSLtim/Nai","owner":"HXSLtim","description":"AI小说创作系统 - 基于多Agent协作的智能小说创作平台，支持世界观管理、角色管理、大纲管理和一致性保障","archived":false,"fork":false,"pushed_at":"2025-11-16T13:57:24.000Z","size":542,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-16T15:21:47.038Z","etag":null,"topics":["agent","ai","chatgpt","chromadb","creative-writing","fastapi","langchain","llm","multi-agent-systems","nextjs","novel","python","rag","typescript","writing"],"latest_commit_sha":null,"homepage":"https://github.com/HXSLtim/Nai","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HXSLtim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-16T13:40:44.000Z","updated_at":"2025-11-16T13:58:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/HXSLtim/Nai","commit_stats":null,"previous_names":["hxsltim/nai"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/HXSLtim/Nai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HXSLtim%2FNai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HXSLtim%2FNai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HXSLtim%2FNai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HXSLtim%2FNai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HXSLtim","download_url":"https://codeload.github.com/HXSLtim/Nai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HXSLtim%2FNai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31562697,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","chatgpt","chromadb","creative-writing","fastapi","langchain","llm","multi-agent-systems","nextjs","novel","python","rag","typescript","writing"],"created_at":"2025-11-22T05:00:47.014Z","updated_at":"2026-04-08T16:01:50.057Z","avatar_url":"https://github.com/HXSLtim.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI小说创作系统\n\n一个基于多Agent协作的智能小说创作平台，支持世界观管理、角色管理、大纲管理和一致性保障。\n\n## 🚀 核心功能\n\n- **多Agent协作写作**：三个专业Agent分工协作\n  - Agent A：世界观描写（环境、氛围、魔法体系）\n  - Agent B：角色对话（性格、心理、动作描写）\n  - Agent C：剧情控制（整合、推进、伏笔）\n\n- **RAG检索增强**：混合检索策略\n  - 向量检索（语义相似度）\n  - BM25关键词检索（精确匹配）\n  - 元数据过滤（章节、时间线、角色）\n\n- **一致性保障**：四层防护机制\n  - 规则引擎（硬规则验证）\n  - 知识图谱（关系验证）\n  - 时间线管理（时间验证）\n  - 情绪状态机（行为验证）\n\n## 🏗️ 技术栈\n\n**后端**\n- FastAPI - 高性能API框架\n- LangGraph - 多Agent编排\n- LlamaIndex - RAG检索\n- Qdrant - 向量数据库\n- PostgreSQL - 关系数据库\n- Redis - 缓存\n- Neo4j - 知识图谱\n\n**前端**\n- Next.js 14 - React框架\n- TailwindCSS - UI样式\n- D3.js - 关系图谱可视化\n\n**LLM**\n- GPT-4o（复杂任务）\n- GPT-4o-mini（简单任务）\n\n## 📂 项目结构\n\n```\nNai/\n├── backend/                    # 后端服务\n│   ├── app/\n│   │   ├── main.py            # FastAPI入口\n│   │   ├── api/               # API路由\n│   │   ├── services/          # 业务逻辑\n│   │   │   ├── agent_service.py        # 多Agent服务\n│   │   │   ├── rag_service.py          # RAG检索服务\n│   │   │   ├── consistency_service.py  # 一致性检查服务\n│   │   ├── models/            # 数据模型\n│   │   └── core/              # 核心配置\n│   ├── requirements.txt\n│   └── Dockerfile\n├── frontend/                   # 前端界面\n│   ├── app/                   # Next.js页面\n│   ├── components/            # React组件\n│   ├── package.json\n│   └── Dockerfile\n├── docker-compose.yml         # 容器编排\n├── .env.example              # 环境变量模板\n└── README.md                 # 本文件\n```\n\n## 🚀 快速开始\n\n### 1. 环境准备\n\n```bash\n# 克隆项目\ncd Nai\n\n# 复制环境变量\ncp .env.example .env\n\n# 编辑.env，填入OpenAI API密钥\n# OPENAI_API_KEY=your_api_key_here\n```\n\n### 2. 启动服务\n\n```bash\n# 启动数据库（Qdrant + PostgreSQL + Redis）\ndocker-compose up -d\n\n# 安装后端依赖\ncd backend\npip install -r requirements.txt\n\n# 启动后端\nuvicorn app.main:app --reload --host 0.0.0.0 --port 8000\n\n# 启动前端（新终端）\ncd frontend\nnpm install\nnpm run dev\n```\n\n### 3. 访问系统\n\n- 前端界面：http://localhost:3000\n- 后端API文档：http://localhost:8000/docs\n- Qdrant管理界面：http://localhost:6333/dashboard\n\n## 📖 使用指南\n\n### 创建小说项目\n\n1. 在前端创建新小说项目\n2. 定义世界观规则（魔法体系、地理等）\n3. 创建角色（性格、关系、背景）\n4. 规划大纲（章节、剧情点）\n\n### 生成内容\n\n1. 输入剧情提示词（如\"主角在魔法塔顶与导师决裂\"）\n2. 系统自动执行三Agent工作流：\n   - Agent A生成世界观描写\n   - Agent B生成角色对话\n   - Agent C整合并推进剧情\n3. 一致性检查\n4. 输出最终段落\n\n### 管理内容\n\n- **世界观管理**：编辑魔法规则、地理设定、历史事件\n- **角色管理**：更新角色性格、关系网、情绪状态\n- **大纲管理**：调整章节结构、剧情走向、伏笔\n\n## 🔧 配置说明\n\n### 环境变量（.env）\n\n```env\n# OpenAI API\nOPENAI_API_KEY=your_key\n\n# 数据库\nPOSTGRES_HOST=localhost\nPOSTGRES_PORT=5432\nPOSTGRES_DB=novel_db\nPOSTGRES_USER=postgres\nPOSTGRES_PASSWORD=password\n\n# Qdrant\nQDRANT_HOST=localhost\nQDRANT_PORT=6333\n\n# Redis\nREDIS_HOST=localhost\nREDIS_PORT=6379\n\n# Neo4j（知识图谱）\nNEO4J_URI=bolt://localhost:7687\nNEO4J_USER=neo4j\nNEO4J_PASSWORD=password\n```\n\n## 📊 开发路线图\n\n- [x] 技术方案设计\n- [x] 项目结构初始化\n- [ ] 后端核心模块开发\n  - [ ] FastAPI基础框架\n  - [ ] Qdrant集成\n  - [ ] LangGraph三Agent工作流\n  - [ ] LlamaIndex RAG检索\n  - [ ] 一致性检查系统\n- [ ] 前端界面开发\n  - [ ] 小说管理界面\n  - [ ] 世界观管理界面\n  - [ ] 角色管理界面\n  - [ ] 大纲管理界面\n  - [ ] 实时生成界面\n- [ ] 测试与优化\n- [ ] 部署上线\n\n## 📚 文档\n\n详细技术文档请查看 `.claude/` 目录：\n- `executive-summary.md` - 执行摘要\n- `technology-comparison.md` - 技术选型对比\n- `ai-novel-writing-system-analysis.md` - 完整技术方案\n- `quick-reference.md` - 快速参考\n\n## 🤝 贡献\n\n欢迎提交Issue和Pull Request！\n\n## 📄 许可证\n\nMIT License\n\n## 📞 联系方式\n\n- **项目维护者**：hahage\n- **邮箱**：a2778978136@163.com\n- **GitHub**：HXSLtim\n- **技术交流**：欢迎提交Issue或Pull Request\n\n如有问题或建议，请通过以下方式联系：\n- 提交GitHub Issue（推荐）\n- 发送邮件至 a2778978136@163.com\n- GitHub: https://github.com/HXSLtim/Nai\n\n---\n\n**开发时间**：2025-11-14\n**版本**：Alpha 0.1.0\n**状态**：开发中\n**项目维护者**：hahage\n**联系方式**：a2778978136@163.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhxsltim%2Fnai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhxsltim%2Fnai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhxsltim%2Fnai/lists"}