插件详情 · 工具与技能
dsh-windows-mcp 怎么安装使用 — dsh 插件
dsh-windows-mcp 把 CursorTouch/Windows-MCP 桌面自动化服务器桥接进 DSH:agent 能枚举窗口、读取 UI 自动化树、点击、输入、截图。它把桌面控制权交给模型,装之前要按这个级别评估。
dsh plugin --profile web add dsh-windows-mcp
这是插件目录给出的安装命令。把它粘进终端执行;装完按页面里的说明重启或刷新。不要把它和别的包名混在一起。
它解决什么问题
有些任务必须在 Windows 桌面上完成:操作只有 GUI 的老软件、点一个没有 API 的按钮、看一个只在窗口里显示的状态。dsh-windows-mcp 通过官方 MCP 客户端桥接层,把 Windows-MCP 的工具接进 DSH,让 agent 用结构化工具操作桌面,而不是靠盲目的坐标点击。
它提供窗口枚举、UI 元素快照、点击/移动/输入、截图等能力;工具名以 mcp__windows__* 出现。默认是 disabled,装完依赖、重启并在设置里启用后才会出现工具。
装之前要什么条件
- Windows 10/11。
- DeepSeek Harness 桌面版,且内置
@deepseek-ai/dsh-mcp-client桥(0.2.0-rc.2 及以上)。 - 运行 DSH 的进程能在自己的
PATH上找到 uv(插件用它在面板里装 Windows-MCP);找不到时还会搜索%USERPROFILE%\.local\bin。 - 想让 agent 真的看到截图,需要一个支持图片输入的模型。
安装
桌面端:设置 → 插件 → 添加,填包名 dsh-windows-mcp 或仓库地址 github:helloHub1212/dsh-windows-mcp,重启 DSH。
非 Electron profile 也可以用 CLI:
dsh plugin --profile <profile> add github:helloHub1212/dsh-windows-mcp
Electron 独占的 desktop profile 会拒绝 CLI 的任何命令,桌面端走图形界面。
装完在哪里看到
- 设置 → 桌面控制:安装 Windows-MCP 依赖、启用桥、设置默认授权。
- 工具列表里的
mcp__windows__*。 windows_mcp_doctor:检查桥、依赖、UI Automation 和截图的健康状态。- 首次安装时没有工具是预期行为:桥出厂是 disabled,装完依赖并重启后才启用。
注意什么
- 这是最高权限的一类插件。 README 原话:装上它,等于把鼠标、键盘、剪贴板、进程和注册表交给模型。优先在一次性虚拟机或专用账户里用。
- 默认不监听网络。 默认走 stdio 子进程;切到 HTTP 时上游强制 loopback 过滤。子进程环境会清掉名字像密钥的变量和所有
DSH_*,凭据要显式写进配置。 - 授权在内存里。 Computer Use 的开关只存在宿主进程内存、按会话记账,重启清零;能写插件设置文件的 agent 仍能改启动行为。
- 你动鼠标键盘时工具会拒绝。 上游把最近 10 秒的物理输入视为你收回控制权,等几秒再试。
- 上游限制。 高 DPI 坐标偏移、
App工具只对英文版 Windows 可靠、UI Automation 失效需要重新登录,这些都在 README 的排障表里。
同类替代
- dsh-computer-use-win:用 UI Automation 操作 Windows 桌面程序和网页。
- dsh-ego-browser:驱动真实 Chrome/Chromium,范围限于浏览器。
- BrowserSkill:控制可见的 Chrome/Edge Agent Window。
只需要浏览器就选后两个;需要整个 Windows 桌面再选这个。
条目信息
- 插件名
- dsh-windows-mcp
- 所属分类
- 工具与技能
- 目录版本
- v0.2.11
- 最后 push
- 2026-11-15
- archived
- 否
- 数据来源
- dsh-plugin-catalog 2026.1119.23991 + GitHub API
所属分类与同类插件
看整类 2113 个这三个是同一分类里 star 靠前的条目,只作为替代参考;没有独立详情页,名字链到分类页里的对应条目。
安装前常问
为什么装完没有 mcp__windows__* 工具?
桥出厂是 disabled。先在设置 → 桌面控制里安装依赖、重启 DSH 并启用;仍没有就跑 windows_mcp_doctor 看生效行。
它会把我的屏幕发到哪里?
截图走本地 MCP 子进程;只有你让模型处理图片时,图片才按当前模型/供应商的规则传输。插件本身不发送遥测,上游 PostHog 默认关闭。
可以只在某个会话授权吗?
README 说 Computer Use 开关按会话记账、只在宿主进程内存里,重启清零;默认授权在设置里。不要把 shell 权限和桌面控制同时交给不可信的模型。