mesalogo
1c22e1a06d
Native browser pages could cover application dialogs and overlapping menus or notifications. Suspend only the viewport while covered and restore the same active page afterward, including nested dialogs and terminal prompts. Keep knowledge source controls at their full height, constrain long library cards and titles, and update automatic names when switching remote targets without overwriting edited or saved names. Restore packaged release-note loading now that the history exceeds its previous size limit. Add focused regressions and real Electron UI evidence. Clean up temporary Harness fixture directories at test completion instead of accumulating them. Release note: 修复内嵌浏览器遮挡弹窗和浮层、知识库来源选项被压缩及长名称显示异常；切换远端知识库时自动名称正确更新，并恢复更新说明显示。
80 lines
3.8 KiB
Markdown
80 lines
3.8 KiB
Markdown
# 知识库 UI 设计
|
|
|
|
## 1. 设计目标
|
|
|
|
知识库优先帮助普通用户完成“添加资料并可靠提问”，高级 RAG 调试和图谱维护不得阻塞
|
|
首次使用。全局视觉、页面壳层、通知、焦点和危险操作遵循
|
|
[UI-DESIGN.md](../../../UI-DESIGN.md)。
|
|
|
|
## 2. 信息架构
|
|
|
|
当前列表同时容纳本地库与外部绑定，页面增加“管理外部实例”和来源筛选。以下详情结构、
|
|
资料导入和索引状态适用于本地库；外部创建、配置、检索测试及引用的当前实现与待验收项见
|
|
[外部知识库 UI 设计](./external-knowledge-ui-design.md)。
|
|
|
|
```text
|
|
知识库
|
|
├─ 知识库列表
|
|
└─ 当前知识库
|
|
├─ 文档与来源
|
|
├─ 知识图谱（启用后显示）
|
|
├─ 任务中心
|
|
└─ 高级设置
|
|
```
|
|
|
|
标题区提供“用于当前对话”“检索测试”、编辑和删除。新建知识库是页面主操作。
|
|
“高级设置”承载问答效果入口、向量索引、分块与图谱配置，不把工程参数放在首次路径。
|
|
|
|
本地与外部库共用的列表以 `minmax(0, 1fr)` 限制条目宽度，再对名称单行省略；选中卡片
|
|
的边框必须完整留在列表内，Provider/实例等辅助文字允许换行。不得用列表外层裁切
|
|
掩盖被长名称撑宽的卡片，库图标不能随名称一起收缩。外部详情的长名称和远端名称允许
|
|
换行，不能撑出横向滚动条。创建类型分段控件与详情页签保持固定内容高度，不随长表单收缩。
|
|
|
|
## 3. 首次使用
|
|
|
|
没有知识库时，页面空状态显示“新建知识库”主操作。创建时先选择类型；本地类型默认
|
|
展示名称和描述，存储方式与知识图谱放入折叠的“高级设置”。本地库创建完成后进入
|
|
“文档与来源”，用户可以导入文件、文件夹或 URL。
|
|
|
|
文档处理完成后，标题区“用于当前对话”可用。该操作把当前知识库加入当前
|
|
Conversation 的检索范围，返回对话并聚焦输入框。
|
|
|
|
## 4. 状态
|
|
|
|
知识库列表显示“可用”和“需处理”文档数。详情标题持续显示可检索、处理中、需处理和
|
|
总文档数，即使用户填写了知识库描述也不隐藏状态。
|
|
|
|
文档行显示：
|
|
|
|
- 总体处理状态。
|
|
- 全文状态。
|
|
- 向量状态。
|
|
- 启用图谱时的图谱状态。
|
|
|
|
失败文档保留错误信息和“重新处理”。只要仍有可用分块，就允许打开分块管理，避免隐藏
|
|
上一版可用索引。
|
|
|
|
## 5. 问答效果与高级参数
|
|
|
|
“检索测试”默认只突出真实问题、测试按钮和结果。高级参数使用折叠区，包含候选倍数、
|
|
通道权重、最低相似度、重排、结果数和上下文预算。“高级设置 → 问答效果”打开同一
|
|
工作台。
|
|
|
|
向量模型未配置时显示“前往设置”，直接进入模型连接，不使用只有说明文字的死路状态。
|
|
|
|
## 6. 来源操作
|
|
|
|
文档行提供“打开来源”，Main 根据知识库和文档归属重新读取保存的文件路径或 URL。
|
|
移除来源使用确认对话框，说明文档数、索引、图谱证据和托管副本影响。初始焦点位于
|
|
取消，提交期间禁止重复操作，失败时保留对话框和错误。
|
|
|
|
## 7. 对话范围
|
|
|
|
知识库多选属于 Conversation。新对话默认空范围；切换对话恢复各自选择。创建新知识库
|
|
只加入当前 Conversation，不重新启用其他已取消项。发送请求时冻结当前选择和检索方式。
|
|
|
|
输入区的知识库选择弹层使用整行原生 Checkbox 标签，点击名称、文档数量或行内空白
|
|
均切换一次选择；选中背景和整行焦点环保持可见。Tab 聚焦、Space 切换，Escape 关闭并
|
|
返回触发按钮。点击行内非焦点元素时产生的空目标失焦不关闭弹层；点击外部或焦点明确
|
|
移到外部时才关闭，避免原生标签完成勾选前被卸载。
|