dsh-kb
qiyaogongfang/dsh-kb
Local-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 fetched on demand. Adds five tools (search, get, save, update, delete) and a sidebar panel, with zero runtime dependencies. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Installazione
dsh plugin --profile web add github:qiyaogongfang/dsh-kbREADME
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
Plugin correlati
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora