本原创文章帖发布在华为开发者联盟社区，欢迎开发者前往访问评论交流，更多与该内容相关讨论，请点击原帖查看：DevEco CLI 快速入门：让 AI Agent 更懂 HarmonyOS 应用开发
各位开发者好！随着 AI 辅助研发成为日常，许多开发者和团队都已经用上了各种本地 AI 编码助手或自研的 AI Agent 工具。那么，如何让这些现有的 AI Agent 快速掌握 HarmonyOS 应用开发的能力？
华为推出的 DevEco CLI 正是为此而生，它定位于统一集成开发工具链和 HarmonyOS 知识库，是专为 AI Agent 打造的原子化能力调度枢纽。
今天我们直接从实操入手，教你如何将 HarmonyOS 能力接本地 AI 工作流。它本质上是将 DevEco Studio 工具链统一封装为一个 CLI，内置 ohpm、hvigor、hdc、emulator、hilog，同时集成 HarmonyOS 技能安装、项目脚手架、本地 HarmonyOS 文档检索和 MCP 服务。
详细操作如下：
1、DevEco CLI 环境依赖与配置要求说明
DevEco CLI 是基于 DevEco Studio 工具链封装的命令行工具。它依赖于已安装并配置好环境的 DevEco Studio（包含 ohpm、hvigor 等工具），通过命令行接口提供项目构建、设备调试等功能，旨在提升自动化脚本和 CI/CD 流程的效率。
前置要求
• 操作系统为 macOS 或 Windows
• Node.js >= 18，推荐使用 22 及以上版本
• DevEco Studio >= 6.1.0
• macOS：必须安装在 ~/Applications 或 /Applications 目录下。
安装
请在终端中执行以下命令安装：
稳定版：npm install -g @deveco/deveco-cli@stable
尝鲜版：npm install -g @deveco/deveco-cli
2、一键集成现有 AI Agent（以 OpenCode 为例）
如果你正在使用本地 AI Agent 工具（例如基于 OpenCode 开发应用），将 DevEco CLI 接入你的工作流非常简单。它能为 AI Agent 专门提供结构化（如 JSON）的数据流，完美兼容 Agent 驱动开发的范式。
实操命令： 只需在终端运行以下初始化指令： devecocli init 运行该指令后即可完成深度集成。你的 AI Agent 甚至可以自主指挥 DevEco CLI 去安装更多用于 HarmonyOS 应用开发的精品 Skills。
3、让 AI Agent 调度端到端研发原子能力
接入完成后，你的 AI Agent 就可以自动推进整个研发流程。你可以通过提示词或脚本，让 Agent 执行以下操作：
• 工程初始化：调用 create 命令，让 Agent 基于官方模板快速生成项目工程结构。
• 编译与构建：调用 build 命令驱动 hvigor 构建系统，自动处理 HAP 打包、多目标产物构建及代码签名。
• 模拟器与运行：使用 device / emulator 和 run 命令统一管理设备生命周期，自动完成安装、权限配置并启动应用。
• 实时语法检查与编译前错误拦截：Check MCP 为模型提供实时语法检查和编译修复工具能力，支持 ArkTS 和 C++ 语法检查，无需耗时编译即可实时发现错误，大幅缩短反馈链路，使 Agent 修复效率提升 5 倍以上。
同时 DevEco CLI 内置最新官方知识文档与极速检索，让 AI Agent 更懂 HarmonyOS。它能让裸模型获取官网最新 API，而非过时信息。
在实操命令与场景中： 你可以引导你的 AI Agent 在生成代码前，先执行以下查询命令： harmonyos knowledge "ArkUI 组件生命周期" 通过查询官方最新的 API 文档和最佳实践，确保它生成的代码严格遵循官方规范。下面是开发全流程展示：
4、调用现有精品 Skills
DevEco CLI 不仅提供工具和知识，也内置 70+精品 Skills 沉淀 HarmonyOS 应用开发中的实践经验，覆盖多设备场景适配开发、知识检索、ArkTS 语法、应用质量等关键场景，帮助开发者提升开发效率和应用质量。
下面以多设备适配 Skills 为例，AI Agent 可结合多设备 Skills 生成更符合设备特性的布局与交互方案，避免简单拉伸、布局错乱等问题，大幅降低多设备适配的人力开发成本。
以上内容展示了 DevEco CLI 的 AI 能力。现将 DevEco CLI 1.2.0 新版本上线特性汇总如下：
👉 开源项目地址：欢迎前往 GitCode 查看项目详情并体验：https://gitcode.com/openharmony-sig/deveco-cli
📺 推荐学习资源
HarmonyOS 白皮书：鸿蒙应用AI辅助研发新范式技术报告
开发者实践：DevEco Code 和 CLI实践专题
开发指南：DevEco CLI 文档
课程视频：HarmonyOS应用AI开发工具--DevEco CLI
对于拥有既定研发流程的团队来说，DevEco CLI 是将 HarmonyOS 能力接入您现有 AI 体系的强有力辅助。立即安装 DevEco CLI，开始你的 HarmonyOS AI 开发之旅！如果您在使用过程中有任何心得，欢迎在评论区留言，我们一起交流探讨！
