macOS 菜单栏展示当前 Agent 工作状态，并提供快速访问入口。
显示内容
- 菜单栏图标和第一行状态行反映当前 Agent 工作状态
- 工作活跃时隐藏健康状态，所有会话空闲后恢复显示
- “Context” 子菜单包含最近会话（不直接展开在根菜单）
- “Nodes” 区块仅列出已配对设备（
node.list），不含 client/presence 条目 - “Usage” 区块在有 provider 用量快照时显示
状态模型
- 会话事件携带
runId（每次运行）和sessionKey main会话优先级最高；main 活跃时立即显示其状态- main 空闲时，显示最近活跃的非 main 会话
图标状态
| 状态 | 图标行为 |
|---|---|
idle | 正常动画（眨眼、偶尔摇摆） |
workingMain | 徽章 + 字形，全色调，腿部”工作”动画 |
workingOther | 徽章 + 字形，柔和色调，无奔跑动画 |
overridden | 调试覆盖，使用选定字形/色调 |
活动类型与字形
| 活动 | 字形 |
|---|---|
exec | 💻 |
read | 📄 |
write | ✍️ |
edit | 📝 |
attach | 📎 |
| 默认 | 🛠️ |
状态行文本
- 工作中：
<Session role> · <activity label>（如Main · exec: pnpm test） - 空闲时：显示健康摘要
调试覆盖
Settings → Debug → “Icon override” 可手动设置图标状态，存储于 @AppStorage("iconOverride")。
相关链接
- platform-macos — macOS 平台总览
- platform-mac-icon — 菜单栏图标详情