跳转到主要内容
superun 鸿蒙开发专家帮助你从一句想法做出能安装到鸿蒙手机的 App，也支持把指定的已有 superun 项目适配后打包。目标平台固定为鸿蒙，无需在对话中重新选择。

安装与启动

本文使用 Qoder 桌面端的 插件 入口，IDE 和 CLI 的界面需分别核对。

方式一：从 Qoder 扩展市场安装（推荐）

  1. 打开 Qoder 桌面端左侧「扩展」，进入「插件」页面。
  2. 在搜索框输入 superun，在结果中选择「superun 鸿蒙开发专家」。市场搜索使用 superun 和中文展示名核对，无需输入插件的技术标识。
  3. 打开插件详情，核对名称、发布者及鸿蒙 App 开发能力说明，再点击「安装」。
  4. 在「已安装」中确认「superun 鸿蒙开发专家」已添加；如有启用提示，按提示启用。安装完成后，按下方「首次运行」选择主技能并发送需求。
市场条目会受上架状态、账号及组织可见范围影响。找不到对应条目时，使用下面的完整 ZIP 导入方式；导入后同样从「已安装」确认插件，并按「首次运行」启动。

方式二：下载并导入 ZIP

下载插件 ZIP · 查看当前版本
  1. 下载完整 ZIP，保留原包，在「扩展 → 插件 → 添加插件 → 上传 Plugin」中导入。
  2. 在「已安装」中确认 superun-harmony-expert 并按提示启用。更新使用同一导入入口，无需另装同名独立 Skill。
请使用 0.1.2 或更高版本的本平台专家包，三个专家的名称分别为「superun 安卓开发专家」「superun 鸿蒙开发专家」「superun iOS开发专家」。若提示名称超过 15 字，请重新下载新版安装，不要继续使用旧 ZIP。下载入口尚无可用版本时，请等待对应包发布；手机安装包会在项目打包完成后另行交付。

首次运行

两种安装方式都使用以下步骤启动：
  1. 新建任务，在输入框输入 /，选择「superun 鸿蒙开发专家」对应的主技能。菜单中的主技能可能显示为 superun-harmony-expert:superun-harmony-expert，按实际菜单核对。
  2. 补充自己的 App 需求；已有项目时提供真实的 superun 项目链接或编号，按需添加截图等参考资料，再发送。可以直接使用下方「可以这样开始」中的示例。
  3. 按提示准备 Node.js 22 或更高版本、npm 和 superun CLI，在系统浏览器登录自己的 superun 账号并完成授权，再返回原任务继续。Qoder 登录与 superun 授权分别完成。
后续使用云端流程，生成与资源费用以实际提示为准。登录或等待中断时回到原任务继续，不重复提交已经启动的操作。

可以这样开始

已有项目时，先提供真实的 superun 项目链接或编号，再发送：
新建 App：

从需求到手机安装包

流程为：本轮选中功能完成 → 自动咨询适配 → 查看规划并确认执行 → 适配完成 → 上线运营 → 选择体验包或正式包 → 配置并打包。
  1. 明确项目与需求：新想法从需求澄清和方案选择开始；已有 superun 项目提供链接或编号，沿原项目继续。
  2. 本轮研发完成后自动咨询：本轮已选功能全部完成后，专家会先告知，再自动检查 App 适配并整理规划。未选中的候选功能可以留到以后，不必先实现整份功能清单。
  3. 查看规划并确认执行：完整查看适配内容与步骤，选择「确认执行」后才开始修复。需要补充时选择「继续咨询」，讨论后的新规划需重新确认。
  4. 适配完成后选择下一步：专家展示结果，提供「上线并打包 / 继续研发」。继续研发沿原项目进行；选择上线时，按实际提示核对费用、公开影响并完成发布。
  5. 上线成功后再选包类型：只有当前版本上线运营成功后才能打包。专家会询问「生成体验包 / 生成正式包」，并让你确认或修改应用名称、图标和本平台应用 ID。
  6. 补齐配置并生成：已有配置直接复用，缺少的账号、签名或手机按提示补齐。完成后交付本次真实安装入口或正式包上传结果。
适配规划确认和上线运营都是打包前置条件。应用 ID 用于识别同一款 App，更改后无法覆盖安装旧包，请在正式发布前确认。

鸿蒙打包前需要准备什么

体验包和正式包都需要你自己的华为开发者账号，并关联与当前应用 ID 一致的 AppGallery Connect（AGC）应用。
  1. 在华为开发者平台准备自己的开发者账号。
  2. 在 AGC 的 Connect API 中创建开发者级 Service Account，按连接指引准备证书、Profile、设备及应用访问权限，并下载原始 JSON；不要使用项目级凭据。
  3. 前往 superun.ai 下载或打开 superun 桌面端，用同一账号打开同一项目的鸿蒙打包设置，连接账号并关联匹配的 AGC 应用。
  4. 生成体验包时，在桌面端添加、勾选并保存本次测试手机；需要连接手机时，按提示允许 USB 调试与设备授权。只有识别到手机、没有勾选保存，仍不能继续打包。
  5. 返回专家，选择「已完成，重新检查」，配置检查通过后继续。
已有账号、应用关联和测试手机可以复用。新增测试手机后需要重新生成体验包；正式包本身不额外要求登记测试手机。原始账号 JSON 只在连接界面导入，不要把私钥内容粘贴到聊天中。

第一次生成正式包

尚未生成过本平台体验包时，专家会引导先体验。选择「先生成体验包」后，先在手机检查功能和效果，再选择「体验无误，继续正式包」；有问题则选择「先修复问题」。 这个体验步骤不会取消原来的正式包需求。修复影响源码时，按更新后的内容完成必要适配和上线，再继续正式包。

打包完成后会收到什么

体验包成功后返回名称、版本、二维码和安装页，用已选测试手机在华为浏览器中打开。正式包返回真实上传状态和 AGC 入口；没有可用的安装或邀请链接时，不会生成安装二维码。 下载手机安装包统一使用安装页中的按钮，不需要单独获取包文件直链。生成成功不代表已经在你的手机上验证安装成功。 正式包上传成功也不代表审核通过、商店已上架或测试邀请已经就绪，仍需在对应平台完成后续分发。

历史包、备案与继续开发

交付完成后，可以选择「查看历史包 / 查看备案信息 / 继续开发」，也可以直接说明要调整的内容。
  • 历史包：查看当前项目、本平台返回的最近记录，选择成功版本重新获取安装入口；返回范围不代表全部历史。
  • 备案信息：查看正式版本对应的实际备案资料。仅有体验包或资料尚未就绪时，专家会说明缺项；资料可查不代表备案已经通过。
  • 继续开发：沿原项目提交新需求，新一轮选中功能完成后再按适配、上线与打包流程更新 App。
出现失败时，专家会说明实际原因，并在可重试时提供「重试本步 / 稍后处理」。任务仍在运行时继续等待原任务；正式包上传失败时复用原包重试上传，不为此重新打包。 同一专家的其他客户端入口：WorkBuddy · 豆包工作。