麒麟os需通过waydroid运行安卓版hisuite或手动安装x86_64版.deb包，前提是系统为x86_64架构且版本≥kylin v10 sp3；arm64平台无官方支持方案。
麒麟OS系统默认不预装华为手机助手，且官方未提供直接适配的Linux版本；必须通过兼容层运行安卓版HiSuite移动端，或借助第三方工具链在x86_64架构下启动PC端HiSuite的Linux移植版。该方案仅适用于已确认为x86_64架构的麒麟OS V10 SP3及以上版本，ARM64平台暂无可行路径。
确认系统架构与基础环境
打开终端，执行：uname -m。若输出为x86_64，可继续；若为aarch64，则当前系统为ARM64，华为手机助手Linux版无法运行，本教程不再适用。
执行cat /etc/os-release | grep "Version"，确认系统版本不低于Kylin V10 SP3（即内核≥5.10，apt源可用）。低于此版本将无法安装Waydroid或满足HiSuite依赖要求。
方案一：用Waydroid运行安卓版HiSuite（推荐）
Waydroid是目前麒麟OS x86_64平台上最稳定、无需Root即可运行安卓应用的容器方案，实测可成功加载并推送安装HiSuite移动端，支持USB直连识别（需额外配置udev规则）。
第一步：添加Waydroid官方仓库并更新源
在终端中依次执行：
sudo apt install curl ca-certificates -y && curl https://repo.waydro.id | sudo bash
sudo apt update
第二步：安装Waydroid并初始化镜像
sudo apt install waydroid -y
执行sudo waydroid init，自动下载Android 11镜像（约1.2GB），期间请保持网络畅通。镜像校验失败会导致后续无法启动界面，此时需删掉/var/lib/waydroid/images重试。
第三步：启动容器并安装HiSuite APK
运行waydroid session start，等待图形界面弹出；打开Waydroid内置文件管理器，将从华为官网下载的HiSuite安卓版APK（版本号≥5.1.0.120，对应HarmonyOS 5+设备）拖入窗口完成安装。
第四步：启用USB调试与HDB连接授权
在Waydroid中打开已安装的HiSuite → 点击右上角“设置” → 开启“允许HiSuite通过HDB连接设备”；同时确保宿主机已开启开发者选项与USB调试（路径：设置 → 系统 → 开发者选项 → USB调试）。
一款AI工具，主要用于生成可直接复制粘贴的 Bash 脚本，用于 Ralph Wiggum/AI 代理循环（Codex、Claude Code、OpenCode、Goose）。适用于“拉尔夫循环”“Ralph Wiggum 循环”或 AI 循环请求，依据 PROMPT.md、AGENTS.md、SPECS、IMPLEMENTATION_PLAN.md 进行计划/构建，包含计划与构建模式、背压、沙箱及完成条件，适合需要提升相关任务效率的用户。
方案二：尝试安装HiSuite for Linux（仅限x86_64）
华为官方仅对统信UOS提供.deb格式HiSuite支持，麒麟OS虽同属Debian系，但部分依赖库路径和权限模型存在差异，安装后常出现hisuite-daemon无法启动、USB设备不可见等问题。仅建议有Linux运维经验的用户尝试。
方法一：手动安装官方.deb包
前往华为官网HiSuite下载页，选择标注“Linux (x86_64)”的最新版（如v16.0.0.120），下载后执行：
sudo dpkg -i hisuite_*.deb
若提示依赖错误，立即运行：
sudo apt --fix-broken install
方法二：配置USB识别权限（关键步骤）
创建udev规则文件：
sudo nano /etc/udev/rules.d/51-hisuite.rules
写入以下两行（覆盖华为全部USB厂商ID）：
SUBSYSTEM=="usb", ATTR{idVendor}=="12d1", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="0b05", MODE="0666", GROUP="plugdev"
保存后执行：sudo udevadm control --reload-rules && sudo udevadm trigger
方法三：启用守护进程
执行：sudo systemctl enable hisuite-daemon && sudo systemctl start hisuite-daemon
若提示“Unit hisuite-daemon.service not found”，说明安装包未注册该服务，需改用Waydroid方案。
连接手机并验证功能
使用原装USB线连接华为手机（HarmonyOS 5.0+），确保手机端已开启“USB调试”及“允许HiSuite通过HDB连接设备”。
在Waydroid中打开HiSuite，点击“连接设备”，输入手机端弹出的6位验证码；若显示设备型号并进入主界面，说明连接成功。此时可进行联系人同步、图片导出、备份密码设置等操作。
若电脑端HiSuite for Linux启动后始终显示“未检测到设备”，请检查udev规则是否生效（执行lsusb | grep 12d1应有输出）、手机USB连接模式是否为“传输文件”、以及hisuite-daemon服务是否处于active状态（systemctl status hisuite-daemon）。
