Clizo1209/dsh-playwright-browser
80最近提交 2026年8月14日
dsh-playwright-browser DSH 插件
dsh-playwright-browser 为 DeepSeek Harness (DSH) 提供持久的浏览器控制器，具备可访问性快照、语义定位器、截图、导航历史和显式标签页管理能力。它在 DSH 工具注册表中注册了十个 browser_* 工具，使代理能够以编程方式与网页交互。
如何安装 dsh-playwright-browser DSH 插件
dsh plugin --profile web add dsh-playwright-browser复制不会执行命令。安装 dsh-playwright-browser DSH 插件前请核对仓库和版本。
dsh-playwright-browser DSH 插件数据来源
dsh-playwright-browser DSH 插件快照日期：2026年8月16日
discovered
dsh-playwright-browser DSH 插件能做什么
- 持久的浏览器上下文，标签页标识符稳定
- 交互后可访问性或可见文本快照
- 语义定位器（role、label、text、CSS 及简写形式）
- 导航操作：打开、导航、后退、前进、刷新
- 键盘输入、点击、填充和等待操作
- PNG 截图，输出目录可配置
- 延迟启动浏览器，可回退到已安装的 Chrome 或 Edge
- 支持中断感知的页面操作和 Cordis 生命周期清理
dsh-playwright-browser DSH 插件适合哪些场景
- 使用 DSH 代理自动化 Web 应用测试
- 抓取需要 JavaScript 执行的动态内容
- 作为工作流的一部分填写和提交表单
- 为文档编制或监控截取网页截图
- 在受控浏览器环境中执行多步骤用户流程
dsh-playwright-browser DSH 插件适合谁
- 需要浏览器访问能力的 AI 代理开发者
- 希望用 Web 自动化扩展代理能力的 DSH 用户
dsh-playwright-browser DSH 插件的限制
- 需要 Node.js ^22.19.0 或 >=24.0.0 以及 DSH 配置文件
- 不支持任意页面 JavaScript 求值，仅限预定义操作
- 浏览器不会自动下载安装，需要预先安装或配置
- 当前测试于 DSH 0.1.0-rc.6，未来 DSH 版本可能需更新兼容性
- 拒绝包含凭据的 URL
dsh-playwright-browser DSH 插件的仓库 README 摘录
以下文字摘自 dsh-playwright-browser DSH 插件的上游仓库 Clizo1209/dsh-playwright-browser 的 README，版权归原作者，仅作引用。
Semantic, multi-tab browser automation for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness), powered by Playwright. The plugin gives a DSH agent a persistent browser controller, accessibility-oriented snapshots, semantic locators, screenshots, navigation history, and explicit tab management. It is behaviorally inspired by the Codex Browser skill, but contains no Codex runtime code and does not depend on OpenAI browser bindings. > [!IMPORTANT] > DSH is currently a developer preview. This plugin is tested against the DSH `0.1.0-rc.6` package line and may need compatibility updates as DSH evolves. ## Features - Ten native `browser_*` tools registered in the DSH tool registry. - Reusable browser context with stable tab identifiers. - Fresh bounded accessibility or visible-text snapshots after interactions. - Semantic locators such as `role=button|Save`, `label=Email`, and `text=Settings`. - Snapshot-friendly role shorthand such as `button|Save` and `textbox|Email`. - Back, forward, reload, keyboard input, waits, and PNG screenshots. - Lazy browser startup with fallback from Playwright Chromium to installed Chrome or Edge. - Abort-aware page operations and C
阅读完整 README仓库许可: MIT
dsh-playwright-browser DSH 插件常见问题
如何安装 dsh-playwright-browser？
运行 `dsh plugin --profile <profile> add dsh-playwright-browser` 从 npm 仓库安装。或者克隆仓库，执行 `npm pack`，然后使用 `dsh plugin --profile <profile> add ./dsh-playwright-browser-<version>.tgz` 从本地 tarball 安装。确保你已设置好 DSH 配置文件。
支持哪些浏览器？
支持 Playwright Chromium、Firefox 和 WebKit。你也可以通过配置 `channel` 选项来使用 Google Chrome 或 Microsoft Edge。如果想使用自定义浏览器可执行文件，请在配置中设置 `executablePath` 选项。
这个插件可以截图吗？
可以，插件提供了 `browser_screenshot` 工具，用于保存当前页面的 PNG 截图并返回其绝对路径。你可以通过 `screenshotDir` 选项配置输出目录（默认是 `.dsh-browser/screenshots`）。
如何使用定位器与元素交互？
插件支持语义定位器，例如 `role=button|Save`、`label=Email`、`placeholder=Search`、`text=Settings`、`testid=submit`、`css=#legacy-button`，以及简写形式如 `button|Save`。这些定位器可以在 `browser_click` 和 `browser_fill` 工具中使用。
插件是否支持无头模式？
是的，默认情况下浏览器以无头模式运行。你可以通过在插件配置中设置 `headless: false` 来更改此设置。无头模式适用于自动化测试和服务器环境，无需可见窗口。