浏览器测试与调试 nemosr/dsh-personal-plugins

dsh-personal-plugins

个人自用的 DeepSeek Harness (DSH) 插件集。Personal-use DeepSeek Harness (DSH) plugin collection.

这些插件源自旧的 0.1.0-rc.5 构建，经整理后作为独立插件集维护，可与当前 DSH（0.1.0-rc.8，Cordis 4.x）组合使用。These plugins originated from an older 0.1.0-rc.5 build and are maintained here as a standalone set, composable with current DSH (0.1.0-rc.8, Cordis 4.x).

插件 Plugins

| 插件 Plugin | 角色 Role | 说明 Description |
| dsh-tool-web-app-testing | 模型工具 | 面向模型的本地 Web 应用交互与截图验证工具（Playwright） |
| dsh-host-web-debugger | 宿主服务 | 回环 HTTP 结构化诊断收集器 + 六阶段调试工作流 |

安装方式 Installation

插件包保持各自独立的 package.json，通过 DSH profile 的依赖机制安装。每个插件都有独立的 README.md（含中文版），包含完整配置说明。

1. 将插件加入 profile 依赖

以 web profile 为例，把插件目录（或打包后的 .tgz）加入：

$DSH_HOME/profiles/web/package.json

{
"name": "dsh-profile-web",
"private": true,
"dependencies": {
"dsh-tool-web-app-testing": "file:/plugins/dsh-tool-web-app-testing",
"dsh-host-web-debugger": "file:/plugins/dsh-host-web-debugger"
}
}

然后在 profile 目录内执行 pnpm install 安装本地依赖。

2. 在 profile 组合中挂载

$DSH_HOME/profiles/web/cordis.patch.yml：

- id: tool-web-app-testing
name: '@deepseek-ai/dsh-tool-web-app-testing'
config:
必须配置一种浏览器接入方式： executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe' 或 connectOverCDP: 'http://127.0.0.1:9222'

- id: host-web-debugger
name: '@deepseek-ai/dsh-host-web-debugger'
config:
host: 127.0.0.1
port: 0

dsh-tool-web-app-testing 是函数插件，使用命名导出（name / inject / Config / apply）；dsh-host-web-debugger 是服务类插件，默认导出 WebDebugger。

特色 Features

- 模型驱动浏览器操作：模型可通过 web_app_testing 打开、点击、填写、选择、截图本地回环页面，并保留截图附件供后续多模态请求使用。
- Agent 级浏览器隔离：每个 Agent 拥有独立浏览器会话，不共享页面状态；Agent 结束、插件释放或闲置超时后自动关闭。
- 强制回环网络边界：仅允许 localhost / 127.0.0.1 / ::1，浏览器层拦截所有非回环子资源。
- 结构化调试收集：WebDebugger 提供有界日志收集和严格的 假设 → 插桩 → 复现 → 分析 → 修复 → 验证 工作流。

兼容性与安全说明 Compatibility & Security

- 两个插件均为 0.1.0-rc.5 构建，peer 范围 >=0.1.0-rc.5 <0.2.0；已在当前 DSH 0.1.0-rc.8 上验证可加载（见各插件 README 的验证记录）。
- dsh-host-web-debugger 没有认证和持久化，不要绑定到 0.0.0.0。
- 本仓库不包含任何会话数据、凭据或用户配置。

License

MIT — 与插件包内声明的许可证一致。