dsh-windows-mcp - 让 DeepSeek Harness 智能体看见屏幕并操作 Windows 桌面的桥接插件

dsh-windows-mcp 是一个面向 DeepSeek Harness（DSH）的 Windows 桌面自动化插件，由 helloHub1212 维护，采用 MIT 许可证。按项目自述，它并不重新实现一套 MCP 协议客户端，也不复制一份 MCP SDK，而是作为一个「载体包」，把 CursorTouch/Windows-MCP 挂载到 DeepSeek Harness 已经内置的 MCP 客户端桥（@deepseek-ai/dsh-mcp-client）上。装上之后，DSH 智能体的工具列表里会出现一组 mcp__windows__* 工具，从而能够截屏、读取界面无障碍树、模拟鼠标键盘、读写剪贴板、管理进程与注册表。它适合希望在 Windows 上让 DSH 智能体直接操作本机桌面的用户，也适合想了解如何用「补丁行」方式复用宿主内置 MCP 桥的插件开发者。

维护者与状态

仓库由 helloHub1212 维护，创建于 2026-10-11，最后一次提交在 2026-11-08。最新正式版本为 v0.2.4，发布于 2026-11-08。截至 2026-11-09，仓库获得 342 个星标。项目处于早期阶段，版本号仍在 0.x，接口与行为可能随版本变化。

主要能力

以下能力均来自项目自述（README），描述的是插件安装并连通 Windows-MCP 之后智能体可用的工具集：

• 屏幕与界面感知：Screenshot 截取屏幕，图像以真实附件形式进入对话；Snapshot 抓取无障碍树，只产生文本、不消耗图像 token；DisplayInventory 枚举显示器及其几何信息。
• 输入模拟：Click、Move、Scroll 负责鼠标操作，Type、Shortcut 负责键盘输入。
• 等待与条件判断：Wait 用于休眠，WaitFor 等待某个界面条件成立。
• 内容提取与批量操作：Scrape 从窗口提取文本，MultiSelect 与 MultiEdit 用于批量选择元素与批量编辑。
• 系统级操作：Clipboard 读写剪贴板，Process 列出、启动与停止进程，Notification 读取通知，Registry 读写注册表值。
• 控制状态：ControlStatus 反映控制循环状态，据项目说明该工具由上游强制保留、无法禁用。
• 默认排除的工具：App（启动/切换应用）默认不启用，项目说明称上游仅在英文 Windows 安装上可靠支持；PowerShell 与 FileSystem 也默认排除，因为 DSH 本身已自带 shell 与文件工具。
• 诊断工具：插件自带 windows_mcp_doctor，当 mcp__windows__* 工具缺失时用于说明原因。
• Computer Use 开关：输入框旁新增一个 Computer Use 胶囊按钮，显示实际注册的桌面工具数量，并在重启后记住选择（状态文件为 ~/.dsh/dsh-windows-mcp.state.json）。该开关默认关闭，全新安装不会自动把桌面交给智能体；关闭是硬开关，从下一步起所有 mcp__windows__* 工具会从模型可见的工具列表中过滤掉，即使调用也会在派发阶段被拒绝，且对所有会话与子智能体即时生效、无需重启。

项目自述还提到，在 Windows 11 + DSH Desktop 0.2.0-rc.2 上验证时，桥接服务器对外公布 18 个工具（上游 21 个减去此处排除的 3 个），启动后约 1.5 秒就绪。

使用入口

仓库地址：helloHub1212/dsh-windows-mcp。

据项目说明，安装方式与普通 DSH 插件包一致：在 DSH Desktop 的 Settings → Plugins 中添加该包，可指向已发布的包名、仓库（github:helloHub1212/dsh-windows-mcp）或本地检出目录，然后重启 DSH 以在启动时组合新的补丁层。非 Electron 配置下可用 CLI 完成同样操作：

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

项目说明特别指出，Electron 应用独占 desktop 配置，CLI 会拒绝针对它的所有命令（包括只读命令），因此 desktop 配置应通过图形界面操作。

Windows-MCP 本身是 Python 程序，需要在 Settings → Desktop 的 Dependency 卡片中安装：卡片会显示 installed 0.8.8、未安装或未找到 uv 三种状态；点击下载安装后，插件会把桥接行写入配置文件的 cordis.patch.yml（写入前做带时间戳的备份，并置于幂等标记内），再重启 DSH 生效。此后桥接直接启动已安装的可执行文件，启动阶段不再解析包索引。同一页面还支持检查上游版本、一键升级与回滚，每个版本安装在各自的工具根目录下，切换版本只改写桥接行、无需重新安装。

许可与限制

许可证为 MIT。使用前需注意项目自述列出的前置条件与边界：

• 仅支持 Windows 10/11。
• 需要带内置 @deepseek-ai/dsh-mcp-client 桥的 DeepSeek Harness Desktop，版本 0.2.0-rc.2 或更新。
• 运行 DSH 的进程需在 PATH 中能找到 uv，Settings → Desktop 用它安装 Windows-MCP；DSH 本身没有它也能启动，且即使不在 PATH 中也会搜索 %USERPROFILE%\.local\bin。
• 若希望智能体真正「看见」截图，需要使用接受图像输入的模型。
• 桥接行默认以禁用状态发布，这是有意为之：首次启动若去解析 Python 依赖，在慢速或被阻断的网络上可能让 DSH 卡在「Loading plugins…」数分钟，因此插件选择不阻塞宿主启动。
• 若同一包存在于多个配置中且宿主未报告启动的是哪一个，插件不会写入任何内容，而会提示设置 DSH_WINDOWS_MCP_PROFILE 后重试。
• 在受限网络中，可把 uv 指向镜像（%APPDATA%\uv\uv.toml）以加速手动或 CLI 安装路径。

以上能力与行为均为项目自述，本文未对项目进行实际运行验证；具体表现请以仓库文档与自身环境测试为准。