bill9109/dsh-webbridge

Plugin插件 Native原生 ⭐ 3 BSD-3-Clause Notifications & Remote通知与远程

DSH结合Kimi WebBridge

Project Overview项目介绍

dsh-webbridge is a native plugin built specifically for DeepSeek Harness (DSH) that acts as an adapter for the Kimi WebBridge local daemon. It exposes 11 model-facing tools prefixed with webbridge_ that let the DSH-hosted model control the user’s existing local browser, rather than spinning up a separate headless browser that has no access to existing user session data. To install the plugin directly from the GitHub repository, run the official DSH command dsh plugin --profile web add github:omdsh-dev/dsh-webbridge in your terminal.

This plugin is designed for DSH users who need their model to interact with websites that require existing user authentication or session data. The standard workflow starts with the model calling webbridge_navigate to open a target URL, assign a session name that groups all tabs for the current task, and set a human-readable label for the tab group. After that, the model uses the other 10 tools to navigate, interact with, and inspect the page, closing the entire tab group only when the user explicitly requests it. All browser state stays local on the user’s machine and is never sent to the model provider.

The plugin itself does not include any browser-driving code, so you must install the Kimi WebBridge daemon and browser extension separately from Moonshot AI to use it. Known limitations include incompatibility with sites that enforce trusted input checks, like some banking portals and captcha pages, and no support for interacting with elements inside cross-origin iframes. The plugin is released under the open-source BSD-3-Clause license, and Kimi WebBridge is subject to Moonshot AI’s separate terms of service.

dsh-webbridge 是一款专为 DeepSeek Harness 开发的原生插件,作用是将 Kimi WebBridge 的本地能力对接进 DSH。它提供了 11 个以 webbridge_ 为前缀的模型工具,让大模型可以直接操控用户本地正在使用的真实浏览器,保留原有的登录态、Cookie 和已打开的标签页信息,不需要使用无状态的无头浏览器。你可以通过 DSH 内置命令 dsh plugin --profile web add github:omdsh-dev/dsh-webbridge 完成安装。

这款插件适合需要让大模型操作有用户登录态的网站的 DSH 用户。典型工作流是:大模型先调用 webbridge_navigate 打开目标网址,指定本次任务的会话名和标签组名称,之后通过 find_tab、snapshot、click、fill 等工具操作页面,完成任务后根据用户要求调用 webbridge_close_session 关闭本次会话的所有标签。整个过程中浏览器状态都保留在用户本地,不会上传到大模型服务端。

本插件本身不包含浏览器驱动代码,必须单独安装 Kimi WebBridge 守护程序和浏览器扩展才能使用。目前已知的限制包括:部分严格检查可信输入的网站(如部分银行门户网站、验证码页面)不支持合成点击/输入,仅支持顶级框架操作,不支持跨源 iframe。插件采用 BSD-3-Clause 许可证开源,本身免费使用,Kimi WebBridge 需要遵循 Moonshot AI 的使用条款。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:omdsh-dev/dsh-webbridge

把 bill9109/dsh-webbridge 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-webbridge — Model tools that drive your REAL browser via Kimi WebBridge

Release v0.0.3 License: BSD-3-Clause Node.js DSH profiles

Install: dsh plugin --profile web add github:omdsh-dev/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 | 中文

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 / close_tab / close_session
  • One task = one tab group: a session name groups tabs, keeping tasks cleanly isolated
  • Local-first: the daemon runs on your machine; browser state never leaves it
  • No KV-cache burden: browser state lives outside the model request

Usage

Prerequisites (required!)

This plugin is an adapter — without the pieces below, browser control does not work. You must install Kimi WebBridge separately (an independent product by Moonshot AI; this plugin contains none of its code). Full install and browser-extension setup instructions live on Kimi's official pages: feature page / help center. In short:

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dock-git 下一个 Next dsh-find-skill →