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

核心用法

Protoss Voice Effect 是一款音频后处理工具，灵感源自《星际争霸》神族（Protoss）的"卡拉"灵能设定。它不生成语音，而是将现有音频（TTS生成或用户录音）通过FFmpeg与Sox工具链进行多层特效处理，输出带有空灵、回响、相位偏移特征的"灵能化"音效。

处理流程：

• 输入：任意格式音频（WAV/MP3/OGG等）
• 处理：通过protoss_fx.py脚本调用Sox效果器链（可能包含混响、延迟、频率移位、立体声扩展等）
• 输出：带_psionic.wav后缀的转换后文件

显著优点

1. 零生成成本：基于成熟音频处理工具，无需AI模型推理，本地执行速度快
2. 高度可组合：与Kokoro-TTS等任意语音合成工具无缝衔接，形成"生成→渲染"流水线
3. 角色沉浸感：为AI Agent扮演神族角色（如Selendis、Zeratul）提供标志性的声音特征
4. 格式兼容广：依托FFmpeg支持几乎所有主流音频格式

潜在局限与风险

• 黑盒处理逻辑：脚本内部效果链参数未文档化，用户难以自定义调整
• 依赖外部二进制：必须预装ffmpeg和sox，跨平台部署（尤其Windows）可能复杂
• 无实时处理能力：仅支持文件批处理，不支持流式/实时语音变换
• 音质损耗：多重效果叠加可能引入失真，尤其对低采样率输入敏感

适合人群

• 开发RPG/叙事类AI Agent的创作者
• 需要特定科幻音效风格的内容制作者
• 熟悉命令行音频处理的技术用户

常规风险提示

• 处理大文件时注意磁盘IO与临时空间占用
• 未明确标注输出音频的采样率/位深度规格，下游应用需额外验证

核心用法

Protoss Voice Effect 是一个纯本地的音频后处理 Skill，专为将普通语音转换为《星际争霸》Protoss（神族）风格的"Khala 灵能"音效而设计。它不生成语音，而是作为 TTS（如 kokoro-tts）或用户录音的后置特效层使用。

典型工作流程分为三步：首先通过 TTS 工具生成基础语音文件，或直接使用用户提供的录音；然后调用 protoss_fx.py 对音频进行"黑盒"处理，生成带有空灵、回响、金属质感等 Protoss 特征的音效；最后输出带 _psionic 后缀的 WAV 文件，可进一步压缩为 OGG 等格式用于即时通讯平台分享。

该 Skill 依赖 ffmpeg 和 sox 两个标准命令行工具，通过 Python 的 subprocess 模块调用，实现简洁、功能聚焦。

显著优点

1. 完全离线处理：不涉及任何网络请求、API 调用或数据传输，隐私风险极低，适合处理敏感内容。
2. 模块化设计：与语音生成功能解耦，可与任意 TTS 工具或录音文件组合，灵活性高。
3. 轻量实现：核心代码仅 139 行，无第三方 Python 依赖，仅使用标准库，维护成本低。
4. 跨场景适配：支持 WAV、MP3、OGG 等常见格式，输出可直接用于社交软件、游戏语音、播客后期等场景。
5. 自动清理机制：临时文件在处理完成后自动删除，减少磁盘占用。

潜在缺点与局限性

1. 外部命令依赖：必须预先安装 ffmpeg 和 sox，Windows 用户配置相对繁琐。
2. 输入路径安全风险：当前版本对用户提供的文件路径缺乏严格校验，特殊字符可能导致命令注入。
3. 异常中断残留：处理过程中若被强制终止，临时文件可能残留，需手动清理。
4. 音效风格固定：仅提供单一的"Massive Void"引擎预设，不支持自定义参数调节音效强度。
5. T3 来源可信度：由社区个人开发者维护，长期更新与技术支持存在不确定性。

适合的目标群体

• 游戏内容创作者：为直播、视频解说、播客添加角色化音效
• 桌游/TRPG 玩家：在线跑团时扮演 Protoss 角色，增强沉浸感
• AI 角色扮演开发者：构建星际争霸主题的智能体人格
• 音频实验爱好者：探索命令行音频处理链路的极客用户

使用风险

| 风险类型 | 说明 |

|---------|------|

| 命令注入 | 文件名含特殊字符（如分号、管道符）可能被解释为命令选项 |

| 临时文件残留 | 异常中断时 `.` 开头的隐藏临时文件可能残留 |

| 依赖缺失 | 未安装 ffmpeg/sox 时直接报错，建议在安装阶段完成校验 |

| 覆盖风险 | 输出文件与源文件同目录，命名冲突时会覆盖 |

建议用户在处理前确认输入文件名安全，避免以 - 开头的命名，并在关键任务后检查工作目录。