前言¶
在 DeepSeek Harness(DSH)裏,智能體除了代碼、文件和終端,還可以調用 computer-use(電腦操作) 工具:讀窗口、截圖、點擊輸入、管理窗口,以及在已授權的瀏覽器裏操作頁面。這些能力來自 DSH 官方組件和 Cua Driver Native 提供方,並不是每個安裝裏都默認裝好、配好。
若沒有統一入口,啓用過程往往分散在配置與組件安裝步驟裏,也不易區分「配置已保存」和「驅動已就緒」。dsh-computer-use-manager(維護者 jwhs648,客戶端類社區插件,MIT)做的是:爲 DSH 已有的 computer-use 能力提供可視化開關、兼容組件檢查與補裝、運行狀態展示和只讀健康自檢。它不自帶獨立的電腦操作引擎,也不會另實現一套 computer-use。
目錄頁:https://www.skillhub.cn/plugins/jwhs648/dsh-computer-use-manager。SkillHub 爲社區插件目錄,與 DeepSeek / 幻方無官方從屬關係。當前預發佈版本爲 0.1.0-alpha.2(安全修復測試版);0.1.0-alpha.1 存在熱重載、取消恢復與遺留安裝進程等問題,不建議繼續分發。
這是什麼¶
本插件是 DSH 原有 computer-use 能力的激活與管理 UI。實際桌面行爲由 DSH 官方 computer-use 組件及其 Cua Driver Native 完成;若當前安裝缺少與宿主版本匹配的官方組件,插件會在用戶確認後補裝,而不是安裝自研引擎。
開啓前後變化的是 AI 可調用的工具,不是模型本身。 未開啓時,DSH 仍可使用已配置的代碼、文件、終端等;開啓且原生提供方運行後,AI 才能通過這套 computer-use 工具觀察和操作 DSH 所在電腦的界面(若已通過其他入口啓用同類能力,本插件主要增加管理頁,不疊加一套桌面工具)。
管理頁提供的入口¶
下面按 README 中的能力表說明各入口在做什麼。
| 入口 | 行爲 |
|---|---|
| 啓用開關 | 檢查本地組件;需要安裝時請求確認,隨後繼續啓用並自檢 |
| 運行狀態 | 區分保存的配置、實際工具提供方、可用工具和需要重啓的狀態 |
| 檢查兼容組件 | 查詢與當前 DSH 精確匹配的官方組件,不是「最新版」檢測 |
| 安裝匹配版本 | 只安裝固定的三個官方組件,不接受任意包名或版本 |
| 健康自檢 | 讀取原生驅動診斷,不發送桌面操作或截圖 |
界面支持中文、英文和窄屏佈局。停用電腦操作能力後,管理頁仍可訪問;插件自檢只讀驅動診斷,不會主動截圖或發送鍵鼠操作。
在已覈驗的 Windows x64 + DSH Desktop 0.2.2-rc.1 環境中,啓用後狀態顯示 56 個原生工具;數量隨宿主版本、提供方和註冊狀態變化,不承諾所有環境相同。
開啓後能做什麼(與未開啓的對比)¶
以下能力均來自 DSH 官方組件及其原生驅動,不是本插件自行實現:
| 場景 | 未開啓這套 computer-use | 開啓且提供方已就緒後 |
|---|---|---|
| 代碼、文件、終端及其他既有工具 | 按原有配置可用 | 保持原有能力,不由本插件新增 |
| 看應用界面 | 無法通過這套工具讀窗口或截圖;可由你提供截圖 | 枚舉應用和窗口,讀可訪問性控件樹,按需截窗口或桌面 |
| 操作應用 | 無法通過這套工具點擊或輸入 | 點擊、雙擊、滾動、拖動,輸入文字,發送按鍵及快捷鍵 |
| 管理應用與窗口 | 無此原生工具入口 | 啓動指定應用,查看並調整窗口位置與大小 |
| 操作瀏覽器頁面 | 仍可用已有網頁搜索、抓取等(若已配置) | 在受支持且完成授權的瀏覽器連接中讀頁面、點擊、填表,並按權限處理上傳下載 |
| 使用剪貼板 | 無這套工具的剪貼板入口 | 按任務讀寫剪貼板文本及工具支持的圖像或文件引用 |
README 中的典型請求示例包括:查找指定應用窗口並讀界面/截圖分析報錯;打開應用進入設置並在修改前說明擬改項;在已授權瀏覽器頁面填表並在提交前停下確認;操作後再讀界面覈對是否生效。目標應用、系統權限、控件與瀏覽器連接都可能限制操作;工具作用於 運行 DSH 的電腦,不默認控制遠程打開 DSH 網頁的另一臺機器。
安裝¶
本插件爲 Windows 測試版,已通過驗證的範圍爲 Windows x64、DSH Desktop 0.2.2-rc.1;macOS、Linux 及其他 DSH 版本尚未實測。插件以當前 dsh 進程權限運行,安裝前應閱讀源碼與 MIT 許可證,並知悉其爲第三方社區組件,非 DeepSeek 或 Cua 官方發行。
方式一:DSH Desktop 圖形界面¶
- 在 DSH Desktop 打開 插件 → 添加插件。
- 將修復包在 DSH 所在機器上的絕對路徑填入 包名或地址(不要加引號)。遠程瀏覽器電腦上的路徑不能直接用於 DSH 主機。
- 閱讀第三方插件信任提示並安裝,然後啓用管理插件。
- 進入側欄 電腦操作能力,按需打開開關;組件缺失時確認安裝並等待自檢。
修復包下載:dsh-computer-use-manager-0.1.0-alpha.2.tgz(同 release 頁提供 SHA-256 校驗,勿用舊版發行包替代)。
方式二:命令行(Desktop 的 dsh)¶
爲確保變更完整應用,先退出 DSH,執行後再打開:
dsh plugin --profile desktop add "C:\path\to\dsh-computer-use-manager-0.1.0-alpha.2.tgz"
也可安裝本地源碼目錄。首次選擇本插件不會自動開啓電腦操作驅動,兩個可選底層組件默認關閉;替換已安裝的 Host 代碼可能需要重啓 DSH,刷新頁面不能替代宿主重啓。
package.json 中聲明 engines.dsh 與 peerDependencies 均爲 0.2.2-rc.1,與上述覈驗範圍一致。
開啓流程¶
點擊開關 → 檢查本地組件 → 必要時確認並安裝 → 啓用 → 等待驅動就緒 → 自檢
- 本地組件已兼容時,跳過聯網查詢與下載。
- 缺失或不兼容時,先驗證與當前 DSH 的匹配版本,再請求安裝確認(確認五分鐘有效、僅可使用一次)。
- 安裝、啓動、需要重啓和自檢異常分別報告,不會一律顯示爲成功。
- 取消或失敗恢復不得把能力從關閉重新開啓;關閉管理頁面不會取消已確認的 Host 操作。
安裝、啓用和停用影響當前 DSH 配置下的所有會話;不自動授予系統權限、不繞過 DSH 審批、不自動重啓 DSH。
卸載與更新¶
本插件爲本地或 tarball 來源,不通過內置 Versions 頁面自動升級;「檢查兼容組件」只管理三個官方組件,不更新本管理插件。卸載管理插件不會自動刪除此前單獨安裝的電腦操作組件;建議先關閉電腦操作能力,再卸載管理插件,便於覈對停用結果。
安全與恢復邊界(簡要)¶
匹配組件安裝始終針對當前宿主精確版本。持有配置寫鎖後發現遺留安裝運行記錄會停止處理;對不能確認已完成並擁有恢復權的失敗,不盲目寫回舊配置。普通重啓保留配置;完整 Desktop 恢復可能取消自定義 bundle 的選擇,此時需在插件頁重新啓用管理插件。
開發與反饋¶
從源碼倉庫運行測試(勿在精簡發行包中執行):
node --test core.test.js api.test.js package.test.js
問題與建議:https://github.com/jwhs648/dsh-computer-use-manager/issues。反饋時請提供 DSH 版本、操作系統、安裝方式和已脫敏錯誤。
結尾¶
dsh-computer-use-manager 把 DSH 已有 computer-use 的啓用、三件套官方組件補裝、狀態區分和只讀自檢集中到側欄「電腦操作能力」一頁,適合需要在 Windows x64 + DSH 0.2.2-rc.1 上可控地打開桌面自動化、又不願自行拼配置的開發者。