v2026 · 基于 OpenCode 扩展 面向 HarmonyOS 开发场景

在终端里, 鸿蒙而生的 AI Agent

DevEco Code 把代码编写、编译构建、设备运行、文档查阅、运行时调试 与 ArkTS 问题修复,全部塞进一个为开发者保留的命令行入口。 一行 deveco, 直达 HarmonyOS 全流程。

立即安装 查看能力
登录后免费使用 GLM-5.1
~ · deveco zsh
npm install -g @deveco/deveco-code
added 1 package in 8s
deveco
欢迎使用 DevEco Code
描述你的 HarmonyOS 需求,例如:
› 帮我用 ArkTS 写一个登录页
解释一下代码库的架构
Tab 切换 Agent Ctrl+A Provider /models 模型
Node ≥ 22
运行时
DevEco ≥ 6.1
编译 / HDC / 模拟器
macOS · Win
arm64 · x64
MIT
开源许可
build_project start_app hdc_log verify_ui check_ets_files arkts_knowledge_search switch_cwd /models Provider · Ctrl+A Skill · MCP · Plugin build_project start_app hdc_log verify_ui check_ets_files arkts_knowledge_search switch_cwd /models Provider · Ctrl+A Skill · MCP · Plugin
01 · QUICK START

三步, 开始与 HarmonyOS 对话。

先安装 Node.js 22+,再装一行 npm 包,然后输入 deveco。 所有交互都在终端里完成——你描述需求,Agent 写代码、编译、推包、验证 UI。

!

建议使用 npm 官方源淘宝镜像, 其他镜像可能因同步延迟导致安装失败。

01 安装
$ npm install -g @deveco/deveco-code
02 启动
$ deveco
03 提示词示例
直接描述你的需求
解释一下代码库的架构
帮我重构 login_check 这个函数
帮我检查并修复语法错误
02 · CAPABILITIES

把工程师的全流程, 都集成进一个对话窗口。

从代码到设备,从知识到检查——DevEco Code 内置 HarmonyOS 场景下高频使用的 7 类工具能力。

build_project

一键编译,自动导出产物

通过 Hvigor 完成项目构建,构建产物自动归档;失败时由 Agent 读取日志、定位问题、直接修复。

Hvigor
构建
HDC
推包
HAP / HAR
产物
start_app

在模拟器或真机上运行应用

真机 模拟器
hdc_log

设备日志,按需收集与清理

连接模拟器、查看实时输出、清理冗余记录。
verify_ui

UI 验证

执行 UI 操作验证功能是否符合需求,默认调用内置 Qwen3-VL 多模态模型。

ArkTS
check_ets_files

ArkTS 静态语法检查

在保存与提交前找出潜在错误,配合 Agent 自动修复。

arkts_knowledge_search

HarmonyOS 知识检索

文档、API、最佳实践,全部嵌入对话流,引用即来源。

switch_cwd

在多个 HarmonyOS 工程之间无缝切换

不必退出会话,一条命令切换当前工程目录,Agent 自动重载上下文。

/switch_cwd ./harmony-shop
03 · AGENT MODES

Tab 切换三种工作模式。

每种模式都为特定开发阶段设计——从构建到规划到端到端交付,让 Agent 在合适的时候做合适的事。

默认
▣ MODE / 01

Build

工程生成、代码生成、配置修正、测试执行、推包运行与发布——动手为主的核心模式。

  • 代码生成与重构
  • 编译构建 / 测试 / 发布
  • 配置修正与设备推包
▢ MODE / 02

Plan

需求拆解、技术方案、发布规划、测试规划、文档生成——动嘴为主的策划模式。

  • 需求拆解 / 技术方案
  • 发布规划 / 测试规划
  • 设计文档自动生成
◆ MODE / 03

Goal

SDD 五阶段端到端特性交付——从一句需求,到实现与构建验证全程托管。

  • 需求 → 设计 → 实现
  • 自动测试 / 构建 / 验证
  • 端到端特性交付
04 · PLATFORM

支持平台

通过 npm 提供以下平台安装包。 暂不支持 Linux—— HarmonyOS 编译与模拟器调试依赖 DevEco Studio,目前仅提供 Windows 与 macOS。

平台
架构
说明
Windows
x64
Windows 11
macOS
arm64
Apple Silicon · M 系列芯片
macOS
x64
Intel 芯片 Mac
RECOMMENDED

推荐配置

操作系统
  • · Windows 11 22H2 +
  • · macOS 15 Sequoia +
硬件
日常使用
8GB+
短会话 · 单模块
重度使用
16GB+
大工程 · 构建 · 调试
终端 Shell
PowerShell 7+ Zsh Bash
05 · MODEL & CONFIG

登录即可免费用 GLM-5.1也可自由接入第三方。

登录后默认开通免费模型通道(GLM-5.1,单账号每分钟 50 次请求)。 通过 /models 切换模型, Ctrl+A 配置 Provider, 或直接编辑 deveco.jsonc

deveco.jsonc · Provider 配置
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deveco": {
      "name": "DevEco Code",
      "models": {
        "glm-5": {
          "tool_call": true,
          "limit": { "context": 200000, "output": 8192 }
        }
      },
      "options": {
        "baseURL": "https://api.openbitfun.com/v1",
        "apiKey": "{env:DEVECO_API_KEY}"
      }
    }
  }
}
deveco.jsonc · 第三方多模态(UI 检查)
{
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "alibaba",
      "options": {
        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "your-api-key"
      },
      "models": {
        "qwen3-vl-plus": { "modalities": { "input": ["text","image"], "output": ["text"] } }
      }
    }
  },
  "agent": {
    "ui_verification": {
      "mode": "subagent",
      "model": "myprovider/qwen3-vl-plus",
      "hidden": true
    }
  }
}
配置文件读取优先级
01 · 最高
.deveco/deveco.jsonc
项目目录
02
deveco.jsonc
项目目录
03 · 最低
~/.config/deveco/deveco.jsonc
用户目录
06 · EXTEND

扩展能力:兼容 OpenCode 生态。

DevEco Code 保留了 OpenCode 的 Skill / MCP / Plugin 扩展点。 安装第三方扩展、定制 Agent 行为、接入企业内部服务,开箱即用。

Skills 扩展

通过 npx 安装公共 Skill 仓库,或把自定义 Skill 放在用户目录。

$ npx skills add
vercel-labs/agent-skills
~/.config/deveco/skills
MCP 协议

deveco.jsonc 中接入任意 MCP server。

"mcp": {
  "playwright": {
    "type": "local",
    "command": ["npx", "@playwright/mcp"]
  }
}
Plugins 插件

通过 npm 安装插件,并在配置中声明入口路径。

$ npm i -g oh-my-opencode
"plugin": [
  "node_modules/oh-my-opencode/dist/index.js"
]

⚠ 新增或修改扩展配置后,需退出并重新启动 deveco 后生效。

07 · MIGRATE

从 OpenCode 迁移? 一行命令完成。

将原有 opencode.jsonc 拷贝到 DevEco Code 配置路径即可。 Skills、Agents、Plugins 同样可迁移到 ~/.config/deveco

Windows · PowerShell ›_
# 拷贝主配置文件
Copy-Item -Force "{源路径}\opencode.jsonc" "~\.config\deveco\deveco.jsonc"
macOS · Zsh ›_
# 拷贝主配置文件
cp {源路径}/opencode.jsonc ~/.config/deveco/deveco.jsonc
免费 · 基于 OpenCode 扩展 · MIT 许可

现在, 在终端里打开它。

$ npm install -g @deveco/deveco-code
已复制到剪贴板