dsh-windows-mcp

前言¶

DeepSeek Harness (DSH) 代理通常处理代码或文本文件。当需要代理直接与 Windows 桌面交互，例如点击 UI 元素、截取屏幕或操作剪贴板时，就需要桌面自动化能力。dsh-windows-mcp 插件通过挂载一行配置，将 CursorTouch/Windows-MCP 协议连接到 DSH 内置的 MCP 客户端桥接上，让代理能够“看见”屏幕并驱动电脑。

插件介绍¶

这是 DeepSeek Harness 的一个插件，由 helloHub1212 维护。它本身不重新实现协议客户端或 MCP SDK，而是一个“载体捆绑包”。它利用 DSH 自带的 @deepseek-ai/dsh-mcp-client 桥接，通过 uvx 启动 Windows-MCP 服务，从而暴露桌面操作工具。

核心功能¶

安装并连接后，DSH 代理工具列表中会出现以下工具：

• 视觉与状态：mcp__windows__Screenshot（截图，作为附件）、mcp__windows__Snapshot（无图 token 的可访问性树）、mcp__windows__DisplayInventory（显示设备枚举）、mcp__windows__ControlStatus（控制循环状态，该工具无法被禁用）。
• 输入操作：mcp__windows__Click、Move、Scroll（鼠标）、mcp__windows__Type、Shortcut（键盘）。
• 等待与提取：mcp__windows__Wait、WaitFor（等待条件）、mcp__windows__Scrape（提取窗口文本）。
• 批量与剪贴板：mcp__windows__MultiSelect、MultiEdit（批量操作）、mcp__windows__Clipboard（读写剪贴板）。
• 系统与进程：mcp__windows__Process（进程管理）、mcp__windows__Notification（通知读取）、mcp__windows__Registry（注册表读写）。
• 辅助工具：windows_mcp_doctor（诊断工具，用于检查配置和已注册的工具）。

此外，DSH Composer 面板旁会出现一个 Computer Use 药丸标记。它显示已注册的桌面工具数量，并在重启后保持状态（文件位于 ~/.dsh/dsh-windows-mcp.state.json）。默认情况下该功能是关闭的。

安装与启用¶

1. 安装插件¶

使用 DSH 插件管理器安装：

dsh plugin --profile <profile> add github:helloHub1212/dsh-windows-mcp

在 DSH Desktop 中：进入 设置 → 插件，添加捆绑包（指向发布的包名、仓库 github:helloHub1212/dsh-windows-mcp 或本地检出目录），然后重启 DSH。

2. 安装依赖¶

Windows-MCP 是一个 Python 程序。在 插件设置 页面中，点击 Download and install 按钮。该操作会在后台运行 uv tool install windows-mcp@<pinned>，安装成功后，插件会自动将桥接配置写入 cordis.patch.yml 并提示重启。

使用说明¶

1. 验证安装¶

运行诊断工具：

windows_mcp_doctor

此命令会输出解析后的 uv/uvx/python 路径、~/.windows-mcp 状态、生效的桥接配置以及实际注册的 mcp__windows__* 工具。

2. 启用 Computer Use¶

在 DSH 界面中找到 Computer Use 药丸标记。
* 默认为关闭。
* 这是一个硬开关，不是提示。关闭后，所有 mcp__windows__* 工具将在该会话的每一步中被过滤，无法再被调用。
* 开启后，工具立即恢复可用。

3. 典型用法¶

启用 Computer Use 后，可以要求代理执行以下任务：

• “截取我的桌面并告诉我屏幕上有什么。”（使用 mcp__windows__Screenshot）
• “在记事本中打开并输入 Hello World。”

注意事项¶

1. 环境要求：

   • 操作系统：Windows 10 或 11。
   • DSH 版本：DSH Desktop 0.2.0-rc.2 或更新版本。
   • 依赖：必须在 PATH 中安装 uv（DSH 会自动搜索 %USERPROFILE%\.local\bin）。
   • 模型：需要支持图像输入的模型才能有效使用截图功能。

2. 功能限制：

   • 默认排除项：mcp__windows__App（应用启动/切换）、mcp__windows__PowerShell、mcp__windows__FileSystem 默认被排除（DSH 自身已提供 Shell 和文件工具，且 App 在非英文系统上支持不稳定）。
   • 强制工具：mcp__windows__ControlStatus 无法被禁用。
   • Computer Use：是硬开关，非软提示。

3. 权限与 Profile：

   • Electron 桌面应用拥有 desktop profile；CLI 拒绝对 desktop profile 执行任何命令（包括只读），请使用 GUI 进行桌面自动化配置。

结语¶

dsh-windows-mcp 通过复用 DSH 内置桥接和 uvx 工具链，为 DeepSeek Harness 提供了原生的 Windows 桌面自动化能力。通过 Computer Use 硬开关机制，用户可以明确控制代理对桌面环境的访问权限。更多详情与源码可参考项目主页。

GitHub 仓库