前言¶

智能體在終端裏能將操作驗證正確，但用戶往往無法用手復現，原因是缺少圖形界面的操作路徑和記錄。單純告訴用戶“運行腳本”無法解決這個問題，這會留下一個無法學習的黑盒，且在換到另一臺機器時會失效。

DSH 插件 dsh-gui-handoff 旨在填補這個落差，它能把命令行驗證過的操作，交接給圖形界面。

這是什麼¶

這是一個 DeepSeek Harness 技能插件，核心功能是把命令行驗證過的操作交接給圖形界面。

插件提供兩條路徑，默認走 B，降級到 A。

路徑 B（默認）：
* 做法：智能體真正操作 GUI 走一遍。
* 產出：生成帶真截圖的教程。
* 價值：用戶可以學習操作流程，且支持跨機器生存。

路徑 A（降級）：
* 做法：把步驟固化成配置文件。
* 產出：配置文件 + 一鍵操作。
* 限制：用戶無法學習，換機器不可用。

路徑 B 運行一個五階段鏈：驅動 → 觀察 → 捕獲 → 還原 → 標註。

插件內置了 30+ 硬約束 和 7 條工作紀律，用於確保操作的可復現性和正確性。驗證環節使用地面真值（例如：產物是否存在 + 時間戳，程序輸出或調試器退出碼），截圖僅用於輔助人類，不作判據。

通過以下命令安裝插件。插件註冊的 skill 名爲 gui-handoff，優先級爲 600（最低），因此本地修改的副本會優先於倉庫副本。

dsh plugin --profile <your-profile> add dsh-gui-handoff

也可以從本地目錄安裝：

dsh plugin --profile <your-profile> add /path/to/dsh-gui-handoff

啓用後，智能體可以執行路徑 B 的五階段鏈。如果當前環境缺乏驅動目標 OS GUI 的手段（Windows 已提供參考實現），插件會自動降級。

示例邏輯如下：

版本要求：需要 DeepSeek Harness >= 0.1.5-rc.1。
系統依賴：路徑 B 的驅動環節需要某種手段來驅動目標系統的圖形界面。本倉庫爲 Windows 提供了參考實現（tools/gui-control/server.py），若在其他系統運行，需自行實現對應的 GUI 驅動邏輯，否則插件會降級到路徑 A。
文件說明：tools/ 目錄是面向 Windows 的參考實現，並非插件運行的必需項。
權限與安全：插件以 DSH 進程的權限運行，安裝前請檢查源碼與許可證。

該插件通過驅動 GUI 一次並生成帶真截圖的教程，解決了命令行驗證與圖形界面操作之間的斷層問題，確保了操作的可學習性與跨機器可用性。