Barra de menus

O que é exibido

• O estado de trabalho atual do agente é exibido no ícone da barra de menus e na primeira linha de status do menu.
• O status de integridade fica oculto enquanto há trabalho em andamento; ele retorna quando todas as sessões ficam ociosas.
• Um item "Contexto" na raiz abre um submenu com as sessões recentes, em vez de expandi-las no menu raiz.
• Um bloco "Nodes" no menu raiz lista apenas dispositivos pareados (de node.list), não entradas de cliente/presença.
• Uma seção "Uso" na raiz aparece abaixo de Contexto quando há instantâneos de uso do provedor disponíveis, seguida por detalhes de custo quando disponíveis.

Modelo de estado

• Origem: WorkActivityStore (apps/macos/Sources/OpenClaw/WorkActivityStore.swift).
• Os eventos chegam como ControlAgentEvent com um runId; o manipulador (ControlChannel.routeWorkActivity) lê sessionKey da carga útil do evento e usa "main" como padrão caso esteja ausente.
• Prioridade: a sessão principal (sessionKey == "main" por padrão) sempre prevalece. Se a principal estiver ativa, seu estado será exibido imediatamente. Se a principal estiver ociosa, será exibida a sessão não principal ativa mais recentemente. O armazenamento não alterna durante uma atividade; ele só muda quando a sessão atual fica ociosa ou a principal se torna ativa.
• Tipos de atividade:
  • job: execução de comando de alto nível (state: started|streaming|done|error|...).
  • tool: phase: start|result com name e meta/args opcionais.

Enumeração IconState (Swift)

• idle
• workingMain(ActivityKind)
• workingOther(ActivityKind)
• overridden(ActivityKind) (substituição para depuração)

ActivityKind -> símbolo do indicador

ActivityKind encapsula um ToolKind (bash, read, write, edit, attach, other) ou um job simples. Cada um é mapeado para um indicador de SF Symbol desenhado sobre o ícone da criatura (IconState.badgeSymbolName):

Mapeamento visual

• idle: criatura normal, sem indicador.
• workingMain: indicador com símbolo, tonalidade completa (destaque .primary), animação de "trabalho" das pernas.
• workingOther: indicador com símbolo, tonalidade atenuada (destaque .secondary), sem movimento apressado.
• overridden: usa o símbolo e a tonalidade escolhidos, independentemente da atividade real.

Submenu de contexto

• O menu raiz mostra uma linha "Contexto" com a contagem/o status das sessões; ela abre um submenu (MenuSessionsInjector).
• O cabeçalho do submenu mostra a contagem de sessões ativas nas últimas 24 horas.
• Cada linha de sessão mantém sua barra de tokens, idade, prévia, opção de ativar/desativar raciocínio/detalhamento e ações de redefinir, compactar e excluir.
• As mensagens de carregamento, desconexão e erro ao carregar sessões são exibidas no submenu de contexto.
• As seções de uso e custo permanecem no nível raiz, abaixo de Contexto, para que continuem visíveis rapidamente sem abrir o submenu.

Texto da linha de status (menu)

• Enquanto o trabalho estiver ativo: &lt;Session role&gt; · <activity label> ("\(roleLabel) · \(activity.label)" em MenuContentView), em que o rótulo da função é Main ou Other.
• Quando estiver ocioso: volta para o resumo de integridade.

Ingestão de eventos

• Origem: eventos agent do canal de controle, encaminhados por ControlChannel.routeWorkActivity(from:).
• Campos analisados:
  • stream: "job" com data.state para início/interrupção.
  • stream: "tool" com data.phase, data.name e, opcionalmente, data.meta/data.args.
• Os rótulos das ferramentas vêm de ToolDisplayRegistry.resolve(name:args:meta:); nomes não resolvidos usam o nome bruto da ferramenta como alternativa.

Substituição para depuração

• Seletor Settings > Debug > "Icon override":
  • System (auto) (padrão)
  • Working: main / Working: other (por tipo de ferramenta: bash, leitura, gravação, edição, outro)
  • Idle
• Armazenado na chave openclaw.iconOverride de UserDefaults; mapeado para IconState.overridden.

Lista de verificação de testes

• Acione um trabalho da sessão principal: o ícone muda imediatamente e a linha de status exibe o rótulo principal.
• Acione um trabalho de uma sessão não principal enquanto a principal estiver ociosa: o ícone/status exibe a sessão não principal e permanece estável até a conclusão.
• Inicie a sessão principal enquanto outra sessão estiver ativa: o ícone muda instantaneamente para a principal.
• Rajadas rápidas de ferramentas: o indicador não pisca (janela de tolerância de 2 s antes de limpar uma ferramenta concluída, WorkActivityStore.toolResultGrace).
• A linha de integridade reaparece quando todas as sessões ficam ociosas.

Relacionado

• Aplicativo para macOS
• Ícone da barra de menus