dsh-knowledge-base-local：为 DeepSeek Harness 打造的本地知识库 DSH plugin

它是做什么的？

它是 DeepSeek Harness（DSH）的本地知识库插件，把文档以纯 Markdown 形式存放在你指定的任意绝对路径下，任何模型和编辑器都能直接读取。它解决知识散落、检索困难、格式锁定的问题，让 DSH 里的 Agent 能搜索、读取、导入和整理你的资料。核心能力包括混合检索、三种向量模式、PDF 与 Office 文本抽取、MCP 服务、静态加密与多用户权限，运行时零依赖，仅用 Node 内置模块。

核心功能

• 混合检索：BM25 词法匹配、向量余弦相似度与标题/子串加权组合，结果附带文档 id、行号与片段。
• 六类 Agent 工具：搜索、读取、列表、添加、导入、管理，覆盖从入库到清理的完整流程。
• 三种向量模式：本地离线 TF-IDF 特征哈希、模型增强、兼容 OpenAI 的嵌入接口，接口失败时自动回退本地。
• 多格式导入：支持文本、Markdown、代码、网页链接，以及 PDF、DOCX、XLSX、PPTX 的文本抽取，并可通过收件箱目录自动导入与更新。
• 安全与协作：文档级 AES-256-GCM 静态加密，owner、admin、editor、reader 四级角色与集合范围限制，默认单用户关闭。
• 版本与回收站：删除为软删除可恢复，每次编辑保留历史版本（默认 20 个）。

怎么使用这个插件？

在 DSH 中启用后，打开设置里的知识库面板选择存放目录，或直接告诉 Agent 把知识库设到某个路径，配置会写入用户数据目录并跟随你跨项目生效。之后用 Agent 工具或命令行完成搜索、添加、导入与整理；把文件丢进收件箱目录即自动入库，需要对外提供检索时还可通过 MCP 服务接入其他客户端。

报错怎么排查？

向量生成失败时，API 模式会自动回退到本地向量，检索仍可继续，按官方说明检查嵌入接口配置即可。加密文档在锁定状态下无法读取，需先解锁再检索；权限不足时检查当前角色与集合范围是否覆盖目标文档。