前言¶

在 DeepSeek Harness（DSH）裏給智能體接上「看屏幕、點窗口、敲鍵盤」這類能力，常見做法包括官方 macOS Computer Use bundle、通過 MCP 掛 Cua Driver，或自己掛載 native 提供方。這些路徑往往各自佔一套配置與註冊邏輯；官方註冊服務在同一時刻只允許一個電腦操作提供方，多開時可能直接拒絕加載。

dsh-computer-use-cua 是由維護者 vb2250158 發佈的配置型 bundle 插件：它不實現 Host 或客戶端，而是通過可同步的配置補丁，把 DSH 官方的 Cua Driver 原生提供方掛進已有 profile。下文介紹它的定位、能力與啓用時要注意的衝突與權限邊界。

這是什麼¶

插件倉庫名爲 dsh-computer-use-cua（npm 包名同名，當前版本 0.1.1）。一句話定位：在提供 tools 與 systemPrompt 服務的 DSH profile 裏，聲明依賴並掛載配置，從而啓用官方 Cua Driver native 提供方。

工具定義、權限處理、輸入執行、截圖回傳以及停用後的撤銷，由官方 @deepseek-ai/dsh-computer-use 與 @deepseek-ai/dsh-experimental-computer-use-cua-driver-native 組件承擔；本倉庫只負責 bundle 補丁與同步用的 Git 釘版本，沒有獨立構建步驟。

核心功能¶

配置 bundle，而非自研驅動¶

插件通過 cordis.patch.yml 在 Host 頂層註冊工具與系統指導，各 Agent 按 DSH 作用域規則繼承。它不改動默認模型、preset、操作系統級權限，也不爲某個會話預留桌面。

固定官方依賴版本¶

package.json 中聲明：

• @deepseek-ai/dsh-computer-use: 0.2.2-rc.1
• @deepseek-ai/dsh-experimental-computer-use-cua-driver-native: 0.2.2-rc.1

原生提供方當前對應 Cua Driver 0.28.0。包內保留 npm optional dependencies，以便安裝各平臺原生運行庫。

與同步器、共享清單協作¶

適合在源碼 Web 環境用現有插件同步器：把本倉庫 完整的 40 位 Git 提交 記下來，再由官方安裝器安裝。共享清單裏登記插件名 dsh-computer-use-cua；不要把其 @deepseek-ai/* 依賴寫進第三方插件清單。

已驗證的運行配置 Git 釘爲 b293c1c446c1437cfd304ea7b9924f2fb3f0754c。同步器在接收機上會按本機 DSH 源碼對齊官方依賴——Git 釘固定的是配置內容，不能替代你在每臺機器上覈對最終解析版本與桌面效果。

安裝與啓用¶

環境要求¶

• Node：>=24.9.0（README 驗證環境使用 24.15.0）
• 需要處於可用的圖形桌面會話；運行 DSH 的進程須具備目標應用所需權限

啓用前：停用其它電腦操作提供方¶

啓用本 bundle 之前，應先停用其它電腦操作提供方，包括但不限於：

• 官方 macOS Computer Use bundle
• Cua Driver MCP
• 手工掛載的 native 提供方

本插件使用自己的穩定配置行 ID，不覆蓋其它 bundle 的行；但若與已加載提供方衝突，官方註冊服務會拒絕加載，不會自動替你停用其它插件。

安裝路徑（以 README 爲準）¶

在已具備 tools 和 systemPrompt 服務的 profile 上操作；標準 Web profile 已提供這些服務。典型流程爲：

1. 用現有插件同步器記錄本插件倉庫的完整 40 位 Git 提交（驗證記錄中爲上述 b293c1c4… 提交）。
2. 通過官方安裝器安裝該 bundle。
3. 在接收機上執行同步器的「檢查更新 → 拉取並應用」，再覈對本機加載狀態、桌面權限與實際操作效果。

不要在共享來源裏寫入本機源碼鏈接；每臺接收機需自行覈對依賴解析來源與 Cua Driver 加載情況。

典型用法與能力邊界¶

啓用後，驅動在驗證環境中曾發現 56 個工具，只讀窗口查詢成功；正式服務中相關官方組件可同時運行，且原有會話可保留。但 README 明確：該次驗證未包含截圖、鼠標鍵盤輸入或模型調用；其它電腦尚未驗收，你本機的效果需自行驗證。

權限與截圖¶

• Windows 上權限級別、應用類型與後臺輸入能力可能限制操作；驅動拒絕後臺操作時，不會自動切到前臺或提權。
• 模型若要接收截圖，還需要附件存儲，以及模型路由上明確聲明圖像輸入。工具加載成功或權限檢查通過，並不等於模型一定能看到截圖，也不等於點擊、鍵盤與窗口讀取已在你的目標應用上驗收通過。

多會話與停用¶

多個會話共用同一桌面時，操作需要自行協調。停用 bundle 後，官方生命週期會撤銷工具並關閉驅動；已經送到應用的輸入不會回滾。

更完整的官方能力與限制見 DSH 文檔 Computer use 與 Cua Driver 0.28.0。

適用場景與注意¶

適合誰： 已在 DSH 標準 Web profile（或同類具備 tools / systemPrompt 的 profile）上開發智能體，並希望用官方 Cua Driver 原生棧做桌面自動化，且願意用同步器 + Git 釘管理可復現配置的團隊或個人。

務必注意：

• 插件能力以 當前 DSH 進程權限 爲界；安裝與啓用前應閱讀本倉庫與 @deepseek-ai/*、Cua Driver 的源碼與許可證（本倉庫原創部分爲 MIT；官方與外部依賴保留各自版權）。
• 驗證範圍目前以 Windows x64、pnpm 11.28.5、DSH 0.2.2-rc.1、Cua Driver 0.28.0 爲主；Linux / macOS 或其它版本組合需自行驗收。
• 社區目錄站點 SkillHub 插件頁 與 DeepSeek / 幻方無官方從屬關係，DSH 生態奉行「一切皆插件」，此處僅爲第三方 bundle 分發與說明入口。

結尾¶

dsh-computer-use-cua 的價值在於用最小自有代碼，把官方 Cua Driver 電腦操作接到可同步的 DSH profile 上，並把「單提供方註冊」「桌面權限」「多機版本對齊」等約束寫清楚。若你正在選型電腦操作方案，可先對照 README 中的衝突說明與 tested-environment.json，再決定是否在接收機上釘住同一 Git 提交做試點。

• 目錄頁：https://www.skillhub.cn/plugins/vb2250158/dsh-computer-use-cua
• GitHub：https://github.com/vb2250158/dsh-computer-use-cua