【HarmonyOS 7】DevEco Code上手实录: 安装与使用一、前言做 HarmonyOS 开发DevEco Studio 肯定绕不开。最近发现华为出了个 DevEco Code终端里直接用装完一行命令启动跟 AI 对话就能干活。用了一段时间觉得挺顺手把上手过程整理一下给同样在搞 HarmonyOS 的朋友参考。以下是AI生成的登录界面UI效果DevEco Code 鸿蒙AI编程效果二、DevEco Code 能干嘛DevEco Code 是一款面向 HarmonyOS 开发场景的 AI Agent 工具基于开源项目 OpenCode 扩展开发。支持代码编写、项目构建、设备部署、文档查询、运行时调试、ArkTS 问题修复。它基于 OpenCode 扩展保留终端 UI、Provider、MCP、Skill、Plugin 体系同时增加 DevEco Studio、Hvigor、HDC、HarmonyOS 知识库、ArkTS 检查和设备调试能力。说白了就是在终端里跟 AI 聊天让它帮你写代码、编译构建、推包到设备、查文档、修 bug。先别管那么多30 秒跑起来# 1. 安装npminstall-gdeveco/deveco-code# 2. 启动deveco# 3. 开聊**启动后直接描述你的需求就行比如 - 解释一下代码库的架构 - 帮我重构 login_check 这个函数 - 帮我检查并修复语法错误 当然前提是你 Node.js 环境没问题这个下面细说。**三、一步一步详细安装与使用操作1、首先我们要去下载最新的IDE可选DevEco Studio 26.0.0 Beta1当然这里有个误区并非一定要下载最新的IDE才能使用DevEco Code。不过推荐下载能更契合智能体的使用。6.12号发布的版本目前使用这个版本最好版本说明如下使用AI智能辅助编程 使用自定义Agent和HarmonyOS Act智能体时支持展示当前会话token的使用量。 选择HarmonyOS Act智能体进行对话、代码生成、代码修改等操作后将鼠标悬浮在对话框的时间点会弹出Back to This Moment点击可回退对话。 工程问答支持调用MCPMarket工具调用LSPLanguage Server Protocol语言服务器协议工具以及ArkTS和C代码语义检索能力。具体请参考工程问答。 编辑区对话Inline Chat支持内置模型使用快捷指令如File Comments和Parameter Validation进行代码文件分析和参数校验等。具体请参考编辑区对话。 自定义智能体Agent新增UIVerification的内置工具。 具体请参考自定义智能体Agent配置和调用。 支持创建自定义指令该功能允许开发者将常用的提示词和工作流封装为可复用的命令提升日常开发效率。 具体请参考自定义指令Commands配置。 DevEco Studio 下载页 https://developer.huawei.com/consumer/cn/download/deveco-studio如果你只是想用 AI 对话、写写代码、查查文档不装 DevEco Studio 也能用。但涉及到编译构建、推包运行这些操作就必须装了因为 DevEco Code 底层调用的是 DevEco Studio 的工具链。装了 DevEco Studio 之后还需要配一下环境变量让 DevEco Code 找到它。不建议手动配置后面安装DevEco Code会有引导直接配置路径即可。把 DEVECO_HOME 指向IDE安装路径就行例如D:\HarmonyOS\IDE\devecostudio-windows-26.0.0.461\DevEco Studio2、安装DevEco Code的门槛目前支持 Windows 11 和 macOSApple Silicon 和 Intel 都行Linux 暂不支持。这也合理毕竟 DevEco Studio 本身就只有 Windows 和 macOS 版本HarmonyOS 的编译构建和模拟器调试都依赖它。硬件方面8 GB 内存日常用够了如果大工程频繁编译构建建议 16 GB 起步再给 DevEco Studio、SDK、模拟器预留 20 GB 以上的磁盘空间。3、下载安装DevEco Code我是直接将安装命令在IDE当前终端中执行结果报错。PSD:\HarmonyOS\workspace\testnpm install-gdeveco/deveco-code npm error codeEPERMnpm error syscall mkdir npm error pathD:\HarmonyOS\IDE\devecostudio-windows-26.0.0.461\DevEco Studio\tools\node\node_modules\deveconpm error errno-4048npm error Error:EPERM:operation not permitted,mkdirD:\HarmonyOS\IDE\devecostudio-windows-26.0.0.461\DevEco Studio\tools\node\node_modules\deveco......这个错误是典型的 EPERM (Error: -4048)权限问题通常发生在 Windows 系统上表示 npm 没有足够的权限在指定路径下创建目录或写入文件。错误信息显示路径为 D:\HarmonyOS\IDE\devecostudio-windows-26.0.0.461\DevEco Studio\tools\node\node_modulesdeveco说明 npm 试图在 DevEco Studio 安装目录下的 node 文件夹中创建 deveco目录但被系统拒绝。解决方案就是打开一个cmd窗口用管理员模式打开安装就正常了。C:\Windows\System32npm install-gdeveco/deveco-code added2packagesin2mC:\Windows\System32deveco--version0.1.0C:\Windows\System32Sign in with HUAWEI account使用华为帐号进行登录即可。如果没有配置DEVECO_HOME根据提示把IDE的路径贴进去回车确认即可。登录后默认免费提供 GLM-5.1 模型单账号每分钟 50 次请求。日常开发够用了写代码、查文档、修 bug 这些场景都没问题。在 DevEco Code 里输入/models可以进入模型配置界面用 CtrlA 可以切换 Provider。如果想研究该工具源码也可以直接下载华为也开源了企业也可以二开定制开发DevEco Studio 生态里的AIAgentCLI/开发平台源码。DevEco Code 这个AI编程代理工具开源 官方仓库https://gitcode.com/openharmony-sig/deveco-code四、安装踩坑实录1、Node.js 版本DevEco Code 要求 Node.js 22 及以上。如果你本机还是 18 或 20先升级node-vnpm-v不够的话用 nvm 或者直接去官网下都行这块不展开。2、npm 源的选择这个坑我踩过。第一次装的时候用的公司内部源装不上报了一堆 404。后来换了淘宝镜像源才搞定# 用淘宝镜像源npminstall-gdeveco/deveco-code--registryhttps://registry.npmmirror.com建议用 npm 官方源或者淘宝镜像源其他镜像源可能因为同步延迟导致安装失败或者版本滞后。五、想换模型怎么办如果你有自己的模型 API Key可以在 deveco.jsonc 里配置第三方模型。一般放项目目录下就行团队共享方便。通常位于 ArkTS 项目的根目录下与 build-profile.json5、oh-package.json5 同级。没有就新建一个配置文件配置长这样{$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}}}}}六、三种 Agent 怎么选DevEco Code 提供了三种 Agent 模式按 Tab 键切换。不用记定义看场景选就行Build 模式默认日常开发用这个。写代码、改配置、跑测试、编译推包都属于这个。你大部分时间会待在这个模式里。Plan 模式需要想方案的时候用。比如接到一个新需求想拆解一下任务、出个技术方案、规划一下发布节奏切到 Plan 模式让 AI 帮你理思路。Goal 模式这个比较重适合从需求到实现到验证的端到端交付。如果你用 SDDSpec-Driven Development流程这个模式能把需求、设计、实现、构建验证五个阶段串起来。简单记写代码用 Build想方案用 Plan端到端交付用 Goal。七、常用命令速查命令说明deveco启动deveco --version查看版本deveco upgrade更新deveco uninstall卸载运行时数据deveco auth login登录华为账号deveco auth logout登出/models模型配置界面终端内CtrlAProvider 选择界面终端内Tab切换 Agent 模式终端内更新deveco upgrade 卸载运行时数据与全局包 deveco uninstall npm uninstall-gdeveco/deveco-code
【HarmonyOS 7】DevEco Code安装与使用
【HarmonyOS 7】DevEco Code上手实录: 安装与使用一、前言做 HarmonyOS 开发DevEco Studio 肯定绕不开。最近发现华为出了个 DevEco Code终端里直接用装完一行命令启动跟 AI 对话就能干活。用了一段时间觉得挺顺手把上手过程整理一下给同样在搞 HarmonyOS 的朋友参考。以下是AI生成的登录界面UI效果DevEco Code 鸿蒙AI编程效果二、DevEco Code 能干嘛DevEco Code 是一款面向 HarmonyOS 开发场景的 AI Agent 工具基于开源项目 OpenCode 扩展开发。支持代码编写、项目构建、设备部署、文档查询、运行时调试、ArkTS 问题修复。它基于 OpenCode 扩展保留终端 UI、Provider、MCP、Skill、Plugin 体系同时增加 DevEco Studio、Hvigor、HDC、HarmonyOS 知识库、ArkTS 检查和设备调试能力。说白了就是在终端里跟 AI 聊天让它帮你写代码、编译构建、推包到设备、查文档、修 bug。先别管那么多30 秒跑起来# 1. 安装npminstall-gdeveco/deveco-code# 2. 启动deveco# 3. 开聊**启动后直接描述你的需求就行比如 - 解释一下代码库的架构 - 帮我重构 login_check 这个函数 - 帮我检查并修复语法错误 当然前提是你 Node.js 环境没问题这个下面细说。**三、一步一步详细安装与使用操作1、首先我们要去下载最新的IDE可选DevEco Studio 26.0.0 Beta1当然这里有个误区并非一定要下载最新的IDE才能使用DevEco Code。不过推荐下载能更契合智能体的使用。6.12号发布的版本目前使用这个版本最好版本说明如下使用AI智能辅助编程 使用自定义Agent和HarmonyOS Act智能体时支持展示当前会话token的使用量。 选择HarmonyOS Act智能体进行对话、代码生成、代码修改等操作后将鼠标悬浮在对话框的时间点会弹出Back to This Moment点击可回退对话。 工程问答支持调用MCPMarket工具调用LSPLanguage Server Protocol语言服务器协议工具以及ArkTS和C代码语义检索能力。具体请参考工程问答。 编辑区对话Inline Chat支持内置模型使用快捷指令如File Comments和Parameter Validation进行代码文件分析和参数校验等。具体请参考编辑区对话。 自定义智能体Agent新增UIVerification的内置工具。 具体请参考自定义智能体Agent配置和调用。 支持创建自定义指令该功能允许开发者将常用的提示词和工作流封装为可复用的命令提升日常开发效率。 具体请参考自定义指令Commands配置。 DevEco Studio 下载页 https://developer.huawei.com/consumer/cn/download/deveco-studio如果你只是想用 AI 对话、写写代码、查查文档不装 DevEco Studio 也能用。但涉及到编译构建、推包运行这些操作就必须装了因为 DevEco Code 底层调用的是 DevEco Studio 的工具链。装了 DevEco Studio 之后还需要配一下环境变量让 DevEco Code 找到它。不建议手动配置后面安装DevEco Code会有引导直接配置路径即可。把 DEVECO_HOME 指向IDE安装路径就行例如D:\HarmonyOS\IDE\devecostudio-windows-26.0.0.461\DevEco Studio2、安装DevEco Code的门槛目前支持 Windows 11 和 macOSApple Silicon 和 Intel 都行Linux 暂不支持。这也合理毕竟 DevEco Studio 本身就只有 Windows 和 macOS 版本HarmonyOS 的编译构建和模拟器调试都依赖它。硬件方面8 GB 内存日常用够了如果大工程频繁编译构建建议 16 GB 起步再给 DevEco Studio、SDK、模拟器预留 20 GB 以上的磁盘空间。3、下载安装DevEco Code我是直接将安装命令在IDE当前终端中执行结果报错。PSD:\HarmonyOS\workspace\testnpm install-gdeveco/deveco-code npm error codeEPERMnpm error syscall mkdir npm error pathD:\HarmonyOS\IDE\devecostudio-windows-26.0.0.461\DevEco Studio\tools\node\node_modules\deveconpm error errno-4048npm error Error:EPERM:operation not permitted,mkdirD:\HarmonyOS\IDE\devecostudio-windows-26.0.0.461\DevEco Studio\tools\node\node_modules\deveco......这个错误是典型的 EPERM (Error: -4048)权限问题通常发生在 Windows 系统上表示 npm 没有足够的权限在指定路径下创建目录或写入文件。错误信息显示路径为 D:\HarmonyOS\IDE\devecostudio-windows-26.0.0.461\DevEco Studio\tools\node\node_modulesdeveco说明 npm 试图在 DevEco Studio 安装目录下的 node 文件夹中创建 deveco目录但被系统拒绝。解决方案就是打开一个cmd窗口用管理员模式打开安装就正常了。C:\Windows\System32npm install-gdeveco/deveco-code added2packagesin2mC:\Windows\System32deveco--version0.1.0C:\Windows\System32Sign in with HUAWEI account使用华为帐号进行登录即可。如果没有配置DEVECO_HOME根据提示把IDE的路径贴进去回车确认即可。登录后默认免费提供 GLM-5.1 模型单账号每分钟 50 次请求。日常开发够用了写代码、查文档、修 bug 这些场景都没问题。在 DevEco Code 里输入/models可以进入模型配置界面用 CtrlA 可以切换 Provider。如果想研究该工具源码也可以直接下载华为也开源了企业也可以二开定制开发DevEco Studio 生态里的AIAgentCLI/开发平台源码。DevEco Code 这个AI编程代理工具开源 官方仓库https://gitcode.com/openharmony-sig/deveco-code四、安装踩坑实录1、Node.js 版本DevEco Code 要求 Node.js 22 及以上。如果你本机还是 18 或 20先升级node-vnpm-v不够的话用 nvm 或者直接去官网下都行这块不展开。2、npm 源的选择这个坑我踩过。第一次装的时候用的公司内部源装不上报了一堆 404。后来换了淘宝镜像源才搞定# 用淘宝镜像源npminstall-gdeveco/deveco-code--registryhttps://registry.npmmirror.com建议用 npm 官方源或者淘宝镜像源其他镜像源可能因为同步延迟导致安装失败或者版本滞后。五、想换模型怎么办如果你有自己的模型 API Key可以在 deveco.jsonc 里配置第三方模型。一般放项目目录下就行团队共享方便。通常位于 ArkTS 项目的根目录下与 build-profile.json5、oh-package.json5 同级。没有就新建一个配置文件配置长这样{$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}}}}}六、三种 Agent 怎么选DevEco Code 提供了三种 Agent 模式按 Tab 键切换。不用记定义看场景选就行Build 模式默认日常开发用这个。写代码、改配置、跑测试、编译推包都属于这个。你大部分时间会待在这个模式里。Plan 模式需要想方案的时候用。比如接到一个新需求想拆解一下任务、出个技术方案、规划一下发布节奏切到 Plan 模式让 AI 帮你理思路。Goal 模式这个比较重适合从需求到实现到验证的端到端交付。如果你用 SDDSpec-Driven Development流程这个模式能把需求、设计、实现、构建验证五个阶段串起来。简单记写代码用 Build想方案用 Plan端到端交付用 Goal。七、常用命令速查命令说明deveco启动deveco --version查看版本deveco upgrade更新deveco uninstall卸载运行时数据deveco auth login登录华为账号deveco auth logout登出/models模型配置界面终端内CtrlAProvider 选择界面终端内Tab切换 Agent 模式终端内更新deveco upgrade 卸载运行时数据与全局包 deveco uninstall npm uninstall-gdeveco/deveco-code
双梁正问题 【 torch 实战】（Python代码实现）)
