前言¶
DeepSeek Harness 的插件生態允許在側邊欄擴展開發工具。鴻蒙模擬器插件是 dsh-better-sidebar 的一個標籤頁擴展，它將鴻蒙模擬器的啓動、設備管理以及應用構建部署流程集成到 DSH 的側邊欄面板中。對於需要在 Harness 環境中直接調試 HarmonyOS 應用的開發者，該插件提供了一個統一的操作入口。
插件定位¶
這是一個基於 dsh-better-sidebar 的標籤頁插件，由用戶 momo20012002 維護，採用 MIT 許可證。它主要解決的是在 DSH 環境下，如何方便地啓動鴻蒙模擬器，並將選定的工程構建並部署到目標設備的問題。
核心功能¶
插件提供了以下功能：
- 模擬器管理：啓動或停止模擬器，查看可用實例與在線設備。
- 項目識別：通過文件瀏覽或掃描，識別 HarmonyOS 應用工程。
- 構建部署：將選定的工程構建、安裝並啓動到目標設備，支持自動識別多入口模塊。
- 實時反饋：構建、安裝、啓動過程的實時輸出。
- 就緒檢測：模擬器冷啓動後自動檢測設備是否上線。
- 模型工具：向 AI 提供六個專用工具，用於模擬器控制、部署、日誌、代碼檢查和文檔檢索。
安裝與前置條件¶
安裝前請確認以下環境已就緒：
- DSH 環境：
dsh web正常運行。 - Node.js：版本 >= 22。
- 包管理器：pnpm 版本 >= 10。
- 開發環境：已安裝 DevEco Studio（Windows/macOS）或 Linux Command Line Tools >= 26.0.0。
- CLI 工具：已安裝
@deveco/deveco-cli（devecocli），如未安裝可在面板點擊「一鍵安裝」。
安裝命令如下：
dsh plugin --profile web add dsh-hmos-emulator
安裝完成後，重啓 dsh web 並刷新瀏覽器頁面即可生效。
使用流程¶
- 打開側邊欄的
+菜單，選擇「鴻蒙模擬器」。 - 點擊「掃描可用」，列出模擬器與在線設備，點擊「啓動」啓動模擬器。
- 在「應用項目」中瀏覽或掃描，選擇一個鴻蒙工程。
- 點擊「構建並部署」，等待完成。
模型工具¶
插件向 AI 提供以下六個工具，可在對話中直接調用：
emu：模擬器實例的查看、啓動與停止。emu_ui：屏幕結構讀取、交互與截圖。hmos_deploy：構建 → 安裝 → 啓動流程。hmos_lint：代碼檢查。hmos_log：設備日誌查看。hmos_docs：官方鴻蒙文檔檢索。
截圖邏輯：界面狀態默認讀取節點結構，僅在結構不清時使用截圖。異常發生時，截圖會自動留存到工作區的 screenshots/ 目錄。
平臺支持與注意事項¶
- Windows / macOS：依賴 DevEco Studio 提供的模擬器功能。
- Linux：DevEco Studio 不可用，需使用 Command Line Tools >= 26.0.0。Linux 上必須配置桌面環境（即
DISPLAY或WAYLAND_DISPLAY環境變量已設置），否則無法啓動模擬器。 - 權限與安全：插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證（MIT）。
結語¶
該插件將鴻蒙開發的核心流程封裝進 DSH 側邊欄，配合 AI 模型工具，能夠顯著提升在 Harness 中開發 HarmonyOS 應用的效率。
