前言¶

DSH 強調「一切皆插件」。在 Windows 上做桌面自動化時，常見難點是截圖包含無關窗口、座標控制不穩定、OCR 文本位置漂移、點擊後無法確認是否進入預期狀態。Altairpaca/dsh-computer-use-windows 針對這些問題，把窗口綁定截圖、OCR 文本定位、點擊後驗證、純 OCR 模式和可選視覺模型放進 DSH 插件裏。

這是什麼¶

這是由 Altairpaca 維護的 Windows Computer Use for DeepSeek Harness 項目，MIT 許可。它提供 DSH plugin wrapper，並在 Windows 側暴露一組 computer-use 能力：computer_screenshot、computer_ocr、computer_click_text、computer_mouse / computer_keyboard、computer_window、computer_use_run、computer_vision、computer_calibrate，同時支持 OCR-only mode、Optional vision provider 和 local health checks。

當前狀態是 Experimental alpha。它適合開發和受控測試，但項目不主張生產級無人值守桌面自動化。剩餘發佈門檻是 clean-install / real-DSH validation matrix，需要在代表性交互式 Windows 配置上完成。

核心功能¶

下面按已覈實事實列出可用能力。

• computer_screenshot：窗口綁定截圖。
• computer_ocr：robust OCR。
• computer_click_text：verified clicks。
• computer_mouse / computer_keyboard：鼠標、鍵盤等輸入操作。
• computer_window：窗口相關操作。
• computer_use_run：computer-use 運行入口。
• computer_vision：可選視覺模型接入。
• computer_calibrate：校準相關能力。
• OCR-only mode：不需要外部視覺模型的純 OCR 路徑。
• Optional vision provider：可配置視覺 provider，示例使用 openai-compatible。
• DSH plugin wrapper：以 DSH 插件形式接入。
• local health checks：本地健康檢查。

安裝與啓用¶

已覈實資料未給出官方安裝命令，因此本文不給出安裝命令。若你已經在目標 Windows 工作站上取得倉庫源碼，可以先運行本地檢查：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/check-health.ps1

這是 package.json 的 check 腳本調用形式。要求包括：Windows 11 recommended；PowerShell 7.4+；Node.js 20+ for the DSH plugin surface；OCR 相關流程需要 Windows OCR language packs。

Hosted CI 只做 deterministic checks；完整 scripts/check-health.ps1 不作爲 hosted CI，因爲它依賴 Windows Runtime/OCR 可用性和交互式桌面會話。

典型用法¶

以下示例來自已覈實用法。

1、在目標 Windows 工作站上運行本地健康檢查：

./scripts/check-health.ps1

2、直接調用 helper 的 screen 示例：

$env:CU_ARGS = '{"cmd":"screen"}'
& ./helper/cu.ps1

3、開啓 OCR-only mode：

{
  "vision": {
    "enabled": false
  }
}

4、配置 Optional vision provider：

{
  "vision": {
    "enabled": true,
    "provider": "openai-compatible",
    "base_url": "https://your-vlm.example.com/v1",
    "api_key_env": "MY_VLM_KEY",
    "model": "your-model"
  }
}

上面的 base_url、api_key_env 和 model 是文檔示例；API key 通過環境變量名引用，不應寫入倉庫配置。

適用場景與注意¶

• 適合在 Windows 11 上做開發、調試和受控測試，尤其是需要 OCR 文本定位、點擊後驗證、截圖保留在本地路徑的場景。
• 不適合直接當作已驗證的生產級無人值守桌面自動化；當前狀態是 Experimental alpha。
• 該軟件可以注入鼠標和鍵盤輸入，只能用於你有權操作的應用和系統。
• Target-window checks 會降低誤操作無關窗口的概率，但不能讓任意桌面自動化變得無風險。
• 如果啓用 vision，截圖可能被髮送到配置端點；如果截圖必須留在本地，使用 OCR-only mode。
• 模型/API 憑據應從環境變量或主機憑據存儲讀取，不要提交到配置中。
• 它會通過本地腳本和 Windows 輸入能力執行操作，因此運行前應確認當前 DSH 進程權限，並檢查源碼、MIT 許可證和依賴。

結尾¶

Altairpaca/dsh-computer-use-windows 提供了一組面向 DeepSeek Harness 的 Windows 桌面操作工具：截圖、OCR、點擊、鼠標鍵盤、窗口管理、批量運行、可選視覺模型和本地健康檢查。它仍處於實驗階段，適合在受控環境中驗證工作流。

GitHub：https://github.com/Altairpaca/dsh-computer-use-windows。目錄頁 URL 未出現在已覈實資料中；如需通過社區目錄查找，請以獨立目錄站點的實際頁面爲準。