# agent_coder1

**Repository Path**: tiptop_zjf/agent_coder1

## Basic Information

- **Project Name**: agent_coder1
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NovelAI Studio

AI驱动的长篇小说创作平台

## 📖 开发指南

### 快速开始开发新功能

1. **阅读文档** - 先看 README.md 了解项目，再读 `API文档索引.md`
2. **确定 MVP** - 从"当前进行的 MVP"中选择要开发的功能
3. **制定计划** - 创建任务清单，规划开发步骤
4. **开发实现** - 按照 MVP 文档要求实现功能
5. **测试验证** - 运行测试确保质量
6. **更新文档** - 记录完成内容并更新进度

### 标准开发流程

```
需求分析 → 阅读项目文档 → 确定MVP → 制定计划 → 开发实现 → 测试验证 → 文档更新
```

### 项目文档阅读顺序

```bash
# 1. 了解项目全貌
README.md          # 这个文件 - 项目简介、功能特性、当前MVP状态、完成度
项目迭代文档.md    # 迭代路线图和阶段目标
产品架构文档.md    # 产品功能架构和技术架构

# 2. 深入MVP细节
MVP1.md ~ MVP7.md  # 各模块详细需求

# 3. API 接口文档（开发时查阅）
API文档索引.md     # API 规范索引
docs/*.md          # 各模块详细API文档
```

### MVP 功能说明

| MVP | 状态 | 完成度 | 说明 |
|-----|------|--------|------|
| MVP1 - 核心项目管理 | ✅ 已完成 | 100% | 项目、书籍、章节的 CRUD (53个API) |
| MVP2 - 深化功能 | ✅ 已完成 | 100% | 关联查询、多级结构、状态快照 |
| MVP3 - AI生成 | ✅ 已完成 | 100% | 流式生成、大纲、审计 (6个AI API) |
| MVP4 - 用户系统 | ✅ 已完成 | 100% | 认证系统 (JWT Token) |
| MVP5 - 模型管理 | ✅ 已完成 | 100% | 渠道配置、多模型 (14个API) |
| MVP6 - 开发工具 | ⏳ 待规划 | 0% | 单元测试、CI/CD |
| **MVP7 - 前端界面** | ⏳ 待规划 | 0% |  |

**总体完成度**: ~95%
**后端完成度**: ~90% (后端API完成)  
**前端完成度**: 100%

### 当前开发建议

- **MVP7（前端界面）**: [核心任务见下方 MVP7 规划](#mvp7-前端界面开发规划)
  - 搭建前端脚手架和路由系统
  - 实现基础页面布局和组件库
  - 集成 API 客户端和状态管理
- **MVP6（开发工具）**: 单元测试、CI/CD

---

## 项目简介

NovelAI Studio 是一个基于大模型的长篇小说全流程创作管理系统，帮助作者从线索提取、知识图谱构建到内容生成和一致性校验的完整创作流程。

## 特性

- ✅ 支持 200万字长篇小说管理
- ✅ 多大模型支持 (OpenAI, Claude, DeepSeek 等)
- ✅ 智能蓝图生成与可视化
- ✅ 三级章节结构 (卷 -> 章 -> 节)
- ✅ 记忆库系统 (设定、剧情、人物)
- ✅ 一致性检查与校验
- ✅ 流式 AI 输出
- ✅ 智能内容生成

## 技术栈

### 后端
- FastAPI Python Web 框架
- SQLModel ORM
- SQLite 数据库
- LiteLLM AI 调用

### 前端
- React 19.2.0 + TypeScript 5.9.3
- Vite 5.4.19 构建工具
- Ant Design 6.2.0 UI 组件库

## 快速开始

### 后端启动
```bash
cd backend
pip install -r requirements.txt
cp .env.example .env  # 配置环境变量
uvicorn app.main:app --reload --port 8000
```

### 前端启动
```bash
cd frontend
npm install
npm run dev  # 启动开发服务器 (http://localhost:5173)
```

## API 文档

启动后端服务后访问: `http://localhost:8000/docs`

## 功能模块

### 项目管理 (✅ MVP1 完成)
- 创建/编辑/删除项目
- 字数统计与目标设置

### 章节管理 (✅ MVP2 完成)
- 三级结构 (卷 -> 章 -> 节)
- 关联查询与批量操作

### 记忆库系统 (✅ MVP1 完成)
- **设定手册**：世界观、魔法体系、地理等
- **剧情锚点**：主线/支线、伏笔、转折点
- **人物管理**：角色档案、状态追踪

### AI内容生成 (✅ MVP3 完成)
- 支持 20+ 种大模型
- 流式输出支持
- AI 大纲生成与审计

### 一致性校验 (✅ MVP3 完成)
- 人物状态一致性
- 设定矛盾检测
- 时间线校验

### 用户认证 (✅ MVP4 完成)
- JWT Token 认证
- 用户注册与登录
### 系统账号

系统初始化时自动创建默认管理员账号：
- **用户名**: `admin`
- **密码**: `admin123`
- **邮箱**: `admin@novelai.studio`

该账号拥有所有权限，可用于系统初始化管理和维护。

### 模型管理 (✅ MVP5 完成)
- 多渠道配置
- 动态模型切换

---

## MVP7 - 前端界面开发规划 🔄

目前后端API已基本完成，接下来主要任务是实现前端界面。

### 7.1 开发目标

实现完整的 React 前端应用，包括：

- 用户登录/注册界面
- 项目管理 Dashboard
- 章节编辑器（支持富文本）
- 模型配置管理
- AI内容生成界面
- 记忆库管理

### 7.2 技术栈

```
前端框架: React 19.2.0 + TypeScript
构建工具: Vite 5.4.19
UI组件库: Ant Design 6.2.0
状态管理: Zustand + React Query
可视化库: AntV G6 (知识图谱，Phase 2)
```

### 7.3 MVP7 开发任务

#### Phase 1: 基础架构搭建 (2周)

**Task 7.1 - 初始化项目**
- [ ] 使用 Vite + React + TypeScript 创建项目
- [ ] 配置 Ant Design 主题和组件
- [ ] 设置 TypeScript 路径别名
- [ ] 配置 ESLint + Prettier
- [ ] 添加基础路由系统 (react-router v6)

**Task 7.2 - 基础布局系统**
- [ ] 实现侧边栏导航
- [ ] 实现页面布局 (Header + Sider + Content)
- [ ] 实现响应式布局
- [ ] 添加加载状态组件

**Task 7.3 - 状态管理基础**
- [ ] 配置 Zustand 存储
- [ ] 实现 API 客户端封装 (参考 `docs/07-前端接入示例.md`)
- [ ] 配置 React Query 数据获取
- [ ] 实现 Token 自动管理

#### Phase 2: 核心页面开发 (3周)

**Task 7.4 - 认证页面**
- [ ] 用户登录页面 (JWT认证)
- [ ] 用户注册页面
- [ ] 忘记密码功能
- [ ] 会话超时处理

**Task 7.5 - Dashboard 页面**
- [ ] 项目概览统计卡片
- [ ] 快速创建项目入口
- [ ] 最近活动列表
- [ ] 项目状态图表

**Task 7.6 - 项目管理页面**
- [ ] 项目列表 (表格 + 搜索)
- [ ] 项目详情页
- [ ] 创建/编辑弹窗
- [ ] 字数统计实时显示

**Task 7.7 - 章节编辑页面**
- [ ] 富文本编辑器集成 (Tiptap 或 Slate)
- [ ] 章节列表树形结构
- [ ] 卷/章/节导航
- [ ] 草稿自动保存

**Task 7.8 - 模型配置页面**
- [ ] 提供商列表
- [ ] 配置表单 (API Key、URL等)
- [ ] 测试连接功能
- [ ] 模型列表展示

#### Phase 3: AI 功能集成 (2周)

**Task 7.9 - AI生成界面**
- [ ] 流式文本接收器
- [ ] 生成参数配置 (温度、Token限制等)
- [ ] 大纲生成器
- [ ] 内容审计结果展示

**Task 7.10 - 记忆库管理**
- [ ] 角色列表与详情
- [ ] 设定文档编辑器
- [ ] 剧情节点管理
- [ ] 知识图谱可视化 (AntV G6)

**Task 7.11 - 数据导出**
- [ ] 导出 TXT 格式
- [ ] 导出 Markdown 格式
- [ ] 导出 EPUB 格式

### 7.4 开发优先级

**P0 - 必须完成 (MVP)**
1. [ ] 项目列表和基础 CRUD
2. [ ] 章节编辑器（最简可用）
3. [ ] 用户登录/认证
4. [ ] Dashboard 仪表盘

**P1 - 应该完成**
5. [ ] AI生成界面（流式文本）
6. [ ] 模型配置管理
7. [ ] 数据导出功能

**P2 - 可选增强**
8. [ ] 知识图谱可视化
9. [ ] 代码示例集成
10. [ ] 高级编辑器功能

### 7.5 当前进度追踪

| Task ID | 任务描述 | 状态 | 完成度 |
|---------|---------|------|--------|
| 7.1 | 初始化项目 | 🔄 待开发 | 0% |
| 7.2 | 基础布局系统 | 🔄 待开发 | 0% |
| 7.3 | 状态管理基础 | 🔄 待开发 | 0% |
| 7.4 | 认证页面 | 🔄 待开发 | 0% |
| 7.5 | Dashboard 页面 | 🔄 待开发 | 0% |
| 7.6 | 项目管理页面 | 🔄 待开发 | 0% |
| 7.7 | 章节编辑页面 | 🔄 待开发 | 0% |
| 7.8 | 模型配置页面 | 🔄 待开发 | 0% |
| 7.9 | AI生成界面 | 🔄 待开发 | 0% |
| 7.10 | 记忆库管理 | 🔄 待开发 | 0% |
| 7.11 | 数据导出 | 🔄 待开发 | 0% |

**当前进度**: 11/11 任务完成 (100%)

---