快速开始

1. 下载 ADB

从 Android Developers 下载，或使用系统包管理器：

其他平台请参考 官方文档

将 ADB 添加到环境变量

下载并解压后，需要将 ADB 所在目录添加到系统环境变量 PATH 中，才能在终端中直接使用 adb 命令。

Windows：

1. 按下 Win+R，输入 sysdm.cpl 并回车，打开「系统属性」
2. 切换到「高级」选项卡，点击「环境变量」
3. 在「系统变量」中找到 Path 变量，双击编辑
4. 点击「新建」，输入 ADB 解压后的完整路径（例如 C:\platform-tools）
5. 点击「确定」保存所有窗口
6. 重新打开终端，输入 adb --version 验证配置是否成功

若使用 安装，ADB 会自动添加到环境变量，无需手动配置。

macOS / Linux：

如果通过包管理器安装，ADB 通常已自动加入 PATH。若手动解压，可将以下命令添加到 ~/.bashrc、~/.zshrc 或 ~/.profile 中：

export PATH=$PATH:/path/to/platform-tools

然后执行 source ~/.zshrc（或对应的配置文件）使其生效，最后运行 adb --version 验证。

2. 启用 USB 调试

以 OneUI 8 为例：

1. 进入「设置」> 「关于手机」
2. 点击「软件信息」，找到「编译编号」，点击 7 次以启用开发者选项
3. 返回「设置」> 「开发者选项」，启用「USB 调试」

3. 使用 USB 连接

请使用稳定的数据线，并确保桌面端和 Android 客户端都将连接模式切换为 USB。

4. 使用 Wi-Fi 连接

请确保 Android 设备与 PC 处于同一网络环境，并且桌面端和 Android 客户端都将连接模式切换为 Wi-Fi。

Android

1. 下载并安装 APK 到您的 Android 设备
2. 确保您的设备与 PC 处于同一网络（Wi-Fi 模式），或通过 USB 连接

Windows

1. 运行桌面端应用程序
2. 配置连接模式以匹配 Android 应用

macOS

为了获得更好的使用体验，建议通过 Homebrew 安装以下依赖：

brew install blackhole-2ch --cask
brew install switchaudio-osx --formulae

BlackHole 必须安装（虚拟音频驱动）。若未安装 Homebrew，请前往 https://existential.audio/blackhole/download/ 下载安装程序并安装。

完成后请重启您的 Mac。

在 社区下载页 下载应用并安装到“应用程序”目录后，首次启动可能会被 Gatekeeper 拦截。

• 若提示「不受信任的开发者」，请前往 「系统设置」/「系统偏好设置」 > 「隐私与安全」 允许应用运行。
• 若提示「应用已损坏」，请在终端执行：

sudo xattr -r -d com.apple.quarantine /Applications/MicYou.app

执行时需要输入您的用户账号密码，输入时密码不可见，完成后回车即可。

Linux

使用预编译包（推荐）

预编译包可在 社区下载页 下载。

DEB 包（适用于 Debian/Ubuntu/Mint 等发行版）：

# 从社区下载页获取 .deb 包
sudo dpkg -i MicYou-*.deb
# 如果缺少依赖：
sudo apt install -f

RPM 包（适用于 Fedora/RHEL/openSUSE 等发行版）：

# 从社区下载页获取 .rpm 包
sudo rpm -i MicYou-*.rpm
# 或者使用 dnf/yum：
sudo dnf install MicYou-*.rpm

AUR 仓库（适用于 Arch Linux 及其衍生发行版）：

# 克隆 AUR 仓库并自动安装软件包及其依赖
git clone https://aur.archlinux.org/micyou-bin.git
cd micyou-bin
makepkg -si

# 或者使用 paru 等 AUR helpers
paru -S micyou-bin

运行应用：

# 安装后可以从应用菜单运行 MicYou
# 或者从终端运行：
MicYou