今日水印相机照片验真

要解决什么问题

现场取证、考勤打卡、保险理赔等场景里，一张带水印的照片是否「真拍、真时、真地」，往往不能靠肉眼或 EXIF 了事：图片可能被 PS、二次翻拍，或根本不是在今日水印相机里拍的。若要在 Agent 或自动化流程里批量判定，就需要对接官方验真能力，并正确处理 HmacSHA256 双重签名、异步任务与结果状态码。

技能如何工作

本 Skill 封装今日水印相机开放平台的三段式流程：

1. 创建验真任务 — 通过 POST .../truth_build/create 提交 photoUrlList 和/或 photoBase64List（Base64 不含 data:image/...;base64, 前缀），拿到 taskID。
2. 查询验真结果 — 用 taskID 轮询 .../truth_build/query，直到 taskStatus=5；单张 status=0 表示时间、地点、防伪码均真实，并返回 photoTime、photoAddress、经纬度与 antiFakeCode。
3. 生成验真报告（可选） — 调用 .../truth_build/verify_report 得到 PNG 报告的 OSS 地址。

签名与请求头可由 scripts/trutu_sign.py 或同等逻辑生成；批量建议每批少于 10 张、上限 50 张。

边界与注意点

• 使用前须向用户确认是否已有商务下发的 GroupKey / GroupSecret；没有则需联系官方商务获取，凭证只应在内存中使用，勿写进代码或日志。
• API 侧承诺传输数据不存储、不落库，但你的 Agent 仍应避免把敏感照片长期落盘。
• 常见失败包括分辨率过低、无防伪码、非今日水印相机拍摄等；HTTP 4007/401 多为凭证或签名与请求体 JSON 不一致，需逐字节对齐签名用的 body 字符串。