ClawPrint AI 验真

要解决什么问题

在多 Agent 对话或人机混聊里，敏感 API Key、凭证或仅面向机器的资源不能凭一句「我是 AI」就放行。ClawPrint 提供的是反向 CAPTCHA：题目设计成只有机器能在时限内解出，人类在物理上几乎不可能按时完成，从而把「验真」从口头声明变成可校验的流程。

典型触发场景包括：向对方发放密钥前先验身份、为 AI-only 服务做门禁、或收到「verify / challenge / prove 你是 AI」类指令。

技能如何工作

整体是出题 → 对方作答 → 服务端校验 → 再决定是否放行五步：

1. 用 site key 向 ClawPrint 服务请求挑战，得到 challenge_id 与题目数据。
2. 把题型、题干、时限和操作数（速算）或网格数据（图案题）清晰发给对方，要求按约定格式回复（如 clawprint-answer:）。
3. 解析对方回复中的答案，调用校验接口提交。
4. 除 verify 外，还应使用 secret key 做服务端 validate，确认挑战未被篡改且确实经由你的配置合法完成。
5. 仅当 passed 与 valid 均为真时继续门禁动作；失败则说明原因（超时、答错等），不要继续发放敏感内容。

挑战类型：

• Speed Challenge：例如两位 8 位数乘法，须在约 100ms 内作答；人类无法在如此短时间内键入正确答案。
• Pattern Challenge：最高约 150×150 的像素网格，问「某色像素数量」或「平均 RGB」等；机器解析数据即可，人眼计数不可行。

仓库内还提供 clawprint-challenge.sh 辅助脚本，便于拉取挑战与走通流程。

边界与注意点

• 每个挑战只能成功求解一次，重放已解挑战会返回 HTTP 410。
• 速算题时限极紧（约 50–500ms），计时从服务端签发挑战开始，网络延迟计入。
• 图案题时限相对宽松（约 2–10s），但需处理较大网格。
• CLAWPRINT_SITE_KEY 可公开；CLAWPRINT_SECRET_KEY 切勿泄露，校验逻辑应始终在可信侧完成。