health

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

TTS Telegram Sync Health Check

TTS Telegram 同步健康检查

Run 10 subsystem health checks to verify the full TTS + bot stack.

运行10项子系统健康检查，验证完整的TTS + 机器人技术栈是否正常。

Checks

检查项


pgrep -la 'bun.*src/main.ts'
curl -s "https://api.telegram.org/bot${BOT_TOKEN}/getMe" | jq .ok
[[ -d ~/.local/share/kokoro/.venv ]]
~/.local/share/kokoro/.venv/bin/python -c "import kokoro"
python -c "import torch; assert torch.backends.mps.is_available()"
/tmp/kokoro-tts.lock
pgrep -x afplay
[[ -f ~/.claude/.secrets/ccterrybot-telegram ]]
find /tmp -name "kokoro-tts-*.wav" -mmin +5
[[ -L ~/.local/bin/tts_kokoro.sh ]]

#	Check	Command
1	Bot process	`pgrep -la 'bun.*src/main.ts'`
2	Telegram API	`curl -s "https://api.telegram.org/bot${BOT_TOKEN}/getMe" \| jq .ok`
3	Kokoro venv	`[[ -d ~/.local/share/kokoro/.venv ]]`
4	Kokoro import	`~/.local/share/kokoro/.venv/bin/python -c "import kokoro"`
5	MPS available	`python -c "import torch; assert torch.backends.mps.is_available()"`
6	Lock state	Check `/tmp/kokoro-tts.lock` mtime and PID
7	Audio processes	`pgrep -x afplay` / `pgrep -x say`
8	Secrets file	`[[ -f ~/.claude/.secrets/ccterrybot-telegram ]]`
9	Stale WAVs	`find /tmp -name "kokoro-tts-*.wav" -mmin +5`
10	Shell symlinks	`[[ -L ~/.local/bin/tts_kokoro.sh ]]`


pgrep -la 'bun.*src/main.ts'
curl -s "https://api.telegram.org/bot${BOT_TOKEN}/getMe" | jq .ok
[[ -d ~/.local/share/kokoro/.venv ]]
~/.local/share/kokoro/.venv/bin/python -c "import kokoro"
python -c "import torch; assert torch.backends.mps.is_available()"
/tmp/kokoro-tts.lock
pgrep -x afplay
[[ -f ~/.claude/.secrets/ccterrybot-telegram ]]
find /tmp -name "kokoro-tts-*.wav" -mmin +5
[[ -L ~/.local/bin/tts_kokoro.sh ]]

#	检查项	命令
1	机器人进程	`pgrep -la 'bun.*src/main.ts'`
2	Telegram API	`curl -s "https://api.telegram.org/bot${BOT_TOKEN}/getMe" \| jq .ok`
3	Kokoro虚拟环境	`[[ -d ~/.local/share/kokoro/.venv ]]`
4	Kokoro导入验证	`~/.local/share/kokoro/.venv/bin/python -c "import kokoro"`
5	MPS可用性	`python -c "import torch; assert torch.backends.mps.is_available()"`
6	锁状态	检查 `/tmp/kokoro-tts.lock` 修改时间和PID
7	音频进程	`pgrep -x afplay` / `pgrep -x say`
8	密钥文件	`[[ -f ~/.claude/.secrets/ccterrybot-telegram ]]`
9	过期WAV文件	`find /tmp -name "kokoro-tts-*.wav" -mmin +5`
10	Shell软链接	`[[ -L ~/.local/bin/tts_kokoro.sh ]]`

Execution

执行方式

Quick Health Check

快速健康检查

bash

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/tts-telegram-sync}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health

bash

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/tts-telegram-sync}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health

Full Stack Check

全栈检查

Run all 10 checks and display results as

[OK]

[FAIL]

table. For each failure, suggest the appropriate skill to fix it:

Failure	Recommended Skill
Bot not running	bot-process-control
Kokoro issues	full-stack-bootstrap
Lock stuck	diagnostic-issue-resolver
Secrets missing	full-stack-bootstrap
Symlinks broken	full-stack-bootstrap

运行全部10项检查，并以

[OK]

[FAIL]

表格形式展示结果。每一项检查失败时，会推荐对应的skill进行修复：

失败项	推荐Skill
机器人未运行	bot-process-control
Kokoro异常	full-stack-bootstrap
锁卡住	diagnostic-issue-resolver
密钥缺失	full-stack-bootstrap
软链接损坏	full-stack-bootstrap

Troubleshooting

故障排查

Issue	Cause	Solution
All checks fail	Not set up yet	Run `/tts-telegram-sync:setup` first
Only Kokoro fails	Venv corrupted	`kokoro-install.sh --uninstall` then `--install`
Lock stuck	Heartbeat died	See diagnostic-issue-resolver skill

问题	原因	解决方案
全部检查失败	尚未完成配置	先运行 `/tts-telegram-sync:setup`
仅Kokoro检查失败	虚拟环境损坏	执行 `kokoro-install.sh --uninstall` 后再执行 `--install`
锁卡住	心跳中断	参考diagnostic-issue-resolver skill