mesalogo
a44de1441a
The titlebar drag-region defect was fixed three times in a row, each time only for the dialogs someone reported, and the same batch introduced two more instances. Repeated full-table lookups and production reuse of a verification helper showed up in several places at once for the same reason. Add docs/quality/recurring-defects.md describing each type that has actually recurred here, the shared mechanism or automated test that now covers it, and the history that justifies the entry. Require reading it from AGENTS.md before touching overlays, store lookups, retrieval entry points, cancellation, or render-time derived values, and require extending the shared mechanism rather than patching one reported case. Correct the external knowledge technical design where it described the removed configuration-snapshot checks, the shared retrieval entry point and the unreachable probe status, and record the refactor and its validation in the knowledge base progress log.
知识库
知识库已提供本地资料导入、解析、分块、索引、检索、图谱和带来源的知识问答。 当前工作区已接入 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 和实现契约 定义。外部知识库的实例、绑定和失败规则由独立逻辑设计维护。