前言¶
做剧本杀、独立游戏或互动剧时，台词往往按角色和场次拆得很细。若用通用 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 。
