dsh-playwright-browser 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node ^22.19.0 || >=24.0.0）；该结论来自程序自动检查，未经人工实机验证。

dsh-playwright-browser 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node ^22.19.0 || >=24.0.0）；该结论来自程序自动检查，未经人工实机验证。

dsh-playwright-browser 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-playwright-browser 还在维护吗？

GitHub 14 星。最近一次上游提交在 2026/8/14。

浏览器自动化 Clizo1209/dsh-playwright-browser

DeepSeek Harnessv0.1.3

Clizo120981 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

为 DeepSeek Harness 提供 Playwright 浏览器自动化。

37.5/100

综合分

GitHub 星标

395

npm 周下载

—/5

用户评分

数据截至 2026/9/17 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

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

npm 源 · dsh-playwright-browser 的发布者账号已校验与本仓库一致

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · browser

装得上吗

本站已在 dsh 0.2.1-rc.5 下真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 81 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-playwright-browser @ 0.1.3

✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/30 15:56:38

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件

查看扫描证据（共 1 处，展示前 1 条）

写入本地文件
lib/browser-controller.js:297
await mkdir(directory, { recursive: true });

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

README

由 DeepSeek 最新模型翻译生成

dsh-playwright-browser 为 DeepSeek Harness (DSH) 提供语义化、多标签页的浏览器自动化，由 Playwright 驱动。这个插件给 DSH 智能体配了一个常驻浏览器控制器，支持面向无障碍树的快照、语义化定位器、截图、导航历史，以及显式的标签页管理。行为上参考了 Codex Browser 技能，但不含任何 Codex 运行时代码，也不依赖 OpenAI 的浏览器绑定。 [!IMPORTANT] DSH 目前还是开发者预览版。这个插件针对 DSH 0.1.0-rc.6 包版本线做过测试，随着 DSH 演进，可能需要跟进兼容性更新。功能 - 在 DSH 工具注册表里注册十个原生 browser_* 工具。 - 可复用的浏览器上下文，标签页标识稳定。 - 每次交互后都重新生成有大小限制的无障碍快照或可见文本快照。 - 语义化定位器，例如 role=button|Save、label=Email、text=Settings。 - 对快照友好的角色简写，例如 button|Save、textbox|Email。 - 前进、后退、刷新、键盘输入、等待，以及 PNG 截图。 - 浏览器延迟启动，Playwright Chromium 不可用时回退到已安装的 Chrome 或 Edge。

展开完整文档（README 剩余 1 节）

dsh-playwright-browser

为 DeepSeek Harness (DSH) 提供语义化、多标签页的浏览器自动化，由 Playwright 驱动。

这个插件给 DSH 智能体配了一个常驻浏览器控制器，支持面向无障碍树的快照、语义化定位器、截图、导航历史，以及显式的标签页管理。行为上参考了 Codex Browser 技能，但不含任何 Codex 运行时代码，也不依赖 OpenAI 的浏览器绑定。

[!IMPORTANT]
DSH 目前还是开发者预览版。这个插件针对 DSH 0.1.0-rc.6 包版本线做过测试，随着 DSH 演进，可能需要跟进兼容性更新。

功能

- 在 DSH 工具注册表里注册十个原生 browser_* 工具。
- 可复用的浏览器上下文，标签页标识稳定。
- 每次交互后都重新生成有大小限制的无障碍快照或可见文本快照。
- 语义化定位器，例如 role=button|Save、label=Email、text=Settings。
- 对快照友好的角色简写，例如 button|Save、textbox|Email。
- 前进、后退、刷新、键盘输入、等待，以及 PNG 截图。
- 浏览器延迟启动，Playwright Chromium 不可用时回退到已安装的 Chrome 或 Edge。
- 页面操作支持中止，生命周期清理由 Cordis 托管。
- 不执行任意页面 JavaScript。

环境要求

- Node.js ^22.19.0 或 >=24.0.0。
- 一个 DSH 配置档。
- 一款受支持的浏览器：
- Playwright Chromium，用 npx playwright install chromium 安装；或
- Google Chrome / Microsoft Edge；或
- 显式指定 executablePath。

安装

从 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

安装到无头配置档：

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

只校验组合后的配置档，不启动：

dsh --profile web --dump-config

从 Git 安装会执行包的 prepare 脚本。pnpm 10 及更高版本可能要求你在配置档的 pnpm-workspace.yaml 里显式放行这次构建。用预构建的 npm 包或 tarball 安装，则不需要在配置档里做源码构建。

配置

DSH 会在已安装 bundle 的补丁之后应用用户覆盖配置。往配置档的 cordis.patch.yml 里加一段这样的内容：

- id: playwright-browser
config:
browser: chromium
channel: chrome
headless: true
viewportWidth: 1440
viewportHeight: 900
screenshotDir: .dsh-browser/screenshots
支持的选项：

| 选项 | 默认值 | 用途 |
| browser | chromium | chromium、firefox 或 webkit |
| headless | true | 不显示浏览器窗口运行 |
| channel | — | Chromium 渠道，例如 chrome 或 msedge |
| executablePath | — | 浏览器可执行文件的绝对路径 |
| userDataDir | — | 专用于自动化的持久化配置档 |
| viewportWidth | 1280 | 浏览器视口宽度 |
| viewportHeight | 800 | 浏览器视口高度 |
| actionTimeoutMs | 15000 | 定位器/操作超时 |
| navigationTimeoutMs | 30000 | 导航超时 |
| maxSnapshotChars | 40000 | 返回快照的最大长度 |
| screenshotDir | .dsh-browser/screenshots | 截图输出目录 |

不要把 userDataDir 指向个人浏览器配置档。请使用专供智能体的目录。

工具

| 工具 | 说明 |
| browser_open | 打开标签页，可选地导航到某个地址 |
| browser_navigate | 在已有标签页中导航 |
| browser_snapshot | 读取有长度限制的无障碍快照或文本快照 |
| browser_click | 点击语义目标 |
| browser_fill | 替换输入框的值，可选地按 Enter |
| browser_press | 发送 Playwright 键盘按键 |
| browser_wait | 等待目标、URL 或加载状态 |
| browser_history | 后退、前进或重新加载 |
| browser_screenshot | 保存 PNG 并返回其绝对路径 |
| browser_tabs | 列出、选择或关闭标签页 |

推荐的目标写法：

role=button|Save
button|Save
label=Email
placeholder=Search
text=Settings
testid=submit
css=#legacy-button

安全模型

- 页面内容是不可信数据，绝不是智能体指令。
- 系统提示词要求智能体在操作前后检查最新状态。
- 有后果的提交、敏感数据、下载、购买、权限、账户变更以及 CAPTCHA 处理，都需要用户相应授权。
- 浏览器安装绝不静默下载。没有可用浏览器时，智能体必须说明最小安装步骤，并在改动机器前先询问，除非安装已获授权。
- 拒绝带内嵌凭据的 URL。
- 关闭标签页会协作式取消该页面上正在进行的操作。

开发

npm install
npm run check

实时测试：

npm run smoke
npm run smoke:dsh
npm run smoke:business
npm run test:real-world

真实场景测试套件使用公开演示站点和虚构数据。它把脱敏日志和截图写到 .dsh-browser/ 下，该目录已被 Git 忽略。

完整工作流见 Testing、Architecture 和 Releasing。

设计溯源

Codex Browser 技能的行为映射记录在 Codex Browser 设计映射 里。简单说，这个项目采用持久绑定、显式标签页归属、语义定位、实时观测、安全会话边界和清理规范。它用自管理的 Playwright 控制器和 DSH 原生工具，替换掉 Codex 专属的浏览器选择与传输方式。

贡献

提交改动前，先读 CONTRIBUTING.md。安全问题请遵循 SECURITY.md。社区参与受 CODE_OF_CONDUCT.md 约束。

许可证

MIT