Tg Body Scan Tool Free

SKILL.md

---
name: "tg-body-scan-tool-free"
description: "通过 Telegram 提交视频进行人体测量，返回基础围度数据与腰臀比，适合个人单次使用。"
license: Proprietary
allowed-tools: read exec
compatibility: "Requires LLM with tool-use capability"
metadata:
  displayName: "体测扫描工具免费版"
  version: "1.0.0"
  summary: "通过 Telegram 提交视频进行人体测量，返回基础围度数据与腰臀比，适合个人单次使用。"
  tags:
    - "体测扫描"
    - "健康测量"
    - "电报机器人"
    - "个人健康"
  source: "SkillHub"
  converted_at: "2026-07-22T17:58:36"
---

# 体测扫描工具 免费版

## 概述

免费版体测扫描工具帮助个人用户通过 Telegram 提交一段体测视频，自动完成人体围度测量并返回结果。用户只需提供性别、身高、手机型号与视频，工具即可在数分钟内返回肩宽、胸围、腰围、臀围等基础数据及腰臀比汇总。本版本适合个人健身爱好者进行单次体测跟踪。

与专业版相比，免费版聚焦单次扫描与基础测量能力，不包含批量提交、历史趋势对比、团队数据共享与高级分析报表。但两者的提交接口与返回格式完全一致，便于后续升级。

## 核心能力

| 能力 | 说明 |
| --- | --- |
| 视频扫描提交 | 通过 Telegram 提交体测视频，启动扫描任务 |
| 状态轮询 | 自动每 10-15 秒轮询扫描状态，完成后返回结果 |
| 基础围度测量 | 返回肩宽、胸围、腰围、臀围等基础围度数据 |
| 腰臀比汇总 | 自动计算腰臀比并给出简要健康参考 |
| 输入校验 | 校验性别、身高范围、视频来源合法性 |
| 隐私保护 | 拒绝本地文件路径与私有网络 URL |
**技术实现要点**：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置。

### 核心功能执行
用`input_params`参数进行配置。

**输入**: 用户提供核心功能执行所需的指令和必要参数。
**处理**: 按照skill规范执行核心功能执行操作,遵循单一意图原则。
**输出**: 返回核心功能执行的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 参数配置与调用
用`config_options`参数进行配置。

**输入**: 用户提供参数配置与调用所需的指令和必要参数。
**处理**: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。
**输出**: 返回参数配置与调用的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`config_options`参数,支持修改/重置/导入操作

### 结果处理与输出
用`output_format`参数进行配置。

**输入**: 用户提供结果处理与输出所需的指令和必要参数。
**处理**: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。
**输出**: 返回结果处理与输出的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`output_format`参数,支持导出/保存/转换操作
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：提交视频进行人体、返回基础围度数据、与腰臀比、适合个人单次使用、面向个人用户的、人体体测测量工具、视频提交、扫描状态轮询、适用场景、个人健身跟踪、单次体测测量、健康数据记录、差异化、免费版聚焦单次扫、描与基础测量、不含批量处理与历、史对比分析、适用关键词、body、scan、fitness等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

## 使用场景

### 场景一：个人健身月度体测

健身爱好者每月拍摄一段正面体测视频，通过 Telegram 机器人提交获取围度数据。

```text
用户：帮我做一次体测，这是我的视频
[视频附件]

机器人：请补充以下信息：
- 性别（male / female）
- 身高（cm，100-250）
- 手机型号（如 iPhone 15 Pro）

用户：male，178，iPhone 15 Pro

机器人：
📋 扫描已提交
- scan_id: scan_20260718_001
- 状态: processing
- 预计完成: 2-3 分钟
```

### 场景二：健康数据基线记录

首次体测建立个人健康基线，后续可手动记录变化。

```text
机器人：扫描完成 ✅
📊 测量结果
- 肩宽: 42.3 cm
- 胸围: 98.5 cm
- 腰围: 82.1 cm
- 臀围: 96.8 cm
📈 腰臀比: 0.85（健康范围内）
```

### 场景三：运动计划前后对比

用户在开始新运动计划前做一次基线扫描，计划结束后再做一次，手动对比两次数据。

```text
用户：三个月前我的腰围是 82.1 cm，现在帮我重新测一下

机器人：
📋 新扫描已提交
- scan_id: scan_20261018_002
- 状态: processing

[轮询中...]

机器人：扫描完成 ✅
📊 测量结果
- 腰围: 78.9 cm
📉 较上次减少 3.2 cm
```

## 快速开始

1. 在 Telegram 中找到体测扫描机器人。
2. 发送体测视频（正面、光线充足、全身入镜）。
3. 根据提示补充性别、身高与手机型号。
4. 等待 2-3 分钟，自动接收测量结果。

**所需输入**

| 参数 | 说明 | 取值范围 |
| --- | --- | --- |
| `gender` | 性别 | `male` / `female` |
| `height_cm` | 身高（厘米） | 100 - 250 |
| `video` | 体测视频 | 视频附件或可下载的 https URL |
| `phone_model` | 手机型号 | 如 `iPhone 15 Pro` |

## 示例

免费版无需额外配置，直接通过 Telegram 对话使用。若需在 Agent 脚本中集成，参考以下调用方式。

```python
# body_scan_free.py
import time

# 步骤1: 提交扫描
scan = anthrovision_bridge_submit_scan(
    gender="male",
    height_cm=178,
    video_url="https://example.com/body-scan.mp4",
    phone_model="iPhone 15 Pro"
)
scan_id = scan["scan_id"]
print(f"扫描已提交: {scan_id}, 状态: {scan['status']}")

# 步骤2: 轮询状态
while True:
    result = anthrovision_bridge_check_scan(scan_id=scan_id)
    if result["status"] != "processing":
        break
    time.sleep(12)  # 每12秒轮询一次

# 步骤3: 输出结果
print(f"扫描状态: {result['status']}")
for key, value in result.get("measurements", {}).items():
    print(f"  {key}: {value} cm")
print(f"腰臀比: {result.get('waist_hip_ratio', 'N/A')}")
```

## 最佳实践

- **视频质量**：确保光线均匀、背景简洁、全身入镜，避免穿着宽松衣物影响测量精度。
- **拍摄距离**：建议距离 2-3 米，手机与地面平行，保持自然站姿。
- **信息完整**：一次性提供性别、身高、手机型号，减少来回确认。
- **耐心等待**：扫描通常 2-3 分钟完成，3 分钟未完成时系统会询问是否继续等待。
- **隐私安全**：仅通过 Telegram 提交视频，不要提供本地文件路径或私有网络地址。
- **数据记录**：免费版不保存历史记录，建议手动截图或抄录每次结果以便对比。
- **合法使用**：仅对本人或已获得明确同意的对象进行扫描。

## 常见问题

### Q1：扫描提交后多久能出结果？

通常 2-3 分钟。系统每 10-15 秒自动轮询一次状态，完成后立即返回结果。若超过 3 分钟仍在处理，系统会发送一条延迟提示并询问是否继续等待。

### Q2：视频有什么要求？

需要正面全身视频，光线充足，背景简洁，穿着贴身衣物。手机型号信息用于校正镜头畸变，确保测量精度。

### Q3：免费版可以保存历史扫描记录吗？

免费版不保存历史记录，每次扫描结果独立返回。如需历史趋势对比与自动存档，请升级至专业版。

### Q4：可以扫描他人吗？

可以，但必须在扫描前获得对方的明确同意。工具在处理真实人物视频前会要求确认已获授权。

### Q5：为什么拒绝本地文件路径？

出于安全考虑，工具仅接受可公开访问的 https URL 或 Telegram 视频附件，拒绝 `localhost`、`127.0.0.1`、RFC1918 私有网段及本地路径（如 `/Users/...`、`file://...`）。

### Q6：腰臀比多少算健康？

一般参考标准：男性低于 0.90、女性低于 0.85 属于健康范围。具体健康评估请咨询专业医生，本工具仅提供数值参考。

### Q7：测量精度如何？

测量精度受视频质量、拍摄角度与手机型号影响。提供准确的手机型号有助于镜头畸变校正，提升精度。建议在相同条件下多次测量取均值。

## 依赖说明

### 运行环境

- **Agent 平台**：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
- **操作系统**：Windows / macOS / Linux
- **通信渠道**：Telegram（需可访问 Telegram 服务）

### 依赖详情

| 依赖项 | 类型 | 是否必需 | 获取方式 |
| :------- | :----- | :--------- | :--------- |
| AnthroVision 扫描服务 | API | 必需 | 体测扫描后端服务（由平台提供） |
| Telegram Bot | 通信渠道 | 必需 | 通过 `@BotFather` 创建机器人 |
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| Python | 运行时 | 可选 | 脚本集成需要，v3.9+ |

### API Key 配置

- 在 Agent 配置中填入 AnthroVision 扫描服务的接入凭证。
- Telegram Bot Token 通过 `@BotFather` 获取并配置在通信通道中。
- 免费版无需额外 API Key（除扫描服务与 Bot Token 外）。

### 可用性分类

- **分类**：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
- **说明**：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务。免费版为单次扫描功能子集，提交接口与返回格式与专业版完全兼容。

## 错误处理


| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |

## 已知限制

- 需LLM支持,无LLM环境不可用
- 复杂业务场景建议结合人工经验判断
- 执行效率受模型能力与网络环境影响