前言¶

DeepSeek Harness (DSH) 采用「一切皆插件」的架构。对于需要长期记忆或管理私有文档的智能体开发者来说，构建一个本地知识库是刚需。下面介绍 dsh-knowledge-lite，这是一个给 DeepSeek Harness 用的本地知识库插件。每篇笔记是一个 Markdown 文件，数据完全在你本机，不依赖任何云服务。

核心功能¶

插件主要提供以下能力：

1. 本地纯文本存储：每篇笔记对应一个 .md 文件，支持用任意外部编辑器直接修改。
2. 全文搜索 + 标签筛选：支持对库内的所有内容进行检索。
3. 层级目录：目录即磁盘文件夹，支持在文件管理器里手动移动文件，库会自动识别。
4. 附件处理：
   • 文本类（.txt/.md/.py/.json/.csv 等）直接进正文。
   • Office 文档（.docx/.xlsx/.pptx）零依赖抽取文本写进正文，原件存入 files/ 目录。
   • 其他类型（.pdf/图片/压缩包等）原样存入 files/ 目录，双击即可打开。
5. 拖拽移动：在界面上把笔记拖到任意目录节点，即可移动文件。
6. 对话导出：支持将 dsh 对话整理成笔记（writeback）。

安装与启用¶

插件市场安装¶

在 DSH 的 设置 → 插件市场 中搜索 dsh-knowledge-lite，点击一键安装。

手动安装¶

针对开发模式或特定宿主版本（dsh 0.2.0-rc.2）：

git clone https://github.com/fangqiing/dsh-knowledge-lite.git
cd dsh-knowledge-lite
pnpm install

安装后需将插件链接进 DSH 的插件目录并重启宿主（安装前需彻底退出 DSH，否则可能遇到 EPERM 错误）。

配置与兼容性¶

路径配置¶

该插件主要在 Windows + dsh 0.2.0-rc.2 下验证。
默认笔记根目录写死为 E:/dsh-kb（Windows 专属）。非 Windows 平台需编辑 lib/config.js 中的 DEFAULT_ROOT 进行修改，或首次启动后在设置里修改。

依赖要求¶

宿主版本需与 @deepseek-ai/dsh-* 0.2.0-rc.2 匹配。

目录结构¶

插件核心文件位于 lib/ 目录：
* store.js：负责笔记与层级目录的存储、扫描、移动、删除。
* index.js：宿主（Node）侧入口与 RPC。
* client.js：浏览器半侧 UI（目录树、编辑器、附件列表）。
* attachments.js：Office 文档零依赖文本抽取（ZIP + XML，无第三方库）。
* writeback.js：把对话抽取为笔记候选。
* config.js：笔记根目录等路径配置。
* writeback-prompts.js：抽取提示词。

适用场景¶

适合需要管理个人知识库、私有文档检索，或希望深度集成开发工作流的智能体开发者。使用时需注意，插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。