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. 进入“所属项目信息”页面，为元服务选择所属的项目后，点击“下一步”。

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

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

   • 如项目尚未设置数据处理位置：点击“数据处理位置”栏的“启用”，之后在“启用”栏为您的项目勾选一个或多个数据处理位置，并在“设为默认”栏将其中一个设置为默认数据处理位置。
   • 如项目已设置过数据处理位置，可点击“数据处理位置”栏的“管理”来启用新的数据处理位置、取消已启用的数据处理位置，或修改默认数据处理位置。

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

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

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

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

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

      

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

7. 将真机与PC连接。

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

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

2. 执行上架自检。

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

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

1. 在插件对话框中输入类似“帮我打包用于最终上架”的提示语。
2. 等待“待办清单”中各任务执行完成后，进入资源管理器界面，在“build

   outputs”目录下获取带签名的元服务软件包。

3. 打开插件配置界面，在“关联元服务”页签的“上架自检”区域，点击文件选择按钮，选择刚刚编译生成的带签名的元服务软件包，点击“提交自检”。
4. 等待自检结果。报告生成后，在“自检结果”栏点击“报告”查看详细信息。

小程序转换元服务

1. 转换元服务。
   1. 在VS Code中打开待转换的工程。
   2. 进入插件界面，在左下角切换模式为“元服务转换”，并在对话框中输入类似“当前是一个XXX小程序，帮我转换为ASCF元服务工程”的提示语。
   3. 等待“待办清单”中各任务执行完成后，进入资源管理器界面查看转换生成的元服务。
2. 将生成的元服务工程与AGC上的元服务关联。支持关联已有的元服务，或者新建一个元服务进行关联。

• 关联已有的元服务
  1. 点击插件右上角设置按钮，进入“关联元服务”页签，点击“关联元服务”。
  2. 在“选择元服务”窗口，选择AGC上元服务所属的团队以及元服务名称，点击“关联”。
  3. “当前元服务”区域将展示元服务的详细信息，表示元服务已成功关联。
• 关联新建的元服务
  1. 点击插件右上角设置按钮，进入“关联元服务”页签，点击“关联元服务”。
  2. 在“选择元服务”窗口，点击“创建元服务”，浏览器将打开AGC控制台页面。
  3. 在“应用开发基础信息”页面，填写待创建的元服务名称，分类仅支持选择“应用”，完成后点击“下一步”。
  4. 进入“所属项目信息”页面，为元服务选择所属的项目后，点击“下一步”。

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

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

   • 如项目尚未设置数据处理位置：点击“数据处理位置”栏的“启用”，之后在“启用”栏为您的项目勾选一个或多个数据处理位置，并在“设为默认”栏将其中一个设置为默认数据处理位置。
   • 如项目已设置过数据处理位置，可点击“数据处理位置”栏的“管理”来启用新的数据处理位置、取消已启用的数据处理位置，或修改默认数据处理位置。

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

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

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

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

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

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

7. 将真机与PC连接。

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

   

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

3. 执行上架自检。

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

      

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

1. 在插件对话框中输入类似“帮我打包用于最终上架”的提示语。
2. 等待“待办清单”中各任务执行完成后，进入资源管理器界面，在“build

   outputs”目录下可获取带签名的元服务软件包。

3. 打开插件配置界面，在“关联元服务”页签的“上架自检”区域，点击文件选择按钮，选择刚刚编译生成的带签名的元服务软件包，点击“提交自检”。
4. 等待自检结果。报告生成后，在“自检结果”栏点击“报告”查看详细信息。

三方库鸿蒙化

1. 获取待转换的三方库文件，并根据三方库类型完成Flutter环境搭建 |
   完成React
   Native环境搭建 | 完成DevEco
   Studio环境搭建。
2. 转换三方库。
   1. 在VS Code中打开待转换的三方库工程。
   2. 进入插件界面，在左下角切换模式为“三方库鸿蒙化”，并在对话框中输入类似“将当前工程进行鸿蒙化适配”的提示语。
   3. 等待各阶段任务执行完成后，进入资源管理器界面，查看鸿蒙化后的三方库工程。

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

1. 在模拟器上运行鸿蒙化三方库Demo。
   1. 使用DevEco Studio打开“example

      ohos”目录下的Demo工程。

   2. 在模拟器中运行Demo，具体请参考使用模拟器运行应用。
2. 在真机上运行鸿蒙化三方库Demo。
   1. 使用DevEco Studio打开“example

      ohos”目录下的Demo工程。

   2. 将Demo推送到连接的真机上运行，具体请参考使用本地真机运行应用。
      本文参考鸿蒙官方文档