跳到正文

bill9109/dsh-webbridge

30最近提交 2026年8月14日

dsh-webbridge DSH 插件

dsh-webbridge 是一个适配器插件,将 Kimi WebBridge 本地守护进程暴露为 DeepSeek Harness 中模型可用的工具。它使模型能够操作你的真实浏览器,保留会话和打开的标签页,而非无头浏览器。插件本身不包含浏览器驱动代码,依赖单独安装的 Kimi WebBridge 守护进程和浏览器扩展。

如何安装 dsh-webbridge DSH 插件

dsh plugin --profile web add github:bill9109/dsh-webbridge

复制不会执行命令。安装 dsh-webbridge DSH 插件前请核对仓库和版本。

dsh-webbridge DSH 插件数据来源

dsh-webbridge DSH 插件快照日期:2026年8月16日

discovered

dsh-webbridge DSH 插件能做什么

  • 提供 11 个工具:navigate、find_tab、snapshot、click、fill、evaluate、screenshot、list_tabs、network、close_tab、close_session
  • 每个任务使用一个 session 名称来分组标签页,保持任务隔离
  • 操作真实浏览器,保留登录状态、Cookie 和实时会话
  • 本地优先:守护进程运行在你的机器上,浏览器状态不会离开本地
  • 无 KV 缓存负担:浏览器状态存在于模型请求之外

dsh-webbridge DSH 插件适合哪些场景

  • 在需要用户登录会话的网站上填写并提交表单
  • 导航到特定页面,通过 snapshot 读取内容并执行操作
  • 截取页面或元素的截图供模型分析
  • 检查页面的网络活动以调试或提取数据
  • 在任务内管理多个标签页,并在用户要求时关闭它们

dsh-webbridge DSH 插件适合谁

  • 希望让 DSH 模型访问真实浏览器环境的开发者
  • 需要自动化依赖于现有会话和 Cookie 的网页任务的用户

dsh-webbridge DSH 插件的限制

  • 需要单独安装 Kimi WebBridge 守护进程和浏览器扩展
  • 严格检查 event.isTrusted 的网站(如银行门户、验证码)可能忽略点击和填充操作
  • 不支持跨域 iframe——工具仅操作顶层框架
  • 截图返回的是文件路径而非图像,模型需使用 Read 工具查看
  • 重启 Kimi WebBridge 守护进程会清除所有标签组和会话

dsh-webbridge DSH 插件的仓库 README 摘录

以下文字摘自 dsh-webbridge DSH 插件的上游仓库 bill9109/dsh-webbridge 的 README,版权归原作者,仅作引用。

**Install:** `dsh plugin --profile web add github:bill9109/dsh-webbridge` **A DeepSeek Harness host plugin: it bridges Kimi WebBridge's local daemon into eleven `webbridge_*` model tools, so the model operates **your own browser** — logins, cookies, and already-open tabs included — instead of a headless one.** [English](README.md) | [中文](README.zh.md) ## Why this exists When a model task has to touch a real website — a page behind your login, carrying your session and your already-open tabs — a headless browser cannot help: it holds none of your state and would ask you to authenticate all over again. `dsh-webbridge` exists to hand the model control of **your real browser** while keeping that browser state strictly on your machine, never inside a model request. It ships **no browser-driving code of its own**: the actual work is done by the Kimi WebBridge daemon and browser extension. This plugin only translates that capability into model-facing tools on the DSH side. ## Features - **Real browser, not headless**: logins, cookies, and live sessions preserved - **Eleven model tools**: navigate / find_tab / snapshot / click / fill / evaluate / screenshot / list_tabs / network /

阅读完整 README仓库许可: BSD-3-Clause

dsh-webbridge DSH 插件常见问题

如何安装 dsh-webbridge?

在终端中运行 `dsh plugin --profile web add github:bill9109/dsh-webbridge`。这会将插件安装到 `web` 配置文件中。你还需要单独安装 Kimi WebBridge 守护进程和浏览器扩展,否则工具会返回 `daemon_unreachable` 错误。

dsh-webbridge 提供哪些工具?

它提供 11 个工具:webbridge_navigate、webbridge_find_tab、webbridge_snapshot、webbridge_click、webbridge_fill、webbridge_evaluate、webbridge_screenshot、webbridge_list_tabs、webbridge_network、webbridge_close_tab 和 webbridge_close_session。这些工具让模型以会话方式控制你的真实浏览器。

能否不使用 Kimi WebBridge 守护进程直接运行 dsh-webbridge?

不能。该插件是适配器,需要 Kimi WebBridge 守护进程和浏览器扩展已安装并运行。如果守护进程未运行,所有工具调用都会返回 `daemon_unreachable` 错误。你可以通过 `~/.kimi-webbridge/bin/kimi-webbridge start` 启动守护进程。

为什么有些网站上的点击或填充操作无效?

某些网站会严格检查 `event.isTrusted` 属性来区分合成事件和真实用户操作。在这些网站上(如银行门户、验证码),守护进程的合成事件可能被忽略。目前尚未将守护进程的 CDP 逃生口暴露为工具。

如何查看模型截取的屏幕截图?

截图工具返回的是本地文件路径,而非图像本身。模型需要使用读取工具(如 `read_file` 或类似工具)来查看该路径下的图像。守护进程将截图写入临时目录。