前言¶
DeepSeek Harness（DSH）裏不少插件帶圖形界面：側欄面板、表單、按鈕和異步加載。開發時常見做法是人工切到插件頁、點一遍、看控制台有沒有紅字，再回到對話繼續改代碼。步驟重複，且樣式問題（間距、顏色、字號）靠肉眼和截圖很難寫成可覈對的斷言。
下面介紹社區插件 dsh-ui-probe（維護者 yuexizhishang，分類：工作流）。它在當前正在運行的 DSH 桌面/Web 客戶端裏打開目標插件頁，用自動化讀佈局與計算樣式、操作控件、等待異步結果，並收集控制台報錯；任務結束後自動回到原來的對話，不佔用界面。
這是什麼¶
dsh-ui-probe 是 DSH 的圖形界面插件測試工具（UI 探針）。一句話定位：在真實界面裏自動測試插件頁面，讀樣式、點按鈕、填表單、等異步結果、抓控制台報錯，測完自動回到原對話。
插件通過 Cordis 補丁接入客戶端（client 平臺爲 web，immediately: true），裝好後無需額外配置文件。對話裏會多出 ui_probe 和 ui_page 兩個工具；技能列表裏會出現「dsh-ui-probe」指南，模型根據工具描述決定何時調用。卸載後工具與指南一併消失，不向系統目錄遺留獨立配置。
當前 npm 包版本爲 1.0.0（見倉庫 package.json），許可證 MIT。
核心功能¶
驗收流程在 README 裏概括爲三步：
| 步驟 | 做什麼 |
|---|---|
| 打開 | 切到目標插件頁面，並記住原對話，供之後返回 |
| 操作 | 逐步執行：點擊、按文字找元素、讀計算樣式、填表單、按鍵、等待元素出現、頁面快照（可見標題與按鈕清單） |
| 收尾 | 返回時間線 + 頁面快照 + 控制台報錯，然後自動回到對話 |
具體能力包括：
- 讀真實界面：元素尺寸、位置，以及字號、顏色、內外邊距、圓角、不透明度等計算樣式（不依賴截圖像素）。
- 點按鈕：按可見文字或 CSS 選擇器定位；文字出現在聊天記錄裏時，可限定在某個容器內查找。
- 填表單：普通輸入框、文本域、富文本編輯器；寫完後回讀校驗，寫不進去會報失敗。
- 按鍵：回車、Esc、退格等。
- 等異步：輪詢等待某元素出現，適合「加載中→出列表」「點完彈提示」等場景。
- 抓報錯：彙總控制台錯誤，界面異常不會靜默失敗。
若只需快速看一眼面板，可打開、讀一次、立刻返回，不必走完整驗收鏈。
收尾與超時：驗收結束會主動返回原對話；中間 30 秒無新動作會自動收尾；頁面意外刷新後會按記錄的起點嘗試回到原對話。
安全邊界（對自動化封閉）：賬號菜單、設置面板內的點擊/輸入/按鍵一律拒絕；若誤打開會立刻關閉並報告「已拒絕」。唯一例外是插件自帶的「UI 探針」設置頁（版本、更新、卸載）。
已知限制：
- 不能從一個面板自動推斷並切回另一個面板，需顯式再點一次。
- 不支持 Canvas / 自繪編輯器內的輸入，僅標準輸入框、文本域與普通富文本。
- 同時只能跑一個驗收任務，後到的排隊。
安裝與啓用¶
在 DeepSeek Harness 的「插件 → 添加插件」中粘貼下列之一併安裝（不要自行拼接未在文檔出現的 CLI 命令）。
方式一：GitHub（推薦）
github:yuexizhishang/dsh-ui-probe
等價倉庫地址：https://github.com/yuexizhishang/dsh-ui-probe。
方式二：npm 預構建包
@yuexizhishang/dsh-ui-probe
無需本地編譯。安裝後若提示重啓，重啓一次 DSH 即可。
裝完不用配置任何東西。 插件自帶發現機制；卸載時在設置側欄「UI 探針」中二次確認即可，只移除插件本身，不刪除用戶自己的文件或倉庫。
插件設置頁還提供：打開時自動與 GitHub 比對版本；有新版時可「更新並安裝」；網絡或倉庫不可達時會如實報錯。插件本身不會自動打開設置面板。
典型用法¶
直接對對話說明意圖即可，例如：
驗收一下便籤插件，看一下界面和插件功能有沒有問題。
模型會調用 ui_probe / ui_page 等工具，在真實客戶端裏完成打開 → 操作 → 收尾。你收到的是可覈對的尺寸、樣式、文字清單與控制台報錯，而不是必須依賴截圖的主觀判斷；若需要給他人看觀感，仍可用系統截圖（如 Windows Win+Shift+S、macOS Shift+Cmd+4）。
適用場景與注意¶
適合誰：正在開發或維護 DSH 圖形界面插件的開發者，希望在同一套 DSH 進程裏做 acceptance test，減少手工切頁與漏看控制台。
運行權限：插件與 DSH 客戶端同進程、同 Web 上下文執行自動化。安裝前應閱讀 GitHub 源碼 與 MIT 許可證，確認行爲與安全邊界符合你的環境要求。
生態說明：DSH 社區插件目錄（如 SkillHub 上的 dsh-ui-probe 頁）由社區維護，與 DeepSeek / 幻方無官方從屬關係；本文事實以倉庫 README 與 package.json 爲準。
結尾¶
dsh-ui-probe 把「切到插件頁 → 操作 → 讀樣式與報錯 → 回到對話」收成對話裏一句話就能觸發的 workflow，適合在真實 DSH 界面裏驗收圖形插件，而不是隻靠截圖或人工點測。
