DevEco Code 实战：终端智能体辅助鸿蒙 ArkTS 开发与调试

鸿蒙专家

随着 HarmonyOS 7 在 HDC 2026 上发布，鸿蒙生态正式迈入 Agent 时代。 DevEco Code（原 codegenie_cli）作为 OpenHarmony-SIG 孵化的专属 AI 开发助手，不再只是简单的代码生成工具，而是一个能直接打通编译、设备调试、ArkTS 报错修复和文档检索的 CLI-first 智能体。 它基于 OpenCode 架构，具备感知（读取 workspace）、决策（判断查文档还是改代码）、行动（直接调用 hvigor 编译或推送真机）三大 Agent 特征，从根本上重塑开发者的工作流。

环境搭建与快速入门

安装 DevEco Code 需要 Node.js 18+ 环境。打开终端全局安装核心包：

2. npm install -g @openharmony-sig/deveco-code

复制代码

安装完成后，通过终端登录华为账号，目前免费提供 GLM-5.1 模型，单账号默认每分钟 50 次请求。接着配置 DevEco Studio 路径（以 Mac 为例，默认 Application 路径），同意使用协议即可开始使用。

首次在鸿蒙项目根目录下执行 deveco-code 会引导初始化。可通过 /models 进入模型配置界面切换不同的 LLM Provider，或通过 /connect 选择第三方模型。配置信息也可写入 deveco.jsonc 文件。

DevEco Code 提供三种核心交互模式，按 Tab 键切换：
- Build：默认模式，适合工程生成、代码生成、配置修正、测试执行、推包运行。
- Plan：适合需求拆解、技术方案、发布规划、测试规划和文档生成。
- Goal：适合 SDD 五阶段从需求到实现与构建验证的端到端特性交付。

核心功能实战

场景一：自然语言驱动的 ArkTS 复杂业务生成

在自动模式下，直接输入指令如：“帮我用 ArkTS 写一个商品列表瀑布流组件，需支持下拉刷新，状态管理使用 @ObservedV2 和 @Trace，最后在 Index.ets 中引入它。” DevEco Code 会自动分析工程目录，创建 ProductList.ets，编写逻辑，甚至复用项目中已有的基础 Loading 动画组件。

场景二：智能终端编译与真机调试

输入：“帮我清理缓存并编译推送到真机。” DevEco Code 会自动在终端执行 hvigorw clean assembleHap 和对应的 hdc 安装命令，省去手动编译步骤。

场景三：异常捕获与自动化 Bug 修复

当项目编译失败或出现 Hilog 崩溃栈时，将报错信息粘贴进对话框，DevEco Code 会自动检索最新 HarmonyOS 官方文档，定位错误堆栈并直接在源码中应用修复。

进阶玩法：扩展专属 AI 开发流水线

Agent Skill 与 Subagent

DevEco Code 提供两种上下文隔离模式。Agent Skill（存放在 .agents/skills 目录的 Markdown 文件）运行时完全继承当前主对话上下文，适合生成 Git Commit Message 等场景。Subagent 通过 /agent 命令唤起，在独立沙箱中执行任务（如全工程代码规范审查），只将最终报告传回主对话，避免 Token 爆仓。

接入 Figma MCP 实现设计稿一键还原

MCP 是大模型连接外部工具的标准桥梁。在 ~/.config/deveco/deveco.jsonc 中配置 Figma MCP Server 后，可直接输入：“请调用 Figma MCP，根据这个 URL 分析设计稿，并使用 ArkTS 重构我当前的首页 UI。” DevEco Code 自主获取色值、间距、字体样式，生成贴合鸿蒙的 UI。配置示例：

2. {
3.   "$schema": "https://opencode.ai/config.json",
4.   "mcp": {
5.     "playwright": {
6.       "type": "local",
7.       "command": ["npx", "@playwright/mcp@latest"],
8.       "enabled": true
9.     }
10.   }
11. }

复制代码

将其中的 command 替换为 Figma 或 Mastergo 的 MCP 命令即可生效。

自动化 Hooks

DevEco Code 基于 OpenCode，未提供内置 Hook 能力，但可通过插件系统实现。在 .opencode/plugin/ 目录下编写 TypeScript/JavaScript 插件，利用 tool.execute.before 和 tool.execute.after 拦截事件。也可安装社区插件 opencode-claude-hooks（npm install opencode-claude-hooks），在 opencode.json 中加载，支持 SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop 等事件及 command/http/prompt 三类钩子，约 80% 语法兼容。

避坑指南与最佳实践

- 上下文记忆压缩：完成一个里程碑功能后，执行 /compact 命令，将数万 Tokens 的繁杂对话浓缩为核心需求，降低 API 成本并减少理解延迟。
- 自定义全局工程约束：在项目根目录创建 .deveco.md，写入团队规范，如“所有业务组件必须按 Feature 模块拆分”“网络请求使用 XxHttp 库”。DevEco Code 每次启动优先读取该文件，保证代码风格统一。
- 网络与 API 兼容：使用海外 LLM Provider 时注意配置本地终端代理。生成代码时在 prompt 中显式指定当前工程是 HarmonyOS NEXT 还是 HarmonyOS 5.0，避免使用废弃 API。

总结

DevEco Code 作为深度融合操作系统能力的 CLI 优先智能体，在 HarmonyOS 7 时代接管了重复的构建、排错与配置工作，让开发者回归核心业务创新。通过本文的实战演练，开发者可以快速上手这一数字研发合伙人，在鸿蒙生态中提升开发效率。

热心网友1

感谢楼主的详细分享！从环境搭建到进阶玩法，尤其是 Agent Skill/Subagent 和 MCP 接入设计稿的实战案例，信息量非常足，感觉对鸿蒙开发者来说是一份很实用的指南。 有个疑问想请教：.deveco.md 里定义的全局工程约束，在多人协作的 git 仓库中是如何处理冲突或版本同步的？另外，Figma MCP 的配置中，除了 command 替换，是否还需要额外的鉴权 token？期待后续能分享更多类似场景的踩坑细节。

热心网友1

感谢楼主这么详细的实战分享！之前一直用 DevEco 的纯代码生成功能，没想到现在已经进化到 CLI 智能体了，能直接调 hvigor 编译和真机调试确实方便，省掉好多手动步骤。那个 `.deveco.md` 全局约束的思路很实用，团队协作时能统一规范。想请教一下，如果项目里同时用了 C++ 的 NAPI 模块，DevEco Code 能跨语言识别和修复相关问题吗？还是主要聚焦在 ArkTS 层？

热心网友1

刚按帖子试了下，自动生成商品列表瀑布流那一步确实省了不少事，之前自己手写 @ObservedV2 和 @Trace 的状态管理总是漏东西。不过想问下楼主，自动修复报错的时候，如果项目里同时混了 HarmonyOS NEXT 和旧版本 API，它判断得准吗？