deepseekplugins

DeepSeek Harness 插件

dsh-better-browser

Better Browser for DeepSeek Harness: drive the user's real browser through Kimi WebBridge with navigation, snapshots, interaction, screenshots, network inspection, and tab management（英文原文）

工具与能力
跳到安装方式

来源信息

GitHub 仓库
titanwings/dsh-better-browser
最近更新
2026年8月13日
分类
工具与能力
GitHub stars
10
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/titanwings/dsh-better-browser
插件名：dsh-better-browser
作者：titanwings

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.md来源说明 · 只读预览
README 语言

<div align="center">

🌐 dsh-better-browser

让 Agent 使用你已经登录的真实浏览器。

![DeepSeek Harness](https://github.com/deepseek-ai) ![Version](package.json) ![Node.js](package.json) ![License](LICENSE) ![GitHub stars](https://github.com/titanwings/dsh-better-browser/stargazers)

<br>

<table> <tr><td align="left">

🔐 &nbsp;需要 Agent 操作已经登录的网站，又不想复制 Cookie 或重新登录？<br> 🧭 &nbsp;需要导航、点击、填写、截图和网络检查组成一条完整工作流？<br> 🧠 &nbsp;希望浏览器状态留在本机，而不是不断塞进模型上下文？

</td></tr> </table>

✨ dsh-better-browser 把用户真实浏览器变成 13 个 Agent 工具。

通过本机 Kimi WebBridge 复用登录态、已有标签页和活动会话；DSH 负责模型工具， 浏览器状态继续留在浏览器里。

真实浏览器 + 本地桥接 + 13 个工具 → Agent 可执行的完整浏览器工作流

<br>

[为什么需要它](#why) · [核心能力](#features) · [安装](#install) · [快速开始](#quick-start) · [工具](#tools) · [安全边界](#safety)

English · 简体中文

<br>

![dsh-better-browser：让 Agent 使用真实浏览器](docs/social-preview.png)

</div>

---

<a id="why"></a>

🎯 为什么需要 dsh-better-browser

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

无头浏览器dsh-better-browser
登录态通常需要重新登录或注入凭据复用用户浏览器现有状态
标签页工具独立维护使用真实标签页与标签组
浏览器状态容易进入工具输出或模型上下文保留在浏览器与本地守护进程
适合场景隔离测试、抓取登录后工作流、真实页面检查

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

---

<a id="features"></a>

✨ 核心能力

🌍 操作用户真实浏览器

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

🔎 看见页面之外的证据

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

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

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

🔌 零 DSH Core Patch

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

---

<a id="install"></a>

⚡ 安装

1. 安装 Kimi WebBridge

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

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

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

安装并启用扩展后保持浏览器运行，再执行 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，不会静默降级。

---

<a id="quick-start"></a>

🚀 快速开始

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

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

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

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

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

---

<a id="tools"></a>

🧰 13 个浏览器工具

工具用途
webbridge_navigate打开 URL，并为任务设置标签组标题
webbridge_find_tab重新选择任务标签页或借用当前活动标签
webbridge_snapshot读取页面无障碍树与 @e 元素引用
webbridge_click按 @e 引用或 CSS selector 点击
webbridge_fill填写 input、textarea 或 contenteditable
webbridge_evaluate在页面中运行同步或异步 JavaScript
webbridge_screenshot截取页面或指定元素并返回文件路径
webbridge_list_tabs列出当前 session 的标签页
webbridge_network启停并检查网络活动
webbridge_upload通过文件输入上传调用 Agent 工作区内的文件
webbridge_save_as_pdf将当前页面保存为 PDF
webbridge_close_tab关闭 session 的当前标签页
webbridge_close_session关闭 session 的全部标签页

---

<a id="safety"></a>

🛡️ 会话与安全边界

  • 一个任务 = 一个 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 字符，超出时会明确标记截断。

---

🔧 技术细节

<details> <summary><strong>配置</strong></summary>

<br>

字段默认值含义
baseUrlhttp://127.0.0.1:10086守护进程的 http/https 地址
timeoutMs30000单次工具调用超时预算（毫秒）
- id: webbridge
  config:
    baseUrl: http://127.0.0.1:10086
    timeoutMs: 30000

非法 URL 或非正整数超时会在插件挂载时响亮失败。

</details>

<details> <summary><strong>从旧名称升级</strong></summary>

<br>

已经安装旧包的 profile 需要先移除，再安装新版本：

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

@dsh-external/dsh-better-browser 包身份、webbridge 行 id、全部工具名和配置字段 保持稳定。GitHub 仓库归属变化不会改变 Cordis bundle 身份。

</details>

<details> <summary><strong>当前限制</strong></summary>

<br>

  • 严格检查 event.isTrusted 的站点可能忽略合成 click/fill。
  • snapshot、click、fill 与 evaluate 只作用于顶层 frame，不穿透跨域 iframe。
  • screenshot 返回守护进程写入的临时文件路径，需要 Read 工具查看。
  • 标签组由守护进程维护；重启守护进程会清空它们。

</details>

<details> <summary><strong>开发与测试</strong></summary>

<br>

DSH 官方包尚未发布到公共 npm，开发工具链需要一个 DSH 源码 checkout：

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

测试覆盖守护进程客户端、13 个工具、Cordis 生命周期、配置校验和 Loader 冒烟。 设置 KIMI_WEBBRIDGE_IT=1 可对真实守护进程运行集成测试。

</details>

---

📄 License 与 WebBridge 边界

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

返回搜索打开 GitHub 仓库

更多相关插件

查看分类