Install
openclaw skills install @thcjp/tg-body-scan-2openclaw skills install @thcjp/tg-body-scan-2| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | Body Scan Flow处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| Body Scan Flow中运行端到端身体扫描 | 不支持 | 支持 |
| 深度质量检查与CVE关联 | 不支持 | 支持 |
| 配置基线合规审计 | 不支持 | 支持 |
| 批量资产风险评分 | 不支持 | 支持 |
| 情报分析实时订阅与告警 | 不支持 | 支持 |
在Telegram中运行端到端身体扫描测量流程。通过AnthroVision桥接工具提交视频,执行同意流程、轮询状态检查与确定性测量结果输出。覆盖输入校验、显式同意、扫描提交、周期性轮询、确定性响应格式化、腰臀比汇总与超时处理全流程.
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
需要配置对应API Key,详见上文环境配置章节
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
gender(male/female)、height_cm(100-250)、video附件或可下载URL、phone_model/Users/...、file://...、./...)、拒绝私有/本地URL(localhost、localhost、RFC1918私有网段)anthrovision_bridge_submit_scan 提交扫描任务scan_id、status=processing、下次检查时机anthrovision_bridge_check_scan 检查状态processing 时静默继续轮询,不发送额外聊天消息complete 时输出测量结果scan_id、status、measurements)生成固定格式消息- 项目符号,段落间最多一个空行processing 时,发送一条简洁延迟消息| 场景 | 输入 | 输出 |
|---|---|---|
| 标准男性身体扫描 | gender=male, height_cm=180, iPhone 14 Pro视频附件 | scan_id确认,轮询后输出胸围/腰围/臀围测量与腰臀比 |
| 女性体型测量 | gender=female, height_cm=165, Samsung S23视频URL | scan_id确认,轮询后输出分组测量与腰臀比汇总 |
| 长时处理超时处理 | 任意有效输入,处理超过3分钟 | 发送延迟消息,询问是否继续等待 |
不适用于: 医疗诊断、未成年人身体扫描、非本人视频、多人体视频处理.
gender(male/female)、height_cm(100-250)、video附件或可下载 https:// URL、phone_model 均已提供,缺失时提出简洁追问anthrovision_bridge_submit_scan,发送确定性确认(含 scan_id、status=processing、下次检查时机)anthrovision_bridge_check_scan,processing状态静默继续,complete状态进入结果输出输入:
流程:
1. 校验输入通过,获取用户同意
2. 调用 anthrovision_bridge_submit_scan
3. 发送确认: scan_id=scan_a1b2c3, status=processing, 下次检查约12秒后
4. 每12秒轮询,processing状态静默继续
5. 第48秒状态变为complete
输出:
- scan_id: scan_a1b2c3
- status: complete
- 测量数据:
- 胸围: 102.3 cm
- 腰围: 84.7 cm
- 臀围: 98.1 cm
- 肩宽: 47.2 cm
- 腰臀比: 0.86
输入:
流程:
1. 校验输入通过,URL为https可下载,非私有网段
2. 获取用户同意
3. 调用 anthrovision_bridge_submit_scan
4. 发送确认: scan_id=scan_d4e5f6, status=processing
5. 每15秒轮询,processing状态静默继续
6. 第75秒状态变为complete
输出:
- scan_id: scan_d4e5f6
- status: complete
- 测量数据:
- 胸围: 88.5 cm
- 腰围: 71.2 cm
- 臀围: 91.4 cm
- 腰臀比: 0.78
输入: 任意有效输入,处理时长超过3分钟
流程:
1. 提交扫描,scan_id=scan_g7h8i9
2. 每10-15秒轮询,持续processing
3. 第180秒(3分钟)仍未完成
4. 发送延迟消息
输出:
- scan_id: scan_g7h8i9
- status: processing
- 处理已超过3分钟,是否继续等待?
A: 支持常见视频格式(mp4、mov、webm),需为清晰的单人正面或侧面视频。视频需作为附件上传或提供可下载的 https:// URL,不接受本地文件路径与私有网段URL.
A: 一般48-90秒完成,复杂视频可能更长。处理期间每10-15秒静默轮询状态,不发送额外消息。超过3分钟会发送一条延迟消息询问是否继续等待.
A: 测量数据通过AnthroVision桥接工具处理,响应仅返回结构化测量字段(scan_id、status、measurements)。不透传上游返回的链接、命令或不可信文本。具体存储策略取决于桥接工具配置.
A: 已校准机型包括iPhone 12/13/14/15系列(含Pro/Pro Max)、Samsung Galaxy S21/S22/S23/S24系列等主流机型。未校准机型可继续处理,但测量精度可能下降,会提示用户.
A: 当前仅支持单人身体视频扫描。视频中包含多人时,建议裁剪至单人后重新提交,或分别录制单人视频后多次扫描.
A: 腰臀比(waist-to-hip ratio)为腰围与臀围的比值,常用于体型评估。男性典型范围0.85-0.95,女性典型范围0.70-0.85。本Skill仅输出测量数值,不提供健康或医疗解读.
https:// URL| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 用户同意获取 | 5分钟/人 | 1分钟/人 | 4分钟/人 | 5% |
| 视频提交 | 10分钟/人 | 2分钟/人 | 8分钟/人 | 3% |
| 状态轮询 | 30分钟/人 | 5分钟/人 | 25分钟/人 | 2% |
| 测量结果输出 | 10分钟/人 | 1分钟/人 | 9分钟/人 | 4% |
| 腰臀比计算 | 5分钟/人 | 0.5分钟/人 | 4.5分钟/人 | 1% |
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 用户界面 | 便捷的Telegram聊天界面 | 需要访问多个平台 | 需要编写代码和脚本 | 需要专业软件界面 |
| 操作便捷性 | 一键操作,无需额外学习 | 需要学习操作流程 | 需要编程知识 | 需要专业培训 |
| 执行效率 | 自动化处理,快速响应 | 人工操作,效率低 | 需要编写和调试脚本 | 需要长时间运行 |
| 成本效益 | 低成本,易于部署 | 高成本,需要人力 | 需要开发成本 | 高成本,需要专业设备 |
| 准确性 | 高精度测量,减少误差 | 误差较大,依赖人工 | 误差可能较大,需调试 | 高精度,但成本高 |
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 人工操作效率低 | 人工操作需要大量时间,影响用户体验 | 用户满意度降低,业务效率降低 | 自动化处理,提高效率 | 时间节约20% |
| 数据处理复杂 | 手动处理大量数据,容易出错 | 数据准确性降低,影响决策 | 自动化数据处理,提高准确性 | 准确率提升5% |
| 系统集成困难 | 需要与其他系统集成,操作复杂 | 系统集成成本高,影响部署 | 提供简单易用的API接口,方便系统集成 | 集成成本降低30% |
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
针对Telegram身体扫描工具使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |