dsh-kb
Manifest validLocal-first knowledge base for DeepSeek Harness. Two-level topics, free tags and full-text search keep runbooks, conventions and gotchas in one kb.json; the prompt carries only an index and bodies are
dsh-kb
把操作流程、规范、踩坑记录收进 DSH 侧栏;对话里按需检索,不往上下文里灌正文。
两级主题 · 自由标签 · 全文检索 · 一个 kb.json 就是全部数据
为什么用它?
| 只带索引 | 两级主题 + 标签 | 一个 JSON |
|---|---|---|
| 系统提示里只有分类计数和每个主题前几条标题,正文只在你要时取 | 一级主题 / 二级主题成树,标签横向串联;多个标签同时命中 | kb.json 纯 JSON,可直接备份、同步、手改 |
- 只存不灌。 系统提示默认只带索引(几十篇也只占一千字上下);你点名要哪篇,我再
kb_get取正文。 - 收得下,也找得到。 标题、主题、标签、摘要、正文都能搜,按命中位置加权;分类计数一眼看到库存。
- 数据在你手里。 写入是「临时文件 + 原子替换」,别的进程改过会按 mtime 重载;一个文件就是全部。
- 零运行时依赖。 不引第三方包,装完就能用;数据不进 Git,也不上传。
- 两边都能改。 侧栏里手动编辑,或者直接让 agent 用
kb_save/kb_update写。
安装
在 DSH 的「插件」里搜索 dsh-kb 并安装(认准 @qiyaogongfang/dsh-kb);装好后刷新页面,左侧栏出现「知识库」。
命令行安装 / 本地开发:
# 装进 DSH profile(推荐)
dsh plugin --profile web add @qiyaogongfang/dsh-kb
# 只装到当前目录(开发依赖)
npm install @qiyaogongfang/dsh-kb
# 从 GitHub 克隆(改代码 / 本地插件)
git clone https://github.com/qiyaogongfang/dsh-kb.git
npm 上还有一个叫
dsh-kb的包是别人做的,不是这个项目;认准作用域@qiyaogongfang/。
五个工具
| 工具 | 作用 |
|---|---|
kb_search | 全文搜(标题 / 主题 / 标签 / 摘要 / 正文),可按主题、二级主题、标签过滤 |
kb_get | 按 id 取正文;只给关键词时命中一篇就直接返回 |
kb_save | 新建;带 id 时只覆盖给出的字段 |
kb_update | 只改传入的字段,clear 清空指定字段 |
kb_delete | 删一篇(会先确认是哪篇) |
数据放在哪
| 位置 | 说明 |
|---|---|
~/.dsh-kb/data/kb.json | 默认位置(用户目录下) |
环境变量 KB_STORE_DIR | 指定别的目录,例如放在同步盘或移动盘上 |
备份 = 复制 kb.json;换机器 = 把它放回去。写入是原子替换,手工编辑也不会被旧缓存盖掉。
系统提示里的开销
默认「只带索引」:分类计数 + 每个一级主题下最多 3 条标题。几十篇文档也只占一千字上下,不含任何正文;正文只在 kb_get 时才进上下文。库里文档再多,提示词也不会跟着膨胀。
目录结构
dsh-kb/
├── index.js Host 半边:HTTP 接口 + 五个工具 + 系统提示索引
├── store.js 存储:JSON、两级分类、标签、全文检索
├── client.js 浏览器半边:侧栏面板 + 输入框引用按钮
├── cordis.patch.yml 插件行声明
├── assets/ banner / 图标
└── locale/ zh / en 元数据
本地开发
克隆后把该目录作为插件装进 profile(插件管理里选本地目录,或 install_bundle target 填绝对路径),改完刷新页面即可。发版走 npm + OIDC:改 package.json 版本 → 推 v* tag → GitHub Actions 自动发布并附 provenance。
问题反馈 · 更新记录 · MIT License · 作者 qiyaogongfang
Comments
Loading…
Similar plugins
by domitor-syh
Local-first knowledge base for DeepSeek Harness: each base is a folder of UTF-8 text, text PDFs and OCR-read images; the plugin retrieves from the session's selected bases before every turn with Chine
★ 4
MIT
TypeScript
Nov 19, 2026
dsh plugin --profile web add @domitor-syh/dsh-knowbaseby fangqiing
本地知识库插件 for DeepSeek Harness:每篇一个 Markdown,支持全文搜索、标签、层级目录、附件与 Office 零依赖抽取
★ 1
MIT
JavaScript
Oct 22, 2026
dsh plugin --profile web add dsh-knowledge-liteLocal-first, editable knowledge base for the DSH workspace, shown in the sidebar.
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-knowledge-baseby PerryLink
Whole-disk, millisecond file search for DeepSeek Harness without Everything: self-built cross-platform index, agent tools and a Web search panel.
★ 2
Apache-2.0
Go
Nov 20, 2026
dsh plugin --profile web add dsh-locatorLocal-first knowledge base for DeepSeek Harness: workspace Markdown notes, provenance, review status, BM25 search, and four km_* tools.
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-kmby imkelt
Local knowledge bases with explicit, source-backed retrieval for DeepSeek Harness Web.
★ 3
↓ 135/wk
MIT
TypeScript
Aug 26, 2026
dsh plugin --profile web add @kai232/dsh-rag