122 lines
3.3 KiB
Markdown
122 lines
3.3 KiB
Markdown
# Interactive Mindmap
|
||
|
||
基于 Next.js、FastAPI 和 SQLite 的交互式思维导图应用，支持通过腾讯云 AI Agent 对话生成思维导图。
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
mindmap/
|
||
├── backend/ # FastAPI 后端
|
||
│ ├── app/
|
||
│ │ ├── main.py # 应用入口
|
||
│ │ ├── config.py # 配置
|
||
│ │ ├── database.py # 数据库
|
||
│ │ ├── models.py # 数据模型
|
||
│ │ ├── schemas.py # Pydantic schemas
|
||
│ │ └── routers/
|
||
│ │ ├── mindmaps.py # 思维导图 CRUD API
|
||
│ │ └── chat.py # AI 对话代理 (SSE)
|
||
│ ├── data/ # SQLite 数据库文件
|
||
│ ├── requirements.txt
|
||
│ └── .env.example
|
||
├── frontend/ # Next.js 前端
|
||
│ ├── app/
|
||
│ │ ├── page.tsx # 首页
|
||
│ │ └── mindmap/
|
||
│ │ ├── [id]/page.tsx # 思维导图详情页
|
||
│ │ └── chat/page.tsx # AI 对话 + 思维导图页
|
||
│ ├── components/
|
||
│ │ ├── MindmapCanvas.tsx # 思维导图画布
|
||
│ │ ├── MindmapNodeCard.tsx # 节点卡片
|
||
│ │ ├── ChatPanel.tsx # 聊天面板
|
||
│ │ └── CreateMindmapForm.tsx # 创建表单
|
||
│ ├── lib/
|
||
│ │ ├── api.ts # API 调用
|
||
│ │ └── treeToGraph.ts # 树转图布局
|
||
│ └── types/
|
||
│ └── mindmap.ts # TypeScript 类型
|
||
└── mind_prompt.md # AI Agent 系统提示词
|
||
```
|
||
|
||
## 环境配置
|
||
|
||
### 后端
|
||
|
||
1. 安装依赖:
|
||
|
||
```bash
|
||
cd backend
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
2. 配置环境变量:
|
||
|
||
```bash
|
||
# 复制示例配置
|
||
cp .env.example .env
|
||
|
||
# 编辑 .env，填入腾讯云 AI Agent 的 bot_app_key
|
||
TENCENT_BOT_APP_KEY=your-key-here
|
||
```
|
||
|
||
3. 启动后端:
|
||
|
||
```bash
|
||
TENCENT_BOT_APP_KEY=your-key-here uvicorn app.main:app --reload
|
||
```
|
||
|
||
### 前端
|
||
|
||
1. 安装依赖:
|
||
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
```
|
||
|
||
2. 启动开发服务器:
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
## 页面说明
|
||
|
||
### 首页 `/`
|
||
|
||
输入主题创建思维导图（使用 mock 数据）。
|
||
|
||
### 思维导图详情 `/mindmap/[id]`
|
||
|
||
查看已保存的思维导图，支持节点展开/收缩。
|
||
|
||
### AI 对话生成 `/mindmap/chat?sessionId=xxx`
|
||
|
||
通过与腾讯云 AI Agent 对话生成思维导图：
|
||
|
||
- **左侧**: 思维导图画布，初始为空，AI 返回有效数据后自动渲染
|
||
- **右侧**: 聊天面板，支持实时 SSE 流式响应
|
||
|
||
URL 参数:
|
||
- `sessionId` (必填): 会话 ID，用于标识对话会话
|
||
|
||
## 数据流
|
||
|
||
```
|
||
用户输入 → ChatPanel → POST /api/chat → 后端代理 → 腾讯云 SSE API
|
||
↓
|
||
画布更新 ← onMindmapUpdate ← JSON 解析 ← SSE 流式响应 ←─┘
|
||
```
|
||
|
||
1. 用户在聊天面板输入消息
|
||
2. 前端发送 POST 请求到后端 `/api/chat`
|
||
3. 后端将请求代理到腾讯云 AI Agent SSE 接口
|
||
4. SSE 流式响应逐步返回到前端
|
||
5. 前端解析 SSE 事件，逐步显示 AI 回复
|
||
6. 当 AI 回复完成后，尝试从回复中提取思维导图 JSON
|
||
7. 如果提取成功，更新左侧画布
|
||
|
||
## AI Agent 配置
|
||
|
||
参见 [mind_prompt.md](./mind_prompt.md) 获取 AI Agent 的系统提示词配置。
|