dsh-browser-playwright：给 DeepSeek Harness 的 Playwright 浏览器插件（快照 + ref 定位）

[ChenyuHeee]

给 DeepSeek Harness 加一个真正的浏览器能力：快照式交互 + 稳定元素引用（ref），模型不再靠猜 CSS 选择器。

一句话

Playwright 驱动的 browser_* 工具族：每次操作返回当前页面的可访问性快照（带 ref=e1 标识），后续 click/fill/press 直接用 ref 定位，确定性强、token 省。

安装

dsh plugin --profile <name> add dsh-browser-playwright

无需下载浏览器：自动探测 chromium → chrome → msedge → edge 通道，本机有 Chrome 就零下载（受限网络给了 npmmirror 镜像指引）。

特性

• 17 个工具：navigate / snapshot / click / fill / press / scroll / back / forward / wait / tabs 四件套 / screenshot / extract / evaluate / close
• 会话隔离：每个 harness 会话一个独立浏览器上下文，登录态/Cookie 跨调用保留，空闲自动回收
• 截图即附件：browser_screenshot 存为持久图片附件，视觉模型直接看
• 结构化提取：browser_extract 用自然语言指令从页面提取 JSON（配一个辅助模型即可）
• 安全默认：仅 http(s)、域名白名单、evaluate 默认关闭、快照 token 上限
• 能力接缝：ctx.browser 三段式（Service Definition / Provider / 工具），将来换云端浏览器（Browserbase/Steel）不动工具 schema

与现有 dsh-browser 的差异

dsh-browser 是 CSS selector 猜测 + get_text/get_html；本插件是 a11y 快照 + ref 定位 + tabs + extract + 附件截图，二者可共存，按偏好选用。

链接

• GitHub：https://github.com/ChenyuHeee/dsh-browser-playwright （24 个测试 + CI 全绿）
• npm：https://www.npmjs.com/package/dsh-browser-playwright

基于 @deepseek-ai/dsh-* 0.1.0-rc.2 ~ rc.6 开发，已实测兼容 rc.5 运行时。欢迎试用、提 issue。