root/goodbuddy
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity

feat: add external knowledge retrieval and cross-project activity

Browse Source 
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
2026-09-13 13:10:01 +08:00
parent b84250f62a
commit 3b560c9a5e
102 changed files with 6716 additions and 1484 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/features/knowledge-base/external-knowledge-prd.md
+47 -10
View File
@@ -4,14 +4,38 @@
| 项目 | 内容 |
| --- | --- |
| 状态 | 设计稿 |
| 版本 | 0.1 |
| 日期 | 2026-09-03 |
| 状态 | 三家短答案、Dify 完整 App 与当前 UI 自动回归已通过；剩余产品验收待完成 |
| 版本 | 0.2 |
| 日期 | 2026-09-13 |
| 适用产品 | GoodBuddy 桌面端 |
| 关联逻辑 | [外部知识库逻辑设计](./external-knowledge-logic-design.md) |
| 关联界面 | [外部知识库 UI 设计](./external-knowledge-ui-design.md) |
| 技术设计 | [外部知识库技术设计](./external-knowledge-technical-design.md) |
## 当前交付范围
当前工作区已提供实例管理、加密凭据保存、目录与手工 ID、外部绑定、Provider 检索参数、
统一知识库列表、聊天预检索与按需工具检索、外部引用和本地移除的实现。参数与恢复默认
遵循下文只读产品决策。2026-09-13 已验证三家 Provider 的生产服务与本机 HTTP MCP，
以及 Dify 桌面的实例保存、绑定、参数更新、重启和历史引用。后续已修正外部弹窗的字段
样式与布局，并验证三家通过生产 IPC 生成有依据的短答案、Dify 按需检索，以及从完整 App
输入区发送 Dify 问题并点击真实答案引用。该证据不代表广泛问答质量。
FastGPT/RAGFlow 完整桌面、远程预检索仍待验收；当前 UI 修改后的聚焦测试、全量回归与
相关检查已通过，精确结果见[实施进度](./progress.md)。
本文的功能需求和产品验收仍是验收目标。以下差异不能仅凭实现存在就标为满足：
| 原需求 | 当前实现与待核对差异 |
| --- | --- |
| `EK-FR-02`、`EK-FR-03` | 实例先保存为未测试，再在列表执行目录测试；目标检索在绑定时验证。没有分项草稿探测、版本或完整能力快照 |
| `EK-FR-04` | 已有目录搜索和分页；Dify/RAGFlow 搜索过滤当前页，FastGPT 搜索当前父级响应，不能保证全目录搜索 |
| `EK-FR-09` | 内置严格配置已实现，没有按探测版本维护支持矩阵；Dify 高级只读能力展示、Metadata 编辑和 RAGFlow Rerank 未提供 |
| `EK-FR-13`、`EK-FR-14` | 已显示片段、原始评分、总耗时和失败；没有完整的 Provider 耗时、裁剪前数量与截断诊断，也不持久化远端目标失效状态 |
| `EK-FR-16` | Main 固定端点及数据说明已接入；当前没有单独接入全局内网兼容模式和按地址传输确认流程 |
这些差异由功能 owner 在验收时核对。2026-09-09、2026-09-10 真实接口探测只作为历史
兼容性资料，不作为本轮桌面产品验证结果。
## 1. 背景
不少企业已经在内网部署 Dify、FastGPT 或 RAGFlow，并在其中维护制度、产品、研发
@@ -42,6 +66,11 @@ GoodBuddy 负责。
10. API Key 在用户输入表单和受限 IPC 中短暂存在，由 Main 进程加密保存并用于请求；
保存后不回传 Renderer，也不进入 Runtime、日志、普通元数据和检索引用。
第一版按只读接入交付：参数修改和恢复默认只更新 GoodBuddy 中当前绑定的客户端配置，
在后续检索请求中使用，不修改远端知识库默认配置，也不影响其他客户端。远端文档、
索引、图谱构建、模型和 Pipeline 设置由用户在对应平台维护。检索请求仍可能产生远端
Embedding、重排用量和审计记录。
## 3. 目标
### 3.1 用户目标
@@ -93,22 +122,23 @@ GoodBuddy 负责。
1. 用户在知识库页面点击“管理外部实例”。
2. 页面列出实例名称、Provider、服务地址、状态和已绑定知识库数量。
3. 用户添加实例，填写名称、Provider、服务地址和 API Key。
4. “测试连接”分别验证服务可达、认证、知识库列表和检索能力。
5. 用户保存后，API Key 被加密保存，列表只显示凭据已配置。
4. 用户先保存实例，API Key 被加密保存，列表显示凭据状态和“未测试”。
5. 在已保存实例上“测试连接”读取目录并记录结果；检索能力在绑定目标时验证。
列表接口不可用但已知远端知识库 ID 可检索时，实例可以保存为“需手工指定知识库”。
服务不可达或认证失败时不得保存为可用实例；用户可以保留表单并修正。
目录 403 显示“需手工指定知识库”；不可达或认证失败保留实例和失败状态，用户可编辑
后重试。保存本身不代表可用。原分项测试验收目标见 `EK-FR-03`，当前实现差异见上表。
### 6.2 添加外部知识库
1. 用户点击现有“新建知识库”。
2. 在“知识库类型”中选择“本地”、Dify、FastGPT 或 RAGFlow。
3. 选择外部类型后，左侧选择同 Provider 的外部实例。
4. GoodBuddy 自动读取远端知识库列表，并填入可搜索下拉框。
4. GoodBuddy 自动读取远端知识库列表，提供搜索、分页和目标选择。
5. 列表权限不可用时，用户可以手工填写远端知识库 ID。
6. 用户选择一个远端知识库，填写 GoodBuddy 显示名称。
7. 右侧展示通用配置和当前 Provider 的专属配置。
8. 用户填写测试查询并执行一次有界检索；请求成功后创建本地绑定，零结果不算失败。
8. 用户填写测试查询并执行有界检索；成功后可添加，零结果不算失败。保存时服务会再次
执行该查询验证目标和配置，之后创建本地绑定。
添加完成后沿用现有知识库规则，把新绑定加入当前聊天选择，但不会重新启用用户此前
取消的其他知识库。
@@ -222,13 +252,20 @@ Provider 的远端创建、更新、上传或删除接口。
| --- | --- | --- | --- |
| Dify | 知识库列表与详情 | Dataset Retrieve | 使用知识库默认配置，或完整覆盖检索方式、Top K、Score 阈值及 Rerank 模式 |
| FastGPT | 知识库层级列表与详情 | Dataset Search Test | 搜索模式、Token 上限、相似度、Rerank |
| RAGFlow | Dataset 列表与详情 | Retrieval | 相似度、向量权重、KNN Top K、Rerank、图谱检索、Knowledge Compilation |
| RAGFlow | Dataset 列表与详情 | Retrieval | 相似度、向量权重、KNN Top K、图谱检索、Knowledge Compilation；当前未提供 Rerank 配置 |
“首批专属配置”表示适配器允许表达的字段，不保证每个实例版本都支持。具体显隐由能力
探测和[逻辑设计](./external-knowledge-logic-design.md)共同决定。
## 9. 产品验收
以下为验收清单，尚未整体通过。第 2 项已有三家生产服务绑定与检索证据，Dify 另有桌面
操作证据；其他 Provider 的桌面、受限目录与高级配置等仍需补验。第 12 项确认流程当前
未实现。早期历史引用检查使用标记为测试的会话；后续已从完整 App 输入区生成 Dify
真实短答案并点击引用，三家另有生产 IPC 短答案证据。完整 App 尚未覆盖 FastGPT/RAGFlow，
也未评估广泛问答质量；本机 MCP 成功不替代被 SSH 凭据解密阻断的真实远程预检索。
详细结果以实施进度为准。
1. 用户可以在知识库页面完成三种 Provider 的实例添加、连接测试、编辑和删除。
2. 每种 Provider 至少通过一个真实自部署实例完成列表读取、绑定和检索。
3. 列表权限关闭时，可以通过手工 ID 添加并验证一个可检索知识库。