前言¶
在 DeepSeek Harness 的开发中，让智能体具备查询本地文档的能力是常见需求。现有方案往往依赖云端向量库或需要配置复杂的本地环境。dsh-move-rag 插件提供了一个轻量级的解决方案：它不需要下载模型权重，也不依赖云端服务，而是将知识库运行在 Windows 桌面上，通过置顶窗口实现快速入库与检索。
是什么¶
这是一个由 xingmen-1 维护的 DeepSeek Harness 插件，提供本地知识库记忆功能。它通过一个常驻桌面的 WinForms 图标，支持拖拽入库、本地 RAG 检索，并将检索结果作为工具暴露给 Agent。
核心功能¶
- 桌面临时面板：WinForms 窗口，支持置顶、拖动。拖动到屏幕边缘时，窗口会自动收起为一条箭头。
- 拖拽入库：支持 PDF、Word、txt、md、csv、代码文件及图片。拖入桌面图标或面板即可完成入库。
- 本地 RAG：使用定长切片 + 哈希嵌入（512 维）+ 余弦召回进行检索。面板内可直接测试检索效果。
- 工具接口：为 DSH Agent 提供检索工具
knowledge_search和开发工具kb_dev。 - 网页同步：DSH 网页侧边栏提供「知识库」入口，可控制桌面图标的显示与隐藏。
安装与启用¶
使用官方安装命令添加插件，安装后需重启 dsh web 以加载配置。
dsh plugin --profile web add github:xingmen-1/dsh-move-rag
典型用法¶
- 打开置顶：在网页侧边栏点击「知识库」，打开「置顶」开关，桌面右上角会出现悬浮图标。
- 入库：将文件拖拽到桌面图标上，或拖入打开的面板中。
- 检索：在面板中输入问题并回车，结果按相似度排序。
- 让 Agent 使用：在对话中直接询问，Agent 会自动调用
knowledge_search工具。
适用场景与注意¶
- 系统限制：插件目前仅支持 Windows。Linux/macOS 需要替换桌面面板与文件写入实现。
- 嵌入原理：哈希嵌入是关键词级别的语义近似，不是神经嵌入。它对同义改写不敏感，但胜在离线、零依赖、速度快。
- 文件索引：图片仅按文件名索引，没有 OCR 能力。
- 文件大小：单个上传文件上限 16MB（base64 走 JSON），本地路径入库上限 256MB。
结语¶
该插件适合需要在 Windows 环境下快速构建本地知识库并给 Agent 赋予检索能力的开发者。插件目录与 GitHub 链接如下：
