titanwings/dsh-better-browser
80最近提交 2026年8月13日
dsh-better-browser DSH 插件
dsh-better-browser 通过 Kimi WebBridge 本地守护进程，让 DSH Agent 使用用户已登录的真实浏览器。它提供 13 个工具，支持导航、点击、填写、截图和网络检查，同时保持浏览器状态留在本地。
如何安装 dsh-better-browser DSH 插件
dsh plugin --profile web add github:titanwings/dsh-better-browser#v0.3.6复制不会执行命令。安装 dsh-better-browser DSH 插件前请核对仓库和版本。
dsh-better-browser DSH 插件数据来源
dsh-better-browser DSH 插件快照日期：2026年8月16日
discovered
dsh-better-browser DSH 插件能做什么
- 导航到任意 URL，并为任务设置标签组。
- 读取页面无障碍树快照，获取元素引用。
- 按 @e 引用或 CSS 选择器点击元素。
- 填写 input、textarea 或 contenteditable 元素。
- 在页面中执行同步或异步 JavaScript。
- 截取页面或指定元素的截图。
- 列出当前会话的标签页。
- 启停并检查网络活动。
- 通过文件输入上传 Agent 工作区内的文件。
- 将当前页面保存为 PDF。
- 关闭当前标签页或整个会话的标签页。
dsh-better-browser DSH 插件适合哪些场景
- 在需要登录的网站上自动执行任务，例如检查 GitHub Issues。
- 执行多步骤工作流（导航→快照→点击→填写→截图），无需复制 Cookie。
- 检查网络请求和页面元素，同时保持浏览器状态不变。
- 让 Agent 使用真实浏览器的文件选择器上传文件到网页表单。
dsh-better-browser DSH 插件适合谁
- 希望 DSH Agent 与需要认证的 Web 服务交互的用户。
- 构建基于真实浏览器的自动化流程，复用现有标签页和会话的开发者。
dsh-better-browser DSH 插件的限制
- 严格检查 `event.isTrusted` 的网站可能会忽略合成点击/填写事件。
- 快照、点击、填写和评估仅作用于顶层 frame，不穿透跨域 iframe。
- 截图返回的是守护进程写入的临时文件路径，需要借助 Read 工具查看。
- 标签组由守护进程维护，重启守护进程会清空它们。
- 需要安装并运行 Kimi WebBridge 守护进程和浏览器扩展。
dsh-better-browser DSH 插件的仓库 README 摘录
以下文字摘自 dsh-better-browser DSH 插件的上游仓库 titanwings/dsh-better-browser 的 README，版权归原作者，仅作引用。
### *让 Agent 使用你已经登录的真实浏览器。* [](https://github.com/deepseek-ai) [](package.json) [](package.json) [](LICENSE) [](https://github.com/titanwings/dsh-better-browser/stargazers) <br> <table> <tr><td align="left"> 🔐 需要 Agent 操作已经登录的网站，又不想复制 Cookie 或重新登录？<br> 🧭 需要导航、点击、填写、截图和网络检查组成一条完整工作流？<br> 🧠 希望浏览器状态留在本机，而不是不断塞进模型上下文？ </td></tr> </table> ### ✨ dsh-better-browser 把用户真实浏览器变成 13 个 Agent 工具。 通过本机 Kimi WebBridge 复用登录态、已有标签页和活动会话；DSH 负责模型工具， 浏览器状态继续留在浏览器里。 **真实浏览器 + 本地桥接 + 13 个工具 → Agent 可执行的完整浏览器工作流** <br> [为什么需要它](#why) · [核心能力](#features) · [安装](#install) · [快速开始](#quick-start) · [工具](#tools) · [安全边界](#safety) [English](README.en.md) · **简体中文** <br>  </div> --- <a id="why"></a> ## 🎯 为什么需要 dsh-better-browser 无头浏览器适合隔离测试，却无法
阅读完整 README仓库许可: BSD-3-Clause
dsh-better-browser DSH 插件常见问题
如何安装 dsh-better-browser？
首先从官网安装 Kimi WebBridge 守护进程和浏览器扩展。然后运行 `dsh plugin --profile web add github:titanwings/dsh-better-browser#v0.3.6`，重启 `dsh web` 即可自动注册工具。
这个插件支持所有浏览器吗？
仅支持安装了 Kimi WebBridge 扩展的浏览器（Chrome 或 Edge）。插件通过本地守护进程与扩展通信，从而控制浏览器。
没有 Kimi WebBridge 能用这个插件吗？
不能。插件只作为桥接层，不包含任何浏览器自动化代码。你必须单独安装并运行 Kimi WebBridge 守护进程和扩展。
如何从旧版本升级？
如果之前安装了旧包 `@dsh-external/dsh-better-browser`，先运行 `dsh plugin --profile web remove @dsh-external/dsh-better-browser` 移除，再按安装说明添加新包。
Agent 会关闭我的浏览器标签页吗？
不会。只有在用户明确通过 `close_tab` 或 `close_session` 工具要求时，才会关闭标签页。任务结束后不会自动清理标签页。