Generate Protoss-style (StarCraft) voice effects using SoX and FFmpeg.

核心用法

Protoss Voice Effect 是一款基于命令行的音频后期处理工具，专为生成《星际争霸》神族（Protoss）风格的"卡拉"心灵共鸣音效而设计。用户通过运行 Python 脚本 protoss_fx.py 并传入音频文件路径，即可自动应用 V9 "Massive Void" 音效引擎，输出带 _psionic.mp3 后缀的处理文件。

典型工作流包括：使用 ElevenLabs 等 TTS 服务生成原始语音，然后通过本脚本进行后期处理，模拟赛兰蒂斯（Selendis）等神族角色的声效特征。

显著优点

• 专业化音效链：采用三段式处理架构——阴影生成（音高下调 + 时间拉伸）、虚空层（反向混响创造"预吸"效果）、母带处理（低频增强 + 超低频切除），形成标志性的"庞大虚无"空间感
• TTS 生态整合：明确设计为 ElevenLabs 等 TTS 服务的后处理环节，补全 AI 语音生成到角色化音效的最后一公里
• 轻量依赖：仅需 ffmpeg 和 sox 两个主流音频工具，通过 Homebrew 一键安装
• 自动化输出：自动在源目录生成命名规范的处理文件，无需手动指定输出路径

潜在缺点与局限性

• 破坏性处理：母带阶段直接丢弃原始干声，仅保留处理后的效果层，无法恢复原始音质
• 固定参数预设：音高(-2 semitones)、时间拉伸(0.9x)、低频增益(+5dB)等关键参数硬编码，缺乏用户可调接口
• 平台限制：依赖 macOS 生态的 Homebrew 包管理，Linux/Windows 用户需手动解决依赖
• 单一风格定位：高度特化的"神族"审美，难以迁移至其他科幻或奇幻声效场景

适合人群

• 《星际争霸》同人创作、角色扮演（RP）社区的语音内容制作者
• 播客、有声书创作者需要为 AI 角色添加差异化音色标识
• 游戏模组开发者为单位语音资源批量生成风格化处理
• TTS 重度用户寻求超出原生音效的后期加工方案

常规风险

• 音频质量损失：多阶段重采样和效果叠加可能引入 aliasing、动态范围压缩等问题
• 版权边界模糊：基于商业游戏 IP 的声效模仿，在公开发布时需注意合理使用范畴
• 依赖版本漂移：ffmpeg/sox 的更新可能导致命令行参数兼容性问题

核心用法

Protoss Voice Effect 是一款将普通语音转换为星际争霸星灵（Protoss）风格的音频处理工具。其核心工作流程分为三步：首先通过 TTS 工具生成原始语音，然后调用 Python 脚本对音频进行"Khala 灵能"特效处理，最后输出带有 _psionic 后缀的成品文件。用户只需运行 python3 skills/protoss-voice/protoss_fx.py <音频路径> 即可完成转换，无需复杂配置。

技术实现上采用三层音频处理链：Shadow Generation（降调+时间拉伸）、Void Layer（反向混响创造"预吸"效果）、以及 Mastering（低音增强+切除次声波）。这种架构刻意追求宏大、神秘的空间感，完全替换原始音色以达成标志性星灵语音效果。

显著优点

1. 零第三方依赖：仅使用 Python 标准库（subprocess/os/sys/shutil），供应链攻击面极小，安装即安全。
2. 硬编码安全：所有 ffmpeg/sox 命令参数固定，不拼接用户输入，从根本上杜绝命令注入风险。
3. ElevenLabs 工作流集成：专为 AI 语音生成后处理设计，可直接将现代 TTS 输出转换为游戏风格资产。
4. 自动清理机制：临时文件在 finally 块中强制清理，避免磁盘污染。
5. 本地纯离线处理：零网络请求，隐私数据零外泄。

潜在缺点与局限性

1. 外部工具依赖：必须预装 ffmpeg 和 sox，跨平台部署时需额外配置（macOS 需 Homebrew，Windows 需手动安装）。
2. 无输入验证：当前版本未检查文件存在性或格式合法性，传递错误路径会导致处理失败。
3. 临时文件实现方式：未使用 tempfile 标准模块，存在极低概率的文件名冲突风险。
4. 单向处理：完全丢弃原始音色，不适合需要保留原声的场景。
5. 参数固化：音效链固定，无法自定义调整混响深度、音调偏移等参数。

适合的目标群体

• 游戏内容创作者：为视频、播客、MOD 制作星灵风格语音素材
• AI 语音艺术实验者：探索 TTS 后处理与风格迁移的创作者
• 星际争霸社区：角色扮演、同人创作、解说配音等场景
• 音频技术学习者：研究 SoX 特效链与 FFmpeg 音频处理的教育用途

使用风险

1. 性能风险：音频处理涉及多次编解码转换，大文件或批量处理时 CPU 占用较高。
2. 依赖项风险：ffmpeg/sox 版本差异可能导致效果不一致，建议使用官方最新稳定版。
3. 文件覆盖风险：输出文件采用固定命名规则（*_psionic.mp3），重复处理同名文件将覆盖先前结果。
4. 无错误恢复：处理中断时可能残留不完整输出文件，需手动清理。