前言¶
在 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
