IC-Coder-Plugin/docs/文档集功能需求文档.md

文档集功能需求文档

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这些类型的文档