Communitygithub.com

ossrs/srs

Enruta tareas de SRS y Oryx al conjunto más pequeño y relevante de documentación del proyecto, y mantiene la documentación integrada en esta habilidad. Úsala cuando el trabajo de soporte o desarrollo requiera localizar, elegir, leer, crear, actualizar o revisar la documentación de SRS, o cuando el trabajo de Oryx necesite documentación del proyecto para despliegue, streaming, autenticación, grabación en almacenamiento local o compatible con S3, retransmisión, vivo virtual, cámara, transcodificación, HTTPS, APIs, callbacks, funciones de IA o desarrollo. Incluye la documentación del servidor multimedia C++, la documentación del proyecto Oryx, páginas web, changelog, ejemplos ejecutables de API, y la documentación del servidor Go de nueva generación y rendimiento.

¿Qué es srs?

Esta habilidad actúa como un enrutador de documentación inteligente para los proyectos SRS y Oryx. Su propósito principal es guiar a un agente de IA hacia la documentación más relevante y específica para la tarea en cuestión, evitando la sobrecarga de información. En lugar de cargar toda la documentación disponible, selecciona y carga solo los archivos necesarios de un conjunto predefinido de documentos de confianza, que incluyen guías de usuario del servidor C++, documentación de Oryx, páginas web, ejemplos de API y documentación del proxy Go de nueva generación. La habilidad es crucial para mantener la precisión y eficiencia al trabajar con SRS y Oryx. Define reglas estrictas para la resolución de rutas, diferenciando entre rutas relativas al directorio de la habilidad (como `references/` y `scripts/`) y rutas relativas al directorio de trabajo del proyecto (como `trunk/` y `oryx/`). También incluye un enrutador de referencia detallado que clasifica la documentación en categorías como documentación de usuario del servidor C++, páginas web, documentación de Oryx, ejemplos de API y documentación del proxy Go. Al ser invocada, la habilidad sigue un flujo de trabajo claro: clasificar la necesidad de documentación usando el enrutador de referencia, resolver la ruta del documento seleccionado, cargar solo los documentos requeridos y luego devolver el control a la habilidad principal para tareas de respuesta, desarrollo o revisión. También incluye pautas para mantener el enrutador actualizado a medida que la documentación evoluciona.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ossrs/srs/tree/HEAD/skills/internal-docs-for-srs

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Documentación Interna de SRS

Enruta tareas de SRS y Oryx a referencias de documentación específicas. La habilidad principal gestiona la tarea orientada al usuario; esta habilidad gestiona la navegación por la documentación y la documentación del proyecto incluida.

Reglas Principales

  • Utiliza el directorio de trabajo actual como raíz del proyecto. No busques en directorios padres ni descubras raíces alternativas del repositorio.
  • Utiliza el Enrutador de Referencia antes de cargar cualquier referencia o documento incluido.
  • Carga solo las referencias y documentos incluidos que sean relevantes para la tarea. No cargues todo.
  • Trata únicamente los archivos del proyecto listados en esta habilidad o en una referencia seleccionada como documentación de confianza.
  • Si ninguna ruta cubre la tarea, informa que el enrutador de documentación no la cubre. No escanees ni hagas búsquedas generales con grep en los directorios de documentación.
  • Selecciona el conjunto más pequeño de documentos del proyecto relevante a partir de sus descripciones.
  • Mantén el enrutamiento de documentación de confianza en esta habilidad. No dupliques tablas de archivos por tema en habilidades dependientes.

Resolución de Rutas

  • Resuelve las rutas incluidas que comiencen con references/, scripts/, assets/ o agents/ en relación con el directorio que contiene este SKILL.md, no con el directorio de trabajo actual.
  • Resuelve las rutas del repositorio como trunk/, internal/, cmd/ o skills/ en relación con el directorio de trabajo actual.
  • Para la documentación de Oryx almacenada en su repositorio, usa la ruta oryx/ relativa a la raíz del proyecto. La ruta puede ser un directorio o un enlace simbólico al checkout preferido del usuario. No resuelvas el enlace simbólico ni busques raíces alternativas de Oryx. Si la ruta no está disponible, pide al usuario que haga disponible el checkout de https://github.com/ossrs/oryx allí; no lo crees automáticamente.
  • Usa el directorio de la habilidad invocada actualmente. No busques copias alternativas en directorios específicos de la herramienta como .agents/, .kiro/ o .claude/.
  • Antes de informar que un archivo enrutado falta, verifica directamente su ruta completamente resuelta.

Enrutador de Referencia

Lanzamientos del Servidor Multimedia C++

Para el seguimiento y lanzamientos del servidor multimedia C++, carga:

  • trunk/doc/CHANGELOG.md — Changelog completo de todas las versiones de SRS, con una entrada y un incremento de versión por cada pull request fusionada.

Documentación de Usuario del Servidor Multimedia C++

Para la documentación de usuario del servidor multimedia C++, selecciona el documento más pequeño relevante:

  • references/cpp-docs/doc/introduction.md — Resumen de SRS, protocolos soportados, lista de características, arquitectura State Threads y ruta de aprendizaje.
  • references/cpp-docs/doc/getting-started.md — Inicio rápido con Docker, publicación RTMP, reproducción HTTP-FLV/HLS, WebRTC, HTTPS, SRT y patrones de URL de stream.
  • references/cpp-docs/doc/getting-started-ai.md — SRS Robot, agentes de IA locales, el sistema de habilidades y la filosofía de base de conocimiento del proyecto.
  • references/cpp-docs/doc/getting-started-build.md — Compilar SRS desde el código fuente y compilación cruzada para ARM o MIPS.
  • references/cpp-docs/doc/getting-started-cdk.md — Desplegar SRS en AWS con srs-cdk.
  • references/cpp-docs/doc/rtmp.md — Uso de RTMP, RTMP mejorado, configuración, RTMPS, comparaciones de protocolos e historia de códecs.
  • references/cpp-docs/doc/hls.md — Compatibilidad HLS, latencia, configuración de segmentos, HTTPS y transcodificación de audio desde WebRTC.
  • references/cpp-docs/doc/webrtc.md — WHIP/WHEP, arquitectura SFU, conversión RTMP a RTC, TURN/ICE, transcodificación de audio, retransmisión NACK y RTX, y uso en plataformas.
  • references/cpp-docs/doc/flv.md — Entrega HTTP-FLV, configuración, latencia, comparaciones de protocolos y compatibilidad con navegadores.
  • references/cpp-docs/doc/srt.md — Transporte SRT, latencia, encapsulación MPEG-TS, HEVC, configuración, IDs de stream y comportamiento en redes débiles.
  • references/cpp-docs/doc/rtsp.md — Reproducción RTSP, transporte TCP, flujo de trabajo de publicación RTMP, configuración y opción de compilación.
  • references/cpp-docs/doc/gb28181.md — Publicación multimedia GB28181 con SIP externo, creación de sesiones HTTP, transporte TCP, configuración de tiempo de espera y ciclo de vida de la sesión.
  • references/cpp-docs/doc/http-server.md — Servidor HTTP embebido, servicio de HLS/estático, endpoint de API, configuración y proxies inversos.
  • references/cpp-docs/doc/hevc.md — Compatibilidad de protocolo H.265/HEVC, RTMP mejorado, configuración del codificador y compensaciones de ancho de banda.
  • references/cpp-docs/doc/dvr.md — Grabación FLV/MP4, planes, rutas, callbacks HTTP y funciones de grabación de Oryx.
  • references/cpp-docs/doc/ingest.md — Extraer archivos externos, cámaras RTSP o streams HTTP a través de FFmpeg y republicarlos en SRS.
  • references/cpp-docs/doc/forward.md — Reenviar streams RTMP a otros servidores, configurar roles maestro/esclavo y comparar el reenvío con el modo edge.
  • references/cpp-docs/doc/security.md — Reglas de permitir/denegar por IP y CIDR para publicación y reproducción.
  • references/cpp-docs/doc/snapshot.md — Capturar miniaturas de streams a través de callbacks HTTP o el transcodificador.
  • references/cpp-docs/doc/http-api.md — Endpoints de la API HTTP para estadísticas del servidor, stream y cliente, incluyendo CORS e integración con consola.
  • references/cpp-docs/doc/http-callback.md — Callbacks de eventos para conexión, publicación, reproducción, DVR, autenticación y lógica de negocio.
  • references/cpp-docs/doc/exporter.md — Métricas de Prometheus, integración con Grafana, etiquetas, tags y observabilidad cloud-native.
  • references/cpp-docs/doc/origin-cluster.md — Balanceo de carga basado en proxy entre servidores origen y la arquitectura del proxy Go.
  • references/cpp-docs/doc/edge.md — Caché en el edge, pull-on-play, push-on-publish y topología CDN multinivel.
  • references/cpp-docs/doc/nginx-for-hls.md — Distribuir y almacenar en caché HLS/DASH a través de NGINX.
  • references/cpp-docs/doc/resource.md — Referencia de puertos, cortafuegos, HTTPS y recursos.
  • references/cpp-docs/doc/low-latency.md — Ajuste de latencia RTMP, configuración de GOP y colas, optimización de merge-write y comparación de protocolos.
  • references/cpp-docs/doc/performance.md — Ajuste de UDP, perf, gprof, Valgrind, ASAN, detección de fugas y metodología de benchmarking.
  • references/cpp-docs/doc/ffmpeg.md — Transcodificación con FFmpeg, salida multi-tasa de bits, filtrado de streams y configuración por vhost/app/stream.

Páginas Web del Servidor Multimedia C++

Para las páginas web del servidor multimedia C++, selecciona la página más pequeña relevante:

  • references/cpp-docs/pages/faq-server-en.md — FAQ del servidor SRS que cubre CDN, VoD, errores comunes, problemas de protocolo y soporte comunitario.
  • references/cpp-docs/pages/license-en.md — Licencias de SRS, State Threads y bibliotecas de terceros.
  • references/cpp-docs/pages/product-en.md — Hitos de lanzamiento, nombres en clave, logros e historia del producto.
  • references/cpp-docs/pages/security-advisories-en.md — CVEs publicados, versiones afectadas, parches y referencias de seguridad.

Documentación de Oryx

Para la documentación de Oryx, selecciona el documento más pequeño relevante:

  • references/oryx/getting-started-oryx.md — Resumen de Oryx, despliegue, comparación con SRS, autenticación, grabación, reenvío, vivo virtual, transcodificación, funciones de IA, OpenAPI y callbacks HTTP.
  • references/oryx/faq-oryx-en.md — Configuración de Oryx, actualizaciones, HTTPS, autenticación, grabación en disco local o almacenamiento en la nube compatible con S3, retransmisión y preguntas operativas comunes.
  • oryx/README.md — Resumen de Oryx, despliegue con Docker, puertos, diseño persistente de /data, variables de entorno, funciones y dependencias.
  • oryx/DEVELOPER.md — OpenAPI de Oryx, variables de entorno, puertos, variantes de despliegue, flujos de trabajo de desarrollo, pruebas y changelog.
  • references/oryx/2022-04-09-Oryx-Tutorial.md — Despliegue con un clic, Docker, Lightsail y DigitalOcean, más inicio rápido con RTMP, WebRTC y SRT.
  • references/oryx/2022-04-12-Oryx-HTTPS.md — DNS, HTTPS automático, Let's Encrypt y renovación de certificados.
  • references/oryx/2022-04-15-Oryx-WordPress-Plugin.md — Incrustar streams HLS, HTTP-FLV y WebRTC en WordPress.
  • references/oryx/2022-04-29-BT-aaPanel.md — Instalar y operar Oryx a través de aaPanel.
  • references/oryx/2023-08-29-Oryx-Ensuring-Authentication-for-Live-Streaming-Publishing.md — Autenticación global con publish-secret y sus limitaciones.
  • references/oryx/2023-09-09-Oryx-Multi-Platform-Streaming.md — Retransmitir a YouTube, Twitch y Facebook.
  • references/oryx/2023-09-10-Oryx-Record-Live-Streaming.md — Grabación del lado del servidor, generación de MP4, filtros y almacenamiento local o en la nube compatible con S3.
  • references/oryx/2023-09-11-Oryx-Virtual-Live-Events.md — Publicar archivos pregrabados como streams en vivo.
  • references/oryx/2023-10-11-Oryx-Stream-IP-Camera-Events.md — Extraer cámaras RTSP y reenviarlas a plataformas de streaming.
  • references/oryx/2023-10-21-Oryx-Live-Transcoding.md — Transcodificación de tasa de bits y resolución basada en FFmpeg.
  • references/oryx/2023-11-28-Oryx-Live-Streams-Transcription.md — Transcripción con Whisper, subtítulos incrustados y WebVTT.
  • references/oryx/2023-12-12-Oryx-OBS-WHIP-Service.md — Publicar WHIP desde OBS y reproducir a través de WHEP.
  • references/oryx/2024-01-31-Browser-Voice-Driven-GPT.md — Asistente de voz en el navegador, salas en vivo, entrenamiento de idiomas y traducción.
  • references/oryx/2024-02-21-Dubbing-Translating.md — Traducción de video, ASR, TTS, edición de segmentos y exportación.
  • references/oryx/2024-05-20-OCR-Video-Streams.md — OCR en vivo, instrucciones de IA configurables y callbacks.

Para Oryx, prefiere la guía de inicio rápido, la FAQ y la documentación del repositorio. Trata los blogs fechados como guías específicas para escenarios. Si los comandos, etiquetas de UI, herramientas o comportamiento difieren, prefiere la documentación que coincida con la versión de Oryx del usuario.

Ejemplos de API Go RTMP

Para ejemplos de API Go RTMP, carga:

  • internal/rtmp/example_test.go — Ejemplos de API RTMP para flujos de trabajo AMF0, handshake y protocolo.

Análisis de Rendimiento WHEP

Para análisis de rendimiento WHEP, carga:

  • references/perf/proxy-whep.md — Perfilar WHEP con pprof y srs-bench y comparar datos de CPU, asignación, heap, goroutine y traza.

Documentación del Proxy Go de Nueva Generación

Para la documentación del proxy Go de nueva generación, selecciona el documento más pequeño relevante:

  • references/proxy/features.md — Estado y limitaciones de las funciones del proxy, incluyendo protocolos implementados, APIs, balanceo de carga, despliegue, configuración, operaciones y limitaciones actuales.
  • references/proxy/proxy-design.md — Arquitectura del proxy, incluyendo diseño de proxy sin estado, balanceo de carga incorporado, modo Redis y escalado horizontal.
  • references/proxy/proxy-protocol.md — Registro de backend, depuración de backend, protocolo de heartbeat y variables de entorno.
  • references/proxy/proxy-usage.md — Inicio rápido con el proxy: compilar, iniciar, registrar, publicar y verificar con un origen SRS.
  • references/proxy/proxy-load-balancer.md — Comportamiento del balanceador de carga para balanceadores de carga en memoria y Redis, mapeo de streams, seguimiento de salud y estado del protocolo.
  • references/proxy/proxy-origin-cluster.md — Clústeres de origen en producción: uso avanzado para configurar y verificar un clúster multi-origen a través del proxy.

Si una tarea abarca múltiples áreas, carga solo las referencias o documentos incluidos requeridos de las listas.

Flujo de Trabajo

  1. Clasifica la necesidad de documentación con el Enrutador de Referencia.
  2. Resuelve la ruta seleccionada según Resolución de Rutas, luego carga el proyecto o el documento incluido directamente.
  3. Carga solo los documentos requeridos para la tarea.
  4. Devuelve el control a la habilidad principal para responder, desarrollar, solucionar problemas, revisar o editar.

Cuando se invoque directamente, sigue el mismo flujo de trabajo de enrutamiento y luego aplica el flujo de trabajo de soporte o desarrollo relevante.

Mantenimiento del Enrutador

  • Actualiza el Enrutador de Referencia cuando se añada, elimine, renombre o cambie la responsabilidad de un documento de confianza.
  • Mantén los resúmenes del enrutador y las descripciones de archivos concisos y centrados en la navegación.
  • No dupliques el contenido de los documentos ni los detalles de implementación en el enrutador.

Skills relacionados