平台依赖
Android
- 相机权限:配对扫码时需要相机权限。
- APK 安装:从 GitHub Releases 下载安装。如系统提示,请允许安装未知来源应用。
Desktop(Linux AppImage)
优先从 GitHub Releases 下载 Airvoice-Desktop-*-Linux-x86_64.AppImage。AppImage 已打包 WebKitGTK,不需要系统安装 webkit2gtk-4.0 / webkit2gtk-4.1。
赋予可执行权限后运行:
chmod +x Airvoice-Desktop-*-Linux-x86_64.AppImage
./Airvoice-Desktop-*-Linux-x86_64.AppImage
使用 Desktop 或 CLI 时,剪贴板 / 模拟按键仍需要下方 X11 或 Wayland 工具。
macOS
- 辅助功能权限:运行二进制文件的终端应用需要辅助功能权限。
- 前往:系统设置 → 隐私与安全性 → 辅助功能。
- 添加并启用你的终端应用(如 Terminal、iTerm2、ghostty)。
Linux(X11)
需要 xclip 访问剪贴板,xdotool 模拟键盘输入:
sudo apt install xclip xdotool
Linux(Wayland)
需要 wl-clipboard 访问剪贴板。按键注入取决于合成器:
- Hyprland: 使用
hyprctl dispatch sendshortcut(不需要ydotool)。终端窗口会发送 Ctrl+Shift+V。 - 其他 Wayland: 需要
ydotool:
sudo apt install wl-clipboard ydotool
确保 ydotoold / ydotool 用户服务已启用并运行:
systemctl --user enable --now ydotoold
# Arch / Omarchy 常见为:
# systemctl --user enable --now ydotool.service
Windows
需要 Windows PowerShell 5.x(系统自带 powershell):
- 剪贴板:
Set-Clipboard(通过 PowerShell) - 按键:
WScript.ShellSendKeys 模拟 Ctrl+V(发送到当前前台窗口)
运行前请确保目标输入框已获得焦点。若按键注入失败,文本仍会写入剪贴板,可手动按 Ctrl+V。