🎯 为什么需要 dsh-better-browser

无头浏览器适合隔离测试，却无法自然复用你正在使用的登录态、Cookie、标签页和 站点会话。dsh-better-browser 连接 Kimi WebBridge 的本地守护进程，让 DSH 中的 Agent 操作用户自己的浏览器。

本插件不包含浏览器驱动代码。真正的浏览器操作由 Kimi WebBridge 守护进程和 浏览器扩展完成；本插件只把它的本地协议适配为 DSH 模型工具。

✨ 核心能力

🌍 操作用户真实浏览器

导航页面、读取无障碍快照、点击、填写与执行 JavaScript，同时保留登录状态和 已经打开的标签页。

🔎 看见页面之外的证据

Agent 可以截图、检查网络活动、上传文件并保存 PDF，不必把整个浏览器状态放进 模型请求。

🗂️ 一个任务，一个标签组

稳定的 session 名把同一任务的标签页归到一起。不同任务互不混用，用户仍然 可以在自己的浏览器中看见并接管全过程。

🔌 零 DSH Core Patch

插件作为 Cordis bundle 安装，注册稳定的 webbridge 行与 13 个 webbridge_* 工具；卸载 bundle 即可移除能力。

⚡ 安装

1. 安装 Kimi WebBridge

Kimi WebBridge 是月之暗面的独立产品，本仓库不包含它的守护进程或浏览器扩展。 请先参考 Kimi 官方产品页与 帮助中心：

curl -fsSL https://cdn.kimi.com/webbridge/install.sh | bash
kimi-webbridge status   # 期望看到 "extension_connected": true

同时需要从官方商店安装 Kimi WebBridge 扩展：

• Google Chrome
• Microsoft Edge

安装并启用扩展后保持浏览器运行，再执行 kimi-webbridge status。只有 "extension_connected": true 才表示浏览器、守护进程和本插件的完整链路已就绪。

2. 安装 DSH 插件

dsh plugin --profile web add github:titanwings/dsh-better-browser#v0.3.6

重启 dsh web 并刷新页面。模型随后即可看到 webbridge_* 工具。守护进程未 运行时，工具会返回 daemon_unreachable，不会静默降级。

🚀 快速开始

安装完成后，可以直接让 Agent：

使用我的真实浏览器打开 GitHub，找到当前仓库的 Issues，检查最新三个问题， 不要关闭我已有的标签页。

Agent 会为任务选择稳定的 session，依次导航、读取页面并执行交互。浏览器动作 采用排他调度，不会并行修改共享标签页。

navigate → snapshot → click/fill → snapshot → screenshot/network

标签页只会在用户明确要求时关闭；任务结束不会自动清理用户浏览器。

🧰 13 个浏览器工具

🛡️ 会话与安全边界

• 一个任务 = 一个 session = 一个标签组。 每次调用保持相同 session 名。
• 关闭由用户发起。 只有用户明确要求时才关闭标签页或整个 session。
• 浏览器动作串行执行。 所有工具声明 isConcurrencySafe=false，避免共享 标签页发生交错修改。
• 主机路径限制在授权范围内。 上传文件必须在调用 Agent 的工作区内；插件会 解析规范路径并拒绝符号链接逃逸。截图和 PDF 路径只接受 WebBridge 专用临时目录。
• 导航只允许 Web Origin。 navigate 与 find_tab 仅接受绝对 http/https URL，拒绝本地文件与脚本协议。
• 本地优先不等于零风险。 Agent 操作的是真实登录会话；发送消息、提交表单、 发布内容等动作仍应遵守 DSH 的确认与权限策略。
• 模型能看到下一步所需证据。 snapshot 无障碍树、标签页、network detail 以及截图/PDF 路径会随 summary 一起进入工具结果；单次模型可见内容最多 32,000 字符，超出时会明确标记截断。

🔧 技术细节

- id: webbridge
  config:
    baseUrl: http://127.0.0.1:10086
    timeoutMs: 30000

dsh plugin --profile web remove @dsh-external/dsh-kimi-browser
dsh plugin --profile web add github:titanwings/dsh-better-browser#v0.3.6

pnpm link:dsh -- /path/to/dsh
pnpm typecheck
pnpm test
pnpm build
pnpm check

📄 License 与 WebBridge 边界

本插件使用 BSD-3-Clause，见 LICENSE。它只兼容 Kimi WebBridge 协议，不包含 Kimi 的守护进程、扩展或代码。Kimi WebBridge 是月之暗面的产品 与商标，需根据 Kimi 自身条款另行安装和使用。