前言¶
在 DeepSeek Harness（下稱 DSH）裏做 HarmonyOS 應用開發時，常見痛點不是單條命令，而是命令分散：項目創建、構建、設備、模擬器、日誌、UI 檢查、文檔檢索都要拼路徑和環境變量。DSH 的理念是「一切皆插件」，但社區目錄是獨立站點，與 DeepSeek 或幻方無官方從屬關係，也不是官方應用商店。
fz-lyle/dsh-deveco-cli 把 DevEco Studio 工具鏈封裝成 devecocli，並以 DSH 插件形式發佈。安裝後，DSH 會註冊 deveco_cli 工具，供 Agent 以結構化參數調用 devecocli。
這是什麼¶
dsh-deveco-cli 是面向 HarmonyOS 應用開發的統一命令行入口，由 fz-lyle 維護，許可證爲 MIT。
它把 ohpm、hvigor、hdc、emulator、hilog 等工具統一封裝到一個 CLI，並提供：
- 項目腳手架
- 本地 HarmonyOS 文檔檢索
- HarmonyOS 技能安裝與管理
- MCP 服務
- 面向
opencode、atomcode等 Agent 的技能添加與 MCP 配置
已覈實資料中，package.json 版本爲 1.3.0-Test.19。
核心功能¶
下面只列已覈實能力，不展開未確認細節。
- 將 DevEco Studio 工具鏈統一封裝爲一個 CLI
- 內置
ohpm、hvigor、hdc、emulator、hilog - 支持項目創建、構建、運行、設備與模擬器查看、UI 檢查、日誌、文檔檢索、技能管理、簽名、兼容檢查等命令
- 支持把技能添加到 Agent，並配置 MCP；示例包括
opencode、atomcode - 發佈爲 DSH bundle，註冊
deveco_cli工具，供 Agent 以結構化參數調用devecocli - DSH 工具的
args是 argv 數組，不是 shell 字符串
常用命令如下：
| 命令 | 用途 |
|---|---|
devecocli create |
創建新的 HarmonyOS 項目 |
devecocli build |
構建項目併產出 .hap / .hsp / .har / .app |
devecocli check lint |
檢查代碼規範並輸出實踐建議與報告 |
devecocli run |
安裝並運行應用 |
devecocli device list |
查看當前連接設備 |
devecocli emulator list |
查看本地模擬器實例 |
devecocli ui layout |
導出設備屏幕上的 UI 節點樹 |
devecocli ui window list |
查看設備窗口列表 |
devecocli ui screenshot |
對真機或模擬器執行 UI 截圖 |
devecocli ui click |
點擊指定座標或節點 ID |
devecocli ui swipe |
自定義滑動 |
devecocli ui text |
輸入文本到焦點或指定位置 |
devecocli log |
查看 hilog 或崩潰日誌 |
devecocli docs search |
搜索本地 HarmonyOS 文檔 |
devecocli init |
安裝內置技能或配置 MCP |
devecocli skills |
管理 HarmonyOS 技能市場中的技能 |
devecocli signature generate |
自動生成調試簽名材料並配置到項目 |
devecocli check compat |
掃描源代碼在兩個 SDK 版本之間的 API 變更 |
安裝與啓用¶
前置要求¶
先確認運行環境：
- 操作系統爲
macOS、Windows或Linux，需要配置對應環境變量 Node.js推薦使用 22 及以上版本package.json的engines要求node >=22- 要求
DevEco Studio >= 6.0.0或Command Line Tools >= 26.0.0 macOS必須把DevEco Studio安裝在~/Applications或/Applications目錄下Linux不支持DevEco Studio Auto_Detect，必選Command Line Tools，最低CLT 26.0.0
安裝 DSH 插件¶
在 DSH 中安裝插件：
dsh plugin add @ah-plugins/dsh-deveco-cli
典型用法¶
創建並運行項目¶
先創建項目，再進入目錄運行，最後查看錯誤日誌：
devecocli create --app-name MyApp
cd MyApp
devecocli run
devecocli log --level E
文檔檢索¶
本地文檔檢索可以先搜索，再讀取具體條目：
devecocli docs search List
devecocli docs read harmonyos-guides/application-models/arkts-page-start-overview
給 Agent 安裝技能¶
以 opencode 爲例，先安裝技能，再配置 MCP：
devecocli init --agent opencode
devecocli init --mcp --agent opencode --project ./MyApp
cd MyApp
之後在項目裏啓動 opencode。
atomcode 的使用方式相同：
devecocli init --agent atomcode
環境變量與平臺約束¶
當使用非默認安裝路徑、多版本並存、Command Line Tools 或在 Linux 下運行時，可通過環境變量顯式指定工具鏈根。
已覈實的環境變量優先級爲：
DEVECO_CLI_STUDIO_PATH > DEVECO_CLI_CLT_PATH > Auto_Detect
其中：
DEVECO_CLI_STUDIO_PATH：顯式指定 DevEco Studio 安裝根，優先級最高DEVECO_CLI_CLT_PATH：顯式指定 Command Line Tools 安裝根
平臺約束如下：
| 平臺 | DevEco Studio Auto_Detect | Command Line Tools | 最低版本 |
|---|---|---|---|
Windows |
支持 | 可選 | Studio 6.0.0 / CLT 26.0.0 |
macOS |
支持 | 可選 | Studio 6.0.0 / CLT 26.0.0 |
Linux |
不支持 | 必選 | CLT 26.0.0 |
DSH 插件調用方式¶
安裝後，DSH 會註冊 deveco_cli 工具，供 Agent 調用 devecocli。
調用時需要注意參數形式：args 是 argv 數組，不是 shell 字符串。例如文檔檢索命令：
devecocli docs search List
對應到 DSH 調用時，search、List 這類參數應按 argv 數組組織，而不是寫成一個需要 shell 解析的字符串。
維護與發佈¶
如果你維護這個 DSH 插件或準備發佈，需要關注構建產物。
DSH 插件複用當前包內的 dist/cli.js，發佈前需要執行：
npm run build
關於數據採集與隱私，README 將遙測打點內容、存儲加密、上報及關閉方式指向 PRIVACY.md。本文不展開未覈實細節。
適用場景與注意¶
適合以下場景：
- 在 DSH Agent 中執行 HarmonyOS 項目的創建、構建、運行、日誌、設備、模擬器、UI、文檔、簽名、兼容檢查
- 將
devecocli技能或 MCP 配置到opencode、atomcode等 Agent - 在
Linux環境下使用Command Line Tools跑 HarmonyOS 工具鏈 - 需要在 DSH 中以結構化參數調用 DevEco 工具鏈，而不是手工拼裝 shell 命令
注意以下事項：
Windows上搭配devecocli使用opencode時，推薦將PowerShell 7作爲默認執行終端- 某些指令建議切換默認終端爲
PowerShell 7 Linux必選Command Line ToolsmacOS下注意DevEco Studio必須安裝在~/Applications或/Applications- 插件以當前
dsh進程權限運行；安裝前應檢查源碼、許可證和依賴，確認只啓用可信來源的插件 - 涉及隱私的內容以
PRIVACY.md爲準
鏈接¶
- 社區目錄：
https://www.skillhub.cn/plugins/fz-lyle/dsh-deveco-cli - GitHub：
https://github.com/fz-lyle/dsh-deveco-cli
