用途:在 macOS(Apple Silicon)上单独升级 TTS + Telegram 机器人技术栈中的某个组件,而不重建整个系统。触发场景包括升级 Kokoro、更新模型、升级机器人依赖等。
主要能力:可升级四类组件——Kokoro TTS 引擎(kokoro-install.sh --upgrade,升级 Python 依赖、重新下载模型、更新 version.json)、机器人依赖(cd ~/.claude/automation/claude-telegram-sync && bun update)、tts_generate.py(从插件 scripts/ 重新复制到 ~/.local/share/kokoro/)、Bun 运行时(mise use bun@latest)。
使用方式:先选择组件,运行健康检查并记录当前版本(cat ~/.local/share/kokoro/version.json),执行对应升级命令,再次健康检查并生成测试音频验证,必要时重启机器人(pkill -f 'bun.*src/main.ts' || true,然后 cd ~/.claude/automation/claude-telegram-sync && bun --watch run src/main.ts)。
要求:已安装 uv(brew install uv)、已安装并配置 mise、可联网下载包、已有安装(否则先运行 full-stack-bootstrap)。
限制:平台限定 macOS(Apple Silicon);首次模型下载约 400MB;升级失败可能因无网络或 PyPI 问题;版本不匹配需重跑健康检查或升级;MLX-Audio 导入失败可通过升级重装 mlx-audio 解决;机器人升级后无法启动可执行 bun install。该技能为自进化技能,遇到可复现问题应直接修正本文件。