浏览器工具包 nguyenhnhatquang/DSH-Plugins

DSH-Plugins

DeepSeek Harness（dsh）的插件仓库。DeepSeek Harness 是构建在 Cordis 之上的智能体框架，在这里一切皆插件。

packages/ 下的每个包都是可独立安装的 dsh bundle。

插件

| 包 | 作用 |
| dsh-plugin-browserkit | 给智能体一个真实浏览器，既能操作也能验证：无障碍快照、基于 ref 的交互、断言、标签页、对话框、登录状态持久化、上传、截图、控制台与网络检查，还能通过 CDP 挂到已有浏览器上。每个智能体一个隔离的浏览器。 |

安装

into a profile
dsh plugin --profile <profile> add <spec> # spec: npm name, absolute path, tarball, or git URL

verify the bundle composed
dsh --profile <profile> --dump-config
dsh --profile <profile> --dump-config-schema

Desktop 应用自己管理 desktop 配置档，所以命令行拒绝操作它。请通过 GUI 的 Plugins 页面安装，或者在 %USERPROFILE%\.dsh\cordis.patch.yml 里加一行（home 层对所有配置档生效）。

仓库结构

packages/<name>/
package.json # name, dsh.bundle.patch, dependencies
cordis.patch.yml # the bundle's patch layer: which plugin rows it inserts
lib/ # the plugin entry and its modules (plain ESM, no build step)
locale/ # display metadata: meta.title, meta.description
test/ # node:test suites

这里的插件发布的是纯 ESM JavaScript，没有构建步骤。dsh 插件就是一个模块，导出 name / inject / Config / apply；bundle 则是一个包，它的 package.json 声明由哪个补丁文件插入自己的行。两者都不需要编译器，所以签出后的插件可以立刻从绝对路径加载——scripts/dev-overlay.mjs 做的就是这件事。

开发

pnpm install
pnpm test # every package's node:test suite
pnpm run dev:overlay # write .dev/overlay.cordis.patch.yml referencing the working tree

本仓库遵循的约定

- 函数式插件契约：只用具名导出，不要默认导出——有默认导出会让 Loader 丢掉 inject。
- Config 是原生 Schemastery schema，因为框架会读取它来生成 --dump-config-schema 和配置表单。普通的 Standard-Schema 对象能加载，但 dump 会失败。
- 不硬编码可调项：凡是两套部署可能设置不同的东西，都做成带校验的配置字段；未知键在加载时报错，而不是悄悄保留默认值。
- 注册即副作用：凡是通过 ctx 注册的东西，卸载时都会回退，所以资源由 ctx.effect(...) 的清理函数释放，而不是手动拆除。
- 工具 schema 必须落在 harness 的 JSON-Schema 子集内（type/oneOf/properties/required/additionalProperties/items/enum/const 以及注解）。每个包都用测试锁住这一点：否则 ToolRuntime.register() 会拒绝整个插件条目，这属于启动失败，而不是运行时失败。
- 测试跑的是真东西。 伪造的只是 harness 上下文，不是插件所驱动的外部系统。

License

MIT —— 见各包的 LICENSE。