前言¶
在對話式開發環境裏，用戶常會希望 Agent「讀出來」或「用語音回答」，而不是隻返回一段文字。若每次都要自己接第三方 TTS 服務、寫腳本生成音頻再播放，流程會打斷對話節奏。Edge TTS 是 SkillHub 上的一條社區 Skill，把「文字轉語音」封裝成 Agent 可識別的能力：在合適意圖下由 Agent 加載 Skill 指引完成合成與播放相關操作，且標註爲不需要 API Key（requires_api_key=false）。
這是什麼¶
Edge TTS 的定位是 Edge TTS 語音合成工具。座標爲 @user_c9d52b8e/edge-tts-mf，版本 1.0.0，來源 community，分類 design-media，發佈者爲 user_c9d52b8e。官方 SkillHub 頁面：Edge TTS；線索中的 API 地址爲 https://api.skillhub.cn/user_c9d52b8e/edge-tts-mf。
它解決的是：在支持 Skills 的 Agent 中，用統一觸發條件把「讀出來、播放音頻、配置 TTS」等需求交給 Skill 處理，而不是在每次對話裏臨時拼湊方案。
核心功能¶
以下能力均來自 SkillHub 頁面與已抓取簡介，未展開 Skill 包內具體命令或配置項。
- 文字轉語音：面向 Edge TTS 路線的語音合成場景。
- 意圖觸發：當用戶要求文字轉語音、用 Edge TTS 說話、播放音頻、配置 TTS、安裝語音合成，或提到「讀出來」「語音回答」時，Agent 應觸發本 Skill。
- 免 API Key：標籤標明
requires_api_key=false，不依賴用戶另行配置 API Key（具體依賴仍以 Skill 內SKILL.md爲準）。
SkillHub 側統計（抓取時）：評分 100000，下載 1388，安裝 1。
安裝與啓用¶
Skill 遵循通用 SKILL.md 格式。安裝前需能使用 SkillHub CLI；若尚未安裝，可先按官方安裝文檔檢查環境。
1、安裝 SkillHub CLI¶
command -v skillhub && skillhub --version
未安裝時，可用官方腳本完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
說明與權限要求見：SkillHub 安裝與優先源配置。
2、安裝 Edge TTS Skill¶
安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。
skillhub install @user_c9d52b8e/edge-tts-mf --dir <skills 目錄>
也可將下面提示交給 AI，讓其按安裝文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_c9d52b8e/edge-tts-mf`。
3、各客戶端 skills 目錄（節選）¶
官方安裝文檔列出的常見路徑如下，請按你實際使用的客戶端選擇 <skills 目錄>：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後若 Agent 未立即識別新 Skill，需按你所用客戶端的說明重啓或刷新 Skills 目錄。
典型用法¶
公開頁面未提供可逐條複製的合成命令或配置字段；典型用法應理解爲 在對話中表達明確意圖，由 Agent 加載本 Skill 後執行。與官方簡介一致的觸發表述包括：
- 「把這段話讀出來」「用語音回答」
- 「用文字轉語音 / 用 Edge TTS 說話」
- 「播放這段內容的音頻」「幫我配置 TTS / 安裝語音合成」
經過上面的步驟安裝到正確 skills 目錄後，用上述自然語言發起請求即可；具體調用 edge-tts 或播放流程以 Skill 包內 SKILL.md 爲準，本文不臆造未公開的腳本參數。
適用場景與注意¶
適合誰：需要在 Cursor、Claude Code、Codex 等支持 Skills 的環境裏，偶爾或經常做 TTS、聽讀回覆的開發者；希望不配置 API Key 即可嘗試社區方案的用戶（以 Skill 標籤爲準）。
注意：
- 社區來源（
community），升級與維護節奏取決於發佈者，使用前可在 SkillHub 查看版本 1.0.0 與頁面說明。 - 安裝路徑錯誤是常見坑：務必
skillhub install ... --dir指向當前 Agent 的 skills 目錄。 - 沙箱或限網環境下安裝 CLI、拉取 Skill 可能需要允許聯網的權限。
- 語音效果、音色、離線能力等細節未在公開簡介中列出，以實際 Skill 文檔與運行環境爲準。
結尾¶
Edge TTS 把「讀出來、播放、TTS 配置」等意圖收斂到一條 design-media 類 Skill，便於在 Agent 對話中按需觸發，並標明無需 API Key。需要安裝或查看元數據時，可打開 SkillHub 頁面：https://www.skillhub.cn/skills/user_c9d52b8e/edge-tts-mf 。
