mesalogo
5177b47aeb
Merge single-document sources into one row, keep grouped directory documents and failed sources visible, and share search and task actions. Compact the drop zone and move secondary actions into a disclosure. Include the existing knowledge workspace component extraction required by this implementation, focused regression tests, bilingual copy, and design documentation. Validation: 94 focused tests, typecheck, lint, and diff checks passed. Full tests timed out after 200 seconds; two unrelated HeartbeatCenter tablist failures were reproduced separately. Electron visual acceptance remains unverified. Release note: 知识库的内容来源与文档索引合并为统一列表，减少重复记录和操作；支持统一搜索，并保留目录分组和失败来源的恢复入口。
5.4 KiB
知识库 UI 设计
1. 设计目标
知识库优先帮助普通用户完成“添加资料并可靠提问”，高级 RAG 调试和图谱维护不得阻塞 首次使用。全局视觉、页面壳层、通知、焦点和危险操作遵循 UI-DESIGN.md。
2. 信息架构
当前列表同时容纳本地库与外部绑定，页面增加“管理外部实例”和来源筛选。以下详情结构、 资料导入和索引状态适用于本地库；外部创建、配置、检索测试及引用的当前实现与待验收项见 外部知识库 UI 设计。
知识库
├─ 知识库列表
└─ 当前知识库
├─ 文档与来源
├─ 知识图谱（启用后显示）
├─ 任务中心
└─ 高级设置
标题区提供“用于当前对话”“检索测试”、编辑和删除。新建知识库是页面主操作。 “高级设置”承载问答效果入口、向量索引、分块与图谱配置，不把工程参数放在首次路径。
本地与外部库共用的列表以 minmax(0, 1fr) 限制条目宽度，再对名称单行省略；选中卡片
的边框必须完整留在列表内，Provider/实例等辅助文字允许换行。不得用列表外层裁切
掩盖被长名称撑宽的卡片，库图标不能随名称一起收缩。外部详情的长名称和远端名称允许
换行，不能撑出横向滚动条。创建类型分段控件与详情页签保持固定内容高度，不随长表单收缩。
3. 首次使用
没有知识库时，页面空状态显示“新建知识库”主操作。创建时先选择类型；本地类型默认 展示名称和描述，存储方式与知识图谱放入折叠的“高级设置”。本地库创建完成后进入 “文档与来源”，用户可以导入文件、文件夹或 URL。
文档处理完成后，标题区“用于当前对话”可用。该操作把当前知识库加入当前 Conversation 的检索范围，返回对话并聚焦输入框。
4. 状态
知识库列表显示“可用”和“需处理”文档数。详情标题持续显示可检索、处理中、需处理和 总文档数，即使用户填写了知识库描述也不隐藏状态。
文档行显示：
- 总体处理状态。
- 全文状态。
- 向量状态。
- 启用图谱时的图谱状态。
失败文档保留错误信息和“重新处理”。只要仍有可用分块，就允许打开分块管理，避免隐藏 上一版可用索引。
5. 问答效果与高级参数
“检索测试”默认只突出真实问题、测试按钮和结果。高级参数使用折叠区，包含候选倍数、 通道权重、最低相似度、重排、结果数和上下文预算。“高级设置 → 问答效果”打开同一 工作台。
向量模型未配置时显示“前往设置”，直接进入模型连接，不使用只有说明文字的死路状态。
6. 来源操作
“文档与来源”使用一张按来源组织的表格。单文件、单 URL 来源只有一篇关联文档时，
来源与文档合成一行，以文档名为主标题，同步状态、同步时间和索引状态就近显示。
不再单独展示同名来源行，也不重复任务入口。目录及其他一对多来源保留来源组标题，
文档紧随其后；零文档和失败来源仍保留同步、暂停、重试及移除入口。
没有 sourceId 或找不到对应来源的文档独立显示。
搜索同时匹配来源名称、来源位置、文档名称和路径。来源命中时显示该组全部文档； 仅文档命中时保留组标题和命中文档。一对多关系按完整数据判断，搜索不能将其临时合成 单文档行。移除确认使用来源的完整文档数量，不使用搜索结果数。
导入文件、目录、URL 及拖放入口保持可用，拖放区使用紧凑的图标与文字提示。 单文档行的同步、移除和重新解析收进原生“更多操作”折叠区，解析预览、打开来源、 分块和任务保留直接入口。失败文档的重新处理入口仍直接显示。合并行的任务入口包含 该来源及该文档的相关任务，保留没有来源 ID 的文档任务。大小与分块数不拆行，操作组 按可用宽度换行，窄窗口在表格内部横向滚动。
解析预览复用现有结果组件；返回列表时恢复搜索、原触发按钮焦点及页面滚动位置。 重新解析继续调用文档重建，使用当前设置并保留上次结果，失败时显示可恢复错误。
文档行提供“打开来源”，Main 根据知识库和文档归属重新读取保存的文件路径或 URL。 移除来源使用确认对话框，说明文档数、索引、图谱证据和托管副本影响。初始焦点位于 取消，提交期间禁止重复操作，失败时保留对话框和错误。
7. 对话范围
知识库多选属于 Conversation。新对话默认空范围；切换对话恢复各自选择。创建新知识库 只加入当前 Conversation，不重新启用其他已取消项。发送请求时冻结当前选择和检索方式。
输入区的知识库选择弹层使用整行原生 Checkbox 标签，点击名称、文档数量或行内空白 均切换一次选择；选中背景和整行焦点环保持可见。Tab 聚焦、Space 切换，Escape 关闭并 返回触发按钮。点击行内非焦点元素时产生的空目标失焦不关闭弹层；点击外部或焦点明确 移到外部时才关闭，避免原生标签完成勾选前被卸载。