云浏览器工具 lexmount/dsh-browser

@lexmount/dsh-browser

Lexmount 云浏览器工具，用于 DeepSeek Harness。这个包是轻量级 DSH Bundle：它注册原生模型工具，并调用 Rust 版 browser-cli，但本身不含原生可执行文件，不运行 MCP 服务器，也不依赖 Lexmount Node.js SDK。

状态：Windows x64、macOS Apple Silicon、Linux x64 原生验证已完成。当前稳定 Bundle 版本为 0.1.1。

当前平台支持： Windows x64、macOS Apple Silicon、Linux x64。macOS Intel 和 Linux ARM64 暂不支持。

运行时架构

DSH Web / Headless
→ @lexmount/dsh-browser (Bundle and Node adapter only)
→ pinned browser-cli download and user cache
→ browser-cli child process
→ Lexmount API / CDP / cloud browser

Bundle 注册工具时不访问网络。首次调用工具时，它会选择当前 OS/CPU 对应的资产，从 Lexmount 带版本号的腾讯 COS 路径下载固定版本的 browser-cli 发行包和 SHA256SUMS，校验摘要、可执行文件格式/架构和 CLI 版本，然后原子化安装到用户缓存。之后的调用和重启都会复用已校验的缓存，因此缓存已填充时也能离线工作。

npm tarball 不含 browser-cli 或 browser-cli.exe 文件。终端用户不需要 Rust、Python、浏览器驱动，也不需要 npm 生命周期脚本。

平台状态

| 主机 | 发行资产 target | 当前状态 |
| Windows x64 | x86_64-pc-windows-msvc | 支持 |
| macOS Apple Silicon | aarch64-apple-darwin | 支持 |
| Linux x64 | x86_64-unknown-linux-musl | 支持 |
| macOS Intel | x86_64-apple-darwin | 暂不支持；资产缺失 |
| Linux ARM64 | — | 暂不支持；资产缺失 |

native-source.json 将 browser-cli v1.1.15 固定在 commit 952a5e53ff9dd3980342d4dae7f860f80b39a100。Windows 资产静态链接 C 运行时，Linux x64 资产是静态 musl 可执行文件。这个 Bundle 使用该不可变发行版发布的三个资产。新增平台需要新的 browser-cli 版本和新的 npm 包版本，并重新验证；不会就地改动本次发行。

安装

当前发行版要求 Node.js >=22.14.0、DSH 0.1.0-rc.6，以及 PATH 上有 pnpm 可执行文件。下面的命令使用 npx，因此不需要全局安装 DSH。命令固定了 Bundle 版本，这样 DSH 的依赖发布年龄策略就不会把请求解析到更旧的发行版。

Windows x64

在应作为 DSH 工作区的目录中打开普通（非管理员）PowerShell，然后运行：

node --version
corepack --version
corepack install --global pnpm@11.22.0
corepack enable pnpm
pnpm --version

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add @lexmount/dsh-browser@0.1.1
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web
如果 corepack enable pnpm 在 C:\Program Files\nodejs 下报权限错误，用管理员 PowerShell 只跑一次 Corepack 的安装命令，然后关掉它，用普通用户身份运行 DSH 本身。如果端口 3080 已被占用，让 DSH 在系统分配的空闲端口上启动，并打开它打印的 URL：

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web --port 0

macOS Apple Silicon

本版本只支持 Apple Silicon。先确认机器报告的是 arm64；x86_64 说明是 Intel Mac，目前不支持。在 Terminal 里切换到要作为 DSH 工作区的目录，然后运行：

uname -m
node --version
corepack --version
corepack install --global pnpm@11.22.0
corepack enable pnpm
pnpm --version

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add @lexmount/dsh-browser@0.1.1
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web

如果端口 3080 已被占用，改用系统分配的空闲端口，并打开打印出来的 URL：

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web --port 0

Linux x64

先确认机器报告的是 x86_64，然后运行：

uname -m
node --version
corepack --version
corepack install --global pnpm@11.22.0
corepack enable pnpm
pnpm --version

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add @lexmount/dsh-browser@0.1.1
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web

如果端口 3080 已被占用，改用系统分配的空闲端口，并打开打印出来的 URL：

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web --port 0

DSH RC.6 把插件安装交给 PATH 上的 pnpm 可执行文件，自身并不打包这个可执行文件。如果 Corepack 建不出 shim，就用常规的 Node 包管理器方式安装 pnpm，并先确认 pnpm --version 能跑通。

如果安装或更新 Bundle 时 DSH 已经在运行，先停掉再重启，然后再测试。安装包不会把新 Bundle 热加载进已有的 Web 进程。

无人值守场景下，把同一个 Bundle 装进 Headless 配置档：

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile headless add @lexmount/dsh-browser@0.1.1

支持的 Harness 版本范围是 >=0.1.0-rc.6 <0.2.0。DSH 仍是 release candidate，所以每次升级 DSH 都要做安装和工具注册的回归测试。

首次使用与缓存

1. 运行 lexmount_doctor。第一次调用可能会下载当前平台的可执行文件。
2. 如果缺少凭证，在交互式 Web 配置档里运行 lexmount_auth_login，并在系统浏览器里批准访问。
3. 建一个临时会话；如果登录状态需要复用，就选择或新建一个持久上下文。
4. 导航，用 lexmount_browser_snapshot 检查，然后用带类型的 wait/click/fill 工具。
5. 用完关掉临时会话。

默认缓存位置如下：

| 平台 | 缓存根目录 |
| Windows | %LOCALAPPDATA%\Lexmount\dsh-browser |
| macOS | ~/Library/Caches/Lexmount/dsh-browser |
| Linux | $XDG_CACHE_HOME/lexmount/dsh-browser 或 ~/.cache/lexmount/dsh-browser |

设置 LEXMOUNT_BROWSER_CLI_CACHE_DIR 可以换一个缓存根目录。LEXMOUNT_BROWSER_CLI_PATH 是管理员/开发者显式指定的覆盖项，用于指向预装的 CLI；这个路径仍会检查格式和版本，但它的可信度由设置该环境变量的人负责。

登录流程把凭据存放在现有的 browser-cli 位置，绝不会要求用户把 API key 粘贴到聊天里。无头运行必须提前完成认证，因为 PKCE 流程需要一个可交互的系统浏览器。

工具面

Bundle 注册 31 个原生工具：

- 诊断与认证：version、doctor、auth status/login/logout；
- 会话：create/get/list/close/keepalive/targets；
- 下载：list/get/archive/delete；
- 上下文：create/get/list/fork/delete/force-release；
- 浏览器操作：open URL、wait selector/text、click、fill、snapshot、screenshot、PDF；
- 逃生通道：任意页面 JavaScript 与原始 CDP。

截图结果通过 DSH 图片附件服务持久化。PDF 和下载工具写入请求的主机路径并返回该路径，因为 DSH 0.1.0-rc.6 没有通用的二进制附件内容块。

安全与行为

- 下载使用固定的 HTTPS 源和版本路径。执行前会校验对应的 SHA256SUMS 条目、可执行文件格式、平台架构、预期 CLI 版本和缓存元数据。
- 首次调用被取消时，如果没有其他调用在等待，就取消它的下载。插件销毁会取消下载并终止自己拥有的子进程。
- 模型输入以子进程参数数组传入，配合 shell: false；绝不拼接进 shell 命令。
- 返回数据和诊断信息中会移除 API key、Authorization 字段、ws 以及 Chrome DevTools WebSocket URL。
- 工具指引会告诉模型：购买、发布、破坏性远程操作以及账号/安全变更之前，先取得用户确认。
- JavaScript 求值和原始 CDP 对模型保持可见，供高级浏览器自动化使用。

DSH RC.6 不会在原生工具上暴露 MCP 风格的副作用注解。UI 展示分类不等于权限约束。

browser-cli 已知限制

首个版本有意保留 browser-cli 的现有行为：

- URL、表单值、JavaScript、元数据和原始 CDP 参数在本地进程 argv 中可见；
- 每个操作独立连接，并选择第一个页面目标；
- 普通交互仅限于 wait、click 和 fill；没有 ACE、hover、press、select、check、drag 或文件上传；
- CDP 命令没有完整的内部超时，也没有重连/重放行为；
- snapshot 返回完整页面文本和 HTML；
- 凭据写入和 Windows ACL 行为保持不变；
- 首个版本中 Windows 二进制文件没有 Authenticode 签名；
- 输出路径不受额外的插件沙箱限制。

开发

npm install
npm run check
npm run package:verify

在当前受支持的宿主机上，测试本地构建的 v1.1.15 命令行，无需改动包：

LEXMOUNT_BROWSER_CLI_PATH=/absolute/path/to/browser-cli npm run test:native

先校验固定版本的远程资源，再在 Windows x64、macOS Apple Silicon 或 Linux x64 上跑真实的当前平台集成测试：

npm run native:assets
npm run test:native

browser-cli-rs 仓库负责原生构建、macOS 签名与公证、校验和以及 COS 发布。本仓库只校验这些不可变输入，并发布轻量的 npm 包装层。