前言¶
DeepSeek Harness (DSH) 是一個以插件爲核心的模型推理框架。該插件由用戶 baldovinmarques391-design 維護，旨在將 Windows 桌面操作轉化爲一系列離散的工具調用。每個工具執行單一操作，並返回操作前後捕獲的幀數據，避免模型記憶截圖的負擔。
核心功能¶
插件在 tools 服務下注冊了 11 個工具，每個工具僅執行一個動作：
computer_probe: 報告屏幕幾何、指針位置/形狀及指針下的窗口。computer_screenshot: 截取屏幕或矩形，支持整數縮放。computer_move/computer_click/computer_drag/computer_scroll/computer_type/computer_key/computer_chord/computer_wait: 分別對應移動、點擊、拖拽、滾動、打字、按鍵、組合鍵和等待操作，均返回操作前後的幀數據。computer_frames: 讀取兩次調用之間記錄的幀數據，用於重建動作細節。
安裝與啓用¶
安裝命令如下，將 <path-to-this-checkout> 替換爲插件目錄的本地路徑：
dsh plugin --profile web add <path-to-this-checkout>
插件依賴由 harness 提供，本地 checkout 通常不包含 node_modules。運行測試：
npm test
使用說明與限制¶
併發與序列化¶
所有工具均爲併發不安全，輸入由註冊表序列化。這意味着同一時間只能有一個桌面輸入操作生效。computer_scroll 拒絕零滾輪手勢。
computer_frames 機制¶
computer_frames 是唯一不進行新捕獲的工具，它讀取錄製環中兩次調用之間的幀數據。默認情況下，maxAttachedImages 爲 2，超過數量的幀僅打印路徑而不作爲圖片附件返回。
功能設計¶
插件不支持長按、重複、宏、循環或“運行直到”參數。每個工具在調用結束後會立即釋放所有按下的鍵或按鈕。
配置項¶
配置項位於 cordis.patch.yml。以下是關鍵默認值：
| 參數名 | 默認值 | 說明 |
|---|---|---|
capturesPerSecond |
10 | 錄製器幀率 |
maxFrames |
2 | 每次調用返回的幀數（1-20） |
maxAttachedImages |
2 | 附件圖片的最大數量 |
settleMs |
700 | 動作完成後額外的捕獲時間 |
maxScrollClicks |
10 | 最大滾輪手勢步數 |
maxDragSteps |
120 | 最大拖拽步數 |
maxTypeChars |
2000 | computer_type 最大輸入字符數 |
生態背景¶
該插件屬於 DeepSeek Harness 社區生態。DeepSeek Harness 不接受外部 Pull Request。社區插件通過 GitHub 上的 dsh-plugin 話題進行發現。
鏈接¶
- GitHub 倉庫：https://github.com/baldovinmarques391-design/dsh-computer-control
- 插件目錄：https://www.skillhub.cn/plugins/baldovinmarques391-design/dsh-computer-control
