完整使用教程

1. 安装 BrowserPilot 并注册本地桥接

在 PowerShell 或终端中执行：

npm install -g @puxora/browserpilot
browserpilot install

browserpilot install 会注册当前 Windows 用户的 Chrome Native Messaging Host。请保存命令输出的 chrome-extension 目录路径，下一步需要选择该目录。

2. 安装 BrowserPilot Chrome 扩展

在 Chrome 打开 chrome://extensions；
开启右上角的 开发者模式；
点击 加载已解压的扩展程序；
选择上一步 browserpilot install 输出的 chrome-extension 目录；
将 BrowserPilot 扩展固定到工具栏并打开它，确认状态显示为已连接。

此步骤不可省略。DSH 插件只提供 MCP 接入与权限控制，真实 Chrome 标签页由 BrowserPilot 扩展连接和操作。

3. 启动并检查 BrowserPilot

browserpilot start
browserpilot status

默认管理后台为 http://127.0.0.1:9876/。首次在本机浏览器打开时会创建仅限 loopback 的认证 Cookie。

若需要查看实时日志，可使用：

browserpilot start --foreground

4. 安装 DSH 插件

正式安装（npm 发布后）

在可使用 dsh 命令的环境执行：

dsh plugin --profile web add @puxora/dsh-browserpilot@latest
dsh web

在 DeepSeek Harness 源码目录中运行时，请使用：

pnpm dsh plugin --profile web add @puxora/dsh-browserpilot@latest
pnpm dsh web

@latest 在 npm 公网发布后可用。发布前请采用下方的本地开发安装方式。

本地开发安装

pnpm dsh plugin --profile web add file:G:/github/dsh-browserpilot
pnpm dsh web

将示例路径替换为本地仓库路径。修改插件代码后，需要重新安装该 file: 依赖、重启 DSH 并刷新网页，才能加载新版本。

5. 在 DSH 中验证连接

打开 设置 → BrowserPilot；
确认 启用浏览器工具 已开启；
在聊天中调用 browserpilot_status；
当状态为 connected 时，即可使用以 mcp__browserpilot__ 开头的浏览器工具。

插件默认通过下列标准输入输出 MCP 命令连接 BrowserPilot：

npx -y @puxora/browserpilot mcp

6. 卸载 BrowserPilot 与 DSH 集成

DSH 插件通过 npx 启动 BrowserPilot MCP。若只卸载 BrowserPilot npm 包，DSH 插件会保留但显示为未连接；若只移除 DSH 插件，Chrome 的 Native Messaging 配置和桥接文件仍会保留。因此请按以下顺序清理：

停止 DSH，并通过当前安装环境的插件管理功能禁用或移除 @puxora/dsh-browserpilot；

在安装 BrowserPilot 的终端执行：

browserpilot uninstall
npm uninstall -g @puxora/browserpilot

在 Chrome 打开 chrome://extensions，手动移除 BrowserPilot 扩展。

browserpilot uninstall 会停止 daemon，并清理 BrowserPilot 创建的 Native Messaging manifest、Chrome 注册表项和桥接文件；它默认保留 ~/.browserpilot 下的配置、Token、任务和日志。仅在确认不再需要这些本地数据时，才执行 browserpilot uninstall --purge。

安装

说明文档