前言¶
做劇本殺、獨立遊戲或互動劇時，臺詞往往按角色和場次拆得很細。若用通用 TTS 逐句生成，容易出現同一角色音色前後不一致、文件命名與劇本順序對不上、導入引擎或桌面劇場時要手工對錶等問題。下面介紹 SkillHub 上的 劇本殺配音·遊戲語音包（@beatra-ai/game-script-voice-pack）：在 Agent 側按 Skill 流程，把完整劇本做成帶角色編號的多角色語音包，並儘量把元數據（角色 ID、臺詞編號）和劇本順序對齊，減輕後期導入成本。
這是什麼¶
劇本殺配音·遊戲語音包 是發佈在 SkillHub 上的一條 design-media 類 Skill，座標 @beatra-ai/game-script-voice-pack，當前版本 v0.1.8，來源標註爲 enterprise，由發佈者 beatra 維護。
一句話定位：把劇本殺或獨立遊戲劇本做成 帶角色編號的多角色語音包——爲每個角色固定一把聲音，按劇本順序生成每一句臺詞，並附帶 角色 ID 與 臺詞編號，便於導入遊戲引擎或桌面劇場類工具。
官方頁面與資源地址：
- SkillHub 展示頁：https://www.skillhub.cn/skills/beatra-ai/game-script-voice-pack
- API 資源入口：https://api.skillhub.cn/beatra-ai/game-script-voice-pack
頁面標籤標明 requires_api_key=false，即不依賴額外 API Key 配置（以 SkillHub 頁面說明爲準）。
核心功能¶
以下能力均來自 SkillHub 官方簡介與頁面說明，不展開未在資料中出現的實現細節。
-
多角色、固定音色
爲劇本中的每個角色綁定固定聲音，避免同角色在多段對白裏音色漂移。 -
按劇本順序生成
按劇本行文順序處理每一句臺詞，輸出順序與閱讀/演出順序一致，便於對照原稿。 -
結構化元數據
生成結果攜帶 角色 ID 與 臺詞編號，方便與劇本條目一一對應，而不是僅靠文件名猜角色。 -
面向導入場景
目標用途包括導入 遊戲引擎 或 桌面劇場 等需要批量對白資源的流程。
適用方向（官方列舉）：劇本殺配音、獨立遊戲配音、多角色配音、NPC 配音、互動劇配音、對白配音、角色語音包、劇本配音、情景訓練音頻等。
安裝與啓用¶
SkillHub 頁面給出的安裝指引是：先按 SkillHub 安裝與優先源配置 準備 skillhub CLI，再安裝本 Skill。
1、檢查或安裝 skillhub CLI¶
command -v skillhub && skillhub --version
若未安裝，可使用官方文檔中的完整安裝命令（需聯網）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安裝到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被 Agent 加載。官方文檔給出的常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
以 Cursor 爲例，安裝命令形如：
skillhub install @beatra-ai/game-script-voice-pack --dir ~/.cursor/skills/
也可將安裝提示直接發給已接入 SkillHub 的 AI，按頁面原文：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@beatra-ai/game-script-voice-pack`。
安裝完成後，按你所用客戶端的要求 重啓或刷新 Agent，使 SKILL.md 被加載。
典型用法¶
資料中未提供單獨的示例倉庫或配置文件名；可復現的流程可以概括爲「裝 Skill → 在對話中交給 Agent 按 Skill 執行」。
-
準備劇本文本
整理出角色列表與各角色臺詞，順序與正式演出稿一致。角色在劇本中應有穩定標識（便於對應後來的角色 ID）。 -
在已啓用該 Skill 的會話中說明目標
明確需要「多角色語音包」、要保留 角色 ID / 臺詞編號、以及最終要導入的環境（例如某引擎或桌面劇場）。由 Agent 讀取@beatra-ai/game-script-voice-pack的SKILL.md完成分角色選音、按序生成與打包說明。 -
按輸出清單驗收
覈對：同一角色音色是否一致、文件或清單順序是否與劇本一致、每條是否帶有可映射到劇本的角色 ID 與臺詞編號。
若需確認最新步驟或字段定義，以安裝目錄內該 Skill 的 SKILL.md 與 SkillHub 頁面 v0.1.8 說明爲準。
適用場景與注意¶
適合誰
- 需要爲劇本殺、獨立遊戲、互動劇批量做多角色對白，且後續要導入引擎或劇場工具的團隊或個人。
- 希望減少「手工對臺詞表、手工重命名音頻」時間的創作者。
使用上需注意
- 安裝路徑必須對：務必
--dir到當前 Agent 的 skills 目錄（見上文官方路徑表）。 - 資料未列出具體音頻格式、目錄樹或引擎插件接口；導入前請在目標工具文檔中與 Skill 輸出字段對齊。
- SkillHub 統計（以抓取資料爲準）：分類 design-media，評分 100000，下載 5344；頁面標籤 requires_api_key=false。指標會隨 SkillHub 更新變化，以安裝時頁面爲準。
結尾¶
劇本殺配音·遊戲語音包 解決的是「多角色劇本 → 可導入、可對錶的多角色語音包」這一環：固定角色音色、按序出句、帶上角色 ID 與臺詞編號。若你正在做劇本殺或遊戲向的對白資源，可從 SkillHub 安裝 @beatra-ai/game-script-voice-pack（v0.1.8），官方入口：https://api.skillhub.cn/beatra-ai/game-script-voice-pack ，展示頁：https://www.skillhub.cn/skills/beatra-ai/game-script-voice-pack 。
