前言¶
DeepSeek Harness (DSH) 的核心架構支持通過插件擴展功能。針對 HarmonyOS 開發場景，dsh-deveco 插件將開發者常用的 HiLog 日誌監控、Chrome DevTools 風格的 ArkUI Inspector、ArkTS 語法高亮查看器以及設備管理工具集成到了 DSH 的 Web UI 右側邊欄中，旨在減少工具切換成本，提供一站式的開發輔助體驗。
功能¶
HiLog 檢查器¶
提供實時的日誌流查看能力。支持對日誌級別（Error/Warn/Info 等）、包名以及自定義關鍵詞進行過濾。用戶可以通過界面上的控制按鈕實時開始或停止日誌流。
ArkUI Inspector¶
採用 Chrome DevTools 的經典三欄佈局設計：
* 設備截圖與交互：點擊「Dump UI」抓取當前界面快照，點擊截圖可直接選中對應的 UI 節點，並在組件樹中自動展開並定位該節點。
* UI 組件樹：展示組件層級結構，支持自定義組件名的顯示、摺疊/展開操作。支持通過 DevEco 調試源或無障礙樹源（uitest）進行切換。
* 節點屬性與盒模型：右側面板展示節點的原始屬性，並支持按屬性名或值搜索過濾。底部提供 Tap、Swipe、Text 等模擬操作。
ArkTS 語法高亮查看器¶
支持在 DSH 的側邊欄中直接查看 .ets 文件。提供關鍵字、裝飾器、註釋、字符串和數字的語法高亮。內容通過官方 remote.workspaceFiles.read 接口分頁讀取。
Agent 工具與配置¶
- Agent 工具：註冊了
harmony_ui_tree工具，對話內的 Agent 可直接調用，返回縮進樹結構或 JSON 格式的 UI 樹，包含組件名、邊界和聲明值。 - 工具鏈配置：在設置頁中可配置 DevEco Studio 路徑和 HarmonyOS Command Line Tools (CLT) 路徑。插件支持跨平臺（Windows/macOS/Linux）自動發現默認安裝路徑，並校驗 CLT 版本是否大於等於 26.0.0。DevEco Studio 路徑與 CLT 路徑互斥。
設備管理¶
提供設備列表管理功能，支持列出 USB 連接和網絡連接的設備。用戶可以手動輸入設備 IP 和端口進行網絡連接，或一鍵斷開連接。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add @duke-dsh-plugins/dsh-deveco
安裝完成後，需重啓 DSH 進程以使插件生效。
典型用法¶
- 配置路徑：首次使用前，進入 DSH 設置頁的 HarmonyOS Suite 區域，掃描並保存 DevEco Studio 或 CLT 的路徑。
- 查看日誌：在右側邊欄啓動 HiLog 檢查器，過濾特定包名或關鍵詞查看實時日誌。
- Agent 調用：在對話中讓 Agent 調用
harmony_ui_tree工具，獲取當前設備的 UI 結構用於自動化測試或分析。 - 網絡調試：在設備管理區域輸入設備的 IP 和調試端口進行連接。
注意事項與限制¶
- DSH 版本要求：僅支持 DSH
^0.2.0-rc.1及以上版本。0.1.x 版本由於缺乏右側邊欄 API，不受支持。 - CLT 版本校驗：配置的 CLT 版本必須大於等於 26.0.0。
- 調試源限制：使用 DevEco 調試源時，應用必須處於調試模式，且應用側的調試 Socket 必須空閒（即 DevEco Studio 的 Inspector 面板未佔用連接）。
- 路徑互斥：DevEco Studio 路徑與 CLT 路徑不能同時配置，設置一方會自動清空另一方。
- 許可證：本項目基於 MIT 許可證開源。
生態與資源¶
- GitHub 倉庫：https://github.com/MoonlitDropOfBlood/dsh-deveco
- 維護者：MoonlitDropOfBlood
