核心用法
Device Capture 是一款面向萤石（Ezviz）智能摄像头的批量抓图工具，通过调用萤石开放平台 API 实现多设备实时画面采集。用户仅需配置 appKey、appSecret 及设备序列号，即可一键获取多个摄像头的抓拍画面。支持环境变量与命令行参数两种配置方式，灵活适配不同部署场景。
工作流程
1. 身份认证：使用 appKey/appSecret 自动获取 accessToken（有效期 7 天，内存缓存）
2. 批量抓图：调用 /api/lapp/device/capture 接口获取各设备实时画面 URL
3. 可选下载：支持自动下载图片到本地指定路径
4. 结果输出：生成结构化 JSON 与控制台日志，包含抓图状态与图片 URL
多设备支持
- 单设备：
dev1 - 批量设备：
dev1,dev2,dev3 - 独立通道：
dev1:1,dev2:2 - 混合模式：
dev1,dev2:2,dev3
显著优点
1. 零 Token 配置：自动获取、缓存、刷新 accessToken，用户无需关心 OAuth 流程
2. 批量并行：原生支持多设备同时抓图，提升运维效率
3. 内存安全：Token 仅驻留内存，不写入磁盘或日志，降低凭证泄露风险
4. 灵活部署：支持 crontab、launchd 等定时任务，满足周期性监控需求
5. 完整日志：分步骤输出执行状态，便于故障排查与审计
潜在缺点与局限性
1. 第三方依赖：完全依赖萤石开放平台 API 稳定性，存在单点故障风险
2. 频率限制：官方建议抓图间隔 ≥4 秒，高频调用可能触发限流（错误码 10028）
3. URL 时效性：抓图 URL 仅有效期 2 小时，需及时下载或二次分发
4. 网络要求：设备必须在线且 support_capture=1，离线设备无法抓图
5. 凭证管理：需妥善保管 appKey/appSecret，泄露可能导致设备被非法访问
适合人群
- 智能家居用户：定期备份家庭监控画面
- 中小企业运维：批量巡检多点位摄像头状态
- 安防集成商：自动化采集现场证据图片
- 开发者：基于萤石生态构建监控管理工具
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | appKey/appSecret 硬编码或误提交 | 使用环境变量，定期轮换凭证 |
| 隐私合规 | 抓图可能涉及他人隐私 | 确保符合《个人信息保护法》及地方法规 |
| 限流中断 | 高频调用触发 API 限制 | 控制抓图频率，建议 ≥5 分钟间隔 |
| Token 失效 | 网络异常导致 Token 获取失败 | 检查网络与凭证有效性，支持自动重试 |
| 设备离线 | 摄像头网络故障或断电 | 结合错误码 20007/20008 进行异常处理 |