HDC 与 HarmonyOS NEXT 设备配置

HDC 是什么

HDC（HarmonyOS Debug Bridge）是华为 HarmonyOS NEXT 对应的设备调试工具，地位等同于 Android 上的 ADB。AutoGLM Phone Agent 框架同时支持 ADB 和 HDC，代码层面自动判断当前连接的设备类型。

下载安装

HDC 工具包含在 HarmonyOS SDK 的 toolchains 目录中。

下载地址：华为开发者官网 → HarmonyOS SDK
安装 SDK 后在 toolchains/ 目录下能找到 hdc 可执行文件

配置 PATH 与 ADB 同理，把 toolchains 目录加到系统环境变量。

手机端开启调试

HarmonyOS NEXT 的开发者选项路径：

设置 → 系统和更新 → 开发者选项

需要开启的选项：

USB 调试 — 基础调试开关
无线调试 — 如果要走 WiFi 连接（可选）

开发者模式本身的开启方式：设置 → 关于手机 → 版本号 连续点击 7 次。

用数据线连接验证

hdc list targets

正常输出设备 ID 字符串（如 7001005458323933328a01bce01c2500）。如果没有输出，检查 USB 调试是否开启、数据线是否支持数据传输。

AutoGLM 框架中的 HDC 用法

指定鸿蒙设备时，在命令行加 --device-type hdc：

python main.py --device-type hdc --base-url http://localhost:8000/v1 --model "autoglm-phone-9b" "打开微信发送消息"

鸿蒙与 Android 的差异点

方面	Android (ADB)	HarmonyOS NEXT (HDC)
文本输入	需要 ADB Keyboard	原生支持中文输入，无需额外 App
截图	`adb exec-out screencap -p`	`hdc shell snapshot_display -f /path/to/screenshot.png`
启动 App	`am start -n`	`aa start -a EntryAbility -b`
支持应用数	50+	60+（含鸿蒙原生应用 + 系统应用 + 华为服务）

支持的鸿蒙原生应用

AutoGLM 已验证覆盖的鸿蒙应用包括：微信、QQ、微博、飞书、淘宝、京东、美团、12306、高德地图、bilibili、抖音、QQ 音乐、小红书、知乎、今日头条、WPS、豆包、应用市场、天气等 60+ 款。运行 python main.py --device-type hdc --list-apps 查看完整列表。