Sobre el proyecto
OpenCode SubAgent Magazine es un plugin para la TUI de OpenCode cuyo objetivo es ofrecer monitoreo en tiempo real de subagentes y visualización en barra lateral. Carga y dispara información de subagentes como un cargador, ayudando al usuario a seguir de forma intuitiva el estado de ejecución, el consumo de tokens, el costo, el tiempo, el modelo y el progreso de cada subagente.
Las funciones principales del plugin incluyen:
- **Visualización de estado en tiempo real**: muestra de un vistazo el estado de cada subagente mediante puntos de color (verde completado, amarillo en ejecución con animación de respiración, rojo error).
- **Seguimiento de tokens y costos**: resume el consumo de tokens y el costo de cada subagente y los muestra globalmente en la barra de título.
- **Detalles expandibles**: al hacer clic en un elemento se expande para ver el tipo de agente, estado, tiempo, tokens, costo, modelo, progreso y otra información detallada; los valores de los campos se alinean a la derecha para facilitar la lectura.
- **Acceso a la sesión con un clic**: tras expandir, hacer clic en "→ 进入会话" permite saltar directamente a la conversación completa de ese subagente.
- **Visualización del ID de sesión**: en el detalle expandido se muestra el Session ID del subagente; al hacer clic se abre una ventana para ver el ID completo y copiarlo.
- **Marcado manual como completado**: para elementos zombie atascados, se puede finalizar manualmente con el botón "- 标记完成" a la derecha del área expandida, o usar `/subagent-clear-running` para limpiar en lote.
- **Panel plegable**: al hacer clic en la barra de título se pliega/despliega el panel; el estado persiste y se mantiene tras reiniciar.
- **Desplazamiento al inicio/final**: en la parte inferior de la lista hay botones "↑ 回顶" y "↓ 回底"; la dirección se adapta al orden.
- **Orden configurable**: mediante `/subagent-order` se admite orden descendente (más recientes primero) o ascendente (más antiguos primero).
- **Cambio de modo de paginación**: `/subagent-scroll` permite elegir entre "paginación con rueda" o "paginación haciendo clic en more", resolviendo el conflicto entre el desplazamiento de la barra lateral y el global.
- **Limpieza automática por TTL**: se puede configurar el periodo de retención de datos (3/7/14/30 días o sin límite); cada acceso renueva el plazo y al expirar se elimina automáticamente.
- **Eliminación manual de entradas**: `/subagent-clear-entries` borra todos los registros de la sesión actual para evitar que entradas históricas se reconstruyan al escanear.
- **Adaptación de idioma**: admite cambiar en tiempo de ejecución entre chino e inglés con `/subagent-lang`; la preferencia persiste.
- **Borde conmutable**: `/subagent-border` controla la visibilidad del borde exterior del panel (oculto por defecto); al activarlo, el estilo se unifica con el panel de estadísticas de caché.
- **Comandos de barra**: ofrece comandos de configuración dinámica como `/subagent-lang`, `/subagent-max`, `/subagent-order`, `/subagent-scroll`, `/subagent-ttl`, `/subagent-clear-entries`, `/subagent-session`, `/subagent-version`, `/subagent-clear-running`, `/subagent-border`, etc.
En cuanto a la instalación, el plugin es compatible tanto con opencode 1.x como con 2.x. Para 2.x, se debe añadir una entrada en el array `plugins` de `~/.config/opencode/cli.json`; para 1.x, se puede instalar desde la paleta de comandos o configurar manualmente `tui.jsonc`. No se debe usar `opencode plugin add` para instalar, ya que ese comando escribe en la configuración de plugins del servidor y provoca errores.
La guía de uso detalla el uso de los comandos de barra, las operaciones de teclado y ratón (como hacer clic en la barra de título para plegar, hacer clic en un elemento para expandir, usar la rueda para paginar, etc.) y el significado de los colores de estado. Al actualizar, es necesario borrar la caché del plugin y reinstalarlo, porque OpenCode tiene un problema conocido que bloquea la versión del plugin.
El plugin es completamente independiente del modelo y admite todos los modelos de IA compatibles con OpenCode (como DeepSeek, Claude, GPT, etc.); los datos se obtienen mediante las interfaces estándar del SDK de OpenCode. Usa licencia MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.