更新记录

0.1.64（2026-07-15） 下载此版本

HarmonyOS Dev Assistant 是一款面向鸿蒙（HarmonyOS）开发者的 AI 编码助手 HBuilderX 扩展。插件以自然语言对话为核心交互方式，提供小程序转元服务能力，帮助您更高效地完成鸿蒙元服务开发。

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

HarmonyOS Dev Assistant for HBuilderX

HarmonyOS Dev Assistant 插件简介

HarmonyOS Dev Assistant 是一款面向鸿蒙（HarmonyOS）开发者的 AI 编码助手 HBuilderX 扩展。插件以自然语言对话为核心交互方式，提供小程序转元服务能力，帮助您更高效地完成鸿蒙元服务开发。

安装环境要求

• 操作系统 — 支持 Windows、macOS 12+（Intel / Apple Silicon）
• HBuilderX — 最低版本 HBuilderX 5.07，推荐版本 HBuilderX 5.07（建议使用近半年内的稳定版）;
• Node.js — 最低版本 Node.js 18.x，推荐版本 Node.js 20.x LTS;

核心特性

• 构建与调试 — 集成鸿蒙元服务适配、 HBuilderX CLI 构建、模拟器调试、HAP 签名与真机部署，覆盖从开发到验证的全流程。
• 一键式签名 — 在插件设置中绑定元服务并完成签名，简化元服务打包与调试流程。
• 内置元服务skill技能 — 提供元服务知识问答、备案上架等面向鸿蒙场景的专属技能（skills），连接 Agent 后自动加载。
• 上架发布辅助 — 覆盖元服务备案、AGC 上架检测等发布全流程指导。

功能介绍

• 小程序转元服务 — 在输入区的模式下拉框中切换至「元服务转换」，输入需要转换的小程序描述，即可自动将uni-app小程序适配转换为鸿蒙元服务。

使用指南

登录插件

使用HarmonyOS开发助手，需要使用已实名认证的华为开发者账号登录。

1. 点击插件主界面“华为账号登录”按钮。
2. 在弹出的账号登录页面，输入已实名认证的华为开发者账号信息。
3. 返回编辑器，此时若当前账号团队尚未签署插件相关隐私声明与使用条款，点击蓝色链接阅读协议内容后点击“同意”，即可进入主界面。

配置插件

在正式使用插件前，您需要先配置AI模型与DevEco Studio安装路径。

1. 配置AI模型。
   1. 首次登录插件，界面会提示您当前未配置模型，点击提示框中的“去配置”链接，前往模型配置界面。后续如需修改模型配置，可点击插件右上角设置按钮进入模型配置界面操作。
   2. 在“模型”页签，点击“添加模型”。
   3. 在“添加模型”窗口，在“供应商”栏选择模型，并输入对应的API Key，点击“保存”。
2. 配置DevEco Studio安装路径。
   1. 点击插件右上角设置按钮。
   2. 在“基础配置 > 安装路径”栏，设置本地DevEco Studio的安装路径。

小程序转换元服务

1. 转换元服务。

   1. 在HBuilderX中打开待转换的工程。
   2. 进入插件界面，在左下角切换模式为“元服务转换”，并在对话框中输入类似“帮我把当前uni-app工程适配为鸿蒙元服务，运行到真机上”的提示语。
   3. 等待“待办清单”中各任务执行完成后，在真机上可查看转换的元服务效果。

2. 将生成的元服务工程与AGC上的元服务关联。支持关联已有的元服务，或者新建一个元服务进行关联。

   • 关联已有的元服务

     1. 点击插件右上角设置按钮，进入“关联元服务”页签，点击“关联元服务”。
     2. 在“选择元服务”窗口，选择AGC上元服务所属的团队以及元服务名称，点击“关联”。
     3. “当前元服务”区域将展示元服务的详细信息，表示元服务已成功关联。

   • 关联新建的元服务

     1. 点击插件右上角设置按钮，进入“关联元服务”页签，点击“关联元服务”。

     2. 在“选择元服务”窗口，点击“创建元服务”，浏览器将打开AGC控制台页面。

     3. 在“应用开发基础信息”页面，填写待创建的元服务名称，分类仅支持选择“应用”，完成后点击“下一步”。

     4. 进入“所属项目信息”页面，为元服务选择所属的项目后，点击“下一步”。

     如需将元服务添加到已有项目，点击下拉框进行选择；如需将元服务添加到新项目，直接在框中填写新项目名称。

     5. 进入“云开发数据处理位置”页面，设置或管理项目的数据处理位置。

     • 如项目尚未设置数据处理位置：点击“数据处理位置”栏的“启用”，之后在“启用”栏为您的项目勾选一个或多个数据处理位置，并在“设为默认”栏将其中一个设置为默认数据处理位置。

     • 如项目已设置过数据处理位置，可点击“数据处理位置”栏的“管理”来启用新的数据处理位置、取消已启用的数据处理位置，或修改默认数据处理位置。

     6. 点击“确认”，元服务创建完成。

     7. 返回HarmonyOS开发助手界面，再次点击“关联元服务”，选择正确的团队和刚刚创建的元服务，点击“关联”。

     8. “当前元服务”区域将展示元服务的详细信息，表示元服务已成功关联。

3. 在模拟器上运行元服务。

   1. 在操作前，请确保DevEco Studio已安装所需版本的模拟器。
   2. 在插件对话框中输入类似“将包推送到模拟器上运行调试”的提示语，插件将拉起DevEco Studio中的模拟器运行元服务。

4. 在真机上运行元服务。

   1. 将真机与PC连接。

   2. 打开插件配置界面，在“关联元服务”页签点击“添加签名”，在“创建元服务签名”窗口输入签名信息，点击“确认”。

      参数	说明
      密钥名称	输入密钥名称。
      密钥密码	输入密钥密码，必须由大写字母（A-Z）、小写字母（a-z）、数字（0-9）和br/>特殊符号（`~!@#$%^&*()_+\|[];:'",<./?）中的两种以上字符的组合，长度为8-32位。
      签名类型	选择“调试签名”。
      调试设备	选择已在AGC注册的设备。如需使用本地设备调试，可点击"使用本地设备"， 当前连接的真机设备将被添加到调试设备列表。之后，您可以在列表中勾选 该设备。
      证书名称	输入证书名称。每个账号仅支持创建3个调试证书。
      Provision名称	输入Provision名称。
      签名存储地址	选择签名存储地址，默认存储在当前工程的.cert文件夹下。

   3. 在对话框中输入类似“已完成签名，帮我运行到真机上”的提示语，插件将元服务推送到连接的真机上运行。

5. 执行上架自检。

   1. 为元服务配置发布签名。

      打开插件配置界面，在“关联元服务”页签点击“添加签名”，在“创建元服务签名”窗口输入签名信息，点击“确认”。

      参数	说明
      密钥名称	输入密钥名称。
      密钥密码	输入密钥密码，必须由大写字母（A-Z）、小写字母（a-z）、数字（0-9）和br/>特殊符号（`~!@#$%^&*()_+\|[];:'",<./?）中的两种以上字符的组合，长度为8-32位。
      签名类型	选择“发布签名”。
      证书名称	输入证书名称。每个账号仅支持创建3个发布证书。
      Provision名称	输入Provision名称。
      签名存储地址	选择签名存储地址，默认存储在当前工程的.cert文件夹下。

   2. 在插件对话框中输入类似“帮我打包用于最终上架”的提示语。

   3. 等待“待办清单”中各任务执行完成后，进入资源管理器界面，在“build > outputs”目录下可获取带签名的元服务软件包。

   4. 打开插件配置界面，在“关联元服务”页签的“上架自检”区域，点击文件选择按钮，选择刚刚编译生成的带签名的元服务软件包，点击“提交自检”。

   5. 等待自检结果。报告生成后，在“自检结果”栏点击“报告”查看详细信息。

反馈与支持

如有问题或建议，请通过 HBuilderX 插件市场的反馈渠道提交。