​

菜单栏状态逻辑

​

显示的内容

• 我们在菜单栏图标和菜单的第一个状态行中显示当前代理工作状态。
• 工作活跃时隐藏健康状态;所有会话空闲时返回。
• 菜单中的”Nodes”块仅列出设备(通过 node.list 配对的节点),而不是客户端/在线条目。
• 当提供商使用快照可用时,“Usage”部分出现在 Context 下。

​

状态模型

• 会话:事件到达时带有 runId(每次运行)加上有效负载中的 sessionKey。 “main”会话是键 main;如果不存在,我们回退到最近更新的会话。
• 优先级:main 始终获胜。如果 main 活跃,则立即显示其状态。如果 main 空闲, 则显示最近活跃的非 main 会话。我们不会在活动中间翻转;仅在当前会话空闲 或 main 变为活跃时才切换。
• 活动类型:
  • job:高级命令执行(state: started|streaming|done|error)。
  • tool:phase: start|result 带有 toolName 和 meta/args。

​

IconState 枚举(Swift)

• idle
• workingMain(ActivityKind)
• workingOther(ActivityKind)
• overridden(ActivityKind)(调试覆盖)

​

ActivityKind → 字形

• exec → 💻
• read → 📄
• write → ✍️
• edit → 📝
• attach → 📎
• default → 🛠️

​

视觉映射

• idle:正常小动物。
• workingMain:带字形的徽章、完整色调、腿”工作”动画。
• workingOther:带字形的徽章、静音色调、无快跑。
• overridden:使用选择的字形/色调,无论活动如何。

​

状态行文本(菜单)

• 工作活跃时:<Session role> · <activity label>
  • 示例:Main · exec: pnpm test、Other · read: apps/macos/Sources/OpenClaw/AppState.swift。
• 空闲时:回退到健康摘要。

​

事件摄取

• 来源:控制通道 agent 事件(ControlChannel.handleAgentEvent)。
• 解析的字段:
  • stream: "job" 带有 data.state 用于开始/停止。
  • stream: "tool" 带有 data.phase、name、可选的 meta/args。
• 标签:
  • exec:args.command 的第一行。
  • read/write:缩短的路径。
  • edit:路径加上从 meta/diff 计数推断的更改类型。
  • 回退:工具名称。

​

调试覆盖

• 设置 ▸ Debug ▸ “Icon override” 选择器:
  • System (auto)(默认)
  • Working: main(每种工具类型)
  • Working: other(每种工具类型)
  • Idle
• 通过 @AppStorage("iconOverride") 存储;映射到 IconState.overridden。

​

测试清单

• 触发 main 会话作业:验证图标立即切换,状态行显示 main 标签。
• 在 main 空闲时触发非 main 会话作业:图标/状态显示非 main;保持稳定直到完成。
• 在其他活跃时启动 main:图标立即翻转到 main。
• 快速工具突发:确保徽章不闪烁(工具结果上的 TTL 宽限期)。
• 所有会话空闲后健康行重新出现。