前言¶
在 DeepSeek Harness（DSH）里做智能体或长对话时，模型往往只能依赖上下文窗口里的内容。团队文档、本地笔记、PDF 规范散落在目录里，外挂检索又多是单独产品，很难在「选源 → 提问 → 看引用」一条链路里完成。若再把外部 MCP、skill 或其它插件工具接进来，通常还要为每家知识库写适配器。
dsh-kb 是面向 DSH 的知识源插件：在对话里选择本地文件夹或按配置挂接的外部工具，回答时在下方给出可展开的引用，并尽量保留打开原文的能力。下面按定位、功能、安装与用法说明如何接入。
这是什么¶
dsh-kb（npm 包名 @local/dsh-kb，版本 0.1.0）由 Trouvaille-xx 维护，属于 DSH 社区目录中的「记忆」类插件。它为 DeepSeek Harness 提供知识源：本地目录递归索引，或通过名称、工具名、参数模板与结果映射接入已注册的外部工具（MCP server、skill、其它插件工具等），不在插件内做厂商专用适配。
简介原文：Knowledge sources for DeepSeek Harness: local folders + configurable external tools, with traceable citations.
核心功能¶
本地文件夹知识源¶
递归扫描 Markdown、纯文本、PDF、docx；按标题感知分块；用 SQLite FTS5（trigram）检索。PDF 引用可带页码。
外部工具知识源（配置式）¶
填写名称、已注册的工具名、参数模板与结果映射即可接入任意外部知识库，无需在插件里为单个厂商写死逻辑。
会话与界面¶
- 会话级选源：输入框左侧芯片下拉选择知识源，支持「不使用知识库」；选择按会话保存。
- 引用折叠面板：回答下方显示「引用 N 条 · 来源」，展开可看片段并打开原文。
- 知识库管理页：侧栏「知识库」入口；左侧本地 / 外部两个 tab；右侧文件表格（名称、类型、状态、更新时间）。
- 设置：分块参数、向量模型、重排模型（后两者配置可保存；向量检索与重排接入见路线图）。
当前检索以本地 FTS5 为主；向量检索、重排、混合检索等仍在路线图中。
安装与启用¶
插件以本地路径方式装进 DSH profile。官方 README 要求先克隆仓库并在插件目录安装运行时依赖（因 profile 的 pnpm 不会为 link: 本地包安装依赖）。
# 1) 克隆到任意目录
git clone <this-repo> dsh-kb
cd dsh-kb
# 2) 安装运行时依赖（pdfjs-dist / mammoth）
npm install --omit=dev
# 3) 装进 DSH profile（路径用绝对路径）
dsh plugin --profile <profile> add <absolute-path-to-dsh-kb>
安装后重启或热重载 DSH：侧边栏应出现「知识库」，输入框左侧出现知识源芯片。
许可证：MIT。
典型用法¶
- 侧边栏打开「知识库」→ 新建本地知识库，填写文件夹绝对路径 → 自动建立索引。
- 回到对话，点输入框左侧芯片，选择该知识源。
- 提问；回答下方出现引用面板，PDF 引用会标注页码。
外部知识源在管理页的「外部」tab 中按 README 说明配置工具名与映射后，同样在芯片里选用即可。
数据落盘¶
$DSH_HOME/kb/state.json：知识源、会话绑定、引用、文档清单、配置。$DSH_HOME/kb/local.sqlite：分块索引（FTS5）。
便于备份或排查索引问题时直接对照这两处路径。
适用场景与注意¶
适合谁：需要在 DSH 对话里固定选用本地文档库或已注册外部检索工具，并希望在回答下方看到可追溯引用的开发者与个人用户。
权限与安全：插件在 DSH 进程权限下运行，本地知识库路径即其可读范围；接入外部工具时会按你的配置调用已注册工具。安装前建议阅读仓库源码与 MIT 许可证，确认路径与工具调用符合你的环境策略。
生态说明：DSH 奉行「一切皆插件」；社区插件目录（如 skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系。本插件当前 GitHub 星标为 0，功能与版本以仓库 README 与 package.json（0.1.0）为准。
路线图（仓库公开项）¶
仓库 README 列出的后续方向包括：向量检索（OpenAI 兼容 / Ollama / 本地 ONNX）、重排、BM25 + 向量混合检索、增量索引、Excel / PPT 解析、召回测试面板等；尚未勾选完成，使用前勿当作已上线能力。
结尾¶
dsh-kb 把「选知识源、提问、看引用」收进 DSH 同一套界面：本地目录走 FTS5 索引，外部能力走配置式工具映射。若要查看目录简介或跟进更新，可访问社区目录页 dsh-kb 与源码仓库 Trouvaille-xx/dsh-kb。
