Communitygithub.com

ossrs/srs

SRS 및 Oryx 작업을 가장 작은 관련 신뢰 문서 집합으로 라우팅하고, 이 스킬과 함께 제공되는 프로젝트 문서를 유지 관리합니다. SRS 문서를 찾거나, 선택하거나, 읽거나, 생성하거나, 업데이트하거나, 검토해야 하는 지원 또는 개발 작업, 또는 배포, 스트리밍, 인증, 로컬 또는 S3 호환 스토리지 녹화, 재스트리밍, 가상 라이브, 카메라, 트랜스코딩, HTTPS, API, 콜백, AI 기능 또는 개발을 위한 프로젝트 문서가 필요한 Oryx 작업에 사용하세요. C++ 미디어 서버 문서, Oryx 프로젝트 문서, 웹사이트 페이지, 변경 로그, 실행 가능한 API 예제, 차세대 Go 서버 및 성능 문서가 포함됩니다.

srs란 무엇인가요?

이 스킬은 SRS(Simple-Rtmp-Server) 및 Oryx 프로젝트 문서를 위한 전용 라우터 역할을 합니다. 개발자나 AI 에이전트가 SRS 또는 Oryx 관련 작업(지원, 개발, 문제 해결)을 수행할 때, 방대한 문서에서 관련 정보를 찾기 위해 광범위하게 검색하는 대신, 이 스킬에 정의된 참조 라우터(Reference Router)를 사용하여 가장 작고 관련성 높은 문서 집합으로 안내합니다. 예를 들어, WebRTC 설정에 대한 도움이 필요하면 `references/cpp-docs/doc/webrtc.md` 문서를 로드하고, Oryx 디버깅이 필요하면 `references/oryx/getting-started-oryx.md` 또는 Oryx FAQ를 로드합니다. 이 접근 방식은 작업 컨텍스트를 정확하고 효율적으로 유지하여 관련 없는 정보로 인한 혼란을 방지합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 모든 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었으며, 문서의 마크다운 구조와 기술적 세부 사항을 그대로 유지합니다. 각 라우터 항목은 특정 문서에 대한 설명과 파일 경로를 제공하므로, 사용자는 정확히 필요한 정보를 얻을 수 있습니다. 스킬은 또한 경로 확인(Path Resolution) 규칙을 정의하여 번들 문서(예: `references/`, `scripts/`)와 저장소 문서(예: `trunk/`, `oryx/`)를 혼동 없이 사용할 수 있도록 합니다. 마지막으로, 이 스킬은 부모 스킬이 사용자에게 답변을 제공하도록 제어권을 반환하는 명확한 워크플로우를 가지고 있습니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SRS 내부 문서

SRS 및 Oryx 작업을 관련 문서 참조로 안내합니다. 상위 스킬은 사용자 대면 작업을 담당하며, 이 스킬은 문서 탐색과 번들 프로젝트 문서를 담당합니다.

핵심 규칙

  • 현재 작업 디렉토리를 프로젝트 루트로 사용하십시오. 상위 디렉토리를 검색하거나 대체 리포지토리 루트를 찾지 마십시오.
  • 참조 또는 번들 문서를 로드하기 전에 먼저 참조 라우터(Reference Router)를 사용하십시오.
  • 작업과 관련된 참조 및 번들 문서만 로드하십시오. 모든 것을 로드하지 마십시오.
  • 이 스킬 또는 선택된 참조에 나열된 프로젝트 파일만 신뢰할 수 있는 문서로 취급하십시오.
  • 어떤 경로도 작업을 다루지 않는 경우, 문서 라우터가 다루지 않는다고 보고하십시오. 문서 디렉토리를 스캔하거나 광범위하게 grep하지 마십시오.
  • 설명을 기반으로 가장 작은 관련 프로젝트 문서 집합을 선택하십시오.
  • 신뢰할 수 있는 문서 라우팅은 이 스킬 내에서 유지하십시오. 주제-파일 테이블을 종속 스킬에 복제하지 마십시오.

경로 확인

  • references/, scripts/, assets/ 또는 agents/로 시작하는 번들 경로는 현재 작업 디렉토리가 아닌 이 SKILL.md가 포함된 디렉토리를 기준으로 확인합니다.
  • trunk/, internal/, cmd/ 또는 skills/와 같은 리포지토리 경로는 현재 작업 디렉토리를 기준으로 확인합니다.
  • 자체 리포지토리에 저장된 Oryx 문서의 경우, 프로젝트 루트 상대 경로인 oryx/를 사용하십시오. 이 경로는 디렉토리이거나 사용자가 선호하는 체크아웃에 대한 심볼릭 링크일 수 있습니다. 심볼릭 링크를 확인하거나 대체 Oryx 루트를 검색하지 마십시오. 경로를 사용할 수 없는 경우, 사용자에게 https://github.com/ossrs/oryx 체크아웃을 해당 위치에서 사용할 수 있도록 요청하십시오. 자동으로 생성하지 마십시오.
  • 현재 호출된 스킬 디렉토리를 사용하십시오. .agents/, .kiro/ 또는 .claude/와 같은 도구별 디렉토리에서 대체 복사본을 검색하지 마십시오.
  • 라우팅된 파일이 누락되었다고 보고하기 전에, 완전히 확인된 경로를 직접 확인하십시오.

참조 라우터

C++ 미디어 서버 릴리스

C++ 미디어 서버 추적 및 릴리스의 경우 다음을 로드하십시오:

  • trunk/doc/CHANGELOG.md — 모든 SRS 버전의 전체 변경 로그. 병합된 각 풀 리퀘스트에 대해 하나의 항목과 버전 범프가 있습니다.

C++ 미디어 서버 사용자 문서

C++ 미디어 서버 사용자 문서의 경우, 가장 작은 관련 문서를 선택하십시오:

  • references/cpp-docs/doc/introduction.md — SRS 개요, 지원 프로토콜, 기능 목록, State Threads 아키텍처 및 학습 경로.
  • references/cpp-docs/doc/getting-started.md — Docker 빠른 시작, RTMP 퍼블리싱, HTTP-FLV/HLS 재생, WebRTC, HTTPS, SRT 및 스트림 URL 패턴.
  • references/cpp-docs/doc/getting-started-ai.md — SRS 로봇, 로컬 AI 에이전트, 스킬 시스템 및 프로젝트 지식 베이스 철학.
  • references/cpp-docs/doc/getting-started-build.md — 소스에서 SRS 빌드 및 ARM 또는 MIPS용 크로스 빌드.
  • references/cpp-docs/doc/getting-started-cdk.md — srs-cdk를 사용하여 AWS에 SRS 배포.
  • references/cpp-docs/doc/rtmp.md — RTMP 사용법, Enhanced RTMP, 구성, RTMPS, 프로토콜 비교 및 코덱 역사.
  • references/cpp-docs/doc/hls.md — HLS 호환성, 지연 시간, 세그먼트 구성, HTTPS 및 WebRTC의 오디오 트랜스코딩.
  • references/cpp-docs/doc/webrtc.md — WHIP/WHEP, SFU 아키텍처, RTMP-to-RTC 변환, TURN/ICE, 오디오 트랜스코딩, NACK 및 RTX 재전송, 플랫폼 사용법.
  • references/cpp-docs/doc/flv.md — HTTP-FLV 전송, 구성, 지연 시간, 프로토콜 비교 및 브라우저 호환성.
  • references/cpp-docs/doc/srt.md — SRT 전송, 지연 시간, MPEG-TS 캡슐화, HEVC, 구성, 스트림 ID 및 약한 네트워크 동작.
  • references/cpp-docs/doc/rtsp.md — RTSP 재생, TCP 전송, RTMP 퍼블리싱 워크플로우, 구성 및 빌드 옵션.
  • references/cpp-docs/doc/gb28181.md — External-SIP GB28181 미디어 퍼블리싱, HTTP 세션 생성, TCP 전송, 시간 초과 구성 및 세션 수명 주기.
  • references/cpp-docs/doc/http-server.md — 내장 HTTP 서버, HLS/정적 서빙, API 엔드포인트, 구성 및 리버스 프록시.
  • references/cpp-docs/doc/hevc.md — H.265/HEVC 프로토콜 호환성, Enhanced RTMP, 인코더 설정 및 대역폭 트레이드오프.
  • references/cpp-docs/doc/dvr.md — FLV/MP4 녹화, 계획, 경로, HTTP 콜백 및 Oryx 녹화 기능.
  • references/cpp-docs/doc/ingest.md — FFmpeg를 통해 외부 파일, RTSP 카메라 또는 HTTP 스트림을 가져와 SRS에 다시 게시.
  • references/cpp-docs/doc/forward.md — RTMP 스트림을 다른 서버로 전달, 마스터/슬레이브 역할 구성, 전달과 에지 모드 비교.
  • references/cpp-docs/doc/security.md — 퍼블리싱 및 재생을 위한 IP 및 CIDR 허용/차단 규칙.
  • references/cpp-docs/doc/snapshot.md — HTTP 콜백 또는 트랜스코더를 통한 스트림 썸네일 캡처.
  • references/cpp-docs/doc/http-api.md — 서버, 스트림 및 클라이언트 통계를 위한 HTTP API 엔드포인트, CORS 및 콘솔 통합 포함.
  • references/cpp-docs/doc/http-callback.md — 연결, 퍼블리싱, 재생, DVR, 인증 및 비즈니스 로직을 위한 이벤트 콜백.
  • references/cpp-docs/doc/exporter.md — Prometheus 메트릭, Grafana 통합, 레이블, 태그 및 클라우드 네이티브 관측 가능성.
  • references/cpp-docs/doc/origin-cluster.md — 오리진 서버 간 프록시 기반 로드 밸런싱 및 Go 프록시 아키텍처.
  • references/cpp-docs/doc/edge.md — 에지 캐싱, 재생 시 풀(pull-on-play), 게시 시 푸시(push-on-publish) 및 다단계 CDN 토폴로지.
  • references/cpp-docs/doc/nginx-for-hls.md — NGINX를 통한 HLS/DASH 배포 및 캐싱.
  • references/cpp-docs/doc/resource.md — 포트, 방화벽, HTTPS 및 리소스 참조.
  • references/cpp-docs/doc/low-latency.md — RTMP 지연 시간 조정, GOP 및 큐 설정, 병합 쓰기 최적화 및 프로토콜 비교.
  • references/cpp-docs/doc/performance.md — UDP 튜닝, perf, gprof, Valgrind, ASAN, 누수 감지 및 벤치마킹 방법론.
  • references/cpp-docs/doc/ffmpeg.md — FFmpeg 트랜스코딩, 다중 비트레이트 출력, 스트림 필터링 및 vhost/app/stream별 구성.

C++ 미디어 서버 웹사이트 페이지

C++ 미디어 서버 웹사이트 페이지의 경우, 가장 작은 관련 페이지를 선택하십시오:

  • references/cpp-docs/pages/faq-server-en.md — CDN, VoD, 일반 오류, 프로토콜 문제 및 커뮤니티 지원을 다루는 SRS 서버 FAQ.
  • references/cpp-docs/pages/license-en.md — SRS, State Threads 및 타사 라이브러리 라이선스.
  • references/cpp-docs/pages/product-en.md — 릴리스 마일스톤, 코드명, 성과 및 제품 역사.
  • references/cpp-docs/pages/security-advisories-en.md — 공개된 CVE, 영향을 받는 버전, 패치 및 보안 참조.

Oryx 문서

Oryx 문서의 경우, 가장 작은 관련 문서를 선택하십시오:

  • references/oryx/getting-started-oryx.md — Oryx 개요, 배포, SRS와의 비교, 인증, 녹화, 전달, 가상 라이브, 트랜스코딩, AI 기능, OpenAPI 및 HTTP 콜백.
  • references/oryx/faq-oryx-en.md — Oryx 설정, 업그레이드, HTTPS, 인증, 로컬 디스크 또는 S3 호환 클라우드 스토리지 녹화, 재스트리밍 및 일반 운영 질문.
  • oryx/README.md — Oryx 개요, Docker 배포, 포트, 영구 /data 레이아웃, 환경 변수, 기능 및 종속성.
  • oryx/DEVELOPER.md — Oryx OpenAPI, 환경 변수, 포트, 배포 변형, 개발 워크플로우, 테스트 및 변경 로그.
  • references/oryx/2022-04-09-Oryx-Tutorial.md — 원클릭, Docker, Lightsail 및 DigitalOcean 배포, RTMP, WebRTC 및 SRT 시작 가이드.
  • references/oryx/2022-04-12-Oryx-HTTPS.md — DNS, 자동 HTTPS, Let's Encrypt 및 인증서 갱신.
  • references/oryx/2022-04-15-Oryx-WordPress-Plugin.md — WordPress에 HLS, HTTP-FLV 및 WebRTC 스트림 임베드.
  • references/oryx/2022-04-29-BT-aaPanel.md — aaPanel을 통해 Oryx 설치 및 운영.
  • references/oryx/2023-08-29-Oryx-Ensuring-Authentication-for-Live-Streaming-Publishing.md — 전역 게시 시크릿 인증 및 그 한계.
  • references/oryx/2023-09-09-Oryx-Multi-Platform-Streaming.md — YouTube, Twitch 및 Facebook으로 재스트리밍.
  • references/oryx/2023-09-10-Oryx-Record-Live-Streaming.md — 서버 측 녹화, MP4 생성, 필터 및 로컬 또는 S3 호환 클라우드 스토리지.
  • references/oryx/2023-09-11-Oryx-Virtual-Live-Events.md — 사전 녹화된 파일을 라이브 스트림으로 게시.
  • references/oryx/2023-10-11-Oryx-Stream-IP-Camera-Events.md — RTSP 카메라를 가져와 스트리밍 플랫폼으로 전달.
  • references/oryx/2023-10-21-Oryx-Live-Transcoding.md — FFmpeg 기반 비트레이트 및 해상도 트랜스코딩.
  • references/oryx/2023-11-28-Oryx-Live-Streams-Transcription.md — Whisper 전사, 내장 자막 및 WebVTT.
  • references/oryx/2023-12-12-Oryx-OBS-WHIP-Service.md — OBS에서 WHIP 게시 및 WHEP를 통한 재생.
  • references/oryx/2024-01-31-Browser-Voice-Driven-GPT.md — 브라우저 음성 비서, 라이브 룸, 언어 코칭 및 번역.
  • references/oryx/2024-02-21-Dubbing-Translating.md — 비디오 번역, ASR, TTS, 세그먼트 편집 및 내보내기.
  • references/oryx/2024-05-20-OCR-Video-Streams.md — 라이브 스트림 OCR, 구성 가능한 AI 명령 및 콜백.

Oryx의 경우 시작 가이드, FAQ 및 리포지토리 문서를 선호하십시오. 날짜가 있는 블로그는 시나리오별 지침으로 취급하십시오. 명령, UI 레이블, 도구 또는 동작이 다른 경우, 사용자의 Oryx 버전과 일치하는 문서를 선호하십시오.

RTMP Go API 예제

RTMP Go API 예제의 경우 다음을 로드하십시오:

  • internal/rtmp/example_test.go — AMF0, 핸드셰이크 및 프로토콜 워크플로우를 위한 RTMP API 예제.

WHEP 성능 분석

WHEP 성능 분석의 경우 다음을 로드하십시오:

  • references/perf/proxy-whep.md — pprof 및 srs-bench로 WHEP 프로파일링하고 CPU, 할당, 힙, 고루틴 및 트레이스 데이터 비교.

차세대 Go 프록시 문서

차세대 Go 프록시 문서의 경우, 가장 작은 관련 문서를 선택하십시오:

  • references/proxy/features.md — 프록시 기능 상태 및 제한 사항, 구현된 프로토콜, API, 로드 밸런싱, 배포, 구성, 운영 및 현재 제한 사항 포함.
  • references/proxy/proxy-design.md — 프록시 아키텍처, 상태 비저장 프록시 설계, 내장 로드 밸런싱, Redis 모드 및 수평 확장 포함.
  • references/proxy/proxy-protocol.md — 백엔드 등록, 디버깅 백엔드, 하트비트 프로토콜 및 환경 변수.
  • references/proxy/proxy-usage.md — 프록시 시작 가이드: 빌드, 시작, 등록, 게시 및 SRS 오리진으로 확인.
  • references/proxy/proxy-load-balancer.md — 메모리 및 Redis 로드 밸런서를 위한 로드 밸런서 동작, 스트림 매핑, 상태 추적 및 프로토콜 상태.
  • references/proxy/proxy-origin-cluster.md — 프로덕션 오리진 클러스터: 프록시를 통해 다중 오리진 클러스터를 구성하고 확인하기 위한 고급 사용법.

작업이 여러 영역에 걸쳐 있는 경우, 목록에서 필요한 참조 또는 번들 문서만 로드하십시오.

워크플로우

  1. 참조 라우터로 문서 요구 사항을 분류하십시오.
  2. 경로 확인에 따라 선택한 경로를 확인한 다음 프로젝트 또는 번들 문서를 직접 로드하십시오.
  3. 작업에 필요한 문서만 로드하십시오.
  4. 응답, 개발, 문제 해결, 검토 또는 편집을 위해 상위 스킬로 제어권을 반환하십시오.

직접 호출되는 경우, 동일한 라우팅 워크플로우를 따른 다음 관련 지원 또는 개발 워크플로우를 적용하십시오.

라우터 유지 관리

  • 신뢰할 수 있는 문서가 추가, 제거, 이름 변경 또는 책임이 변경될 때 참조 라우터를 업데이트하십시오.
  • 라우터 요약과 파일 설명을 간결하고 탐색에 집중하여 유지하십시오.
  • 문서 내용이나 구현 세부 사항을 라우터에 복제하지 마십시오.

관련 스킬