• 简体中文

    • 安装豆包说

    豆包说是 Linux 桌面应用，面向 Omarchy / Hyprland，也支持原生 X11。需要 Python 3.11 或更新版本，以及 GTK4、WebKitGTK、PipeWire 等系统组件。安装器会检查 Arch / Omarchy 缺少的系统包，列出清单后再请求安装。

    方式一：下载离线安装包

    前往 GitHub Releases，按 CPU 架构和 Python 版本选择 app（独立应用）或 plugin（Omarchy 插件）安装包。确认下载的压缩包与 SHA256SUMS 在同一目录，校验后解压：

    sha256sum -c SHA256SUMS --ignore-missing
./install.sh --check
./install.sh

    安装包包含匹配的 Python 依赖 wheel；GTK、WebKit、PipeWire 等系统库仍需由系统提供。

    方式二：从源码安装独立应用

    在 Arch / Omarchy 的桌面会话中运行：

    git clone https://github.com/quanru/doubao-say.git
cd doubao-say
./install.sh
./start.sh

    保留源码目录，桌面入口会指向它。其他发行版需要自行准备对应系统依赖。

    方式三：安装 Omarchy 插件

    插件和独立应用使用同一个语音引擎。请只选择一种安装方式；如果插件添加时提示启用，先跳过启用，完成安装及首次引导后再启用。

    omarchy plugin add https://github.com/quanru/doubao-say.git
cd "${XDG_CONFIG_HOME:-$HOME/.config}/omarchy/plugins/md.lifeos.doubao-say"
./install.sh
./start.sh

    完成首次引导并退出前台应用后，运行 omarchy plugin enable md.lifeos.doubao-say。

    第一次打开

    1. 选择豆包网页登录，或在设置中配置火山引擎 Seed ASR 2.0、Deepgram Nova-3（英语）的 API Key。
    2. 选择 PipeWire 麦克风，并运行三秒本机检测。
    3. 选择或录制语音快捷键，再用「试说」验证转写。

    完整的系统依赖、升级、卸载和故障排查请参阅项目安装说明。