AI 辅助编译部署鸿蒙应用：harmonyos-build-deploy Skill

场景 2：切换环境

你只需要说：

切换到生产环境，用 release 模式重新打包部署 

Claude 理解后执行：

npx harmonyos-deploy --all-p production --release--launch

场景 3：调试问题

你只需要说：

应用好像有问题，帮我看看设备日志，过滤 NetworkError 相关的 

Claude 会：

npx harmonyos-deploy --log-only --filter NetworkError 

然后帮你分析日志内容，定位问题。

场景 4：准备上架

你只需要说：

项目开发完了，帮我打个包准备上架华为应用市场 

Claude 会：

1. 使用 release 模式打包 .app 文件
2. 确保 debuggable=false
3. 输出文件路径和大小
4. 告诉你下一步去 AppGallery Connect 上传

npx harmonyos-deploy --app-p production --release-o ./dist 

AI + Skill 的协作模式

传统方式 vs AI Coding

Skill 如何工作

┌─────────────────────────────────────────────────────────────┐ │ 开发者 │ │ "帮我编译部署" │ └─────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ Claude Code │ │ 1. 理解用户意图：编译 + 部署 │ │ 2. 识别项目类型：检测到 build-profile.json5 → 鸿蒙项目 │ │ 3. 调用 Skill：harmonyos-build-deploy │ │ 4. 执行命令：npx harmonyos-deploy --all --launch │ │ 5. 处理结果：成功/失败 → 反馈给用户 │ └─────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ harmonyos-deploy CLI │ │ • ohpm install │ │ • hvigorw assembleHap/assembleHsp │ │ • hdc install │ │ • aa start │ └─────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 鸿蒙设备 │ │ 应用成功运行 │ └─────────────────────────────────────────────────────────────┘ 

如何开始使用

方式 1：在 Claude Code 中安装 Skill

# 安装 skill /skill install harmonyos-build-deploy 

安装后，Claude 就会在你提到鸿蒙编译、部署、hvigor、hdc 等关键词时自动激活这个 Skill。

方式 2：直接使用（无需 Skill）

即使不安装 Skill，你也可以在对话中引导 Claude 使用这个工具：

我的项目是鸿蒙应用，请使用 npx harmonyos-deploy 来帮我编译部署 

方式 3：项目级配置

在项目根目录创建 .claude/skills/ 文件夹，将 Skill 文件放入，Claude 会自动加载。

触发关键词

当你在对话中提到以下关键词时，Claude 会自动识别并使用 harmonyos-build-deploy：

• 鸿蒙、HarmonyOS、OpenHarmony
• 编译、构建、部署、安装
• hvigor、hvigorw、hdc
• HAP、HSP、HAR
• AppGallery、上架
• ohpm、hilog

Skill 的技术实现

零依赖设计

整个工具是一个约 1900 行的 Node.js 脚本，不依赖任何第三方 npm 包。这意味着：

• ✅ 无需 npm install
• ✅ 直接 npx 运行
• ✅ AI 可以立即使用

智能依赖解析

对于多模块项目，工具会：

1. 扫描所有 oh-package.json5
2. 解析 dependencies 字段
3. 构建依赖图
4. 拓扑排序得到正确的编译顺序

lushu_acommon (无依赖) ↓ lushu_appcommon (依赖 acommon) ↓ lushu_home, lushu_service... (依赖 acommon + appcommon) ↓ entry (HAP，最后编译) 

错误诊断

当编译或安装失败时，工具会分析错误并给出修复建议，AI 可以直接将这些信息呈现给你。

未来展望

更深度的 AI 集成

• 🔮 AI 直接修改代码后自动重新编译部署
• 🔮 AI 分析运行时日志，自动定位并修复 Bug
• 🔮 AI 根据测试结果自动优化性能

更完整的 DevOps 支持

• 🔮 自动化测试集成
• 🔮 多设备并行部署
• 🔮 版本管理和发布流程

开源地址

• GitHub: https://github.com/supermanaaaa/harmonyos-build-deploy
• npm: https://www.npmjs.com/package/harmonyos-deploy
• Claude Skills: 已提交至 anthropics/skills

总结

harmonyos-build-deploy 不仅仅是一个 CLI 工具，更是连接 AI 能力 和 鸿蒙开发 的桥梁。

它的存在让 Claude 能够：

• 理解鸿蒙项目的结构和构建流程
• 执行复杂的多模块编译
• 处理设备部署和调试
• 完成应用上架打包

而你只需要：

• 用自然语言描述需求
• 让 AI 帮你完成剩下的工作

这就是 AI Coding 时代的开发方式。