dsh-kimi-assemble：Kimi 桥接插件

前言¶

DeepSeek Harness（DSH）允许通过插件扩展工具集。现有做法中，模型需要读取 skill、调用 shell 的 curl，或者写入 Node REPL 的 js cell 来操作浏览器和桌面。这种方式存在依赖多、链路长、错误信息不精确的问题。dsh-kimi-assemble 提供了一组原生工具，直接驱动本地已安装的 Kimi 组件，通过 DSH 的工具调用机制完成操作。

插件定位¶

dsh-kimi-assemble 是一个桥接插件，为 Kimi 的两个本地运行组件提供 DSH 工具：

• Kimi browser extension daemon（WebBridge），监听 127.0.0.1:10086，控制真实登录的浏览器
• KimiCU native agent，通过命名管道 \\.\pipe\kimi-cu-win-<user> 操作真实 Windows 窗口

插件本身不包含实现，而是调用已运行的组件。如果组件未安装，工具会返回 KIMI_WEBRIDGE_DOWN 或 KIMI_CU_NOT_INSTALLED 并附带安装说明。

核心功能¶

插件提供 17 个工具，分为诊断、浏览器控制和桌面控制三类。

诊断工具¶

• kimi_status {deep?}：报告两个组件的运行状态，包括 daemon 地址/版本、扩展连接状态、CU 进程 PID/管道/权限，以及 hints 数组中的下一步操作建议。

浏览器控制工具（12 个）¶

• kimi_browser_read：读取页面内容，默认 20000 字符预算，可配置是否包含元数据。
• kimi_browser_click：点击页面元素。
• kimi_browser_fill：在输入框中填入文本。
• kimi_browser_submit：提交表单。
• kimi_browser_type：在输入框中逐字输入。
• kimi_browser_select：从下拉菜单选择选项。
• kimi_browser_hover：鼠标悬停。
• kimi_browser_wait：等待页面达到指定状态。
• kimi_browser_scroll：滚动页面。
• kimi_browser_focus：聚焦页面元素。
• kimi_browser_verify：验证操作是否实际改变了页面，默认自动验证，可关闭。
• kimi_browser_diff：读取当前页面并返回与上一次读取的差异。

桌面控制工具（5 个）¶

• kimi_cu_launch：启动桌面应用。
• kimi_cu_focus：聚焦桌面窗口。
• kimi_cu_read：读取桌面窗口的可访问性树。
• kimi_cu_type：在桌面窗口输入文本。
• kimi_cu_click：点击桌面窗口中的元素。

所有工具描述以英文呈现，错误信息、工具输出、提示内容以及技能正文支持中文（通过 language 配置）。

安装与启用¶

前置要求¶

在安装插件前，需确保以下组件已就绪：

• DeepSeek Harness >= 0.2.0（已验证版本 0.2.1-rc.2）
• Node.js >= 22
• Chrome 或 Edge 浏览器，并安装 Kimi 浏览器扩展
• Windows + KimiCU runtime (kimi-cu.exe)

安装插件¶

使用 DSH 的插件管理器从 npm 安装：

plugin_manager install_bundle  target=dsh-kimi-assemble@1.1.0

安装完成后，运行 cordis_inspect_query(Tool.listTools) 应能看到 17 个 kimi_* 工具。

配置组件¶

浏览器组件¶

1. 从 Chrome Web Store 或 Edge Add-ons 安装 Kimi 浏览器扩展。
2. 打开扩展侧边栏 → 设置 → “本地 Agent 远程控制” → 点击“去连接 / Connect”。
3. 复制对话框中显示的安装命令，在终端执行。该命令会在 ~/.kimi-webbridge 下安装本地 daemon。

桌面组件¶

下载并运行安装脚本，或在配置中指定 kimicuExePath：

# 下载并运行安装脚本
setup_windows.cmd https://cdn.kimi.com/kimi-computer-use-windows/latest/setup_windows.cmd

# 或在配置中指定现有 kimi-cu.exe 路径

运行诊断¶

插件附带诊断脚本，用于检查组件状态并提示缺失项：

# 从已安装的插件目录运行
node "%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-kimi-assemble\scripts\doctor.mjs"

# 或全局安装后运行
npm i -g dsh-kimi-assemble && kimi-assemble-doctor

# 输出机器可读的缺失项列表
kimi-assemble-doctor --json

退出码：0 表示两个组件就绪；2 表示需要人工介入；3 表示桌面组件未安装但可自动安装。

典型用法¶

检查状态并补全组件¶

1. 运行诊断：

kimi-assemble-doctor

2. 如果提示 kind: "user"，按提示在浏览器中安装扩展并点击“去连接”，复制安装命令执行。
3. 重新运行诊断，直到退出码为 0。

控制浏览器¶

模型调用 kimi_browser_read 读取页面，然后通过 kimi_browser_click 或 kimi_browser_fill 执行操作。插件会自动验证操作是否生效，若页面未变化则可能返回错误。

控制桌面¶

模型调用 kimi_cu_launch 启动应用，随后使用 kimi_cu_read 获取窗口内容，再通过 kimi_cu_type 或 kimi_cu_click 进行交互。

配置说明¶

配置项通过 config 对象整体替换（非深度合并），可覆盖默认值：

禁用部分功能¶

如果只需浏览器控制，设置 kimicuEnabled: false；如果只需桌面控制，设置 webbridgeEnabled: false。

兼容旧版 KimiCU MCP¶

若之前使用 @deepseek-ai/dsh-mcp-client 的 KimiCU MCP，建议在 cordis.patch.yml 中禁用该条目，避免工具名冲突：

- id: mcp-kimicu
  name: "@deepseek-ai/dsh-mcp-client"
  config: { ... }
  disabled: true

适用场景与注意¶

适用场景¶

• 需要操作真实登录状态的浏览器，而非无头浏览器
• 需要直接控制 Windows 桌面窗口，而非通过截图识别
• 希望减少 shell 调用和复杂脚本链路
• 已安装 Kimi 浏览器扩展和 KimiCU runtime 的 Windows 用户

注意事项¶

• 插件以当前 DSH 进程的权限运行，请确保安装前检查源码与许可证。
• 插件不自动下载或执行安装程序，需用户手动完成浏览器扩展和 KimiCU 的安装。
• 浏览器扩展的本地 Agent 安装命令仅由扩展的“设置 → 本地 Agent 远程控制”对话框提供，无公开安装 URL。
• 所有工具描述为英文，语言配置影响错误信息与提示文本。

价值总结¶

dsh-kimi-assemble 将 Kimi 的浏览器扩展与桌面控制能力封装为 DSH 工具，提供 17 个可调用的工具，支持诊断、浏览器操作和桌面操作。模型无需读取 skill 或调用 curl，即可通过工具调用完成端到端操作，错误信息更精确，链路更短。适合需要在真实浏览器和 Windows 桌面上进行自动化任务的 DSH 开发者。

• 目录页：https://www.skillhub.cn/plugins/KexinCC/dsh-kimi-assemble
• GitHub：https://github.com/KexinCC/dsh-kimi-assemble