將 Fish Audio TTS 連接到 WorkBuddy

騰訊WorkBuddy可以透過自訂Skills呼叫外部API。使用 Fish Audio 技能從 WorkBuddy 任務產生 MP3 檔案。

此整合處於測試階段，因為 WorkBuddy 的技能匯入和權限 UI 可能會因桌面版本而異。不要在 設定→模型 下配置 Fish Audio：此畫面需要聊天模型端點，例如 /chat/completions，而不是 Fish Audio 語音端點。

開始之前

您需要：

帶有 API 積分的 Fish Audio API 鑰匙
Python 3.9 或更高版本可供 WorkBuddy 使用
技能運行本地腳本和存取網路的權限

為 WorkBuddy 建立專用的 API 金鑰，以便可以獨立監控和撤銷它。

下載技能

下載【Fish Audio TTS技能包】(/integrations/workbuddy/fish-audio-tts.zip)並解壓縮。軟體包包含 SKILL.md、skill.yml、Python 實作和自述文件。

WorkBuddy 版本目前使用下列安裝流程之一：

開啟技能，選擇匯入或本機技能操作，然後選擇解壓縮的資料夾。
如果您的版本不顯示匯入操作，請建立一個任務，要求 WorkBuddy 將提取的資料夾安裝為自訂技能。

在啟用技能之前，請檢查 WorkBuddy 顯示的檔案和權限。

設定憑證

在啟動WorkBuddy的環境中設定密鑰：

export FISH_AUDIO_BASE_URL="https://fishaudio.org/v1"
export FISH_AUDIO_API_KEY="YOUR_FISH_AUDIO_API_KEY"
export FISH_AUDIO_VOICE_ID="00a1b221-6137-4b73-ad62-b0cbce134167"
export FISH_AUDIO_MODEL="fishaudio-s21pro-flash"

在 macOS 上，終端機中設定的環境變數不會自動可供從 Finder 啟動的應用程式使用。遵循 WorkBuddy 版本的本地秘密或環境配置流程，或從包含這些變數的環境啟動應用程式。

切勿將 API 金鑰貼到 WorkBuddy 對話中或將其儲存在 Skill 資料夾中。

測試技能

啟動一個新的 WorkBuddy 任務並詢問：

Use the Fish Audio TTS Skill to create an MP3 file that says:
"Hello, this is a Fish Audio test."
Save it as fish-audio-test.mp3.

確認 WorkBuddy 報告輸出路徑並且 MP3 播放。然後將測試語音 ID 替換為您首選的 Fish Audio 語音 ID。

故障排除

未發現技能：確認提取的資料夾根目錄包含 SKILL.md，然後重新匯入或重新啟動 WorkBuddy。
Python 或終端權限被拒絕：僅啟用該技能所需的本機執行權限。
API 金鑰遺失：將 FISH_AUDIO_API_KEY 暴露給 WorkBuddy 進程；不要將其新增至技能檔。
401/402：更換 API 金鑰或新增 API 積分。
未建立 MP3：檢查任務輸出中的 HTTP 狀態和回應正文，並確認輸出目錄可寫入。

Beta 支援邊界

包含的腳本和 Fish Audio API 請求可獨立測試。確切的技能匯入畫面和秘密載入行為仍必須根據您使用的 WorkBuddy 桌面版本進行驗證。如果安裝失敗，請在聯絡支援時提供 WorkBuddy 版本、作業系統和可見錯誤訊息。

WorkBuddy 設定（測試版）