平台依赖

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.Shell SendKeys 模拟 Ctrl+V(发送到当前前台窗口)

运行前请确保目标输入框已获得焦点。若按键注入失败,文本仍会写入剪贴板,可手动按 Ctrl+V。