Files
goodbuddy/docs/features/knowledge-base
mesalogo 3b560c9a5e 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.
2026-09-13 13:10:01 +08:00
..

知识库

知识库已提供本地资料导入、解析、分块、索引、检索、图谱和带来源的知识问答。 当前工作区已接入 Dify、FastGPT 和 RAGFlow 的实例管理、外部绑定、检索配置、统一检索、 聊天引用与界面。2026-09-13 已验证三家 Provider 的生产服务、本机 HTTP MCP 和生产 IPC 短答案生成,并从完整 App 输入区完成 Dify 检索、真实回答及引用点击。外部实例弹窗已修正 Portal 字段样式,并完成浅深主题和键盘检查。当前 UI 修正后的聚焦测试、全量回归及相关检查已通过; FastGPT/RAGFlow 完整 App 与专属配置、真实远程预检索仍待验收。验证只覆盖有依据的短答案, 不代表广泛问答质量,详见实施进度。

文档导航

文档 权威职责
知识库检索与分块增强 PRD 检索、分块、诊断和产品验收
User Stories 知识使用者、维护者和调试者场景
UI 设计 本地知识库的信息架构、首次使用、状态与外部界面分工
实施进度 已验证实现事实、验证命令与剩余外部知识库工作
本地文本向量技术设计 本地与兼容向量连接、模型包、索引和进程边界
知识检索评估 检索质量评估方法、数据集、指标和门槛
外部知识库接入 PRD 外部实例、知识库绑定、检索范围和产品验收
外部知识库 User Stories 实例配置、添加、使用和故障恢复场景
外部知识库逻辑设计 状态、不变量、配置优先级和失败规则
外部知识库 UI 设计 知识库页面、外部实例管理和创建向导交互
外部知识库技术设计 当前 Client、Service、Store、共享契约、IPC 和检索标准化
外部知识库实测基线 脱敏记录真实实例的接口状态、字段结构、特色能力和耗时
2026-09-10 基础复测 开启证书校验的目录、详情和基础检索结果
2026-09-10 扩展复测 配置覆盖、重排、图谱与知识编译开关的请求结果及结构
2026-09-13 产品验证摘要 生产服务与本机 HTTP MCP、Dify 桌面、凭据重开、调用计数、最终自动检查状态及远程阻断的脱敏证据
2026-09-13 UI 与真实生成复验 后续 UI 修正、三家生产 IPC 生成、Dify 完整 App 回答与引用、视觉 fixture 及本轮请求计数

术语

  • 外部实例:一个由用户配置的 Dify、FastGPT 或 RAGFlow 服务地址及其认证信息。
  • 外部知识库绑定:GoodBuddy 中的知识库记录与外部实例内一个远端知识库 ID 的只读关联。
  • Provider 配置:某一 Provider 检索接口独有的设置,例如 RAGFlow 图谱检索。

外部知识库只提供检索结果。GoodBuddy 不接入外部 App、Chat、Assistant、Workflow 或 Agent,也不在外部实例中创建、修改、上传或删除知识库内容。远端资料不会批量同步 或进入本地索引;实际用于回答的有界片段会随引用保存在本地会话中。

本目录尚未拆出统一逻辑设计;当前本地知识库状态规则由 PRD、User Stories 和实现契约 定义。外部知识库的实例、绑定和失败规则由独立逻辑设计维护。