前言¶
在 DeepSeek Harness (DSH) 的插件生態中，實現桌面自動化是常見需求。現有的 MCP 協議方案或第三方驅動可能增加系統開銷或依賴額外的中間件。dsh-computer-use 插件旨在提供一種更輕量、更原生的 Windows 桌面控制方式，直接通過 DSH 的 Cordis 工具註冊表調用，無需 MCP 代理層。
這是什麼¶
dsh-computer-use 是一個爲 DeepSeek Harness 提供原生 Windows 計算機使用工具集的插件。它直接使用 DSH 的 Cordis 工具註冊表，不依賴 MCP 協議。該插件僅支持 Windows 平臺，通過調用 user32.dll 和 System.Drawing 實現輸入和截圖功能，不會安裝全局鉤子或運行後臺進程。
核心功能¶
插件提供了一套標準的計算機控制工具，支持以下操作：
computer_screenshot: 捕獲虛擬桌面並返回 DSH 圖像附件。computer_click,computer_drag,computer_scroll: 使用虛擬桌面座標控制指針。computer_type,computer_keypress: 向當前控件發送 Unicode 文本或鍵盤快捷鍵。computer_wait: 允許應用在下一步觀察前進行狀態穩定。computer_observe: 捕獲桌面併發送給配置的視覺模型，用於當前 DSH 模型無法直接查看圖像時的推理。
所有 computer_* 工具默認通過 DSH 原生批准服務進行請求，確保在發送輸入前得到確認。
安裝與啓用¶
安裝插件需要指定 DSH 配置文件（Profile），例如 web、tui 或 headless。
dsh plugin --profile web add @crazy_th/dsh-computer-use
安裝完成後，必須重啓 DSH 才能加載新插件。可以通過以下命令驗證配置是否生效：
dsh --profile web --dump-config
在輸出的配置中，應能找到 computer-use-settings 和 computer-use 兩個節點。如果未找到，請重新構建或重新安裝插件。
視覺模型配置¶
插件支持將截圖發送給外部的視覺模型進行分析。
- 打開 Settings > Plugins > Plugin configuration。
- 展開 Computer Use Vision 配置卡片。
- 填寫以下字段：
| 字段 | 說明 |
|---|---|
| Enabled | 僅在填寫了端點、密鑰和模型後開啓。 |
| Base URL | HTTPS 格式的 OpenAI 兼容 API 地址，例如 https://api.example.com/v1。 |
| API Key | 存儲在 DSH 設置的密文字段中，僅用於本地存儲。更新時留空可保留現有密鑰。 |
| Model | 視覺模型的標識符。 |
| Max Tokens | 整數，範圍 64 至 8192，默認爲 1000。 |
注意：computer_observe 工具僅將當前截圖發送到上述配置的端點，請確保瞭解數據的處理位置。
適用場景與注意¶
- 平臺限制：該插件是 Windows-only 的自動化驅動，依賴
user32.dll和System.Drawing。 - 安全性：默認啓用 DSH 原生批准服務。如果遇到
user rejected tool錯誤，可能是因爲使用了approval: never（如danger-full-access預設），此時工具會被自動拒絕並顯示誤導性文本。建議在對話中輸入/permission workspace-write恢復提示。 - 配置生效：插件註冊的視覺配置通過 DSH 的瀏覽器配置 API 讀取，以確保安全性。
- 許可證：插件採用 MIT 許可證。
短結尾¶
dsh-computer-use 爲 DSH 在 Windows 環境下的桌面自動化提供了原生支持。通過直接集成到 Cordis 工具註冊表並利用 DSH 的原生批准機制，它簡化了環境配置，適合需要精細控制桌面操作的開發者使用。
- GitHub 倉庫：https://github.com/ThreeBody6666/dsh-computer-use
