# 知识库 UI 设计

## 1. 设计目标

知识库优先帮助普通用户完成“添加资料并可靠提问”，高级 RAG 调试和图谱维护不得阻塞
首次使用。全局视觉、页面壳层、通知、焦点和危险操作遵循
[UI-DESIGN.md](../../../UI-DESIGN.md)。

## 2. 信息架构

```text
知识库
├─ 知识库列表
└─ 当前知识库
   ├─ 文档与来源
   ├─ 知识图谱（启用后显示）
   ├─ 任务中心
   └─ 高级设置
```

标题区提供“用于当前对话”“检索测试”、编辑和删除。新建知识库是页面主操作。
“高级设置”承载问答效果入口、向量索引、分块与图谱配置，不把工程参数放在首次路径。

## 3. 首次使用

没有知识库时，页面空状态显示唯一的“新建知识库”主操作。创建表单默认只展示名称和
描述；存储方式与知识图谱放入折叠的“高级设置”。创建完成后进入“文档与来源”，用户
可以导入文件、文件夹或 URL。

文档处理完成后，标题区“用于当前对话”可用。该操作把当前知识库加入当前
Conversation 的检索范围，返回对话并聚焦输入框。

## 4. 状态

知识库列表显示“可用”和“需处理”文档数。详情标题持续显示可检索、处理中、需处理和
总文档数，即使用户填写了知识库描述也不隐藏状态。

文档行显示：

- 总体处理状态。
- 全文状态。
- 向量状态。
- 启用图谱时的图谱状态。

失败文档保留错误信息和“重新处理”。只要仍有可用分块，就允许打开分块管理，避免隐藏
上一版可用索引。

## 5. 问答效果与高级参数

“检索测试”默认只突出真实问题、测试按钮和结果。高级参数使用折叠区，包含候选倍数、
通道权重、最低相似度、重排、结果数和上下文预算。“高级设置 → 问答效果”打开同一
工作台。

向量模型未配置时显示“前往设置”，直接进入模型连接，不使用只有说明文字的死路状态。

## 6. 来源操作

文档行提供“打开来源”，Main 根据知识库和文档归属重新读取保存的文件路径或 URL。
移除来源使用确认对话框，说明文档数、索引、图谱证据和托管副本影响。初始焦点位于
取消，提交期间禁止重复操作，失败时保留对话框和错误。

## 7. 对话范围

知识库多选属于 Conversation。新对话默认空范围；切换对话恢复各自选择。创建新知识库
只加入当前 Conversation，不重新启用其他已取消项。发送请求时冻结当前选择和检索方式。

输入区的知识库选择弹层使用整行原生 Checkbox 标签，点击名称、文档数量或行内空白
均切换一次选择；选中背景和整行焦点环保持可见。Tab 聚焦、Space 切换，Escape 关闭并
返回触发按钮。点击行内非焦点元素时产生的空目标失焦不关闭弹层；点击外部或焦点明确
移到外部时才关闭，避免原生标签完成勾选前被卸载。