Hadice Vibe 项目

项目简介

Hadice 是由货拉拉（HuolalaTech）开源的跨平台桌面端调试工具，专门为鸿蒙（HarmonyOS Next）与安卓（Android）开发者打造。它基于 Wails v3 框架构建，把原本散落在命令行、多个脚本与第三方工具里的移动端调试能力，整合进一个统一的图形界面。开发者只需通过 USB 或无线调试连接手机，就能在电脑端完成性能监控、应用管理、文件互传、投屏录屏、网络抓包乃至 AI 自动化操作，覆盖日常开发调试中绝大多数高频场景。官方表示 iOS 平台支持正在逐步实现中。

核心功能

• 设备总览：集中展示电池、CPU、内存、存储与系统信息，快速掌握设备状态。
• 性能监控：提供 CPU、内存、网络与帧率曲线，支持数据导出，便于定位卡顿与内存泄漏。
• 进程管理：按 CPU / 内存占用排序，支持搜索并结束进程。
• 应用管理：启动、停止、卸载应用，并清理应用数据。
• 应用安装：支持拖拽或选择 APK / HAP 文件快速安装。
• 投屏截屏：实时镜像设备画面，支持截图、录屏与历史记录管理。
• 文件传输：设备与电脑双向互传，支持批量队列。
• 系统日志：实时查看 hilog / logcat，支持过滤与保存。
• 网络抓包：鸿蒙与安卓双平台抓包，支持详情预览、Mock 与导出。
• 终端命令：内置 HDC / ADB Shell 与本地终端。
• AI 自动化：基于视觉与指令驱动设备完成自动化操作。

技术实现

Hadice 采用 Go 语言配合 Wails v3 构建桌面应用，前端使用 Node.js 生态（建议 Node 20+），通过 USB / 无线调试协议与设备通信。项目在实现上做了平台抽象分层，把鸿蒙与安卓的差异隔离在底层适配层，上层界面保持统一。编译安卓抓包 Agent 时需要 Android NDK（推荐 25.2.9519653）与 JDK 配合。构建任务统一由 Task（taskfile.dev）驱动，同时提供 task build、task build:agent 等命令，方便开发者按需打包。整个应用支持将每个功能菜单单独拆分为独立窗口，便于多屏并行调试。

快速上手

1. 开启手机开发者模式：鸿蒙手机进入「设置 > 关于本机 > 软件版本」连续点击 7 次，再进入「设置 > 系统 > 开发者选项」启用开发者选项与 USB 调试；安卓手机则在「设置 > 关于手机」连续点击版本号 7 次后启用 USB 调试。
2. 用 USB 数据线将手机连接至电脑。
3. 点击程序右上角的刷新图标，并在手机上确认「允许此电脑调试设备」；若连接异常，可使用「连接诊断」排查。
4. 从 GitHub Releases 下载对应平台安装包：macOS 用户安装 dmg 后，需在终端执行 sudo xattr -dr com.apple.quarantine /Applications/Hadice.app 解除隔离；Windows 用户按向导安装，遇到 SmartScreen 提示选择「仍要运行」。
5. 按需打开各功能模块，每个菜单右侧均带帮助按钮，可查看详细说明。

适用人群

• 鸿蒙与安卓应用开发者，需要一款统一的桌面调试面板。
• 移动端测试工程师，做性能压测、抓包与日志分析。
• 需要频繁录屏、投屏演示移动端效果的产品与设计人员。
• 关注移动端自动化与 AI 视觉操作能力的工程团队。

项目信息

• 项目地址：https://github.com/HuolalaTech/hadice
• 出品方：货拉拉（HuolalaTech）
• 技术栈：Go + Wails v3 + Node.js
• 许可与平台：开源项目，支持 macOS 与 Windows