前言¶

在 DeepSeek Harness（DSH）里做长期对话或项目协作时，模型往往只能依赖当前上下文和临时粘贴的文本，本地文档、规范、笔记很难稳定进入回答依据。把资料手工复制进每条消息既费事，也难以在回答里追溯「这句话来自哪份文件」。下面介绍社区插件 dsh-knowbase（npm 包名 @domitor-syh/dsh-knowbase）：在 DSH 侧建本地知识库、按会话选库，并在对话前用检索把相关片段交给模型，同时支持引用与原文阅读。

这是什么¶

dsh-knowbase 由维护者 domitor-syh 发布，在 SkillHub 插件目录 中归类为「记忆」。项目自述为：为 DSH 提供本地知识库——把文档纳入知识库，在对话中自动检索相关内容，并通过引用查看资料出处。插件当前版本 0.1.0，采用 MIT 许可证；README 标明适配 DSH 0.2.1-rc.5，兼容范围 >=0.2.0-rc.2 <0.3.0-0。

DSH 生态强调「一切皆插件」；SkillHub 等社区目录独立于 DeepSeek / 幻方，并非官方应用商店。安装前建议自行查看 GitHub 仓库 源码与许可证。

核心功能¶

以下能力均来自项目 README，检索算法说明中注明「正在持续优化中」。

本地资料管理：每个知识库对应一个文件夹，支持上传文件、直接放入文件夹后重扫，以及增量更新索引。

多种资料格式：支持 TXT、Markdown、JSON、CSV、源码等 UTF-8 文本、文本型 PDF，以及 PNG / JPG 图片的本地中英 OCR（基于 Tesseract.js，语言包在知识库页面下载后在本机识别）。

自动检索：使用中文 n-gram 与 BM25，在对话前检索相关片段，为回答提供资料依据。

按会话选库：在输入区选择一个或多个知识库，选择随会话保存；新会话默认未开启，需按需选择。

引用与原文阅读：查看回答使用的来源、复制引用，并在右侧阅读器打开资料、定位对应内容。

检索测试与统计：在知识库页面测试查询效果；插件详情页可按需开启自动检索统计。

新资料提案：Agent 可提交文本资料提案，由用户预览并批准后保存到知识库。

界面：中英双语，跟随 DSH 系统语言与明暗主题。

安装与启用¶

当前 README 给出的安装方式如下。

Web 端（dsh web，从 npm 安装）：

dsh plugin --profile web add @domitor-syh/dsh-knowbase

桌面端：在插件管理的安装入口填写包名：

@domitor-syh/dsh-knowbase

安装后，Web 端需重启 dsh web 并刷新页面；桌面端需重启应用。若从 DSH 源码运行，在 Web 安装命令前加 pnpm。

典型用法¶

界面流程¶

1. 点击侧栏「知识库」，选择「添加知识库」，填写名称和描述。
2. 上传资料，或打开知识库文件夹、放入文件后点击「重扫」。
3. 回到对话，点击输入区「知识库」按钮，开启本次会话要使用的库。
4. 发送问题，插件会检索所选库中的相关片段供模型参考。
5. 点击回答下方的知识库来源按钮，查看引用、复制出处，或在右侧打开原文。

修改文件夹内资料后，点击「重扫」更新内容。

图片文字识别¶

在知识库页面「图片文字识别」区域下载中英语言包，然后重扫图片资料。

检索测试¶

在知识库页面搜索框输入问题并选择检索范围，可查看命中的文件、位置和原文片段；展开「检索详情」可查看得分与覆盖率。

会话内命令¶

适用场景与注意¶

适合谁：需要在 DSH 对话中反复引用本地文档、规范、笔记或项目资料，并希望回答带来源、可点开原文的开发者或团队。

运行与权限：插件随当前 DSH 进程运行，读写知识库目录、索引与 OCR 等均在本机完成；安装前应阅读仓库代码，确认路径与数据处理符合你的环境策略。

依赖与格式：PDF 需为可提取文本的类型；图片 OCR 需先下载语言包。检索为 n-gram + BM25，并非向量数据库方案，选型时需与自身资料规模和语言特点对照 README 中的检索测试能力。

结尾¶

dsh-knowbase 把「建库 → 选库 → 检索 → 引用」收进 DSH 一条工作流，适合以本地资料为可信来源的对话场景。进一步了解可访问 SkillHub 目录页 与 GitHub：domitor-syh/dsh-knowbase。