# aixiaoshuo
**Repository Path**: zclcx521/aixiaoshuo
## Basic Information
- **Project Name**: aixiaoshuo
- **Description**: ai写小说
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-11-20
- **Last Updated**: 2026-03-24
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# AI小说创作助手 📚
**智能创作，无限可能**
[在线演示](https://your-demo-url.com) | [文档中心](./docs/) | [问题反馈](https://gitee.com/zclcx521/aixiaoshuo/issues)
## 📖 项目简介
AI小说创作助手是一个基于人工智能技术的专业小说创作平台，集成了先进的AI写作引擎、丰富的剧情模板库、智能角色管理等功能，为小说创作者提供全方位的创作支持。
### 🎯 核心价值
- **🤖 AI智能写作** - 基于大语言模型的智能写作建议和内容生成
- **📚 专业模板库** - 内置多种经典剧情结构模板，快速构建故事框架
- **👥 角色管理** - 完善的角色设定和关系管理系统
- **⏰ 时间线控制** - 可视化故事时间轴编辑和管理
- **🎭 情感分析** - 实时分析文本情感，优化故事节奏
- **🔍 一致性检查** - 智能检测故事逻辑一致性问题
- **📝 伏笔追踪** - 专业的伏笔设置和追踪管理
- **🌍 世界观构建** - 完整的背景设定和世界观管理
## ✨ 功能特性
### 🎨 AI写作助手
- **智能续写** - 根据上下文智能生成后续内容
- **风格模仿** - 学习指定作者或作品的写作风格
- **多语言支持** - 支持中英文等多种语言创作
- **实时建议** - 写作过程中提供实时优化建议
- **个性化训练** - 根据用户写作习惯进行模型微调
### 📚 剧情模板库
- **经典结构** - 英雄之旅、三幕剧、悬疑推理等经典模板
- **现代叙事** - 多线叙事、非线性叙事、群像剧等现代结构
- **主题模板** - 成长故事、爱情故事、复仇故事等主题模板
- **自定义模板** - 支持创建、编辑、分享个人模板
- **智能推荐** - 根据项目特点智能推荐合适模板
### 👥 角色管理系统
- **角色档案** - 详细的角色信息管理
- **关系图谱** - 可视化角色关系网络
- **成长轨迹** - 角色发展历程记录
- **性格分析** - 基于心理学的角色性格分析
- **对话风格** - 角色对话风格个性化设置
### ⏰ 时间线管理
- **可视化时间轴** - 直观的时间线编辑界面
- **多时间维度** - 支持故事时间、写作时间等多维度管理
- **事件关联** - 时间线事件与情节自动关联
- **冲突检测** - 时间线逻辑冲突自动检测
### 🎭 情感分析引擎
- **实时情感识别** - 文本情感实时分析
- **情感曲线** - 故事情感起伏可视化
- **节奏优化** - 基于情感分析的故事节奏建议
- **情感对比** - 不同章节、角色情感对比分析
### 🔍 一致性检查器
- **逻辑一致性** - 故事逻辑自动检查
- **角色一致性** - 角色行为一致性验证
- **时间一致性** - 时间线一致性检查
- **设定一致性** - 世界观设定一致性验证
### 📝 伏笔追踪系统
- **伏笔设置** - 专业的伏笔记录和管理
- **呼应检测** - 伏笔与呼应自动匹配
- **伏笔图谱** - 伏笔关系可视化展示
- **完成度追踪** - 伏笔完成状态实时更新
### 🌍 世界观构建器
- **地理设定** - 完整的世界地理信息管理
- **历史年表** - 世界历史时间线管理
- **文化体系** - 语言、宗教、习俗等文化设定
- **规则设定** - 物理、魔法等世界规则管理
## 📚 文档
- **[📖 用户使用指南](./USER_GUIDE.md)** - 详细的功能使用教程
- **[🔧 安装部署指南](./INSTALL.md)** - 完整的安装和部署说明
- **[📚 API 参考文档](./docs/api-reference.md)** - 开发者API文档
- **[🎭 剧情模板说明](./docs/plot-templates.md)** - 模板系统详细介绍
- **[📋 更新日志](./CHANGELOG.md)** - 版本更新记录
- **[📄 许可证](./LICENSE)** - MIT 许可证
## 🚀 快速开始
### 📋 环境要求
- **Node.js** >= 16.0.0
- **npm** >= 8.0.0 或 **yarn** >= 1.22.0
- **现代浏览器** (Chrome 90+, Firefox 88+, Safari 14+)
### ⚙️ 安装步骤
1. **克隆项目**
```bash
git clone https://gitee.com/zclcx521/aixiaoshuo.git
cd aixiaoshuo
```
2. **安装依赖**
```bash
npm install
# 或者
yarn install
```
3. **启动开发服务器**
```bash
npm run dev
# 或者
yarn dev
```
4. **访问应用**
打开浏览器访问 [http://localhost:5173](http://localhost:5173)
详细安装说明请参考 [安装部署指南](./INSTALL.md)。
### 🔧 可选配置
如果需要使用后端AI服务，请按照以下步骤配置：
1. **安装Python依赖**
```bash
cd backend
pip install -r requirements.txt
```
2. **启动后端服务**
```bash
npm run backend
```
3. **配置API地址**
在 `src/config/ai-models.ts` 中配置您的AI服务API地址
## 📖 使用指南
### 🎯 新手入门
1. **创建新项目**
- 点击"新建项目"按钮
- 输入项目名称和基本信息
- 选择合适的剧情模板
2. **开始写作**
- 在写作界面输入故事内容
- 使用AI助手获取写作建议
- 实时查看情感分析和一致性检查结果
3. **管理角色**
- 在角色管理器中添加角色信息
- 设置角色关系和性格特征
- 跟踪角色成长轨迹
4. **控制时间线**
- 在时间线管理器中设置故事时间
- 添加关键事件和情节节点
- 检查时间线逻辑一致性
### 🎨 高级功能
#### AI写作配置
- 在设置页面配置AI模型参数
- 选择合适的写作风格和创意程度
- 设置个性化偏好
#### 模板自定义
- 复制现有模板进行修改
- 调整模板结构和参数
- 保存为个人模板
#### 协作功能
- 邀请协作者加入项目
- 设置不同权限级别
- 实时同步编辑内容
## 🏗️ 技术架构
### 📦 技术栈
- **前端框架**: React 18.2.0 + TypeScript 4.9.3
- **构建工具**: Vite 4.1.0
- **UI组件库**: Ant Design 5.3.0 + Tailwind CSS 3.2.7
- **状态管理**: Zustand 4.3.6
- **路由管理**: React Router 6.8.0
- **数据请求**: Axios 1.3.4 + React Query 4.24.6
- **代码编辑器**: Monaco Editor 4.4.6
- **测试框架**: Jest 29.7.0 + Testing Library 14.1.2
### 🏛️ 项目结构
```
src/
├── components/ # React组件
│ ├── ui/ # 基础UI组件
│ └── __tests__/ # 组件测试
├── services/ # 业务服务层
│ └── __tests__/ # 服务测试
├── types/ # TypeScript类型定义
├── config/ # 配置文件
├── hooks/ # 自定义Hooks
├ contexts/ # React Context
├── store/ # 状态管理
└── utils/ # 工具函数
```
### 🔧 核心模块
#### AI写作服务 (`services/aiWritingService.ts`)
- AI模型调用和响应处理
- 写作建议生成
- 文本风格分析
#### 剧情模板服务 (`services/plotTemplateService.ts`)
- 模板管理和应用
- 模板验证和推荐
- 自定义模板支持
#### 角色管理服务 (`services/characterService.ts`)
- 角色信息管理
- 关系图谱构建
- 角色发展追踪
#### 时间线服务 (`services/timelineManagerService.ts`)
- 时间线数据管理
- 事件关联和冲突检测
- 时间可视化
## 🧪 测试
### 📊 运行测试
```bash
# 运行所有测试
npm test
# 监听模式运行测试
npm run test:watch
# 生成测试覆盖率报告
npm run test:coverage
```
### 🎯 测试覆盖
- **单元测试**: 核心服务和工具函数
- **组件测试**: React组件功能测试
- **集成测试**: 模块间交互测试
- **端到端测试**: 完整用户流程测试
## 📦 构建部署
### 🏗️ 构建生产版本
```bash
npm run build
```
### 🚀 部署选项
#### 1. 静态部署
```bash
npm run preview
```
#### 2. Docker部署
```dockerfile
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "run", "preview"]
```
#### 3. 云平台部署
- **Vercel**: 支持一键部署
- **Netlify**: 静态站点部署
- **阿里云**: 支持多种部署方式
## 🤝 贡献指南
我们欢迎所有形式的贡献！
### 📝 贡献方式
1. **报告问题** - 在Issues中报告bug或提出建议
2. **提交代码** - Fork项目并提交Pull Request
3. **完善文档** - 改进文档和示例
4. **分享经验** - 分享使用经验和最佳实践
### 🔄 开发流程
1. Fork项目到个人仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建Pull Request
### 📋 代码规范
- 使用TypeScript进行类型检查
- 遵循ESLint和Prettier代码格式规范
- 编写单元测试覆盖新功能
- 更新相关文档
## 📄 许可证
本项目采用 [MIT License](LICENSE) 开源协议。
## 🙏 致谢
感谢以下开源项目和贡献者：
- [React](https://reactjs.org/) - 用户界面构建
- [TypeScript](https://www.typescriptlang.org/) - 类型安全的JavaScript
- [Ant Design](https://ant.design/) - 企业级UI设计语言
- [Vite](https://vitejs.dev/) - 下一代前端构建工具
- [Tailwind CSS](https://tailwindcss.com/) - 实用优先的CSS框架
## 📞 联系我们
- **项目主页**: [https://gitee.com/zclcx521/aixiaoshuo](https://gitee.com/zclcx521/aixiaoshuo)
- **问题反馈**: [Issues](https://gitee.com/zclcx521/aixiaoshuo/issues)
- **邮箱**: zclcx521@gitee.com
## 🗺️ 路线图
### 📅 版本计划
#### v1.1.0 (计划中)
- [ ] 协作编辑功能
- [ ] 更多AI模型支持
- [ ] 移动端适配
- [ ] 插件系统
#### v1.2.0 (规划中)
- [ ] 语音输入支持
- [ ] 多语言界面
- [ ] 云端同步
- [ ] 社区模板市场
#### v2.0.0 (长期规划)
- [ ] AI角色自动生成
- [ ] 智能情节推荐
- [ ] 多媒体内容支持
- [ ] 出版流程集成
---
**⭐ 如果这个项目对您有帮助，请给我们一个Star！**
Made with ❤️ by AI Novel Writer Team