mcpField
A
augment

augment

github.com/terrylica开发139 次安装1 天前更新
代码仓库

关于 augment

augment 是维护 Kokoro TTS 插件的技能，可升级 MLX-Audio 依赖、重新下载模型权重并更新附带脚本。它还提供合成验证与回退步骤。

主要功能

  1. 01检查安装状态
  2. 02升级 Python 软件包
  3. 03重新下载模型权重
  4. 04更新附带脚本
  5. 05验证语音合成
  6. 06通过卸载重装回退

适用场景

  1. 01更新 Kokoro TTS 依赖和模型
  2. 02检查升级后的安装状态
  3. 03升级不兼容时恢复 TTS

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/terrylica/cc-skills --skill augment

安装后在 Claude Code 中输入/augment确认已加载。

详细介绍

增强 Kokoro TTS

升级 MLX-Audio 依赖项，重新下载模型，并更新捆绑脚本。

自我进化技能：此技能会在使用中不断改进。如果指令有误、参数发生偏差，或需要变通方法，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。

工作流

步骤 1：升级前健康检查
ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --health
cat ~/.local/share/kokoro/version.json
步骤 2：执行升级
ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --upgrade

此操作会升级：

  • Python 软件包：mlx-audio、soundfile、numpy
  • 模型权重：从 mlx-community/Kokoro-82M-bf16 重新下载
  • 捆绑脚本：从插件重新复制 kokoro_common.py 和 tts_generate.py
  • version.json：使用新版本重写
步骤 3：升级后验证
ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/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 无法使用，请执行全新安装：

ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --uninstall
bash "$ROOT/scripts/kokoro-install.sh" --install

卸载后会保留模型缓存，因此重新安装时会复用缓存的模型。

故障排除

问题原因解决方案
升级失败无网络或 PyPI 故障检查网络连接，然后重试
导入错误mlx-audio 不兼容全新安装：先执行 --uninstall，再执行 --install
模型下载缓慢下载内容较大等待 HuggingFace 下载完成

执行后反思

此技能执行完毕后，请在结束任务前进行反思：

  1. 确定位置。 — 找到此 SKILL.md 的规范路径，然后再进行编辑。
  2. 哪里出了问题？ — 修复导致问题的指令。
  3. 哪些地方比预期更好？ — 将其列为推荐做法。
  4. 哪些内容发生了偏差？ — 修复与实际情况不符的脚本、引用或依赖项。
  5. 记录下来。 — 添加进化日志条目，包含触发原因、修复内容和证据。

不要拖延。下一次调用会继承你留下的一切。

评论

支持 Markdown