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/oagents/en relación con el directorio que contiene esteSKILL.md, no con el directorio de trabajo actual. - Resuelve las rutas del repositorio como
trunk/,internal/,cmd/oskills/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 dehttps://github.com/ossrs/oryxallí; 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
- Clasifica la necesidad de documentación con el Enrutador de Referencia.
- Resuelve la ruta seleccionada según Resolución de Rutas, luego carga el proyecto o el documento incluido directamente.
- Carga solo los documentos requeridos para la tarea.
- 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.