dsh 插件集

我自己在用的 DeepSeek Harness（dsh） 插件集。

平时用得上、顺手的小功能，就写成一个组合包（bundle）收进来，每个插件一个顶层目录——换机器或重装时能一把装回；攒下来的顺手公开，别人看着有用可以直接拿去用。

⚠️ 非官方项目。 与 deepseek-ai 无隶属关系，也不属于官方插件市场。仓库里都是自己用得上才写的插件，想到什么加什么。

插件一览

插件	作用	版本	直接安装（免 clone）
turn-notifier	提示铃：智能体需要你注意时响铃提醒（答完一轮 / 停下来等你操作），不理会就按间隔重复，一动鼠标键盘就停。点组件行的箭头可设置提示音、波形、音量与重复次数	1.7.1	github:Jedeiah/dsh-plugins#path:turn-notifier
session-purge	删除会话：在会话行的悬停按钮 / 「…」菜单里加「删除会话」，把会话连同子 agent 会话真正从磁盘上删掉。点组件行的箭头可设置清理范围	1.0.1	github:Jedeiah/dsh-plugins#path:session-purge
chrome-devtools-mcp	浏览器调试：接入 chrome-devtools-mcp，给模型浏览器调试工具（页面、快照、截图、DOM/JS 求值、控制台、网络、性能），工具名形如 mcp__chrome-devtools__<tool>；并附带随包分发的 7 个调试技能，点组件行的箭头可设置技能开关，以及让智能体操作哪个浏览器（自己拉起一个，或接管你正在用的）	1.3.0	github:Jedeiah/dsh-plugins#path:chrome-devtools-mcp
rea-dsh	逆向工程：接入 REA 的 MCP 服务器，给模型逆向工程工具（原生二进制、Electron/JS 应用、.NET 程序集、APK、固件、网页），工具名形如 mcp__rea__<tool>；并分发 reverse-engineer-anything 技能、让它自动跟随 REA 的版本走；点组件行的箭头可看状态、自检、设置技能开关与版本	1.5.0	github:Jedeiah/dsh-plugins#path:rea-dsh
web-fetch-fakeip	代理抓取：让 web_fetch 在 TUN + fake-ip 代理（Clash / Shadowrocket）下也能正常工作	5.1.1	github:Jedeiah/dsh-plugins#path:web-fetch-fakeip

最后一列是 pnpm 安装 spec，直接喂给 dsh plugin --profile <名字> add，或填进 Plugins 页的安装框即可（见安装）。

每个插件都是独立、可单独安装的组合包：package.json 里声明 dsh.bundle.patch，patch 文件插入该插件的行；带界面/交互的插件再声明 dsh.client 提供客户端半边。

环境要求

项	说明
dsh 版本	0.2.0-rc.2（桌面端）实测通过；更早版本未验证
构建步骤	不需要 —— 五个插件都是零构建（没有 src/、没有 tsdown、没有 install 脚本）；除 web-fetch-fakeip（纯 Host 插件）外都含 Host/Client 半边；!!js 只在确实需要时用 —— 目前 chrome-devtools-mcp 一处（算出 skills-live/ 的绝对路径），rea-dsh 三处（技能目录 + 桥的 command/args，见其 README《怎么拉起 REA》）
依赖安装	不需要手动装 —— 对 dsh 自带包的依赖写在 peerDependencies 里，由 dsh 的模块解析器路由到安装里的副本
平台	插件本身与平台无关；chrome-devtools-mcp 需要宿主有 node/npm（首次运行由 npx 拉取 MCP 服务器）；rea-dsh 不需要 —— 宿主有 node/npm 就复用（复用其 npm 缓存），没有或 GUI 启动拿不到 PATH 时改用 dsh 自带运行时（自带 node + pnpm），桌面端不装 node/npm 也能起
适用场景	web-fetch-fakeip 只在使用 TUN + fake-ip 代理（Clash / Shadowrocket 等）时才有意义

安装

四种方式，装完的形态不同（link: 软链 vs git 依赖 vs 副本），下面标明。

方式一：Plugins 页面

dsh 的 Plugins 页 → Add plugin，填 pnpm spec 或插件目录的绝对路径 → 安装 → Enable now。

方式二：plugin_manager 工具（在 agent 里）

plugin_manager → action: install_bundle，target: 同样是 spec 或绝对路径； 卸载用 action: remove_bundle，target: <包名>。

方式三：dsh CLI（不进桌面端、可脚本化）

# 安装（<spec> 见下方《安装 spec 的形式》）
dsh plugin --profile <你的profile> add "<spec>"

# 卸载
dsh plugin --profile <你的profile> remove @jedeiah/turn-notifier

dsh plugin 会把剩余参数原样转发给 pnpm、在 profile 目录里执行，所以 add / remove / why / ls 之类都能用。它要求 --profile，且会真的改 profile。

⚠️ 本机上 /usr/local/bin/dsh 缺少可执行位（-rw-r--r--），可能报 Permission denied。 此时用 sh /usr/local/bin/dsh plugin --profile <名字> add "<spec>" 绕过。

方式四：手工编辑 profile（最底层）

编辑 ~/.dsh/profiles/<你的profile>/package.json，两处都要改：

{
  "dependencies": {
    "@jedeiah/turn-notifier": "github:Jedeiah/dsh-plugins#path:turn-notifier"   // ① 加依赖
  },
  "dsh": {
    "profile": {
      "bundles": [
        "...",
        "@jedeiah/turn-notifier"                                               // ② 加进组合包列表
      ]
    }
  }
}

然后在 profile 目录跑一次 pnpm install，重启 dsh。 bundles 是有序的，新加的包放在末尾会改变配置优先级（后加载的覆盖先加载的），介意就手动挪位置。

安装 spec 的形式

上面方式一/二/三都收同一种 pnpm spec（由 dsh 的 install-spec 解析后交给 pnpm）：

形式	例子	装出来是什么
GitHub 子目录（推荐，免 clone）	github:Jedeiah/dsh-plugins#path:turn-notifier	git 依赖（克隆整仓，取子目录）
git URL	git+https://github.com/Jedeiah/dsh-plugins.git#path:turn-notifier	同上
本地路径	/abs/path/to/turn-notifier 或 link:/abs/path/...	link: 软链（dev 用）
压缩包	./pkg.tgz、https://…/pkg.tgz	解压副本
npm 包名	@scope/name、@scope/name@1.2.3	registry 安装（本仓库未发布）

取子目录用 #path:，写在 # 后面的参数位（和 #semver:、分支名同级）：

dsh plugin --profile <你的profile> add "github:Jedeiah/dsh-plugins#path:turn-notifier"

• #path: 后面不带前导斜杠最稳（作者在 pnpm 11.22 上见过一次 #path:/x 失败；本机 pnpm 11.7.0 与 12.11.2 复核两种写法都能装，姑且记作版本相关）。
• 这种方式会克隆整个仓库（不是 sparse checkout），仓库小所以无所谓。
• 装出来的是 git 依赖（不是 link:），升级 = 重新 add 一次；且会锁定到当时的 commit（pnpm-lock.yaml 里记的是 codeload…/tar.gz/<sha>）。

为什么本仓库的插件能这样装？ 官方《打包与安装插件》警告：git 安装拉的是源码、 不会运行构建脚本，所以 TypeScript 包到手时缺 lib/ 输出、加载会失败。本仓库的插件全是 纯 JS、零构建（直接写 index.js / client.js，没有 src/、没有 tsdown），因此不受这条 限制。新增插件时请保持这一点，否则 #path: 这种安装方式会失效。

⚠️ 方式一、方式二、方式四里的本地路径装出来的是 link: 软链，不是复制。不要移动或删除插件目录，否则 bundle 会失效（典型表现：包元信息错误、或该行 failed to import、或行启用了但功能不出现）。

卸载：Plugins 页里 Remove，或 plugin_manager → action: remove_bundle。

新增一个插件

在仓库根下建一个目录，放这些文件：

文件	必需	说明
package.json	✅	声明 dsh.bundle.patch；有客户端半边再声明 dsh.client
cordis.patch.yml	✅	insert: 该插件的行（id + name）
index.js	可选	宿主半边；纯客户端插件可以导出空的 apply，纯 patch 组合包（如 chrome-devtools-mcp）不需要
client.js	可选	客户端半边，用 window.__ModuleLoader__.load({ id, factory }) 注册
locale/{en,zh}.json	可选	Plugins 卡片的标题与描述，结构必须是 {"meta": {"title", "description"}}
icon.svg	可选	卡片图标

约定（来自官方文档；踩过的坑都记在各插件自己的 README 里）：

• 宿主半边不要写死可调参数。 导出 Config schema（import z from '@deepseek-ai/schemastery'），字段加 .volatile()，这样它们才会出现在 Plugins 页面的配置表单里。
• 从 dsh 安装目录里 import 的包，必须写进该插件的 peerDependencies。 本仓库的插件是 link: 进 profile 的，裸导入靠这条声明被路由到安装里的副本（否则报 ERR_MODULE_NOT_FOUND → 该行 failed to import）。
• 客户端半边别写 immediately: true，除非真的需要启动期预取——它会把这一行划进 bootstrap 阶段，而 bootstrap 条目无法被动态移除/替换。
• @jedeiah/* 是这些包的作用域名（与仓库作者同名，避免与他人撞名）。改名要同步改 cordis.patch.yml 里的行名、客户端半边的模块 id 并重新安装。

已知的 dsh 侧问题

• 停用一行带客户端半边的插件后再启用，客户端半边不保证重新挂载：浏览器模块表认为该包已加载，于是不再执行它的 apply（deepseek-harness#8452）。 本仓库的规避方式：把配置页的注册放进一道 ctx.inject(['remote.<本插件自己的服务>', …], cb) 依赖门里——apply 不重跑时，Host 半边重建仍会让依赖消失又出现，门于是重开、页面重新挂上。turn-notifier 与 session-purge 都用了这个形状，实测「停用 → 启用」后 › 和页面内容都在。 隐形条目（响铃、按钮等）不走这道门，其恢复情况未逐项验证；若发现某行界面消失，重载界面（⌘R）即可恢复，不必重启 App。

• 静态 import dsh 自带包：作者在 0.2.0-rc.2 上遇到过一次「条目建不起来、诊断只报 failed to import」（当时 specifier 就是同一个）；后续复核里，把该包写进 peerDependencies 之后静态导入可以正常组合（schemastery、dsh-web-fetch-http 都是静态导入）。因此本仓库仍统一用模块作用域的 await import(...) 兜底，见 web-fetch-fakeip 的 README《实现注记》。

反馈

仓库首先是自用的，插件都按"自己用得上"的标准写。有 bug、有建议，或者想加个类似的插件，欢迎提 issue / PR：

• 加插件：按上面《新增一个插件》的文件与约定来。
• 改现有插件：请保持纯 JS、零构建，可调参数走 Config，界面文案走客户端 locale。
• 如果踩到 dsh 自身的坑，欢迎连带把复现步骤写进对应插件的 README——本仓库的习惯是"把坑记在原地"。

许可

MIT —— 与 dsh 本身一致。