feat: add external knowledge retrieval and cross-project activity
Connect Dify, FastGPT and RAGFlow through read-only bindings, encrypted local credentials, shared retrieval and persistent citations. Configuration and removal affect GoodBuddy only. Show active conversations across projects, retain older live work, and improve project dialog scrolling. Queue concurrent questions and route managed SSH OpenCode questions through the Agent. Preserve recoverable read/search errors and partial search results. Document the Electron UI automation standard, real model and external knowledge validation, and remaining acceptance limits. Validation: earlier full regression passed 4081 tests with 66 skipped; subsequent focused remote-question checks and real Linux evidence are recorded in feature progress. Precommit typecheck and lint passed; latest project dialog and shared UI suites passed 58 tests. The full suite was not rerun for the final dialog changes. Release note: Use external knowledge in conversations, find active work across projects, and answer concurrent local or managed SSH OpenCode questions. Managed SSH questions require the updated Agent adapter.
This commit is contained in:
mesalogo
@@ -4,13 +4,90 @@
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | 设计稿 |
|
||||
| 版本 | 0.1 |
|
||||
| 日期 | 2026-09-03 |
|
||||
| 状态 | Portal 与控件已修正，Dify 完整 App 真实问答及当前自动回归已通过 |
|
||||
| 版本 | 0.2 |
|
||||
| 日期 | 2026-09-13 |
|
||||
| 产品需求 | [外部知识库接入 PRD](./external-knowledge-prd.md) |
|
||||
| 行为规则 | [外部知识库逻辑设计](./external-knowledge-logic-design.md) |
|
||||
| 全局规范 | [GoodBuddy UI 设计系统](../../../UI-DESIGN.md) |
|
||||
|
||||
## 当前实现与验收边界
|
||||
|
||||
`KnowledgeWorkspace.tsx` 已接入 `ExternalKnowledge.tsx`，不再处于只有界面草案的阶段。
|
||||
当前操作与控件如下；后续编号章节保留目标布局、文案和验收要求，其中超出本节的内容
|
||||
仍待核对，不能作为已实现或已通过桌面验收的描述。
|
||||
|
||||
| 区域 | 当前实现 |
|
||||
| --- | --- |
|
||||
| 页面入口与列表 | 标题区有“管理外部实例”和新建操作；本地和外部同一列表，按显示名、远端名、Provider、实例名搜索，原生 Select 筛选来源 |
|
||||
| 实例管理 | 560px 紧凑 Modal 内切换实例列表、编辑表单和删除确认；标题随状态变化，行内提供测试、编辑、启停和移除，显示地址 origin、凭据、探测状态、绑定数与本地化测试时间 |
|
||||
| 实例保存与测试 | 新建直接显示密码输入；编辑才提供 keep/replace/clear，清除需要确认。眼睛图标切换显隐并提供可访问名称和按下状态。保存后回列表测试目录，连接说明默认折叠；HTTP 地址下显示传输说明 |
|
||||
| 创建类型 | 共享 `SegmentedControl` 选择本地、Dify、FastGPT、RAGFlow；本地继续使用现有创建向导，外部挂载独立绑定表单 |
|
||||
| 来源选择 | 实例使用复用既有 picker 样式的富信息菜单，条目显示名称、地址 origin 与凭据状态；目录使用搜索框、目标按钮、刷新和分页，FastGPT 文件夹可进入与返回根目录；共享分段控件切换手工 ID |
|
||||
| 配置 | 常规窗口来源与参数两栏，宽度不超过 959px 时单栏；参数使用数字输入、原生 Select 与共享滑动 Switch 样式，没有 Slider 或自由 JSON 编辑器 |
|
||||
| 测试与保存 | 用户填写查询，测试成功后可保存，零命中允许添加；保存会再次发出检索请求。查询、目标或参数改变会使测试失效，更换现有绑定目标要求确认 |
|
||||
| 外部详情 | 共享 `PageTabs` 提供概览、检索配置和检索测试；概览显示远端 ID、推导状态和绑定验证时间，可刷新详情、用于对话、重新绑定、管理实例或移除 |
|
||||
| 参数编辑 | 复用绑定表单，保存按钮为“保存检索参数”；恢复默认只重置表单。配置页签访问后保持挂载，切换详情页签保留草稿 |
|
||||
| 检索结果 | 外部组件显示总耗时、返回数量、片段、定位、实际 ID 和原始评分，包括 FastGPT 评分数组；不显示本地全文、向量、图谱通道或本地上下文操作 |
|
||||
| 聊天与引用 | 统一选择器显示 Provider、实例与状态；外部引用打开保存片段，显示实例 ID 和远端定位，不请求本地上下文或打开原始来源 |
|
||||
|
||||
原 `knowledge-field` 的控件样式依赖知识库工作区祖先，实例 Modal 经 `createPortal` 挂到
|
||||
body 后丢失该作用域。当前 `Field` 使用全局 `.field` 和标签 span，密码也复用同一字段
|
||||
结构，确保 Portal 内的字体、输入边框、背景和焦点样式与应用一致。弹窗宽度为
|
||||
`min(560px, 100%)`，内容可滚动；操作区粘附底部，范围徽标靠左、按钮靠右，滚动留白
|
||||
避免键盘焦点被底部操作区遮住。通用参数、Provider 参数和认证使用 fieldset/legend 分组。
|
||||
|
||||
Switch 按标签文字在左、滑动开关在右排列，保持 `role="switch"`。实例菜单支持方向键
|
||||
打开与移动、Home/End、跳过禁用项、Enter 选择和 Escape 返回触发按钮；目录空状态使用
|
||||
共享 `EmptyState`，无搜索结果可清空查询，无目录可切换手工 ID。已选目标悬停不覆盖
|
||||
选中背景，保存和测试分别显示对应忙碌文案。
|
||||
|
||||
保存、删除等成功信息及实例管理中的异步错误使用应用通知；绑定测试、详情刷新和删除
|
||||
中途失败保留就地恢复所需的错误。实例有绑定时，确认后依次移除本地绑定再删实例；中途
|
||||
失败刷新已完成的移除，远端内容不变。
|
||||
|
||||
当前已实现过期响应丢弃、Modal 焦点管理、`PageTabs`、标记了 `role="switch"` 的开关和
|
||||
窄窗口 CSS。2026-09-13 Dify 已在当前生产 BrowserWindow、Main、Preload、Renderer 和
|
||||
IPC 上完成实例保存、目录选择、检索后绑定、参数更新、重启及历史引用检查，详见
|
||||
[脱敏验证摘要](./external-knowledge-validation-2026-09-13.json)。验证程序仅在 Main 的实例
|
||||
保存 Handler 边界替入已有密钥，未将真实密钥放入 Renderer。
|
||||
|
||||
1440、900、700 窗口宽度对应报告 viewport 1439、899、699，均无 body 横向溢出。
|
||||
宽屏配置两栏、窄屏单栏，窄屏列表可见；原生 ArrowRight 可以激活检索页签。已保存并
|
||||
重开的参数为返回 2 条、超时 15 秒、单片段 200 字符。生产搜索返回两条引用，验证程序
|
||||
保存带测试标记的会话后重载，引用弹窗显示 Provider、片段和快照说明，焦点在弹窗内，
|
||||
没有本地上下文或打开来源操作。此检查没有生成模型答案。
|
||||
|
||||
上述早期检查没有生成答案。后续完整 App 已从实际输入区选择 Dify 知识库并点击发送，
|
||||
得到已保存的真实模型短答案，再点击引用核对片段及远端文档/片段 ID；没有伪造消息或
|
||||
引用。浅深主题均检查了真实 Portal 编辑器的共享字体、背景、560px 宽度与无横向溢出。
|
||||
|
||||
另有真实 Electron 视觉 fixture 覆盖浅深主题、四档尺寸及原生键盘操作；其 IPC 是假数据，
|
||||
只用于界面、焦点和布局检查。三家生成的生产 IPC 验证中，引用展示使用隔离 DOM；只有
|
||||
Dify 完成了完整 App 的发送与点击引用。计数与方法边界见
|
||||
[实施进度](./progress.md#2026-09-13-ui-修正与真实生成复验)和
|
||||
[后续摘要](./external-knowledge-follow-up-2026-09-13.json)。当前 UI 修正后的聚焦测试、
|
||||
全量回归、类型检查、lint 与工作区/暂存区 diff 检查均已通过。App 测试已按实际可访问
|
||||
富信息菜单交互替换旧 Select 操作，精确计数由实施进度维护。FastGPT/RAGFlow 完整桌面专属操作和
|
||||
广泛问答质量仍待验收。
|
||||
|
||||
与下文目标设计相比，当前还存在以下边界：
|
||||
|
||||
- 没有保存前按地址传输风险确认，也没有接入独立证书例外设置；只有传输说明。
|
||||
- 没有目录或检索的 IPC 取消入口；丢弃旧响应不等于中止网络请求。测试期间绑定表单整体
|
||||
禁用，不能把其“取消”按钮描述为正在进行的请求可随时取消。
|
||||
- Dify 版本、Metadata、摘要、多模态和 Pipeline 状态没有进入当前界面；RAGFlow 只接收
|
||||
图谱完成与知识编译可用布尔证据，没有三态构建展示或版本支持矩阵。
|
||||
- 列表和概览没有持久化的最近成功检索时间；概览显示 `lastVerifiedAt`。当前也没有自动
|
||||
`remote-missing/config-invalid` 状态、完整裁剪诊断或历史引用“连接已移除”标签。
|
||||
- 没有覆盖所有关闭、类型切换和手工模式切换的未保存草稿离开确认；实例列表使用可换行
|
||||
列表而非表格，未单设 720px 表格转换规则。
|
||||
|
||||
## 目标设计与待验收要求
|
||||
|
||||
以下保留既有产品布局和交互目标。当前事实以上节为准；历史 Provider 探测用于解释能力
|
||||
边界，不作为下述界面已经呈现或已通过产品验证的证据。
|
||||
|
||||
## 1. 信息架构
|
||||
|
||||
外部知识库不增加左侧主导航和知识库一级页签。现有知识库页面结构保持：
|
||||
@@ -82,7 +159,7 @@ RAGFlow
|
||||
|
||||
## 4. 管理外部实例
|
||||
|
||||
点击“管理外部实例”打开大尺寸 Modal。Modal 使用标题、可滚动内容和固定操作区，遵循
|
||||
点击“管理外部实例”打开最大 560px 的紧凑 Modal。Modal 使用标题、可滚动内容和粘附底部操作区，遵循
|
||||
全局焦点陷阱、Escape、背景隔离和焦点恢复规则。
|
||||
|
||||
```text
|
||||
@@ -237,6 +314,14 @@ Rerank 用量。`
|
||||
右侧配置固定分为“通用配置”和“{Provider} 配置”，不创建嵌套卡片。高级字段可以使用
|
||||
一个折叠区，但核心检索方式、阈值和 RAGFlow 图谱检索保持直接可见。
|
||||
|
||||
第一版遵循 [PRD 产品决策](./external-knowledge-prd.md#2-产品决策)的只读范围。面板固定说明：
|
||||
`参数仅保存在 GoodBuddy，用于此绑定的后续检索，不会修改远端知识库设置。`
|
||||
编辑页保存按钮使用“保存检索参数”；恢复默认仅重置当前表单，保存后作用于当前绑定。
|
||||
远端索引、模型、图谱构建和 Pipeline 配置只展示状态，不提供编辑或执行操作。
|
||||
|
||||
Dify 的“使用知识库默认配置”开启时说明：`每次检索沿用远端当前设置，远端设置变化会影响结果。`
|
||||
关闭后，客户端显式检索参数随请求发送，不写回远端默认配置。
|
||||
|
||||
控件选择：
|
||||
|
||||
- 开关：图谱检索、Score 阈值启用、Rerank、使用 Dify 知识库默认配置。
|
||||
@@ -267,11 +352,11 @@ Rerank 用量。`
|
||||
| Dify `0.15.8` | 使用知识库默认配置；展示 `retrieval_model_dict` 中已出现的检索方式、Top K、阈值和 Rerank 配置 | Metadata、多模态、摘要和 Pipeline 状态 | 目录项能力；该版本详情 GET 返回 405，不能把详情失败显示成实例不可用 |
|
||||
| Dify `1.17.0` | 默认配置、当前完整配置；详情中的文档统计、摘要索引、多模态、Metadata 和 Pipeline 只读状态 | 当前库没有字段定义时禁用 Metadata 条件；远端 Pipeline 和摘要配置不可编辑 | 详情 GET 和 3 条非空检索结果已实测；`child_chunks/files/summary` 仅按结果实际存在显示 |
|
||||
| FastGPT 当前实例 | embedding、全文召回、混合召回；Rerank | 查询扩展、扩展模型和背景文本 | 三种模式和 Rerank 均有 200 非空实测；查询扩展会调用模型，初始版本不启用 |
|
||||
| RAGFlow 当前实例 | 相似度、向量权重、KNN Top K；具备完成证据时启用图谱检索 | 没有独立配置证据时禁用 Knowledge Compilation；Metadata 条件仍隐藏 | `graphrag_task_finish_at` 有效才启用图谱；`compilation_template_group_id` 有效才启用 Knowledge Compilation |
|
||||
| RAGFlow 当前实例 | 基础检索；具备完成证据时启用图谱检索 | 没有独立配置证据时禁用 Knowledge Compilation；Metadata 条件仍隐藏 | 相似度、向量权重和候选数请求已被接受，但未单独验证参数效果；候选数参数需按部署版本适配，详见技术设计；`graphrag_task_finish_at` 有效才启用图谱；`compilation_template_group_id` 有效才启用 Knowledge Compilation |
|
||||
|
||||
RAGFlow 列表项应区分三个图谱状态：“未配置”“构建中或未完成”“可用于图谱检索”。不能
|
||||
仅因 `parser_config.graphrag.use_graphrag = true` 就显示为可用。当前实测中 17 个库配置了
|
||||
GraphRAG，只有 15 个存在完成证据。
|
||||
仅因 `parser_config.graphrag.use_graphrag = true` 就显示为可用。实测数量见
|
||||
[实施进度](./progress.md#验证证据)，界面按当前远端知识库的配置和完成状态判断。
|
||||
|
||||
Knowledge Compilation 的请求被服务器接受但当前没有库提供配置证据，因此开关显示为禁用，
|
||||
说明为“当前知识库未配置 Knowledge Compilation”。返回 200 或零结果都不能改变此状态。
|
||||
|
||||
Reference in New Issue
Block a user