@puxora/dsh-browserpilot
BrowserPilot 的 DeepSeek Harness 桥接和设置页面。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @puxora/dsh-browserpilot@0.1.6Browserpilot 以 @puxora/dsh-browserpilot 发布，当前版本为 0.1.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English · BrowserPilot · DeepSeek Harness
在 DeepSeek Harness（DSH）中安全地使用本机 Chrome，并将最终网页确认保留在 BrowserPilot 浏览器扩展中。
@puxora/dsh-browserpilot 是 BrowserPilot 的独立 DSH 双端插件。Host 端将 BrowserPilot MCP 工具提供给 Agent；Web 端提供专属设置入口、权限策略和管理面板按钮。
| 能力 | 说明 |
|---|---|
| 本机 Chrome 控制 | 让 DSH Agent 通过 BrowserPilot 操作用户本机 Chrome。 |
| 分级权限 | 分别管控只读、网页交互和敏感操作。 |
| 本地最终确认 | 需确认的网页操作仍由 BrowserPilot Chrome 扩展完成。 |
| 连接诊断 | 使用 browserpilot_status 查询 MCP 状态与已注册工具数量。 |
| 管理面板入口 | 从 DSH 设置直接打开 BrowserPilot 本地后台。 |
BrowserPilot 负责浏览器连接、标签页占用、令牌与网页确认。本插件不会把令牌、Cookie 或浏览器凭据保存到 DSH。
在 PowerShell 或终端中执行：
npm install -g @puxora/browserpilot
browserpilot install
browserpilot install 会注册当前 Windows 用户的 Chrome Native Messaging Host。请保存命令输出的 chrome-extension 目录路径，下一步需要选择该目录。
chrome://extensions；browserpilot install 输出的 chrome-extension 目录；此步骤不可省略。DSH 插件只提供 MCP 接入与权限控制，真实 Chrome 标签页由 BrowserPilot 扩展连接和操作。
browserpilot start
browserpilot status
默认管理后台为 http://127.0.0.1:9876/。首次在本机浏览器打开时会创建仅限 loopback 的认证 Cookie。
若需要查看实时日志，可使用：
browserpilot start --foreground
在可使用 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 并刷新网页，才能加载新版本。
browserpilot_status；connected 时，即可使用以 mcp__browserpilot__ 开头的浏览器工具。插件默认通过下列标准输入输出 MCP 命令连接 BrowserPilot：
npx -y @puxora/browserpilot mcp
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。
在 设置 → BrowserPilot 中可以编辑 BrowserPilot 的真实全局安全策略。这些值通过 DSH Host 端使用本机 API Token 读写，与 BrowserPilot 管理后台共用 ~/.browserpilot/settings.json，会影响 Codex、DSH 以及其他 BrowserPilot 客户端：
| 全局策略 | 默认值 | 作用范围 |
|---|---|---|
| 自动化写操作 | 每次询问审批 | 点击、输入、关闭标签页和页面脚本等写操作。 |
| 页面 JavaScript | 关闭 | 是否允许 Agent 在网页上下文执行 JavaScript。 |
| 文件下载 | 每次询问 | BrowserPilot 已接管标签页触发的下载。 |
| 文件上传 | 每次询问 | 是否允许打开网页文件选择器。 |
特定域名例外规则仍在 BrowserPilot 管理后台维护，DSH 更新上述字段时不会覆盖这些规则。全局策略由 daemon 最终执行；DSH 页面不会接触 API Token。
DSH 另外保留一层只对当前 DSH 生效的限制：
| DSH 本地策略 | 默认值 | 作用范围 |
|---|---|---|
| 启用浏览器工具 | 开启 | 关闭后，DSH 不会调用任何 BrowserPilot 工具。 |
| 只读操作 | 遵循全局策略 | 可设置为“DSH 内禁止”。 |
| 网页交互 | 遵循全局策略 | 可设置为“DSH 内禁止”。 |
| 敏感操作 | DSH 内禁止 | 上传、下载、脚本、Cookie 与凭据相关操作。 |
DSH 本地策略只能进一步限制，不能放宽 BrowserPilot 全局策略。插件每 3 秒同步一次全局值；daemon 不可用时，全局控件会变为只读。
设置页底部的 打开管理面板 会在新标签页打开：
http://127.0.0.1:9876/
该面板属于 BrowserPilot，可查看连接、任务、日志、审批和浏览器策略。无法访问时，请确认 BrowserPilot daemon 正在运行，且未更改默认端口。
DSH Agent
│
├── BrowserPilot DSH Host 插件 ── stdio MCP ── BrowserPilot daemon
│ │
│ └── Chrome 扩展 ── Chrome 标签页
│
└── BrowserPilot DSH Web 设置页 ── DSH settings scope ── Host 全局策略同步
DSH 加载时，插件立即注册设置页与 browserpilot_status；随后在后台启动 MCP、握手、读取工具列表，并通过 BrowserPilot 的认证设置接口同步全局策略。因此 DSH Web 不会等待 npx、daemon 启动或 MCP 握手完成才开始监听。连接握手默认超时为 12 秒，单次工具调用默认超时为 60 秒。
先调用 browserpilot_status。若状态不是 connected，请检查：BrowserPilot 是否已安装、Chrome 扩展是否显示已连接，以及下列命令能否在本机运行：
npx -y @puxora/browserpilot mcp
检查 http://127.0.0.1:9876/ 是否可访问。daemon 未启动或使用了自定义端口时，面板不会显示。
本地 file: 依赖可能被包管理器缓存。重新安装 profile 依赖，重启 dsh web，再刷新浏览器。
npm install
npm run check
npm test
测试覆盖后台连接延迟、连接超时、设置规范化、权限拦截、工具注册和状态输出。
npm 包发布后，用户可使用 dsh plugin --profile web add @puxora/dsh-browserpilot@latest 安装。发布前请确认版本号、npm scope 权限、DSH 兼容性和 BrowserPilot 的端到端联调结果。
本项目采用 MIT License。