你构建的 HAP，一键签名装真机。
纯血鸿蒙把 HAP 装到真机、送上架，能卡你一下午——华为账号、UDID、配额、证书链、system 权限报错，一步错就装不上。面向鸿蒙应用开发者，HapLane 把这七步折成一条命令：真机调试一键签装，也走华为邀测 / AppGallery 上架这条干净发布轨。想接 CI、让 AI agent 跑也行。
挂进你的 AI，用说的：「把这个 HAP 装到手机上」。
HapLane 是 MCP 工具——不用背命令，agent 自己选工具、撞错自己修。粘一段配置就接上，支持任意 MCP 客户端。
需 Node ≥ 18（做鸿蒙开发一般都有，hvigor 就依赖它）。更想命令行直接用？往下看。
一条 deploy 搞定，也能拆成四步。
不挂 MCP、想手动跑也行。deploy 一条龙：签名 + 装机 + 验签。只想签名、或只想推包？拆开单独调那一步就行。
| 命令 | 做什么 | 要连设备？ |
|---|---|---|
haplane deploy --in app.hap | 签名 → 装机 → 验签，一条龙（带 --in 跳过打包） | 要（装机那步） |
haplane deploy | 从源码工程全链：hvigorw 打包 → 签名 → 装机 → 验签 | 要 |
haplane sign --in app.hap | 只签名，产出签好的 HAP | 上架 / CI 不用；debug 真机连一次取 UDID |
haplane install --in app.hap | 只推已签好的包（≈更聪明的 hdc install） | 要 |
haplane verify --in app.hap | 只验签名，判真假 | 不用 |
haplane setup / doctor / device | 生成配置 / 体检工具链 / 列设备取 UDID | device 要 |
签名墙不是难，是"烦"——每一步都能卡你半天。
HoKit、小白助手是把这些步骤塞进界面里一个个点；HapLane 是一条命令跑完，还能写进脚本、让 AI 帮你跑。
⚠ 手动部署一个 HAP 到真机
- 01开发者模式 + USB/无线调试 + 手机弹窗授权
- 02hdc 连真机，取 UDID
- 03AGC 注册设备、申请 debug 证书（配额 2 本/年）
- 04申请 Profile，绑死 bundleName + UDID
- 05包名被占？逐用户改名
- 06hap-sign-tool 签名（路径不能有中文）
- 07装机 → system 权限报错 → 卡住
✓ HapLane
✓ 已装上设备 · 6.2s
连设备 + 一条命令。UDID、包名、证书材料、system 权限降级——全自动，不用你填。证书到期自动重签。这套骨架已在模拟器五步全绿实测（hdc→sign→install→verify），也支持接 AGC 走邀测 / 上架。
别人给你一句"AI 分析中"，HapLane 直接把它装上。
侧载站那些"AI 助手"多是网页套壳——给你一句分类建议就完了。HapLane 是真能跑签名、部署、诊断的命令行工具，不是网页上点一下看个热闹。
- →丢一个装不上的 HAP，它真诊断：包名被占？覆盖装撞
9568332（签名不一致）？system 权限不够？ - →system 权限报错自动降级——竞品都卡在这个通用坑，我们把它做成自动重装。
- →签名走你自己的 AGC 材料适配器，不凭空造信任。
订阅官方源,一条命令装上。
HapLane 是中性工具,自身不放任何包;内容来自你订阅的源(默认订阅这个官方开源源,可退订)。条目只索引上游权利人官方发布位——不托管、不转存,装机时从上游拉取 + sha256 校验。全部开源、license 白名单、不收破解魔改。对 agent 说一句话,或 npx -y haplane deploy --app <id>;也可 haplane source add 加你自己的源。
加载应用列表…
完整列表 → haplane-registry · 投稿你的开源应用 → 填「投稿」表单（机器人自动机检 + 开 PR，合并即上站）
解析、投屏都有人做了。命令行签名部署这块，交给 HapLane。
HapViewer 看包强、HoKit 有投屏 GUI、DevEco Code 是华为的 IDE 助手，各有各的用处。你要在终端里、在脚本和 CI 里、让 AI 帮你签名装机——这正是 HapLane 的活。
| 能力 | HapLane | DevEco Code | HoKit | HapViewer |
|---|---|---|---|---|
| 接任意 MCP agent | ✓ | 仅自家 | — | — |
| 无头 CLI（无 GUI） | ✓ | — | — | — |
| CI 流水线集成 | ✓ | — | — | — |
| system 权限自动降级 | ✓ | — | — | — |
| 穿戴大包推送 | ✓ | — | — | — |
| HAP 深度解析 | 基础 | ✓ | 基础 | ✓ |
| 投屏 / 消费级 GUI | — | — | ✓ | — |
| 开源免费 | 开源可查·MIT | — | 闭源免费 | ✓ |
签名的坑大多集中在这三处。HapLane 讲清楚，也替你处理掉。
下面这三样，是真机调试和上架时最容易卡半天的地方。
华为三层认证，一次讲明白
寄生会话 / cookie 会话 / 机器密钥（client_credentials）该用哪个？配额墙、包名全局占用（装 B站撞过 205339064 吧？）怎么绕？文档讲透，不用自己猜。
system 权限报错，自动降级
装 system 应用几乎都会撞权限报错。HapLane 自动把 apl 降到能装的档再重装，不用你手改配置。
穿戴大包也能推
watch 表盘、5MB 以上的大包推送——别的工具容易卡在这，HapLane 单独处理这条路。
它不做什么，和你需要准备什么。
签名这件事，本来就该在你有权限的范围内做。HapLane 不碰灰色地带，也不藏着前提。
不做
- 不破解、不绕过签名——只帮你把该走的流程走顺
- 只处理你自己或已授权的设备 / 账号
- 不碰纯血鸿蒙真机的商用根：真机走你自己的 AGC 材料
前提
- 华为开发者账号 + AGC（真机 / 上架签名要）
- 华为 SDK：hdc / hap-sign-tool / java（各平台官方版都有）
- Node（或用单文件二进制）；macOS / Windows / Linux 都行
装上，跑第一条命令。卡住了就来问。
一行装全局：npm i -g haplane，装完直接有 haplane 命令；连装都不想装就 npx -y haplane deploy … 直接跑。国内 npm 慢，把 registry 设成 npmmirror，或下 Gitee Release 单文件（node haplane.mjs，免 npm）。需 Node ≥ 18。签名踩坑、穿戴推送、AGC 配额，开 Issue 一起解。
签名 / 部署 / RN 移植，进群一起解
鸿蒙 HAP 开发者互助群。签名卡配额、部署跑不通、RN 应用上鸿蒙——贴报错、贴命令，一起搭手。不做资源分发，只解决真问题。
扫码或点按钮加入 · QQ 群号 897559316 · 审核制