> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 鸿蒙开发专家

> 在豆包工作使用 superun 鸿蒙开发专家，完成本轮研发、适配规划确认、上线与打包，查询历史包和备案信息。

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

## 本地安装与启动

先安装[豆包工作桌面端](https://www.doubao.com/work)，使用本页的豆包 **Skill** 包。

[下载技能 ZIP](https://www.superun.com/web-api/packages/superun-harmony-expert/doubao/skill/download) · [查看当前版本](https://www.superun.com/web-api/packages/superun-harmony-expert/doubao/skill/latest)

1. 下载本页的豆包工作版 ZIP，保留完整安装包，无需重新压缩。
2. 打开左侧「插件 · 技能 · 伙伴」，切换到顶部「技能」，点击「管理」查看个人技能。
3. 点击「添加 → 上传技能」，通过「选择文件」上传刚下载的 ZIP。部分版本可直接在技能页点击「添加 → 上传技能」。
4. 已有同名技能时，先保留自己的修改，再在该技能详情菜单中选择「替换」，上传完整新包；出现确认时核对技能名并选择「上传并替换」。
5. 回到个人技能列表，确认已添加 `superun-harmony-expert`，再按下方「首次运行」新建工作任务使用。

也可以解压 ZIP，通过「选择文件夹」选择包含 `SKILL.md` 的完整 `superun-harmony-expert` 文件夹。请保留脚本、引用和素材；单独上传 `SKILL.md` 会缺少执行所需资源。

> [!NOTE]
>
> 请使用 **0.1.2 或更高版本的本平台专家包**，三个专家的名称分别为「superun 安卓开发专家」「superun 鸿蒙开发专家」「superun iOS开发专家」。若提示名称超过 15 字，请重新下载新版安装，不要继续使用旧 ZIP。下载入口尚无可用版本时，请等待对应包发布；手机安装包会在项目打包完成后另行交付。

### 首次运行

新建工作任务，选择「本地电脑」。在输入框输入 `/superun`，从候选中选择 `superun-harmony-expert` 对应技能，再补充自己的 App 需求；也可以直接说明「请使用 superun-harmony-expert」并给出具体任务。已有项目时提供真实的 superun 项目链接或编号，可以附上截图等参考资料。

按提示准备 Node.js 22 或更高版本、npm 和 superun CLI，在系统浏览器登录自己的 superun 账号并完成授权，再回到原任务继续。豆包工作与 superun 分别登录；生成与资源费用以实际提示为准。

如果没有出现技能，先在「技能 → 管理」中确认已导入，再新建本地电脑任务。切换豆包账号后，重新核对当前账号的技能列表；等待或登录中断后继续原任务。

## 可以这样开始

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

```text theme={null}
把我的 CRM 系统打包成一个鸿蒙 App，方便我在手机上使用。请先展示实际适配规划，等我确认后执行修复，上线后再选择包类型。
```

新建 App：

```text theme={null}
帮我做一个鸿蒙记账 App，可以记录收支并按月份查看统计，最后生成能安装到手机上的体验包。
```

## 从需求到手机安装包

流程为：**本轮选中功能完成 → 自动咨询适配 → 查看规划并确认执行 → 适配完成 → 上线运营 → 选择体验包或正式包 → 配置并打包**。

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

> [!NOTE]
>
> 适配规划确认和上线运营都是打包前置条件。应用 ID 用于识别同一款 App，更改后无法覆盖安装旧包，请在正式发布前确认。

## 鸿蒙打包前需要准备什么

体验包和正式包都需要你自己的华为开发者账号，并关联与当前应用 ID 一致的 AppGallery Connect（AGC）应用。

1. 在[华为开发者平台](https://developer.huawei.com/consumer/cn/)准备自己的开发者账号。
2. 在 AGC 的 Connect API 中创建**开发者级 Service Account**，按连接指引准备证书、Profile、设备及应用访问权限，并下载原始 JSON；不要使用项目级凭据。
3. 前往 [superun.ai](https://superun.ai) 下载或打开 superun 桌面端，用同一账号打开同一项目的鸿蒙打包设置，连接账号并关联匹配的 AGC 应用。
4. 生成体验包时，在桌面端添加、勾选并保存本次测试手机；需要连接手机时，按提示允许 USB 调试与设备授权。只有识别到手机、没有勾选保存，仍不能继续打包。
5. 返回专家，选择「已完成，重新检查」，配置检查通过后继续。

已有账号、应用关联和测试手机可以复用。新增测试手机后需要重新生成体验包；正式包本身不额外要求登记测试手机。原始账号 JSON 只在连接界面导入，不要把私钥内容粘贴到聊天中。

| 包类型 | 安装或分发 |
| - | - |
| 体验包 | 仅本次已选测试手机可安装，用华为浏览器打开安装页 |
| 正式包 | 专家说明影响并取得本次许可后，生成并自动上传 AGC；后续仍需在华为平台完成审核和发布 |

## 第一次生成正式包

尚未生成过本平台体验包时，专家会引导先体验。选择「先生成体验包」后，先在手机检查功能和效果，再选择「体验无误，继续正式包」；有问题则选择「先修复问题」。

这个体验步骤不会取消原来的正式包需求。修复影响源码时，按更新后的内容完成必要适配和上线，再继续正式包。

## 打包完成后会收到什么

体验包成功后返回名称、版本、二维码和安装页，用已选测试手机在华为浏览器中打开。正式包返回真实上传状态和 AGC 入口；没有可用的安装或邀请链接时，不会生成安装二维码。

下载手机安装包统一使用安装页中的按钮，不需要单独获取包文件直链。生成成功不代表已经在你的手机上验证安装成功。

正式包上传成功也不代表审核通过、商店已上架或测试邀请已经就绪，仍需在对应平台完成后续分发。

## 历史包、备案与继续开发

交付完成后，可以选择「查看历史包 / 查看备案信息 / 继续开发」，也可以直接说明要调整的内容。

* **历史包**：查看当前项目、本平台返回的最近记录，选择成功版本重新获取安装入口；返回范围不代表全部历史。
* **备案信息**：查看正式版本对应的实际备案资料。仅有体验包或资料尚未就绪时，专家会说明缺项；资料可查不代表备案已经通过。
* **继续开发**：沿原项目提交新需求，新一轮选中功能完成后再按适配、上线与打包流程更新 App。

出现失败时，专家会说明实际原因，并在可重试时提供「重试本步 / 稍后处理」。任务仍在运行时继续等待原任务；正式包上传失败时复用原包重试上传，不为此重新打包。

同一专家的其他客户端入口：[WorkBuddy](https://docs.superun.com/superun/third-party-apps/workbuddy/experts/harmony-expert.md) · [Qoder](https://docs.superun.com/superun/third-party-apps/qoder/plugins/harmony-expert.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.