88 lines
2.5 KiB
Markdown
88 lines
2.5 KiB
Markdown
# 文档集功能需求文档
|
||
|
||
## 1. 功能概述
|
||
|
||
文档集功能允许用户管理文档，在添加上下文时可以选择文档加载到输入框中，发送给 AI 作为对话上下文。
|
||
|
||
## 2. 核心流程
|
||
|
||
### 2.1 添加文档集入口
|
||
1. 用户点击"添加上下文"中的"文档"按钮
|
||
2. 如果文档集为空，显示"添加文档集"按钮
|
||
3. 点击按钮跳转到"设置 → 上下文"页面
|
||
|
||
### 2.2 创建文档集
|
||
1. 在设置的上下文页面，点击"添加文档集"按钮
|
||
2. 弹出文档集创建对话框
|
||
3. 用户输入文档集名称
|
||
4. 用户点击"添加文件"按钮，选择文件
|
||
5. 系统验证文件（格式、大小、数量）
|
||
6. 显示已选文件列表和统计信息
|
||
7. 用户点击"确定"，保存文档集
|
||
8. 系统持久化文档集信息到 `globalState`
|
||
|
||
### 2.3 使用文档
|
||
1. 用户点击"添加上下文"中的"文档"按钮
|
||
2. 显示所有文档列表（自动同步设置中的文档集）
|
||
3. 用户点击选择一个或多个文档
|
||
4. 文档路径加载到输入框中
|
||
5. 用户发送消息，后端读取文档内容作为上下文
|
||
|
||
### 2.4 管理文档集
|
||
1. 在设置的上下文页面查看文档列表
|
||
2. 显示每个文档的更新时间
|
||
3. 支持修改文档名称
|
||
4. 支持删除文档
|
||
|
||
## 3. 功能详细需求
|
||
|
||
### 3.1 前端需求
|
||
|
||
#### 3.1.1 添加上下文 - 文档按钮
|
||
**功能**:
|
||
- 点击"文档"按钮，显示文档列表弹窗
|
||
- 如果没有文档，显示"添加文档集"按钮
|
||
- 点击"添加文档集"按钮，跳转到设置的上下文页面
|
||
|
||
#### 3.1.2 文档列表弹窗
|
||
**UI 元素**:
|
||
- 文档列表（显示所有文档集中的文档）
|
||
- 每个文档显示：名称
|
||
- 支持多选
|
||
- 确定/取消按钮
|
||
|
||
**交互逻辑**:
|
||
- 自动同步设置中的文档集
|
||
- 点击文档选中/取消选中
|
||
- 点击确定，将选中文档路径加载到输入框
|
||
|
||
#### 3.1.3 设置 - 上下文页面
|
||
**UI 元素**:
|
||
- "添加文档集"按钮
|
||
- 文档列表
|
||
- 每个文档显示：名称、更新时间、修改名称按钮、删除按钮
|
||
|
||
**交互逻辑**:
|
||
- 点击"添加文档集"打开创建对话框
|
||
- 点击修改名称，弹出输入框修改
|
||
- 点击删除，删除二次确认弹窗 确认删除文档
|
||
|
||
#### 3.1.4 文档集创建对话框
|
||
**UI 元素**:
|
||
|
||
- 文档集名称输入框
|
||
- 添加文件按钮
|
||
- 文件列表显示区域
|
||
- 确定/取消按钮
|
||
|
||
**交互逻辑**:
|
||
- 点击"添加文件"触发文件选择器
|
||
- 显示已选文件的相对路径和大小
|
||
- 支持删除单个文件
|
||
- 实时更新统计信息
|
||
|
||
### 3.2 后端需求
|
||
|
||
后端只需要支持读取pdf,txt,.v,.sv，.md这些类型的文档
|
||
|