cfanmaoli/kimi-webbridge-dsh

Plugin插件 Native原生 ⭐ 2 MIT Notifications & Remote通知与远程

Project Overview项目介绍

kimi-webbridge-dsh is a native plugin built specifically for DeepSeek Harness (DSH). Its job is to bridge the Moonshot Kimi browser extension into the host so a DSH model session can drive a real local browser through documented, official capabilities. The plugin ships three responsibilities: it provisions the matching platform daemon binary from the official manifest with SHA-256 verification and stores it under ~/.kimi-webbridge/bin/, it bundles and registers the official skill documentation (including its references/ folder) as the kimi-webbridge skill at startup, and it exposes a thin kimi_webbridge tool whose only action is status, reporting daemon, extension, and registered-skill health. Installation is a single dsh plugin --profile web add kimi-webbridge-dsh; the package carries its own bundle patch, so no manual edit of cordis.patch.yml is required and a single DSH restart activates it.

The intended workflow begins with loading the kimi-webbridge skill, triggered by phrases like browser, webpage, or screenshot, and also by requests such as "build a reusable CLI for this site". The user or agent then calls kimi_webbridge.status to confirm that the daemon is reachable and the Chrome extension is connected; the plugin will silently start or even install the daemon if autoStartDaemon and autoInstallDaemon are left at their defaults. Once green, the actual browser control follows the bundled skill documentation: a POST to http://127.0.0.1:10086/command with a JSON body {action, args, session} makes the extension execute the requested action on the user's open browser tab. The plugin is aimed at DSH users who need the model to interact with live web pages, capture screenshots, or expose website actions as reusable commands.

Dependencies and limits are clearly bounded. The plugin only imports @deepseek-ai/* packages from the host as peer dependencies and never bundles copies; it has been verified against DSH 0.2.0-rc.1 and its peer range covers every 0.1.x and 0.2.x release since 0.1.0-rc.7. The browser extension itself is not auto-installed and must be added manually from the Chrome Web Store and connected on the extension side, with status reporting extension_connected: true before use. On Windows, any JSON request body containing non-ASCII characters must be delivered through a temporary file because the shell otherwise mangles the payload, and the skill doc spells this out. License is MIT. Configurable knobs (baseUrl, requestTimeoutMs, autoStartDaemon, autoInstallDaemon, daemonVersion, registerSkill) can be overridden per-id in ~/.dsh/profiles/web/cordis.patch.yml. Note that status.skills being empty is expected, because the upstream daemon only natively recognizes Claude Code, Codex, Hermes, OpenClaw, and Kimi, so this plugin is the sole path by which DSH acquires the skill. Finally, on first run always inspect status and hand any returned command straight back to the user; the plugin must never self-execute upgrade, stop, restart, or uninstall, since those actions would kill an active daemon.

kimi-webbridge-dsh 是一个面向 DeepSeek Harness(DSH)的原生插件,把 Moonshot Kimi 浏览器扩展接入宿主。它提供守护进程供应、技能注册和健康检查三类能力:自动按官方清单下载对应平台二进制并以 SHA-256 校验、安装时随包内置官方技能文档并以 kimi-webbridge 为名注册到 DSH 的 web profile,同时暴露只含 status 动作的瘦工具 kimi_webbridge。安装通过 dsh plugin --profile web add kimi-webbridge-dsh,插件自带 bundle patch,无需手写 cordis.patch.yml,重启一次 DSH 即可生效。

典型用法是先用 kimi_webbridge status 确认本地守护进程、Chrome 端扩展和已装技能副本健康,必要时由插件自动补装或拉起守护进程;随后加载 kimi-webbridge skill,按官方文档向 http://127.0.0.1:10086/command 发送 {action, args, session} 请求体即可驱动真实浏览器。它面向需要让 DSH 跨过模型边界、操作真实网页、截图或抓取内容的用户,但浏览器扩展本身需自行从 Chrome Web Store 手动安装并在扩展端完成连接,status 返回 extension_connected: true 后才可用;Windows 下含非 ASCII 字符的 JSON 请求必须经临时文件提交。

依赖与限制方面,插件只 import 宿主提供的 @deepseek-ai/* 包作为 peer,不捆绑副本,已在 DSH 0.2.0-rc.1 验证,peer 范围覆盖 0.1.0-rc.7 起的 0.1.x / 0.2.x。可在 ~/.dsh/profiles/web/cordis.patch.yml 中按 id 覆盖 baseUrl、requestTimeoutMs、autoStartDaemon、autoInstallDaemon、daemonVersion、registerSkill 等键,默认守护进程地址为 http://127.0.0.1:10086,超时 120000 ms。守护进程共享官方安装器的 ~/.kimi-webbridge/bin/ 目录,status.skills 为空属正常——该进程只识别 Claude Code、Codex、Hermes、OpenClaw 和 Kimi,DSH 获取技能的唯一渠道即本插件;首次运行建议先执行 status,并把其中的 command 原样交回用户,不要让插件自行 upgrade / stop / restart / uninstall。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
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 kimi-webbridge-dsh

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

READMEREADME

kimi-webbridge-dsh

把 Kimi 浏览器扩展(Kimi Browser Extension,原 Kimi WebBridge)接进 dsh:供应守护进程 + 注册官方技能包。插件本身不代理浏览器操作——浏览器能力全部由官方技能文档描述,模型照它驱动本地守护进程。

职责 说明
守护进程供应 按官方清单下载对应平台二进制(SHA-256 校验),未运行时自动拉起;落在 ~/.kimi-webbridge/bin/
技能注册 随包内置官方技能文档(含 references/),启动时注册为 kimi-webbridge skill
健康锚点 瘦工具 kimi_webbridge,只有 status 一个动作(守护进程 + 扩展 + 已装技能副本)

安装

dsh plugin --profile web add kimi-webbridge-dsh

自带 bundle patch,无需手改 cordis.patch.yml;重启一次 dsh 生效。

用法

  1. 需要真实浏览器时加载 kimi-webbridge skill(触发词:browser / 网页 / 截图 / ……,也包括"给某个网站做个可复用 CLI");
  2. 先调 kimi_webbridge 的 status 确认守护进程 + 扩展健康(会自动补装 / 拉起);
  3. 按 skill 文档 POST http://127.0.0.1:10086/command,请求体 {action, args, session};
  4. Windows 必须用临时文件承载 JSON 请求体(shell 会破坏非 ASCII),skill 里有说明。

工具清单、参数与注意事项一律以 skill 文档为准。

配置

在 ~/.dsh/profiles/web/cordis.patch.yml 按 id 覆盖(整份替换,未给出的键取默认):

- id: kimi-webbridge
  config:
    daemonVersion: v2.0.22
键 默认 说明
baseUrl http://127.0.0.1:10086 守护进程地址
requestTimeoutMs 120000 单次请求超时(ms)
autoStartDaemon true 未运行时自动启动
autoInstallDaemon true 二进制缺失时自动下载安装
daemonVersion latest 自动安装的版本,带 v 前缀,建议与扩展版本一致
registerSkill true 注册 kimi-webbridge skill

要求与提示

  • 浏览器扩展:需自行安装并连接(Chrome Web Store);status 显示 extension_connected: true 即可用。
  • 守护进程:无需预装,插件自动供应;与官方安装器共用 ~/.kimi-webbridge/bin/(Windows %USERPROFILE%\.kimi-webbridge\bin\)。
  • dsh 版本:只 import 宿主提供的 @deepseek-ai/*(声明为 peer,不打包副本),已在 0.2.0-rc.1 验证,peer 范围覆盖 0.1.0-rc.7 起的整个 0.1.x / 0.2.x。dsh 换代后如果 kimi_webbridge 工具、系统提示段落和 skill 一起消失,通常就是插件版本还没覆盖新 dsh——升级本插件再重启即可。
  • status 里的 version_mismatch / update_available / skill_mismatch:把其中的 command 原样交给用户执行;不要自行 upgrade / stop / restart / uninstall,它们会杀掉正在运行的守护进程。
  • status.skills 为空是正常的:守护进程只识别 Claude Code / Codex / Hermes / OpenClaw / Kimi,dsh 拿到技能的唯一途径就是本插件。

移除

dsh plugin --profile web remove kimi-webbridge-dsh

重启后生效;skill 随插件注册,移除即消失。

← 上一个 Prev dsh-autoupdate 下一个 Next glm4v-vision-mcp →