Usar mystatus: comandos de barra diagonal y lenguaje natural
Lo que aprenderás
- Usar el comando de barra diagonal
/mystatuspara consultar con un clic todas las cuotas de plataformas de IA - Hacer preguntas en lenguaje natural para que OpenCode llame automáticamente a la herramienta mystatus
- Comprender las diferencias y escenarios de uso de ambos métodos de activación
Tu situación actual
Desarrollas usando múltiples plataformas de IA (OpenAI, Zhipu AI, GitHub Copilot, etc.), quieres saber cuánta cuota le queda a cada plataforma, pero no quieres iniciar sesión individualmente en cada plataforma para verlo — es demasiado problemático.
Cuándo usar esta técnica
- Cuando necesitas ver rápidamente las cuotas de todas las plataformas: Verifica antes de comenzar el desarrollo cada día, organiza el uso de manera razonable
- Cuando quieres conocer la cuota específica de una plataforma: Por ejemplo, quieres confirmar si OpenAI está casi agotado
- Cuando quieres verificar si la configuración surtió efecto: Acabas de configurar una nueva cuenta, verifica si puedes consultar normalmente
Verificación previa
Este tutorial asume que has completado la instalación del plugin opencode-mystatus. Si aún no lo has instalado, completa primero los pasos de instalación.
Enfoque central
opencode-mystatus ofrece dos formas de activar la herramienta mystatus:
- Comando de barra diagonal
/mystatus: Rápido, directo, sin ambigüedad, adecuado para consultas frecuentes - Preguntas en lenguaje natural: Más flexible, adecuado para consultas combinadas con escenarios específicos
Ambos métodos llaman a la misma herramienta mystatus, la herramienta consulta paralelamente las cuotas de todas las plataformas de IA configuradas y devuelve resultados con barras de progreso, estadísticas de uso y cuentas regresivas de restablecimiento.
Sigue los pasos
Paso 1: Usa el comando de barra diagonal para consultar la cuota
En OpenCode, ingresa el siguiente comando:
/mystatusPor qué El comando de barra diagonal es un mecanismo de comando rápido de OpenCode, puede llamar rápidamente herramientas predefinidas. El comando /mystatus llama directamente a la herramienta mystatus, sin necesidad de parámetros adicionales.
Lo que deberías ver: OpenCode devuelve la información de cuota de todas las plataformas configuradas, el formato es el siguiente:
## OpenAI 账号额度
Account: user@example.com (team)
3小时限额
███████████████████████████ 剩余 85%
重置: 2h 30m后
## 智谱 AI 账号额度
Account: 9c89****AQVM (Coding Plan)
5小时 token 限额
███████████████████████████ 剩余 95%
已用: 0.5M / 10.0M
重置: 4小时后Cada plataforma mostrará:
- Información de cuenta (correo o API Key enmascarada)
- Barra de progreso (visualiza la cuota restante)
- Cuenta regresiva de tiempo de restablecimiento
- Uso y uso total (algunas plataformas)
Paso 2: Haz preguntas en lenguaje natural
Además del comando de barra diagonal, también puedes hacer preguntas en lenguaje natural, OpenCode reconocerá automáticamente tu intención y llamará a la herramienta mystatus.
Prueba estos métodos de pregunta:
Check my OpenAI quotaO
How much Codex quota do I have left?O
Show my AI account statusPor qué Las consultas en lenguaje natural se ajustan más a los hábitos de conversación diaria, adecuadas para plantear preguntas en escenarios específicos de desarrollo. OpenCode reconocerá a través de coincidencia semántica que quieres consultar cuotas y llamará automáticamente a la herramienta mystatus.
Lo que deberías ver: El mismo resultado de salida que el comando de barra diagonal, solo que el método de activación es diferente.
Paso 3: Comprende la configuración del comando de barra diagonal
¿Cómo funciona el comando de barra diagonal /mystatus? Se define en el archivo de configuración de OpenCode.
Abre ~/.config/opencode/opencode.json, encuentra la sección command:
{
"plugin": ["opencode-mystatus"],
"command": {
"mystatus": {
"description": "Query quota usage for all AI accounts",
"template": "Use the mystatus tool to query quota usage. Return the result as-is without modification."
}
}
}Explicación de elementos de configuración clave:
| Elemento de configuración | Valor | Función |
|---|---|---|
description | "Query quota usage for all AI accounts" | Descripción mostrada en la lista de comandos |
template | "Use to mystatus tool..." | Indica a OpenCode cómo procesar este comando |
Por qué es necesario el template El template es una "instrucción" para OpenCode, le indica: cuando el usuario ingresa /mystatus, llama a la herramienta mystatus y devuelve el resultado tal cual sin modificaciones.
Punto de control ✅
Confirma que has dominado ambos métodos de uso:
| Habilidad | Método de verificación | Resultado esperado |
|---|---|---|
| Consulta con comando de barra diagonal | Ingresa /mystatus | Muestra información de cuota de todas las plataformas |
| Consulta en lenguaje natural | Ingresa "Check my OpenAI quota" | Muestra información de cuota |
| Comprender la configuración | Ver opencode.json | Encuentra la configuración del comando mystatus |
Advertencias de errores comunes
Error común 1: El comando de barra diagonal no responde
Síntoma: Después de ingresar /mystatus no hay ninguna respuesta
Causa: El archivo de configuración de OpenCode no ha configurado correctamente el comando de barra diagonal
Solución:
- Abre
~/.config/opencode/opencode.json - Confirma que la sección
commandcontiene la configuraciónmystatus(ver paso 3) - Reinicia OpenCode
Error común 2: Las preguntas en lenguaje natural no activan la herramienta mystatus
Síntoma: Después de ingresar "Check my OpenAI quota", OpenCode no llama a la herramienta mystatus, sino que intenta responder por sí mismo
Causa: OpenCode no reconoció correctamente tu intención
Solución:
- Intenta una expresión más clara: "Use mystatus tool to check my OpenAI quota"
- O usa directamente el comando de barra diagonal
/mystatus, es más confiable
Error común 3: Muestra "未找到任何已配置的账号"
Síntoma: Después de ejecutar /mystatus muestra "未找到任何已配置的账号"
Causa: Aún no has configurado la información de autenticación de ninguna plataforma
Solución:
- Configura al menos la información de autenticación de una plataforma (OpenAI, Zhipu AI, Z.ai, GitHub Copilot o Google Cloud)
- Consulta las explicaciones de configuración en el tutorial de inicio rápido
Resumen de esta lección
La herramienta mystatus ofrece dos métodos de uso:
- Comando de barra diagonal
/mystatus: Rápido y directo, adecuado para consultas frecuentes - Preguntas en lenguaje natural: Más flexible, adecuado para combinarse con escenarios específicos
Ambos métodos consultan paralelamente las cuotas de todas las plataformas de IA configuradas y devuelven resultados con barras de progreso y cuentas regresivas de restablecimiento. La configuración del comando de barra diagonal se define en ~/.config/opencode/opencode.json, a través del template se indica a OpenCode cómo llamar a la herramienta mystatus.
Próxima lección
En la siguiente lección aprenderemos Interpretar la salida: barras de progreso, tiempos de restablecimiento y múltiples cuentas.
Aprenderás:
- Cómo interpretar el significado de las barras de progreso
- Cómo se calculan las cuentas regresivas de tiempo de restablecimiento
- Formato de salida en escenarios con múltiples cuentas
- Principios de generación de barras de progreso
Apéndice: Referencia de código fuente
Haz clic para expandir y ver la ubicación del código fuente
Fecha de actualización: 2026-01-23
| Función | Ruta de archivo | Línea |
|---|---|---|
| Definición de herramienta mystatus | plugin/mystatus.ts | 29-33 |
| Descripción de herramienta | plugin/mystatus.ts | 30-31 |
| Configuración de comando de barra diagonal | command/mystatus.md | 1-6 |
| Consulta paralela de todas las plataformas | plugin/mystatus.ts | 49-56 |
| Recopilación y resumen de resultados | plugin/mystatus.ts | 58-89 |
Constantes clave: No hay (esta sección presenta principalmente el método de llamada, no involucra constantes específicas)
Funciones clave:
mystatus(): Función principal de la herramienta mystatus, lee el archivo de autenticación y consulta paralelamente todas las plataformas (plugin/mystatus.ts:29-33)collectResult(): Recopila los resultados de consulta en los arrays results y errors (plugin/mystatus.ts:100-116)