DeepSeek Harness（DSH）採用插件化架構，這使得擴展系統功能變得靈活。在處理 Android 設備時，若要通過智能體直接操作設備，需要通過 ADB 協議建立連接。dsh-adb-ultimate 正是爲這一場景設計的插件，它將完整的 ADB 設備管理能力集成到 DSH 中。
插件定位¶
該插件由維護，屬於「工作流」類別。它的核心作用是讓 DeepSeek Harness 能夠直接控制 Android 設備，實現屏幕監控、性能數據讀取以及應用和文件的操作。
核心功能¶
插件在 DSH 界面中嵌入了一個完整的設備管理面板，主要包含以下能力：
-
設備面板
- 屏幕監控：支持實時屏幕查看，刷新間隔爲 1 秒。
- 性能監控：實時顯示內存（RAM）、CPU、電池狀態（電量、溫度、健康度）。
- 設備信息：展示設備型號、Android 版本、序列號等基礎信息。
- 應用管理：支持瀏覽、搜索應用，查看應用詳情（版本、權限）。
- 日誌查看：實時輸出 Logcat 日誌，支持 V/D/I/W/E 級別過濾。
-
設備連接
- 支持 WiFi 直連及配對驗證。
- 記錄連接歷史，方便快速重連。
- 支持同時管理多臺設備。
-
設備控制
- 支持截圖、開關屏幕、點擊、滑動、文本輸入等手勢操作。
- 支持應用安裝、卸載、啓動、強制停止。
- 支持文件推送與拉取。
-
系統調試
- 支持 Logcat 輸出、Dumpsys、Getprop 等系統命令查詢。
- 支持直接執行 Shell 命令。
安裝與啓用¶
在安裝前，請確保環境滿足以下依賴要求：
* Node.js >= 18.0.0
* @deepseek-ai/cordis >= 3.0.0
使用以下命令安裝插件：
dsh plugin --profile web add github:newborne/dsh-adb-ultimate
典型用法¶
- 連接設備：首先在 Android 設備上開啓 WiFi ADB 調試，然後通過插件提供的面板連接設備 IP 地址。
- 實時監控：連接成功後，設備面板會自動刷新屏幕畫面（1秒間隔）和性能數據。
- Agent 操作：你可以通過自然語言指令讓 Agent 幫你安裝該插件，例如：“Help me install this plugin: https://github.com/newborne/dsh-adb-ultimate”。
- 應用管理：在面板的 Apps 標籤頁中瀏覽已安裝應用，或通過指令安裝、卸載應用。
適用場景與注意¶
該插件適合需要通過 AI 控制或監控 Android 設備的開發者、測試人員以及技術愛好者。
安全提示：插件以當前 DSH 進程的權限運行。在安裝第三方插件前，建議檢查其源碼和許可證（MIT）。
