dsh-playwright：为 DeepSeek Harness 智能体接入真实浏览器操作能力

它是做什么的？

它是 DeepSeek Harness（DSH）的浏览器自动化插件，把官方 Microsoft Playwright MCP 打包成 DSH 组合包，让 profile 上的每个智能体都能驱动真实浏览器。它解决的是智能体无法直接操作网页的问题：导航、点击、输入、快照、截图都能通过结构化无障碍树完成，不需要视觉模型。由 akash-digitavision 维护，采用 MIT 协议，兼容 DSH ≥ 0.2.0-rc.2 的 bundles API，支持 Windows、macOS 与 Linux。

核心功能

• 浏览器操作工具集：以 mcp__playwright__* 命名空间暴露 browser_navigate、browser_snapshot、browser_click、browser_type、browser_take_screenshot 以及标签页、网络请求等工具。
• 无障碍快照驱动：基于结构化 accessibility snapshot 理解页面，无需视觉模型即可定位元素。
• 默认使用本机已安装的 Google Chrome，带界面运行并保留持久化 profile。
• 与 dsh-chrome-devtools 共存：工具命名空间与浏览器实例相互独立，互不干扰。
• 可选启动参数：支持 --isolated、--headless、--browser chromium、--caps=vision,pdf 以及完整 JSON 配置。
• 无账号、无 API 密钥、无遥测，网络访问范围取决于你浏览的页面。

怎么使用这个插件？

在 DSH 的 profile 中启用该组合包后，智能体会自动获得 Playwright 浏览器工具，可直接要求它导航到某个页面并做一次快照来验证是否生效。首次启动时 MCP 服务会通过 npx 下载依赖，大约需要 30 到 60 秒，之后启动约 1 秒。需要调整行为时，在 cordis.patch.yml 的 args 里追加启动参数即可，例如无头模式或改用 Playwright 自带 Chromium。运行环境要求 Node.js ≥ 18 并带 npx，且本机已安装 Chrome 或 Chromium。

报错怎么排查？

• 首次调用工具时长时间无响应：属于首次通过 npx 下载 MCP 服务的正常现象，等待 30 到 60 秒即可，之后启动会明显加快。
• 修改组合包配置后不生效：file: 依赖会被 pnpm 复制进 profile，按官方说明重新安装依赖后再重新应用配置。
• 工具列表里看不到浏览器工具：确认 profile 中已启用该组合包，并检查插件列表里是否存在对应的 include:mcp-playwright 条目。