#安裝豆包說

豆包說是 Linux 桌面應用程式，適用於 Omarchy / Hyprland，也支援原生 X11。需要 Python 3.11 或更新版本，以及 GTK4、WebKitGTK、PipeWire 等系統元件。安裝程式會檢查 Arch / Omarchy 缺少的套件，列出清單後再詢問是否安裝。

#方式一：下載離線安裝包

前往 GitHub Releases，依處理器架構和 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. 選擇或錄製語音快捷鍵，再使用「試說」確認辨識結果。

完整的系統依賴、升級、解除安裝和疑難排解請參閱專案安裝說明。