看懂 Clawd on Desk 的 12 种动画状态：桌面宠物是怎么知道你的 AI Agent 在干什么的？

看懂 Clawd on Desk 的 12 种动画状态桌面宠物是怎么知道你的 AI Agent 在干什么的【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-deskClawd on Desk 是一款像素风桌面宠物它能实时感知 Claude Code、Codex、Cursor 等 AI Agent 正在运行、思考还是报错并用12 种动画状态把「Agent 在干什么」变成看得见的画面。这篇文章用一张速查表带你看懂每一种状态并讲清楚背后的 Hook 事件流和状态优先级机制帮助新手快速上手这款 AI Agent 状态监视器。桌面宠物凭什么「知道」Agent 在忙Clawd on Desk 的感知能力来自各 AI Agent 自带的Hook 机制整条链路可以概括为一句话Agent 触发生命周期事件 → Hook 脚本读取事件 → 上报到本地端口 → 状态机裁决 → 渲染对应动画以 Claude Code 为例Agent 在执行提问、调用工具、完成回答等节点触发事件如UserPromptSubmit、PreToolUse、Stop安装时注册的 Hook 脚本如 hooks/clawd-hook.js从标准输入读取事件 JSON通过 HTTP 上报到本机127.0.0.1:23333/state内置状态机 src/state.js 做多会话追踪 优先级裁决渲染进程切换动画素材你看到螃蟹开始「打字」各 Agent 的事件 → 状态映射规则不同比如 Kimi、ZCode、Pi 各有独立事件表完整对照见官方文档docs/guides/state-mapping.zh-CN.md。12 种动画状态速查表每个状态什么时候出现内置 Clawd像素螃蟹主题的 12 种状态如下触发事件对应 Agent 生命周期节点#状态由什么触发你会看到1待机无活动任务眼球跟随鼠标、呼吸眨眼偶尔随机看书或巡逻 2思考提交提问UserPromptSubmit头顶思考泡泡 灵感闪光3打字工具运行中1 个会话疯狂打字4耳机律动2 个会话并行工作戴上耳机跟着节奏晃动5建造3 个以上会话并行建造中的忙碌姿态6三球杂耍2 个以上子代理并行SubagentStart抛接三球1 个子代理时为耳机律动变体7报错工具执行失败PostToolUseFailure报错姿态8开心任务完成Stop / PostCompact开心庆祝9通知权限请求PermissionRequest警报 弹出可点击的审批气泡10扫地上下文压缩前PreCompact扫地动画11搬运创建 WorktreeWorktreeCreate搬箱子12睡觉鼠标 60 秒无活动打哈欠 → 打盹 → 倒下睡觉动一下鼠标立即惊醒 注意细节第 9 种「通知」状态不只是动画——Clawd 会同时弹出权限审批气泡你可以直接在桌面上点「允许 / 拒绝」或用全局快捷键CtrlShiftY允许、CtrlShiftN拒绝不用切回终端。多会话并行时谁的画面说了算当你同时开多个 Agent 会话各会话会处于不同状态。Clawd 的状态机src/state-priority.js按优先级取「最高级」的状态来显示报错(8) 通知(7) 扫地(6) 开心(5) 搬运/杂耍(4) 工作(3) 思考(2) 待机(1) 睡觉(0)另外两个防「闪切」的设计最小显示时长每个状态至少显示固定秒数如报错 5 秒、通知 4 秒避免画面在多个事件间高频跳变一次性状态自动回退报错、开心、扫地、通知、搬运显示完会自动退回之前的状态不需要你操心睡觉序列也值得玩味鼠标静止 20 秒进入「打望」60 秒后打哈欠持续 10 分钟才真正倒下睡着——免打扰模式下会跳过打盹直接睡。完整实现细节见 docs/project/theme-state-ui.md。支持哪些 AI AgentClawd on Desk 覆盖 20 多种 AgentClaude Code 和 Codex 安装后开箱即用自动注册 Hook其余可在Settings → Agents里一键安装主要包括Claude Code、Codex CLI、Copilot CLI、Gemini CLI、Antigravity CLI、Cursor Agent、CodeBuddy、WorkBuddy、Kiro CLI、Kimi Code CLI、Qwen Code、ZCode、CodeWhale、opencode、MiMo Code、Pi、OpenClaw、Hermes Agent、Qoder、QwenWork、Reasonix CLI 与 DeepSeek Harness。每个 Agent 的适配器代码放在 agents/ 目录例如 agents/claude-code.js 负责 Claude 的事件与素材映射。不同集成的能力有差异部分仅状态同步、不弹权限气泡清单见 docs/guides/known-limitations.zh-CN.md。极简模式与互动彩蛋不想让宠物占地方把它拖到屏幕右边缘或右键菜单选「极简模式」它会缩进屏幕边缘只露出半身鼠标悬停时探头招手任务完成还会迷你庆祝。右键菜单长这样互动彩蛋双击会戳戳、连点 4 下会东张西望任意状态下都可以直接把它拖走松手后继续当前动画。新手上手最快路径安装普通用户建议直接下载预构建安装包Windows.exe、macOS.dmg、Linux.AppImage/.deb开发者可从源码运行git clone https://gitcode.com/gh_mirrors/cl/clawd-on-desk cd clawd-on-desk npm install npm start启动后Claude Code 和 Codex 的 Hook 已自动注册发个提问就能看到螃蟹从「思考」切到「打字」装更多 Agent打开 Settings → Agents按需安装对应集成进阶远程服务器上的 Agent 可通过Settings → 远程 SSH把状态转发到本地桌宠效果如下更完整的安装步骤含 WSL、远程 SSH、平台差异见 docs/guides/setup-guide.zh-CN.md。总结Clawd on Desk 把抽象的 AI Agent 生命周期翻译成了 12 种一眼能懂的桌面宠物动画状态你负责提问它负责「表演」。看懂状态速查表后只要瞟一眼螃蟹——是打字、杂耍还是在睡觉——你就知道任务进行到哪一步了。想深入某个状态的触发规则直接从 docs/guides/state-mapping.zh-CN.md 的完整事件映射表查起即可。【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-desk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考