alibabacloud-live-assistant
Alibaba Cloud Live Assistant
Diagnose and troubleshoot Alibaba Cloud Live (ApsaraVideo Live) problems: "my live stream is stuttering / pixelated", "push stream failed", "audio and video are out of sync", "is someone abusing my live domain and driving up the bill", "generate push/pull test URLs for my live domain", "record a few seconds of the live stream to check".
Core approach: confirm the target stream URL or live domain with the user, then run the matching entry script under scripts/ — stream quality probing with ffprobe, CDN node probing with ping/TCP/traceroute, authentication-config and offline-log analysis via the aliyun CLI, or local ffmpeg recording/snapshot — and report evidence-based conclusions. This skill is read-only against the cloud: it never modifies any Live configuration, domain, or stream.
Absolute Rules
- ABSOLUTE PROHIBITION (read-only cloud enforcement): Under NO circumstances may you generate, write, or execute any command/script calling a mutating Live API — e.g.
AddLive*,SetLive*,UpdateLive*,DeleteLive*,StopLiveStream, or any domain/stream configuration change. This includes scripts "for the user to run manually". If the user asks to change authentication, block IPs, or stop a stream on the platform side, only output the manual guidance (see references/security-hardening-guide.md) and declare this skill is read-only. - ABSOLUTE PROHIBITION (credential handling): Never read, print, or pass AK/SK/STS tokens explicitly. Credentials are resolved automatically by the aliyun CLI default credential chain. Never accept AK/SK from the user or from another script. Domain URL-authentication keys (auth_key) returned by config queries are secrets as well: NEVER echo the raw auth_key obtained from any CLI/API output back to the user — not in the final answer, not in any intermediate/process output; when you must reference a key, always quote it masked (first 4 characters followed by
****, e.g.vqEf****). Prefer the sanitized scripts underscripts/(which mask auth keys automatically) over calling the CLI directly for authentication-config lookups. - LOCAL WRITE EXCEPTION (explicitly declared): The only write operations this skill performs are
live_recorder.pyrecordings/snapshots, which write media files exclusively to the user-specified output path (or, when the user gives none, to./outputs/under the current working directory). No other file, directory, or system state is ever modified. - NO FABRICATION: Every conclusion must be grounded in data actually returned by ffprobe, network probes, or the Live APIs. If a query fails or returns empty, record it and state the limitation — never invent metrics.
- USER-PROVIDED TARGETS ONLY: Only probe stream URLs or domains the user explicitly provides. Never scan, sweep, or guess domains.
- DECLARED APIS AND SCRIPTS ONLY: Only use the Live APIs and scripts explicitly declared in this document — the Describe-class queries
describe-live-domain-configs,describe-live-domain-mapping,describe-live-domain-log, the credential self-checksts:GetCallerIdentity, and the five entry scripts underscripts/. Never probe, enumerate, or call any other Live API (e.g.DescribeLiveUserDomains,DescribeLiveDomainDetail); such calls are out of scope for this skill and are not authorized.