最近给 cc-statistics 加了一个新功能——状态栏 Clawd 像素桌宠，能实时感知 Claude Code 的工作状态。写这篇文章分享一下实现思路，以及顺带介绍一下社区里一个很棒的桌面宠物项目。
一、状态栏动画：让 Claude 的工作状态可见
cc-statistics 是一个统计 AI coding 用量的本地工具，支持 Claude Code / Gemini CLI / Codex / Cursor。之前版本的状态栏只显示 Token 用量和费用，这次新增了 Clawd 像素宠物动画，能跟着 Claude Code 的实际状态切换动作。
状态栏左侧的小人就是 Clawd，右边显示当日费用（今天 $180，有点肉疼）。
二、动画状态是怎么来的？
核心机制是 Claude Code Hook 事件驱动。Claude Code 支持在工具调用前后注入 Hook，cc-statistics 通过监听这些事件来判断当前状态：
PreToolUse → Claude 正在执行工具调用 → active 动画
PostToolUse → 工具调用完成，等待下一步 → idle 动画
Stop → 会话结束 → sleeping 动画
Hook 配置写在 ~/.claude/settings.json 里：
{
"hooks": {
"PreToolUse": [{
"matcher": "",
"hooks": [{ "type": "command", "command": "node /path/to/ccstats-hook.js PreToolUse" }]
}],
"PostToolUse": [{
"matcher": "",
"hooks": [{ "type": "command", "command": "node /path/to/ccstats-hook.js PostToolUse" }]
}],
"Stop": [{
"matcher": "",
"hooks": [{ "type": "command", "command": "node /path/to/ccstats-hook.js Stop" }]
}]
}
}
ccstats-hook.js 是一个轻量脚本，把当前事件写入 ~/.cc-stats/activity-state.json。状态栏 Swift App 每 3 秒轮询这个文件，根据状态切换对应帧动画。整个链路完全本地，零延迟、零网络。
动画状态一共 3 种：
active：敲键盘，Claude 正在干活idle：等待输入，左右摇摆sleeping：会话结束，趴下睡觉
三、Clawd on Desk：感谢鹿鹿的开源项目
像素动画素材来自 clawd-on-desk，这是作者鹿鹿开发的一个 Electron 桌面宠物应用，专门为 AI coding agent 设计。
功能很齐全：
- 12 种动画状态，覆盖 AI coding 全流程
- 支持多 Agent：Claude Code / Codex / GitHub Copilot
- 迷你模式：缩成一个小点趴在角落，不打扰
- 权限审批气泡：Claude 请求高危权限时，桌宠会弹气泡提示
- 多 Agent 并发感知：同时跑多个 Agent 时，桌宠会切换到"加班"状态
cc-statistics 直接复用了 clawd-on-desk 的动画素材（MIT 协议），通过 Hook 事件驱动状态切换，把桌宠能力嵌入到了 macOS 状态栏。
四、Skill 调用统计
这次版本还新增了 Skill 调用统计，专门针对 Claude Code 的 slash command（/commit、/review 这类自定义命令）。
实现原理是解析 ~/.claude/projects/ 下的 JSONL 会话文件，找其中 tool_use 类型且 name == "Skill" 的调用记录，统计汇总后展示：
- 每个 Skill 的调用频次
- 成功率分布
- 一天内各时段的使用热力
五、安装
# pipx（隔离环境，推荐）
pipx install cc-statistics
# Homebrew（macOS / Linux）
brew install androidZzT/tap/cc-statistics
安装后启动状态栏：
cc-stats-app
首次启动会提示配置 Hook，按提示操作即可。
六、总结
这次更新的核心思路是：把 Claude Code 的内部状态外显出来，让人在专注写代码的时候，也能一眼感知 AI 在干什么。
状态栏桌宠是个小功能，但用起来还挺有意思的——看着小人敲键盘，莫名觉得它真的在帮你干活。
项目地址：
- cc-statistics：github.com/androidZzT/…
- Clawd on Desk：github.com/rullerzhou-…
欢迎 Star、Issue、PR。
