mesalogo
d08ba33c3e
OpenCode child cards now show ordered text, reasoning and tool progress, with the final result displayed separately. Local SDK and remote ACP paths share child tracking, including progress retained across recovery and cancellation. Remote live progress requires an Agent package containing the event plugin; older Agent packages still expose final results without inventing missing history. Knowledge-library rows remain clickable when native label activation changes focus. File workspace changes use colored Git status letters and per-file staged/unstaged diffs, including deleted, renamed and untracked files. Refreshing reloads the selected diff and expanded directories, and more than 50 changes remain accessible through incremental loading. Validated with 3552 passing tests, typecheck, lint, desktop build, current-source Linux Host scenarios and isolated Windows desktop UI interactions. Release note: 展开 OpenCode 子代理卡片可查看执行过程、工具详情与独立最终结果；知识库支持整行勾选。工作区支持单文件暂存与未暂存差异，刷新会更新当前差异，更多变更可继续加载。远端实时过程需要更新 GoodBuddy Agent。
71 lines
3.0 KiB
Markdown
71 lines
3.0 KiB
Markdown
# 知识库 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 关闭并
|
|
返回触发按钮。点击行内非焦点元素时产生的空目标失焦不关闭弹层；点击外部或焦点明确
|
|
移到外部时才关闭，避免原生标签完成勾选前被卸载。
|