blake-r/dsh-plugins

dsh-plugins

DeepSeek Harness (dsh) 的插件 monorepo。每个插件都是一个独立的
npm 包，带有 dsh.bundle.patch 清单，因此可以从单个仓库中
选择性地安装插件，并且会自动添加到
profile 中（无需手动编辑 cordis.patch.yml）。

结构

dsh-plugins/
├── package.json          # 根目录：workspaces，私有
├── pnpm-workspace.yaml
├── scripts/check.mjs     # 对所有 src/* 执行 node --check
└── packages/
├── dsh-plugin-a/     # @blake-r/dsh-plugin-a
└── dsh-plugin-b/     # @blake-r/dsh-plugin-b

插件

| 包 | 功能 |
| --- | --- |
| dsh-assembly-rewrite | 根据配置重写具名的系统提示词组装插入项（工具、章节、上下文、变量）。 |
| dsh-assembly-tools-prompt-strip | 从系统提示词中移除 tool: 说明性指导章节。 |
| dsh-command-from-prompt | 通用的“命令 = 用户提示词”斜杠命令插件。 |
| dsh-compaction-micro | 针对 kb 预设的按请求轨迹重组。 |
| dsh-provider-websearch-lightpanda | 由 lightpanda MCP 服务器支持的 WebRuntime provider 对。 |
| dsh-skill-from-tools | 每个工具一个技能（无模块分组），简短形式。 |
| dsh-tool-filter-root-find | 拦截扫描整个磁盘或主目录的工具调用。 |
| dsh-tool-trajectory-recall | 面向模型的、基于持久会话日志的同一会话召回/搜索工具。 |

工作原理

每个包在 package.json 中声明：

"dsh": { "bundle": { "patch": "./cordis.patch.yml" } }

并附带一个 cordis.patch.yml 文件（一个包含 insert 的 YAML 行列表）。
dsh plugin --profile web add  命令会安装该包，并通过
reconcilePlugins 自行将其添加到 dsh.profile.bundles —— 插件
无需手动编辑即可激活。

安装（选择性，本地）

cd
dsh plugin --profile web add ./packages/dsh-plugin-a
仅 dsh-plugin-a；dsh-plugin-b 不会被安装

pnpm add ./path 会创建指向本地文件夹的符号链接 —— 便于开发。

安装（外部用户）

从 npm registry 安装（推荐，便于从单个仓库中选择性安装）
dsh plugin --profile web add @blake-r/dsh-plugin-a

从 GitHub 仓库安装，单个插件子目录（tag = 版本）
dsh plugin --profile web add github:blake-r/dsh-plugins#path:packages/dsh-plugin-a

从 GitHub 仓库安装，整个仓库根目录（tag = 版本）
dsh plugin --profile web add github:blake-r/dsh-plugins#v1.0.0

关于 github:： github: 协议会安装仓库根目录，
默认。要从这个 monorepo 安装单个插件，请用 #path:packages/ 指向其子目录（如上所示）。若要从单个仓库中进行最具选择性的安装，请将包发布到 npm（pnpm -r publish）并按名称安装。

发布

pnpm install
pnpm check        # node --check over all src/*
pnpm -r publish   # publish all packages to npm

npm 版本应与 git 标签 vX.Y.Z 匹配。

添加新插件

1. 复制 packages/dsh-plugin-a → packages/dsh-plugin-。
2. 修改 name（作用域 @blake-r/dsh-）、version、description。
3. 在 src/index.js 中编写逻辑（ESM，导出 name + apply(ctx)）。
4. 更新 cordis.patch.yml（行 id 和 name）。
5. pnpm check 和 pnpm -r publish。

备注

- 插件文件是 ESM（.mjs）；用 node --check 检查。
- 包的 cordis.patch.yml 必须在 files 中（否则它不会被发布）。