前言¶
在 DSH 中使用 Agent 操作浏览器时，通常不只要能调用工具，还要明确哪些操作允许、哪些操作必须本地确认、凭据放在哪里。@puxora/dsh-browserpilot 是 BrowserPilot 的独立 DSH 双端插件：Host 端将 BrowserPilot MCP 工具提供给 Agent，Web 端提供专属设置入口、权限策略和管理面板按钮。
这是什么¶
它是 @puxora/dsh-browserpilot，由 Puxora 维护，许可证为 MIT。
它解决的是 DSH Agent 使用本机 Chrome 的接入问题：Host 端提供 MCP 工具，Web 端提供设置、权限策略和管理面板入口。
本插件不会把令牌、Cookie 或浏览器凭据保存到 DSH。
核心功能¶
- 本机 Chrome 控制：让 DSH Agent 通过 BrowserPilot 使用本机 Chrome。
- 分级权限：对浏览器操作进行分级限制；DSH 本地策略只能进一步限制，不能放宽 BrowserPilot 全局策略。
- 本地最终确认：保留本地最终确认环节。
- 连接诊断：调用
browserpilot_status查看连接状态。 - 管理面板入口：从 DSH 设置打开本地管理面板。
安装与启用¶
1、准备 BrowserPilot 本地桥接¶
先注册当前 Windows 用户的 Chrome Native Messaging Host：
browserpilot install
命令输出中会给出 chrome-extension 目录，下一步需要在 Chrome 中加载该目录。
在 Chrome 开发者模式下，加载 browserpilot install 输出的 chrome-extension 目录。
启动并查看状态：
browserpilot start
browserpilot status
2、安装 DSH 插件¶
执行：
dsh plugin --profile web add @puxora/dsh-browserpilot@latest
如果使用本地开发安装，命令中包含示例路径 G:/github/dsh-browserpilot，需要替换为本地仓库路径。
典型用法¶
1、打开设置 → BrowserPilot，确认启用浏览器工具已开启。
2、在 DSH 中调用 browserpilot_status。
3、状态为 connected 后，使用以 mcp__browserpilot__ 开头的浏览器工具。
设置与权限¶
- 本插件不会把令牌、Cookie 或浏览器凭据保存到 DSH。
- DSH 本地策略只能进一步限制，不能放宽 BrowserPilot 全局策略。
- 敏感操作在 DSH 内禁止，包括上传、下载、脚本、Cookie 与凭据相关操作。
- 插件每 3 秒同步一次全局值；daemon 不可用时，全局控件会变为只读。
- 连接握手默认超时为 12 秒，单次工具调用默认超时为 60 秒。
管理面板¶
设置页中的管理面板按钮会打开：
http://127.0.0.1:9876/
适用场景与注意¶
适合 DSH / 智能体开发者：需要在 DSH 中让 Agent 操作本机 Chrome，同时保留本地确认和敏感操作限制。
注意：该插件以当前 DSH 进程权限运行。安装前应检查源码与许可证。
源码仓库：https://github.com/Puxora/dsh-browserpilot。
许可证：MIT。
链接¶
GitHub：https://github.com/Puxora/dsh-browserpilot
