dsh-playwright-browser

English

面向 DeepSeek Harness（DSH） 的 Playwright 浏览器自动化插件，提供语义定位、多标签页和持久浏览器控制能力。

本插件在行为设计上参考 Codex Browser 技能，但不包含 Codex 运行时代码，也不依赖 OpenAI 的浏览器绑定。DSH 目前仍是开发者预览版；本项目已针对 DSH 0.1.0-rc.6 包系列进行测试。

主要能力

• 10 个原生 browser_* 工具。
• 可复用浏览器上下文和稳定标签页 ID。
• 每次交互后返回新的 accessibility 或可见文本快照。
• role=button|保存、label=邮箱 等语义定位。
• 接受快照友好的 button|保存、textbox|邮箱 role 简写。
• 支持截图、等待、键盘、前进、后退、刷新和多标签管理。
• Playwright Chromium 缺失时自动尝试系统 Chrome 和 Edge。
• 操作支持取消，由 Cordis 生命周期统一清理。
• 不提供任意页面 JavaScript eval。

环境要求

• Node.js ^22.19.0 或 >=24.0.0。
• 一个 DSH profile。
• Playwright Chromium、系统 Chrome/Edge，或明确配置的浏览器可执行文件。

安装 Playwright Chromium：

npx playwright install chromium

安装

从 npm 安装：

dsh plugin --profile web add dsh-playwright-browser

从当前源码目录打包并安装：

npm install
npm pack
dsh plugin --profile web add ./dsh-playwright-browser-0.1.3.tgz

安装到 headless profile：

dsh plugin --profile headless add ./dsh-playwright-browser-0.1.3.tgz

检查组合配置：

dsh --profile web --dump-config

Git 安装会执行 prepare 构建。pnpm 10 及以上版本可能要求在 profile 的 pnpm-workspace.yaml 中明确允许该构建。预编译 npm 包或 tarball 不需要在 profile 中执行源码构建。

配置

在 profile 的 cordis.patch.yml 中添加覆盖：

- id: playwright-browser
  config:
    browser: chromium
    channel: chrome
    headless: true
    viewportWidth: 1440
    viewportHeight: 900
    screenshotDir: .dsh-browser/screenshots