claudio

私人电台 DJ，跑在你自己的机器上。喊一声，他选歌、合成报幕、起 mpv，立刻返回不阻塞。

npm i -g @slicenfer/claudio
brew install mpv ffmpeg     # 系统依赖（缺了 claudio 会提示）

claudio init                # 选音乐源、填 key
claudio login               # 终端扫码登录
claudio import              # 拉我喜欢歌单（30-60s）
claudio install-skill       # （可选）让 Claude Code 自动用 claudio
claudio play "今天周一，写代码写吐了，来点能撑住的"

命令

| 命令 | 干嘛 | |---|---| | claudio play "<一句话>" | 一句话给 DJ，他出 3 首+报幕，起播放器 | | claudio play "<一句话>" -n 5 | 出 5 首 | | claudio play "<续杯>" | 已经在播：append 到当前队列，不重启 | | claudio next | 跳下一首 | | claudio stop | 关播放器 | | claudio status | 看现在在播什么、队列里还有啥 | | claudio lyrics -f | 跟着歌走显示当前歌词 |

播放器 detached，开了立即返回——你接着写代码，他在后台放。剩 1 首时自动续杯。

音乐源

claudio init 第一个问题选：

• netease（默认）：体验最好，cookie 永不过期、有逐首播放统计 → DJ 选歌画像最准
• qq：QQ 音乐，需要绿钻账号才能播大部分歌（非绿钻歌曲会自动 skip）；首次 play 会多 1-2 秒（启动本地 sidecar）

切源不丢数据：cookie 和 liked 都按源分文件存（~/.claudio/cookie.netease / cookie.qq / liked.netease.json / liked.qq.json）。

给 Claude Code / Codex 用

跑一下：

claudio install-skill

会装一份 skill 到 ~/.claude/skills/claudio/SKILL.md，让 agent 在 vibecoding 时自动调 claudio play——你说"换首"、"放点慢的"，它直接喊 DJ，不再问你。

状态

• 状态目录 ~/.claudio/：config.json、mpv.sock、mpv.log、state.json、memory.jsonl、tts/
• 想看 DJ 选歌的理由：tail -f ~/.claudio/memory.jsonl 里有 picks[].why

故障

• × 一首都没解析出可播链接 → cookie 过期，重 claudio login；QQ 用户也可能没绿钻
• 报幕不出声 → 装 ffmpeg
• × 没在播 但确实开过 → mpv 被 kill 了，claudio stop 清状态再重 play

License

MIT