返回目录

dsh-webbridge

精选清单收录维护状态: 活跃

bill9109/dsh-webbridge

DSH 结合 Kimi WebBridge

前往 GitHub
$ dsh plugin add dsh-webbridge

安装

dsh 没有统一的安装命令——把该插件 README 中的配置行加入你的 profile/patch 配置,然后重启即可。

了解安装方式

3

星标

0

Fork

JavaScript

语言

BSD-3-Clause

许可证

2026-08-09

创建于

2026-08-26

最近推送

README

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:

# 1. Install the daemon:
curl -fsSL https://cdn.kimi.com/webbridge/install.sh | bash

# 2. Install the Kimi WebBridge browser extension and let it connect to the
#    daemon (search "Kimi WebBridge" in the Chrome Web Store), then check:
kimi-webbridge status   # expect "extension_connected": true

If the daemon is not running, tools fail loud with a daemon_unreachable error that tells you to run ~/.kimi-webbridge/bin/kimi-webbridge start.

Model experience

Tool Purpose
webbridge_navigate Open a URL (new tab or current), set the tab group label
webbridge_find_tab Re-select a tab this task opened, or borrow the user's active tab
webbridge_snapshot Read the page's accessibility tree (text + @e refs)
webbridge_click Click an element by @e ref or CSS selector
webbridge_fill Type into inputs / textareas / contenteditable editors
webbridge_evaluate Run JS in the page (async supported)
webbridge_screenshot Capture the page or one element to a file path
webbridge_list_tabs List the tabs opened in the session
webbridge_network Inspect network activity (start/stop/list/detail)
webbridge_close_tab Close the current tab of the session
webbridge_close_session Close ALL tabs of the session (clears the tab group)

Session and closing rules (model contract)

These rules come from the upstream Kimi WebBridge skill and are part of the model contract:

  • One task = one session = one tab group. Pick a session name at the task's start and keep it on EVERY call — never switch mid-task.
  • Name it after the task, not the site (camping-research, not kimi.com).
  • group_title is the human-readable group label, set on the FIRST navigate of the task, written in the user's language.
  • Closing is always user-initiated. Call webbridge_close_session ONLY when the user explicitly asks to close/clear the tabs; never close tabs automatically at the end of a task.

Configuration

The daemon address defaults to http://127.0.0.1:10086. The plugin accepts no configuration today; the baseUrl seam exists for tests.

Install

The plugin is a DSH bundle (package.json declares dsh.bundle, and cordis.patch.yml carries the patch). Install it into the web profile with the standard dsh plugin mechanism — no DSH source changes and no hand-written patch:

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

For a stable install, pin the version: dsh plugin --profile web add github:omdsh-dev/dsh-webbridge#v0.0.3.

Internally the command runs pnpm add <spec> in the profile directory and automatically appends packages that declare dsh.bundle to dsh.profile.bundles. You can also clone it and install from a local path (for development):

dsh plugin --profile web add /path/to/dsh-webbridge

The repository ships its build output (lib/), so the plugin works right after installing — no build step needed. After installing, restart the Web UI (production mode has no hot reload) and refresh the page — the webbridge_* tools become available to the model.

Upgrade

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

For a local-path installation, run add again against the replacement checkout, then restart the Web UI and refresh.

Uninstall

在 GitHub 阅读完整 README →

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。