DeepSeek Harness（DSH）的生态以“一切皆插件”为核心理念。在开发需要访问真实浏览器环境的智能体时，保留登录会话、执行页面操作是常见需求。下面介绍的是 Bernardxu123 维护的 dsh-kimi-webbridge 插件，它通过本地运行的 Kimi WebBridge 守护进程，将 DSH 智能体的能力延伸到用户的真实浏览器中。
核心功能¶
该插件通过本地 Kimi WebBridge 守护进程，为 DSH 提供了 16 个工具，覆盖浏览器的导航、交互、截图、脚本执行及网络监控等能力。
- kimi_webbridge_navigate: 打开 URL，在首次使用时设置标签组名称。
- kimi_webbridge_find_tab: 根据 URL 重新选中任务标签页，支持
active:true借用当前标签页。 - kimi_webbridge_list_tabs: 列出当前会话的所有标签页。
- kimi_webbridge_snapshot: 读取页面可访问性树（包含
@e元素引用）。 - kimi_webbridge_click: 点击元素（支持
@e引用或 CSS 选择器）。 - kimi_webbridge_fill: 向输入框、文本域或富文本编辑器输入内容。
- kimi_webbridge_evaluate: 在页面中执行 JavaScript（支持异步）。
- kimi_webbridge_cdp: 透传 Chrome DevTools Protocol（高级用法）。
- kimi_webbridge_screenshot: 对标签页或单个元素截图，返回文件路径。
- kimi_webbridge_network: 捕获或检查标签页的网络请求。
- kimi_webbridge_upload: 向
<input type=file">上传文件。 - kimi_webbridge_save_as_pdf: 将当前页面渲染为 PDF，返回文件路径。
- kimi_webbridge_close_tab: 关闭当前标签页。
- kimi_webbridge_close_session: 关闭整个标签组（仅按需执行）。
- kimi_webbridge_status: 检查守护进程或扩展的健康状态。
- kimi_webbridge_start_daemon: 当守护进程不可用时自动启动。
安装与启用¶
首先需要安装 DeepSeek Harness (DSH) 环境并确保已安装 Kimi WebBridge 守护进程（版本 v1.11.6）。
- 在终端中执行以下命令安装插件：
dsh plugin --profile demo add github:Bernardxu123/dsh-kimi-webbridge
- 安装完成后，启动 DSH Web 交互模式：
dsh --profile demo web
典型用法¶
安装并启动后，智能体即可使用上述工具。例如，你可以让智能体打开一个网页，读取内容并截图。
- 对智能体提问：“打开 example.com，告诉我页面上有什么，并截图。”
- 智能体会执行以下操作：
- 打开一个标签组（使用你指定的语言命名）。
- 通过snapshot读取页面内容。
- 通过screenshot保存图片并展示给用户。
适用场景与注意¶
该插件要求 DSH 在 0.1.0-rc.7 版本上运行，并依赖 Node.js 18+。
- 已知问题：在 dsh 0.1.0-rc.7 中，如果 pnpm 出现罕见的临时失败，插件条目可能会残留在
dsh.profile.bundles中，导致 profile 启动失败并报错cannot resolve profile bundle "dsh-kimi-webbridge"。恢复方法为编辑 profile 的package.json，删除dsh.profile.bundles中的dsh-kimi-webbridge条目，然后重新启动。 - 文件结构：安装时仅会复制运行时文件（index.js, cordis.patch.yml, READMEs, LICENSE），仓库中的
docs/和tests/不会安装。 - 操作系统支持：插件在 Windows 上已测试，macOS/Linux 的代码路径已支持但尚未经过完整验证。
总结¶
通过这个插件，DeepSeek Harness 的智能体可以安全地操控用户的真实浏览器。所有操作均通过本地守护进程进行，数据不经过第三方服务，实现了真实会话的复用。
