本地研究知识库 Zzz11042/dsh-research-kit

dsh-research-kit

面向 DeepSeek Harness（DSH / dsh）的本地优先研究工具包。

一个 DSH 宿主插件加两个 DSH 技能，把外部网络研究变成可管理、能持续积累的知识库：

| 组成 | 类型 | 说明 |
| dsh-research-kit | DSH 宿主插件 | 注册三个面向模型的工具 —— kb_grep、kb_list、kb_save —— 通过受作用域约束的 ctx.fs 文件系统服务读写 markdown 知识库。纯 Node ESM，零运行时依赖，不联网。 |
| local-first-research | DSH 技能 | 协议：先查本地缓存，本地不够才回退到网络，并且把抓到的内容全部写回本地存储，让知识跨会话持续积累。 |
| session-memory | DSH 技能 | 协议：从此前的 DSH 会话（session_search、session_event_search、session_event_trace、session_trace）回答「我之前做了什么？」，而不是再问模型一遍它已经有的上下文。 |

思路是这样：智能体维护一份本地知识库，就不必为已有的事实反复支付完整的网络成本；每个抓取的页面都变成可复用、可引用、带版本的 markdown 资源，而不是一次性的上下文碎片。

目录结构

dsh-research-kit/
├── plugin/ # the DSH host bundle (kb_grep / kb_list / kb_save)
│ ├── index.js # entry point — apply(ctx, config) │ ├── package.json # dsh.bundle manifest │ ├── cordis.patch.yml │ ├── icon.svg │ ├── locale/{en,zh}.json │ └── test/index.js # node test harness (no framework) ├── skills/ │ ├── local-first-research.md │ └── session-memory.md ├── .github/CONTRIBUTING.md ├── LICENSE └── README.md

安装

插件是 DSH 宿主 bundle。把本仓库的 plugin/ 目录复制或 git clone 到某个配置档，然后通过 plugin_manager 安装（install_bundle，target 填包的绝对目录）。插件的 dsh.bundle.patch 字段指向 cordis.patch.yml，其中插入一行插件记录。

安装两个技能：把 markdown 文件复制到 DSH 会扫描的技能根目录（<dshHome>/skills、<projectRoot>/.dsh/skills 或 Config.customSkillDirs）：

cp skills/local-first-research.md ~/.dsh/skills/
cp skills/session-memory.md ~/.dsh/skills/

技能名用 kebab-case；local-first-research 和 session-memory 都符合。

知识库布局

插件默认把知识库根目录设在 ~/dsh-kb（可用插件的 config.kbHome 字段覆盖）。布局如下：

~/dsh-kb/
├── 01-知识卡片/ # atomic concept cards ├── 02-任务复盘/ # per-task postmortems ├── 05-项目/ # project notes ├── 06-资源/ # cached web material (one .md per fetch, frontmatter: source/fetched/task/tags) └── 07-会话导出/ # exported session summaries kb_save 每次抓取写一个 .md 文件，frontmatter 包含 source / fetched / task / tags。同一个 source: URL 已有资源文件时不要重复创建，直接原地更新。

插件工具

| 工具 | 作用 | 说明 |
| kb_grep | 用正则表达式（ripgrep 语法）搜索知识库文件内容，按文件分组返回匹配行。 | 宿主机有 rg 时用 rg，否则回退到 grep -rn。搜索范围限定在知识库根目录。 |
| kb_list | 列出知识库文件，最新的排在最前。可选 include 后缀过滤和 limit。 | 纯 ctx.fs.listDir 遍历，不起子进程。 |
| kb_save | 把抓取到的页面保存为新的资源文件 06-资源/<yyyy-mm-dd>_<slug>.md，或更新已有文件。会校验 frontmatter 字段。 | 路径拼接由工具负责，模型自己从不拼知识库路径。 |

为什么本地优先？

网页搜索慢、有速率限制、结果还不确定。本地知识库：

- 就是一个文件系统 —— grep 是每个智能体都有的工具；
- 可检查、可 diff（对 git 友好）；
- 会复利：工作流跑得越多，你对网页的依赖越少；
- 让智能体保持诚实 —— 必须先展示本地找到了什么，才允许花网页 token。

local-first-research 技能把这条纪律固化下来；dsh-research-kit 把「保存你找到的东西」这一步从一串 shell 命令变成一次工具调用。

开发

cd plugin
node --check index.js # syntax
node test/index.js # run the test harness (plain node:assert, mock ctx.fs)

新增工具的检查清单见 .github/CONTRIBUTING.md。

许可证

MIT