Barra de menús

Qué se muestra

• El estado de trabajo actual del agente se muestra en el icono de la barra de menús y en la primera fila de estado del menú.
• El estado de salud se oculta mientras hay trabajo activo; vuelve a mostrarse cuando todas las sesiones están inactivas.
• Un elemento raíz «Contexto» abre un submenú con las sesiones recientes en lugar de desplegarlas en el menú raíz.
• Un bloque «Nodos» del menú raíz muestra únicamente los dispositivos emparejados (de node.list), no las entradas de cliente/presencia.
• Una sección raíz «Uso» aparece debajo de Contexto cuando hay disponibles instantáneas de uso del proveedor, seguidas de los detalles de costes cuando están disponibles.

Modelo de estados

• Fuente: WorkActivityStore (apps/macos/Sources/OpenClaw/WorkActivityStore.swift).
• Los eventos llegan como ControlAgentEvent con un runId; el controlador (ControlChannel.routeWorkActivity) lee sessionKey de la carga útil del evento y usa "main" de forma predeterminada si no está presente.
• Prioridad: la sesión principal (sessionKey == "main" de forma predeterminada) siempre tiene preferencia. Si la sesión principal está activa, su estado se muestra inmediatamente. Si está inactiva, se muestra en su lugar la sesión no principal activa más recientemente. El almacén no cambia de sesión durante una actividad; solo lo hace cuando la sesión actual pasa a estar inactiva o cuando se activa la sesión principal.
• Tipos de actividad:
  • job: ejecución de comandos de alto nivel (state: started|streaming|done|error|...).
  • tool: phase: start|result con name y, opcionalmente, meta/args.

Enumeración IconState (Swift)

• idle
• workingMain(ActivityKind)
• workingOther(ActivityKind)
• overridden(ActivityKind) (anulación de depuración)

ActivityKind -> símbolo de insignia

ActivityKind encapsula un ToolKind (bash, read, write, edit, attach, other) o un job independiente. Cada uno se asigna a una insignia de SF Symbols dibujada sobre el icono de la criatura (IconState.badgeSymbolName):

Correspondencia visual

• idle: criatura normal, sin insignia.
• workingMain: insignia con símbolo, tinte completo (prominencia .primary) y animación de «trabajo» de las patas.
• workingOther: insignia con símbolo, tinte atenuado (prominencia .secondary), sin correteo.
• overridden: usa el símbolo y el tinte elegidos independientemente de la actividad real.

Submenú de contexto

• El menú raíz muestra una fila de «Contexto» con el número y el estado de las sesiones; esta abre un submenú (MenuSessionsInjector).
• El encabezado del submenú muestra el número de sesiones activas durante las últimas 24 horas.
• Cada fila de sesión conserva su barra de tokens, antigüedad, vista previa, controles para activar o desactivar el razonamiento y el modo detallado, y acciones para restablecer, compactar y eliminar.
• Los mensajes de carga, desconexión y error al cargar sesiones se muestran dentro del submenú de contexto.
• Las secciones de uso y coste permanecen en el nivel raíz, debajo de Contexto, para que puedan consultarse de un vistazo sin abrir el submenú.

Texto de la fila de estado (menú)

• Mientras el trabajo está activo: &lt;Session role&gt; · <activity label> ("\(roleLabel) · \(activity.label)" en MenuContentView), donde la etiqueta de función es Main o Other.
• Cuando está inactivo: vuelve al resumen de estado.

Ingesta de eventos

• Fuente: eventos agent del canal de control, enrutados mediante ControlChannel.routeWorkActivity(from:).
• Campos analizados:
  • stream: "job" con data.state para iniciar/detener.
  • stream: "tool" con data.phase, data.name y los campos opcionales data.meta/data.args.
• Las etiquetas de las herramientas provienen de ToolDisplayRegistry.resolve(name:args:meta:); los nombres no resueltos recurren al nombre sin procesar de la herramienta.

Anulación de depuración

• Selector Settings > Debug > "Icon override":
  • System (auto) (predeterminado)
  • Working: main / Working: other (según el tipo de herramienta: bash, lectura, escritura, edición, otro)
  • Idle
• Se almacena en la clave openclaw.iconOverride de UserDefaults; se asigna a IconState.overridden.

Lista de comprobación de pruebas

• Activar un trabajo de la sesión principal: el icono cambia inmediatamente y la fila de estado muestra la etiqueta principal.
• Activar un trabajo de una sesión no principal mientras la principal está inactiva: el icono y el estado muestran la sesión no principal; permanecen estables hasta que finaliza.
• Iniciar la sesión principal mientras otra sesión está activa: el icono cambia instantáneamente a la principal.
• Ráfagas rápidas de herramientas: el indicador no parpadea (ventana de gracia de 2 s antes de borrar una herramienta finalizada, WorkActivityStore.toolResultGrace).
• La fila de estado reaparece cuando todas las sesiones están inactivas.

Relacionado

• Aplicación para macOS
• Icono de la barra de menús