HarmonyOS Dev Assistant for VS Code

HarmonyOS Dev Assistant 插件简介

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

安装环境要求

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

核心特性

• 智能代码生成 — 与 AI 对话式生成 ArkTS/HarmonyOS 代码，覆盖项目创建、UI 开发、状态管理、网络请求、数据存储等完整开发流程。
• 元服务研发问答 — 基于项目上下文的实时技术问答，快速解决鸿蒙元服务开发中的 API 使用、设计指南、华为登录/支付接入等问题。
• 构建与调试 — 集成 hvigor 构建、模拟器调试、HAP 签名与真机部署，覆盖从开发到验证的全流程。
• 一键式签名 — 在插件设置中绑定元服务并完成签名，简化元服务打包与调试流程。
• 内置元服务skill技能 — 提供元服务开发、转换、续写、备案上架等面向鸿蒙场景的专属技能（skills），连接 Agent 后自动加载。
• 上架发布辅助 — 覆盖元服务备案、AGC 上架检测等发布全流程指导。

功能介绍

• 一站式生成元服务 — 在输入区的模式下拉框中切换至「元服务生成」，输入自然语言描述你的需求，即可一键生成可运行的元服务工程与代码。
• 小程序转元服务 — 在输入区的模式下拉框中切换至「元服务转换」，输入需要转换的小程序描述，即可自动将微信/支付宝小程序源代码转换为 ASCF 元服务代码。
• 三方库鸿蒙化 — 在输入区的模式下拉框中切换至「三方库鸿蒙化」模式，通过对话描述需要适配的三方库，即可快速生成鸿蒙平台的适配产物。

多平台支持

除 VS Code 外，HarmonyOS Dev Assistant 还以插件层形式支持：

• HBuilderX — 面向 uni-app 与鸿蒙混合开发场景
• DevEco Studio — 面向鸿蒙原生语言开发的 IDE

使用指南

登录插件

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

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

配置插件

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

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

一站式生成元服务

1. 生成元服务。

   1. 在VS Code中打开一个空目录。
   2. 进入插件界面，在左下角切换模式为“元服务生成”，并在对话框中输入类似“生成一个元服务”的提示语，并添加对元服务功能、布局详细要求的提示词。
   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） 和特殊符号（`~!@#$%^&*()_+|[];:'",<.>/?）中的两种以上字符的组合，长度 为8-32位。
      签名类型	选择“调试签名”。
      调试设备	选择已在AGC注册的设备。如需使用本地设备调试，可点击"使用本地设备"， 当前连接的真机设备将被添加到调试设备列表。之后，您可以在列表中勾选该设备。
      证书名称	输入证书名称。每个账号仅支持创建3个调试证书。
      Provision名称	输入Provision名称。
      签名存储地址	选择签名存储地址，默认存储在当前工程的.cert文件夹下。

   3. 在对话框中输入类似“将当前项目推包到手机运行”的提示语，插件将元服务推送到连接的真机上运行。

5. 执行上架自检。

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

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

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

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

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

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

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

小程序转换元服务

1. 转换元服务。

   1. 在VS Code中打开待转换的工程。
   2. 进入插件界面，在左下角切换模式为“元服务转换”，并在对话框中输入类似“当前是一个XXX小程序，帮我转换为ASCF元服务工程”的提示语。
   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）和 特殊符号（`~!@#$%^&*()_+|[];:'",<.>/?）中的两种以上字符的组合，长度为8-32位。
      签名类型	选择“调试签名”。
      调试设备	选择已在AGC注册的设备。如需使用本地设备调试，可点击"使用本地设备"， 当前连接的真机设备将被添加到调试设备列表。之后，您可以在列表中勾选 该设备。
      证书名称	输入证书名称。每个账号仅支持创建3个调试证书。
      Provision名称	输入Provision名称。
      签名存储地址	选择签名存储地址，默认存储在当前工程的.cert文件夹下。

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

5. 执行上架自检。

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

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

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

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

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

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

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

三方库鸿蒙化

1. 获取待转换的三方库文件，并根据三方库类型完成Flutter环境搭建 | 完成React Native环境搭建 | 完成DevEco Studio环境搭建。

2. 转换三方库。

   1. 在VS Code中打开待转换的三方库工程。

   2. 进入插件界面，在左下角切换模式为“三方库鸿蒙化”，并在对话框中输入类似“将当前工程进行鸿蒙化适配”的提示语。

   3. 等待各阶段任务执行完成后，进入资源管理器界面，查看鸿蒙化后的三方库工程。

      “ohos”目录下即为鸿蒙化三方库，供项目后续调用。“example > ohos”目录下还提供了鸿蒙化三方库的Demo样例，供您查看转换效果。

3. 在模拟器上运行鸿蒙化三方库Demo。

   1. 使用DevEco Studio打开“example > ohos”目录下的Demo工程。
   2. 在模拟器中运行Demo，具体请参考使用模拟器运行应用。

4. 在真机上运行鸿蒙化三方库Demo。

   1. 使用DevEco Studio打开“example > ohos”目录下的Demo工程。
   2. 将Demo推送到连接的真机上运行，具体请参考使用本地真机运行应用。

反馈与支持

如有问题或建议，请通过 VS Code 扩展商店的反馈渠道提交。