WorkBuddy 接入教程（Beta）
安装 Beta 版 WorkBuddy Skill，通过 Kitta Audio API 生成 MP3 语音文件。
WorkBuddy 接入 Kitta Audio TTS
下载包保留
fish-audio-tts包名、Kitta Audio 显示名称和FISH_AUDIO_*兼容变量，不会随本站更名。下面显式设置的FISH_AUDIO_BASE_URL决定服务地址，请配合对应的 Kitta Audio 账户密钥使用。
腾讯 WorkBuddy 可以通过自定义 Skill 调用外部 API。安装 Kitta Audio Skill 后，就能在 WorkBuddy 任务中生成 MP3 文件。
当前集成标记为 Beta，因为不同 WorkBuddy 桌面版本的 Skill 导入和权限界面可能不同。不要在 设置 → 模型 中配置 Kitta Audio：该入口需要
/chat/completions等聊天模型接口，而不是 Kitta Audio 语音接口。
准备工作
你需要：
- 一个有 API 额度的 Kitta Audio API Key
- WorkBuddy 可以使用的 Python 3.9 或更高版本
- 允许该 Skill 执行本地脚本和访问网络
建议为 WorkBuddy 单独创建 API Key，以便独立查看用量和撤销权限。
下载 Skill
下载并解压 Kitta Audio TTS Skill 包。其中包含 SKILL.md、skill.yml、Python 实现和 README。
目前 WorkBuddy 版本通常使用以下一种安装方式：
- 打开 Skills，选择导入或本地 Skill，然后选择解压后的文件夹。
- 如果当前版本没有导入入口，新建任务并要求 WorkBuddy 把解压后的文件夹安装为自定义 Skill。
启用前请先检查包内文件和 WorkBuddy 展示的权限。
配置凭证
在启动 WorkBuddy 的环境中设置：
export FISH_AUDIO_BASE_URL="https://fishaudio.org/v1"
export FISH_AUDIO_API_KEY="YOUR_FISH_AUDIO_API_KEY"
export FISH_AUDIO_VOICE_ID="00a1b221-6137-4b73-ad62-b0cbce134167"
export FISH_AUDIO_MODEL="fishaudio-s21pro-flash"在 macOS 中，从终端设置的环境变量不会自动传给从 Finder 启动的应用。请使用当前 WorkBuddy 版本提供的本地密钥或环境配置方式，或者从包含这些变量的环境启动应用。
不要把 API Key 粘贴到 WorkBuddy 对话中，也不要写进 Skill 文件夹。
测试 Skill
新建 WorkBuddy 任务并输入：
请使用 Kitta Audio TTS Skill 生成一个 MP3 文件，内容是：
“你好，这是一条 Kitta Audio 测试语音。”
保存为 fish-audio-test.mp3。确认 WorkBuddy 返回输出路径，并且 MP3 可以播放。之后可以把测试音色替换成自己的 Kitta Audio 音色 ID。
常见问题
- 没有发现 Skill：确认解压目录根部存在
SKILL.md，然后重新导入或重启 WorkBuddy。 - Python 或终端权限被拒绝：只开启该 Skill 运行本地脚本所需的权限。
- 提示缺少 API Key：让 WorkBuddy 进程读取
FISH_AUDIO_API_KEY，不要把 Key 写进 Skill 文件。 - 401/402：更换 API Key 或补充 API 额度。
- 没有生成 MP3：查看任务输出中的 HTTP 状态和响应内容，并确认输出目录可写。
Beta 支持边界
包内脚本和 Kitta Audio API 请求可以独立测试；具体 Skill 导入界面和密钥加载方式仍需以所用 WorkBuddy 桌面版本为准。若安装失败，反馈时请同时提供 WorkBuddy 版本、操作系统和可见错误信息。