mesalogo
dd8289fdef
Knowledge selection was shared globally, document readiness overstated usable content, and important import and source-management paths exposed technical details or lacked safe recovery actions. Knowledge scope now persists per conversation, readiness reflects real processing channels, and the workspace guides users from creation and import into cited chat with controlled source actions. Release note: 知识库现按对话保存使用范围，准确区分可用、处理中和失败文档，并提供更简洁的创建、检索测试、来源打开、删除确认和失败重试流程。
2.6 KiB
知识库 UI 设计
1. 设计目标
知识库优先帮助普通用户完成“添加资料并可靠提问”，高级 RAG 调试和图谱维护不得阻塞 首次使用。全局视觉、页面壳层、通知、焦点和危险操作遵循 UI-DESIGN.md。
2. 信息架构
知识库
├─ 知识库列表
└─ 当前知识库
├─ 文档与来源
├─ 知识图谱（启用后显示）
├─ 任务中心
└─ 高级设置
标题区提供“用于当前对话”“检索测试”、编辑和删除。新建知识库是页面主操作。 “高级设置”承载问答效果入口、向量索引、分块与图谱配置，不把工程参数放在首次路径。
3. 首次使用
没有知识库时，页面空状态显示唯一的“新建知识库”主操作。创建表单默认只展示名称和 描述；存储方式与知识图谱放入折叠的“高级设置”。创建完成后进入“文档与来源”，用户 可以导入文件、文件夹或 URL。
文档处理完成后，标题区“用于当前对话”可用。该操作把当前知识库加入当前 Conversation 的检索范围，返回对话并聚焦输入框。
4. 状态
知识库列表显示“可用”和“需处理”文档数。详情标题持续显示可检索、处理中、需处理和 总文档数，即使用户填写了知识库描述也不隐藏状态。
文档行显示：
- 总体处理状态。
- 全文状态。
- 向量状态。
- 启用图谱时的图谱状态。
失败文档保留错误信息和“重新处理”。只要仍有可用分块，就允许打开分块管理，避免隐藏 上一版可用索引。
5. 问答效果与高级参数
“检索测试”默认只突出真实问题、测试按钮和结果。高级参数使用折叠区，包含候选倍数、 通道权重、最低相似度、重排、结果数和上下文预算。“高级设置 → 问答效果”打开同一 工作台。
向量模型未配置时显示“前往设置”，直接进入模型连接，不使用只有说明文字的死路状态。
6. 来源操作
文档行提供“打开来源”，Main 根据知识库和文档归属重新读取保存的文件路径或 URL。 移除来源使用确认对话框，说明文档数、索引、图谱证据和托管副本影响。初始焦点位于 取消，提交期间禁止重复操作，失败时保留对话框和错误。
7. 对话范围
知识库多选属于 Conversation。新对话默认空范围；切换对话恢复各自选择。创建新知识库 只加入当前 Conversation，不重新启用其他已取消项。发送请求时冻结当前选择和检索方式。