用途 该技能用于升级 Kokoro TTS 引擎。根据资料,它会升级 MLX-Audio 依赖、重新下载模型,并更新随附脚本。触发词为:upgrade kokoro、update tts、kokoro update、update mlx-audio。
主要能力 执行升级时,该技能会完成以下更新:
- Python 包:mlx-audio、soundfile、numpy
- 模型权重:从 mlx-community/Kokoro-82M-bf16 重新下载
- 随附脚本:从插件重新复制 kokoro_common.py 和 tts_generate.py
- version.json:以新版本重写
使用方式 工作流程分为三步。
第一步:升级前健康检查 PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}" bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health cat ~/.local/share/kokoro/version.json
第二步:执行升级 PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}" bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --upgrade
第三步:升级后验证 PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}" bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health cat ~/.local/share/kokoro/version.json
Test synthesis
~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_generate.py
--text "Upgrade verification" --voice af_heart --lang en-us --speed 1.0
--output /tmp/kokoro-upgrade-test.wav && echo "OK"
回滚 如果升级导致 TTS 损坏,可执行干净重装: PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}" bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --uninstall bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --install
模型缓存在卸载过程中会被保留,因此重装会复用已缓存的模型。
故障排查
- 升级失败:原因可能是无网络或 PyPI 不可用;解决方法是检查连接后重试。
- 升级后出现导入错误:原因可能是 mlx-audio 不兼容;解决方法是干净重装,先 --uninstall 再 --install。
- 模型下载缓慢:原因是下载体积较大;解决方法是等待 HuggingFace 下载完成。
自进化说明 该技能会随使用而改进。如果指令有误、参数发生漂移,或需要变通方案,应立即修复该文件,不要推迟。仅针对真实、可复现的问题进行更新。
执行后反思 技能完成后,在关闭任务前进行反思:定位自身(编辑前找到本 SKILL.md 的规范路径);什么失败了(修复导致失败的指令);什么比预期更好(提升为推荐实践);什么发生了漂移(修复任何不再符合现实的脚本、引用或依赖);记录日志(在 evolution-log 中记录触发条件、修复与证据)。不要推迟,下一次调用会继承你留下的一切。
适用场景 适用于需要升级 Kokoro TTS 引擎依赖与模型、更新 MLX-Audio 相关组件,或在升级后验证 TTS 合成是否正常的场景。
限制 资料未提供该技能支持的操作系统、Python 版本、硬件要求、收费或价格信息,暂未提供。