# AGENTS.md

- This is a generic vehicle/device video service, not a sweeper-only app. Keep docs and UI wording generic unless protocol topic names require otherwise.
- Primary target is RK3588/aarch64 Linux. Prefer building on `aiec@192.168.2.211` with `./scripts/build_video.sh`; Windows native builds are not the target.
- Main protocol doc is `docs/视频协议.md`. Current integration scope is live video only; record query/play sections are reserved and should remain marked as deferred unless explicitly requested.
- Live streaming must be on-demand: service startup should not push live streams to SRS; `switch=1` starts live push and returns WHEP URLs, `switch=0` stops live push and returns `data: []`.
- Default public profile is `wan_194`; public WHEP URLs must include `eip=36.153.162.171:8000` and use streams like `AHD*_main` without `.flv`.
- Record behavior is controlled by existing `srs.record_enabled`; do not remove or redesign record code for live-video protocol changes.
- MQTT topic profile defaults to `protocol` (`/zxwl/sweeper/{vid}/...`), with `legacy` retained for `/kun/vehicle/video/...`.
- Before pulling on 2.211, check `git status`. A previous safety backup may exist as `stash@{0}: codex-before-video-protocol-pull`; do not drop stashes unless asked.