前言¶
DSH 的插件生态强调“一切皆插件”,把可安装、可覆盖、可移除的能力拆成 bundle;社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系,不能理解成官方应用商店。
在智能体自动化里,一个常见痛点是:模型不仅要“懂网页”,还要能操作用户当前已登录、已有上下文的真实浏览器。传统无头浏览器或外部抓取链路,往往缺少登录态,也难以覆盖本地文件上传、截图、PDF 导出等动作。
下面介绍 dsh-kimi-webbridge。它把本地 Kimi WebBridge daemon 暴露给 DeepSeek Harness(dsh)智能体,使智能体可以通过本地 daemon 驱动当前用户的真实浏览器。
这是什么¶
dsh-kimi-webbridge 是 MicroHEROX 维护的 DeepSeek Harness 插件,许可证为 MIT。
它做的事情比较具体:
- 智能体侧得到一组
kimi_webbridge_*工具。 - 插件通过本地 daemon 与浏览器端协作。
- 操作对象是当前用户的真实浏览器。
- 流程保持在本机:
plugin -> 127.0.0.1:10086 daemon -> user's real browser。 - 不依赖第三方服务中转浏览器流量。
- 不需要 API keys。
- 要求 Node.js >= 18。
它解决的不是“再建一个浏览器沙箱”,而是让 dsh 智能体在用户已登录的浏览器环境中完成页面导航、读取、点击、填写、截图、网络查看、上传和 PDF 导出等操作。
核心能力¶
该插件提供 15 个工具,名称如下:
kimi_webbridge_navigate
kimi_webbridge_find_tab
kimi_webbridge_list_tabs
kimi_webbridge_snapshot
kimi_webbridge_click
kimi_webbridge_fill
kimi_webbridge_evaluate
kimi_webbridge_cdp
kimi_webbridge_screenshot
kimi_webbridge_network
kimi_webbridge_upload
kimi_webbridge_save_as_pdf
kimi_webbridge_close_tab
kimi_webbridge_close_session
kimi_webbridge_start_daemon
覆盖的能力包括:
1、打开页面。
2、查找或列出标签页。
3、读取页面快照。
4、点击元素。
5、填写表单。
6、在页面中执行 JavaScript。
7、截图。
8、查看网络请求。
9、上传文件。
10、保存当前页面为 PDF。
11、关闭标签页。
12、关闭整个会话。
13、在 daemon 不可达时尝试启动本地 daemon。
这些工具都以 kimi_webbridge_ 为前缀,便于在 dsh 工具目录中识别和筛选。
安装与启用¶
先使用官方给出的安装命令。这里以 demo profile 为例:
dsh plugin --profile demo add github:MicroHEROX/dsh-Kimi-WebBridge
安装完成后,启动带 web 能力的 profile:
dsh --profile demo web
启用后,智能体目录中会出现 kimi_webbridge_* 工具。
如果需要按一次性 overlay 方式运行,可以使用:
dsh web --patch ./kimi-webbridge.overlay.yml
这个命令只作为运行入口,具体 overlay 内容应放在本机已有的 kimi-webbridge.overlay.yml 中。
移除插件时使用:
dsh plugin --profile demo remove dsh-kimi-webbridge
典型用法¶
下面是一个可复现的问法示例。
先安装并启动:
dsh plugin --profile demo add github:MicroHEROX/dsh-Kimi-WebBridge
dsh --profile demo web
然后给智能体这样的任务:
Open example.com in the browser, tell me what's on the page, and screenshot it.
经过上面的步骤,智能体预期会完成这几件事:
1、打开目标页面。
2、读取页面内容。
3、执行截图。
4、把结果返回给用户。
如果需要在不改变默认安装方式的情况下临时启用,也可以用 overlay 命令:
dsh web --patch ./kimi-webbridge.overlay.yml
适用场景与注意¶
适合的场景:
- 需要操作用户当前已登录的浏览器。
- 需要读取真实页面、截图、保存 PDF。
- 需要在本机完成网页自动化,而不是把页面流量交给第三方服务。
- 需要把浏览器操作纳入 dsh 智能体的工具链。
需要注意的限制:
1、fill / click 可能会被严格检查 event.isTrusted 的站点忽略,例如部分银行门户或验证码页面。这类页面可能需要人工介入。
2、跨域 iframe 不在当前范围内;相关工具主要操作顶层 frame。
3、会话是按 profile 维度管理,而不是按 agent 维度隔离;subagents 会共享同一组 tab。
4、Windows 已测试;macOS / Linux 由代码路径支持,但尚未验证。
5、所有配置键都是可选的。
6、插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。
另有一个 dsh harness 侧的已知问题:在罕见的 transient pnpm failure 情况下,dsh-kimi-webbridge 可能残留在 dsh.profile.bundles 中,导致 profile 启动失败。恢复方式是编辑对应 profile 的 package.json,移除相关条目后再启动。
链接¶
GitHub 仓库:
https://github.com/MicroHEROX/dsh-Kimi-WebBridge
社区目录:本文所依据的事实未提供具体目录页 URL,因此不补充未经核实的链接。