用途：为已启动的 iOS 模拟器、Android 模拟器或实体 Android 设备录制屏幕视频，适合演示交互流程、留存可回放的视频记录。
主要能力：提供 screen-recording-start 与 screen-recording-stop 两个工具。使用与截图、交互工具相同的 simulator-server 后端取帧，实时编码为 h264 mp4（固定 30 fps、设备原生分辨率）。每台设备同时只能录制一个视频，不同设备可并行；录制不影响同一屏幕上的预览窗口。默认把 argent 驱动的点击、滑动、捏合等手势绘入视频（触点可视化），也可用 showTouches: false 关闭。默认开启静止帧裁剪：每段静止只保留首秒，其余丢弃，可用 trimStatic: false 关闭以获得实时真实时长。文件默认持久化保存到项目的 <project>/.argent/recordings/ 或 ~/.argent/recordings/，命名 screen-recording-<device>-<timestamp>.mp4。
使用方式：先启动设备并用 list-devices、launch-app、argent-device-interact 将应用置为期望状态，再调用 screen-recording-start 并传入 udid 与略大于预期交互时长的 timeLimitSeconds（默认 180，上限 600），随后设置录制结束提醒，驱动交互，最后用相同 udid 调用 screen-recording-stop。停止会返回 video、durationMs、wallClockMs、trimmedMs、warning；请检查 warning 并确认文件可播放。可通过 argent config set recordings.directory <dir> 更改保存目录，用 argent disable/enable video-watermark 控制水印。
适用场景：iOS 模拟器、Android 模拟器与实体 Android 设备上的操作演示与过程记录。
限制：不支持 tvOS 模拟器、实体 iPhone、Chromium 应用、Vega/Fire TV 及远程模拟器；Android 安全屏幕（DRM、部分密码字段）录成黑色；视频尺寸固定为开始时屏幕大小，屏幕尺寸变化后按比例加黑边；必须安装 ffmpeg（macOS 可用 brew install ffmpeg），否则启动即失败；录制不会自动提前停止，需按提示及时调用 stop，否则会占用会话与磁盘并产生无用片段。