前言¶
文章、公衆號稿或筆記寫完後，若還要再錄一集口播，常見做法是單獨開 DAW、找主播或自己重錄。書面語和口播節奏往往對不上，人名、術語、數字的讀法也容易在錄音時才發現問題。下面介紹 SkillHub 上的 Agent Skill「播客配音·AI文字轉語音」，它把「改稿 → 定主播與讀音 → 合成 MP3」收進一套可複用的工作流，由 Agent 按 SKILL.md 引導執行，而不是讓你從零拼 API。
這是什麼¶
「播客配音·AI文字轉語音」是座標 @beatra-ai/ai-podcast-voiceover 的內容創作類 Skill（分類 content-creation，當前版本 0.2.2，來源標註爲 enterprise，發佈者 beatra）。它面向單人播客單集：先把用戶提供的文章、筆記、大綱或定稿整理成適合聆聽的腳本，明確讀音表與節目檔案，再經 Beatra 的文字轉語音能力生成自然口播，默認交付 MP3 單集音頻。
SkillHub 標籤標明 requires_api_key=true：實際運行時依賴 Beatra 側授權（設備令牌存放在本機 ~/.beatra/，見下文安裝與授權），遠程合成按字符計費，腳本準備與試聽查詢本身不收費。
核心功能¶
以下能力均來自官方簡介與包內 SKILL.md（0.2.2），不展開未在文檔中出現的接口細節。
-
節目檔案（show profile）
在工作目錄維護./<show>/show-profile.json，記錄聽衆、語言、固定開場/收尾、讀音表與交付約定，便於多集複用同一主播方向。 -
單集腳本化
將書面材料改爲口播結構（開場、正文章節、收尾），事實與觀點以用戶材料爲準；超長稿（超過 50,000 字符）按批准的主題或章節拆分，並在製作確認卡中列出每次付費調用。 -
主播與模型選擇
通過隨包 MCP 客戶端調用beatra.voices.list選就緒的voice_id，用beatra.models.list（capability: "text_to_speech"）覈對模型與 BCP-47 語言；默認model: "auto"、MP3、速度 1.0 等交付參數見 Skill 內「聲音、交付與恢復」參考文檔。 -
試聽與整集合成
新節目或音色/語言變更時，先做短試聽再出整集製作卡；每次beatra.speech.synthesize爲付費步驟，需用戶確認後的不透明client_request_id，禁止自動重試。可選配樂走獨立的beatra.music.generate確認卡。 -
任務與產物
所有遠程 Beatra 操作僅通過包內scripts/mcp_client.py執行（連接https://mcp.beatra.cn/mcp），用beatra.tasks.get輪詢至終態，交付音頻 URL、時長、MIME、用量等事實。 -
路由邊界
書稿/章節旁白、短視頻口播、多語言配音、自定義聲線等場景，Skill 文檔明確應交給同系列的其它 Beatra Skill，本包專注單主持、單集 TTS 交付。
安裝與啓用¶
SkillHub 官方安裝說明是：讓 Agent 按通用安裝文檔操作，並指明技能座標。
請根據 https://skillhub.cn/install/skillhub.md，安裝 @beatra-ai/ai-podcast-voiceover。
若本機已有 SkillHub CLI，可按安裝文檔第三節裝到當前 Agent 的 skills 目錄（須帶 --dir，否則默認 ./skills/ 可能不被識別）。Cursor 常用路徑示例：
skillhub install beatra-ai/ai-podcast-voiceover --dir ~/.cursor/skills/
也可從 SkillHub 頁面下載 Zip（0.2.2）後解壓到對應 skills 目錄：
https://api.skillhub.cn/api/v1/download?slug=@beatra-ai/ai-podcast-voiceover
安裝完成後，在 Skill 目錄內完成 Beatra 授權（Python 3.10+，僅用標準庫）：
python3 scripts/authorize.py
授權成功會輸出 Beatra is ready；令牌只寫入 ~/.beatra/credentials.json，不應出現在對話或日誌中。驗證連接可執行：
python3 scripts/mcp_client.py verify
Codex、Claude Code 等其它客戶端的 skills 路徑以 SkillHub 安裝文檔 第四節列表爲準；未在文檔列出的客戶端，請查閱其官方 skills 目錄說明，本文不臆測路徑。
典型用法¶
經過上面的安裝與授權，在 Cursor 等支持 Skills 的 Agent 中啓用本 Skill 後，可按文檔中的標準流程與 Agent 協作。下面是一條與 SKILL.md 一致的簡化路徑，便於復現理解（具體工具參數以包內 references/ 爲準）。
-
提供材料
給出文章、公衆號定稿、筆記或大綱，並說明這一集要給誰聽、希望聽衆帶走什麼；僅給主題而無正文時，Agent 會先索取材料。 -
批准腳本與讀音
Agent 按章節展示單集重點、口播稿與讀音表，等你批准後再進入音頻製作；若你只需要腳本，可在此步結束。 -
鎖定主播並（必要時）短試聽
Agent 列出候選音色與製作確認卡（含加權字符數、實時估價、每次合成的client_request_id）。方向變化時先聽短樣，再批准整集合成。 -
合成與交付
Agent 通過scripts/mcp_client.py提交已批准的合成請求，輪詢任務完成後交付 MP3 及元數據；若你允許寫入節目工作目錄，會同步記錄單集事實。
示例：向 Agent 發送的自然語言請求可以是：
用 @beatra-ai/ai-podcast-voiceover，把下面這篇公衆號定稿做成一集單人播客 MP3。
聽衆是熟悉行業的開發者；主播偏沉穩男聲；請先給口播稿和讀音表，我確認後再合成。
Agent 會在 Skill 約束下調用 Beatra MCP，而不是讓你手動配置宿主 Connector。
適用場景與注意¶
適合誰
- 文字轉播客、公衆號文章轉音頻、知識解說、新聞評論或個人欄目等單人口播單集。
- 需要固定主播音色、讀音表和多集節目檔案的連續更新欄目。
限制與注意
- 依賴 Beatra 賬號與設備授權； mainland 網絡下 MCP 連接可能有專門說明，見包內
references/mcp-connection.md。 beatra.speech.synthesize與配樂生成均爲付費調用，參數變更需新的client_request_id與確認卡，文檔禁止對付費請求自動重試。- 多主持混音、RSS 上架、專業母帶等不在本包交付範圍內；書稿旁白、短視頻口播等應按 Skill 文檔路由到其它 Beatra Skill。
- SkillHub 頁面顯示本 Skill 累計下載約 143847 次（數據隨平臺更新）；使用前請自行評估內容與合規風險。
結尾¶
「播客配音·AI文字轉語音」把播客單集製作拆成可審查的腳本階段與可計價的合成階段，並把 Beatra TTS 封裝進 Agent 工作流，適合已有文稿、希望穩定產出 MP3 單集的場景。官方入口與 Skill 包說明見：
- SkillHub 頁面：https://www.skillhub.cn/skills/beatra-ai/ai-podcast-voiceover
- API 座標頁：https://api.skillhub.cn/beatra-ai/ai-podcast-voiceover
