@dsh-external/dsh-browser

AI 浏览器操作插件（DeepSeek Harness / dsh）：CDP 直连 Chrome，文本 snapshot+ref 主感知，截图走辅助视觉兜底。

• 独立 Chrome 实例：专属 user-data-dir（登录态持久化），用户实时可见、可交互
• 文本主感知：snapshot 注入 JS 遍历 DOM，给可交互元素标 data-dsh-ref，返回文本 ref 树给 LLM；每次操作后自动返回最新 snapshot
• 截图兜底：browser_screenshot 存文件返回路径，模型配合 vision_describe（辅助视觉插件）看图
• 零依赖运行时：Node 24 原生 WebSocket 实现 CDP 客户端
• 设置页提供「允许 AI 使用浏览器」开关；browser_* 工具由宿主注入

安装

方式一：本地 link（已验证，推荐）

本站已在 web profile 中验证可用。将本目录作为链接依赖加入 profile：

// %USERPROFILE%\.dsh\profiles\web\package.json -> dependencies
"@dsh-external/dsh-browser": "link:D:/AI/Dsh/dsh-browser"

再在 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml 追加：

- insert:
    - id: dsh-browser
      name: "@dsh-external/dsh-browser"

然后 pnpm install，重启 dsh web。

本地 link 方式下，插件的运行依赖（schemastery、@deepseek-ai/dsh-tools 等）由插件目录内自带的 node_modules 链接解析（指向本机 dsh checkout 的 vendor / packages），因此不依赖 npm 注册表版本，最稳定。

方式二：GitHub 官方安装

dsh plugin add github:statem-li/dsh-browser

注意： 本插件面向 dsh 最新 harness（0.1.0-rc.x）开发，运行依赖为 scoped 包（@deepseek-ai/schemastery、@deepseek-ai/cordis、@deepseek-ai/dsh-tools 0.1.0-rc.x）。当前 npm 注册表上 @deepseek-ai/dsh-tools 仅发布到 0.0.1-rc.1，与最新 harness 版本存在差距——若官方安装后启动报 Cannot find package ... 之类的依赖解析错误，请改用方式一（或等 npm 版本跟进后重试）。

源码构建

DSH_CHECKOUT=D:/AI/deepseek-harness bash scripts/build.sh
# 产物：src/*.ts → lib/*.js（tsc）、src/client/* → lib/client.js（tsdown）

scripts/build.sh 会自动链接 checkout 内的 vendor/cordis、vendor/cosmokit、vendor/schemastery、@deepseek-ai/dsh-tools、@deepseek-ai/dsh-llm 等构建依赖；需本机存在对应 dsh 源码 checkout。

许可

BSD-3-Clause