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 倉庫