知识库和 RAG 插件

项目简介

一个 bundle 含三个插件行： 插件 · 平台 · 职责 插件: knowledge（ctx.knowledge） · 平台: host · 职责: 核心引擎：存储域、分块、embedding、检索、/knowledge/ HTTP 服务 插件: tool-knowledge · 平台: host · 职责: 12 个模型工具，消费 ctx.knowledge 插件: ui-knowledge · 平台: client · 职责: 侧边栏底部入口（sidebar.footer.action）+ 工作区整页浮层（shell.overlay），Cherry Studio 式布局

分块数据不放在存储域 KV 里，而是独立 SQLite 文件：web profile 的 JSON 后端每次写记录都会重写整个单元文件，数据增长后删除/导入会变慢到秒级甚至分钟级；SQLite 让每次写入/删除都是单条语句，并提供 FTS5 三元组全文检索（BM25）与查询时向量扫描、有界读取——常驻内存不随语料增长。升级后首次启动会自动把旧 JSON 单元里的分块迁入 SQLite（幂等，中断产生的重复行自动去重）。 以上所有字段均可在每个知识库的设置面板中单独覆盖（Cherry Studio 式：留空继承全局）；API Key 以明文保存在本地存储（与 Cherry Studio 一致）。 本地模型（进程内 embedding）

选择 embeddingProvider: local 时，插件在 host 进程内用 @huggingface/transformers（+ onnxruntime）跑 embedding，无需任何外部服务。默认模型 onnx-community/Qwen3-Embedding-0.6B-ONNX（1024 维，Cherry Studio 同款），embeddingModel 可换成任意 Hugging Face 上的 ONNX embedding 仓库 id。首次使用会从 Hugging Face Hub 下载模型权重（默认缓存到 $DSHHOME/cache/dsh-knowledge/local-models）；下载完成后后续导入与检索全程本地。在设置 →「本地模型」页面可提前下载 / 取消 / 删除 / 重试，并实时查看下载进度；知识库设置面板也会显示模型下载进度（下载中 % / 就绪 / 失败）；可用环境变量 HFENDPOINT 指向镜像加速下载。 召回效果实证（可复现）