\r \r

慧龄云®中华05骨龄智能分析技能（RUS-CHN05）\r

\r

功能概述\r

\r 本技能对接慧龄云®骨龄人工智能检测系统（host: www.pipitu.net），基于中华05标准（RUS-CHN05计分法），通过分析左手腕部正位X光片，评估儿童青少年骨骼发育程度，输出规范的骨龄诊断报告。\r \r 核心能力：\r

• AI自动推算骨龄（中华05 RUS-CHN05计分法，推理服务器端执行）\r
• 成年身高预测（中华05查表法 + BCPE拟合法）\r
• 人工修改骨骺等级后重新推算\r
• 历史报告查询\r \r 评估标准：中华05（Chinese 05）RUS-CHN05计分法，慧龄云®推理服务器端实现\r 适用范围：3~18 岁儿童青少年\r 评估部位：左手非利手腕部正位X光片\r \r ---\r \r

触发场景\r

\r 当用户提出以下任意请求时启动本技能：\r

• "帮我看看这张X光片的骨龄"\r
• "这张骨片显示几岁？"\r
• "我孩子骨龄发育正不正常"\r
• "上传了骨骼片，请分析一下"\r
• "骨龄评估/骨龄检测/身高预测"\r
• 附带手/腕部X光图片并询问发育相关问题\r \r ---\r \r

两种调用路径\r

\r

路径A：轻量路径（仅AI骨龄识别）⭐ 推荐\r

注册激活 → 密码登录 → 图片上传 → /bmd/v2/cosBoneAgeOnLineByThirdPartner\r
```\r
- 仅需参数：fileName + sex\r
- 返回：骨龄(bam)、SMS、stages、scores、标注图(url)\r
- 优势：参数少、响应快、职责清晰\r
- ⚠️ 需要"第三方"Shiro角色，无条件扣次数\r
\r
### 路径B：完整路径（AI骨龄 + 身高预测）\r
```\r
注册激活 → 密码登录 → 图片上传 → /bmd/v2/predictHeightByBoneAge\r
```\r
- 需要参数：sex、age、height、weight、detectedImgName、fatherHeight、motherHeight、telephone 等\r
- 返回：骨龄 + 预测身高 + 遗传靶身高 + 评估报告URL\r
- ⚠️ 非会员3次/分钟限频\r
\r
> 💡 默认使用**路径A**，仅在用户明确需要身高预测时切换到路径B。\r
\r
---\r
\r
## 分析流程\r
\r
### Step 1：收集必要信息\r
\r
向用户收集以下信息（缺失时逐一询问，不要一次问太多）：\r
\r
**路径A（仅骨龄）必填信息**：\r
1. **X光片图片**（用户上传手腕/手部X光片）\r
2. **性别**：男/女\r
\r
**路径B（骨龄+身高预测）额外必填信息**：\r
3. **年龄**：X岁X个月\r
4. **当前身高**（cm）\r
5. **当前体重**（kg）\r
6. **父亲身高**（cm）\r
7. **母亲身高**（cm）\r
8. **手机号码**（用于报告关联）\r
\r
**女性额外必填**（路径B）：\r
9. **是否已有初潮**：是/否\r
10. **初潮年龄**（已有初潮时）：X岁\r
\r
**可选信息**：\r
- 患者姓名（默认"匿名"）\r
- appid（用于微信消息推送，非必须）\r
\r
### Step 2：调用API完成骨龄推算\r
\r
按 `references/api-protocol.md` 中的接口协议，**严格按顺序**依次调用：\r
\r
**2.1 终端注册激活**（首次使用时）\r
```\r
POST {host}/v1/baClient/tidRegister\r
参数：{ "tid": "{终端唯一标识}" }\r
返回：{ "ret": true, "data": { "tid": "..." } }\r
```\r
\r
**2.2 密码登录**（⚠️ 核心关键环节，获取TOKEN）\r
```\r
POST {host}/auth/local/login\r
参数：{ "username": "...", "password": "{SHA256加密}" }\r
返回：{ "ret": true, "data": { "token": "...", "user": {...}, "expireTime": ... } }\r
```\r
⚠️ TOKEN 获取后缓存，后续所有接口需在 Header 中携带：`token: {JWT_token}  ⚠️ 注意：Header名是"token"而非"Authorization: Bearer"`\r
⚠️ 登录返回的 `user.id` 在人工修改等级时需要用到\r
⚠️ 登录返回的 `user.enable` 标识会员状态，`user.counts` 为剩余计算次数\r
\r
**2.3 获取图片上传预签名URL**\r
```\r
POST {host}/service/signForBAImageUploadEasy\r
参数：{ "fileName": "bone.jpg" }  ⚠️ 仅需 fileName，uuid 从登录态自动获取\r
返回：{ "ret": true, "data": { "signedUrl": "https://..." } }\r
```\r
\r
**2.4 上传图片**\r
```\r
PUT {signedUrl}\r
请求体：图片字节流\r
Content-Type: image/jpeg 或 image/png\r
返回：HTTP 200 即成功\r
```\r
\r
**2.5 AI骨龄推算**\r
\r
根据路径选择对应接口：\r
\r
**路径A：仅AI骨龄识别**（推荐）\r
```\r
POST {host}/bmd/v2/cosBoneAgeOnLineByThirdPartner\r
参数：{\r
  "fileName": "bone.jpg",   // 与上传时的fileName一致\r
  "sex": "M"                // M男/F女\r
}\r
⚠️ 此接口需要"第三方"角色，无条件扣次数\r
⚠️ 发送到推理服务器时参数名为 filename（小写n），Java后端自动转换\r
返回：{\r
  "ret": true,\r
  "data": {\r
    "url": "https://...",     // 标注后的X光片\r
    "bam": 10.5,              // ⚠️ 骨龄值，字段名是 bam（非 bam05）\r
    "sms": 465,               // 发育分数\r
    "fname": "bone.png",      // ⚠️ 标注后文件名，字段名是 fname\r
    "stages": [1,2,3,...],    // 13个骨骺等级\r
    "scores": [12.5,...],     // 各骨骺评分\r
    "sex": "M",\r
    "orderNo": "abc123..."\r
  }\r
}\r
```\r
\r
**路径B：AI骨龄+身高预测**\r
```\r
POST {host}/bmd/v2/predictHeightByBoneAge\r
参数：{\r
  "sex": "M",\r
  "age": 10.5,\r
  "height": 140,\r
  "weight": 35,\r
  "detectedImgName": "bone.jpg",  // ⚠️ AI推算用 detectedImgName\r
  "fatherHeight": 175,\r
  "motherHeight": 162,\r
  "telephone": "13800000000",\r
  "name": "匿名",\r
  "hasM": "no",            // 女性必填\r
  "appid": ""              // ⚠️ 可选，用于消息推送，非必须\r
}\r
返回：含 bam05、sms、stages、scores、url、predictedHeight 等字段\r
```\r
\r
**人工修改等级后重新推算**\r
```\r
POST {host}/bmd/v2/predictHeightFromWebBySms\r
额外参数：{\r
  "userId": "{从登录返回的user.id}",\r
  "selectedFileName": "bone.jpg",  // ⚠️ 人工修改用 selectedFileName\r
  "stages": [修改后的等级数组],\r
  "sms": "{修改后的sms值}",\r
  "rpImg": "{微信本地图片localId}"\r
}\r
```\r
\r
### Step 3：生成完整诊断报告\r
\r
基于 API 返回结果，按以下模板输出报告（**使用中文，语气专业亲切**）：\r
\r
---\r
\r
## 📋 骨龄分析报告\r
\r
> ⚠️ **免责声明**：本报告由AI辅助分析生成，仅供参考，不构成医疗诊断。如有疑问，请咨询专业医师。\r
\r
### 基本信息\r
| 项目 | 内容 |\r
|------|------|\r
| 评估日期 | {当前日期} |\r
| 评估方法 | 中华05标准 · RUS-CHN05 · AI辅助评估 |\r
| 受检者姓名 | {姓名} |\r
| 性别 | {男/女} |\r
| 实际年龄 | {X岁X个月} |\r
| 当前身高 | {XXX cm} |\r
| 当前体重 | {XX kg} |\r
\r
### 骨龄评估结论\r
**骨龄：{bam 或 bam05} 岁**（中华05标准）\r
\r
骨龄与实际年龄差值：**{bam - age} 岁**\r
\r
| 判定 | 差值范围 | 当前状态 |\r
|------|---------|---------|\r
| 正常 ✅ | -1 ~ +1 岁 | {判断结果} |\r
| 偏快 ⚠️ | +1 ~ +2 岁 | |\r
| 偏慢 ⚠️ | -1 ~ -2 岁 | |\r
| 明显超前 🔴 | > +2 岁 | |\r
| 明显落后 🔴 | \x3C -2 岁 | |\r
\r
### 骨成熟度评分\r
- **SMS总分**：{sms}\r
- **骨骺发育等级**：{stages数组，按13块骨骼名称映射展示}\r
\r
13块骨骼对应顺序：\r
桡骨、尺骨、掌骨I、掌骨III、掌骨V、近节指骨I、近节指骨III、近节指骨V、中节指骨III、中节指骨V、远节指骨I、远节指骨III、远节指骨V\r
\r
### 成年身高预测（仅路径B）\r
| 项目 | 数值 |\r
|------|------|\r
| 父亲身高 | {XXX cm} |\r
| 母亲身高 | {XXX cm} |\r
| 遗传靶身高（CMH-C） | {男：(父+母+11.94)/2；女：(父+母-11.94)/2} cm |\r
| AI预测成年身高 | **{predictedHeight} cm** |\r
\r
> 注：身高预测受多种因素影响，仅供参考，误差范围约 ±5cm\r
\r
### 发育状态解读\r
{2~3句话解释当前骨龄的含义，用家长能理解的语言}\r
\r
### 临床建议\r
{根据骨龄差值，给出1~4条具体、可操作的建议}\r
\r
### 温馨提示\r
- 骨龄评估误差约 ±1岁，属正常范围\r
- 如骨龄异常，建议至儿科内分泌科就诊\r
- 本报告不可作为法律或医疗鉴定依据\r
\r
---\r
\r
## 高级功能：人工修改等级后重新推算\r
\r
当用户对AI自动推算的骨骺等级有异议时，可手动修改后重新调用：\r
\r
```\r
POST {host}/bmd/v2/predictHeightFromWebBySms\r
参数：在AI推算参数基础上增加/修改：\r
{\r
  ...\r
  "userId": "{从登录返回的user.id}",\r
  "selectedFileName": "{人工修改用的文件名}",  // ⚠️ 注意字段名不同于AI推算\r
  "stages": [修改后的等级数组],\r
  "sms": "{修改后的sms值}",\r
  "rpImg": "{微信本地图片localId}"\r
}\r
```\r
\r
---\r
\r
## 高级功能：历史报告查询\r
\r
```\r
POST {host}/service/serviceLogs/getHistoryReports\r
参数：{ "limit": 10, "skip": 0, "sort": "desc" }\r
返回：历史报告列表，含 id、orderNo、createdAt、height、age、bam05 等\r
```\r
\r
---\r
\r
## 配置说明\r
\r
在使用本技能前，需确保以下配置已就绪（存放在环境变量或技能配置中）：\r
\r
| 配置项 | 说明 | 示例 |\r
|--------|------|------|\r
| `BONE_AGE_API_HOST` | 慧龄云®服务器地址 | `https://www.pipitu.net` |\r
| `BONE_AGE_USERNAME` | 登录账号 | `[email protected]` |\r
| `BONE_AGE_PASSWORD` | 登录密码（SHA256加密后） | `5e8848...` |\r
| `BONE_AGE_TID` | 终端唯一标识 | `TID-XXXXX` |\r
\r
⚠️ **appid 无需配置**：appid 是请求体中的可选参数（`jsonObject.containsKey("appid")`），仅在需要微信消息推送时传递。不需要提前配置，也不从登录结果中自动获取。\r
\r
⚠️ **Shiro角色**：使用第三方接口（`cosBoneAgeOnLineByThirdPartner`）时，登录账号需具备"第三方"角色。\r
\r
首次使用时，若配置缺失，需引导用户完成配置。\r
\r
## 注意事项\r
\r
1. **TOKEN有效期**：登录获取的TOKEN有过期时间（expireTime，单位秒），失效后（响应码401）需重新登录\r
2. **密码安全**：密码必须SHA256加密后传输，禁止明文\r
3. **图片格式**：支持JPG/PNG，通过预签名URL上传至腾讯云COS\r
4. **性别必须确认**：男女评估标准不同（RUSCHNTables 分 scoreBoy/scoreGirl），性别错误会导致骨龄偏差\r
5. **不要过度诊断**：骨龄差值在±1岁内属正常范围，使用"偏快/偏慢"而非"异常"\r
6. **免责声明**：每份报告必须包含免责声明\r
7. **手机号格式**：需符合 `1[3-9]\d{9}` 格式，否则校验失败\r
8. **空值处理**：空值字段需传递null，不可省略或留空字符串\r
9. **fileName字段区别**：AI推算用`detectedImgName`，人工修改用`selectedFileName`，上传预签名用`fileName`，不可混用\r
10. **返回字段名映射**：轻量路径返回 `bam`（骨龄）/ `fname`（文件名），完整路径返回 `bam05`（骨龄）\r
11. **推理服务器参数**：Java后端发送给推理服务器时 `fileName` 转为 `filename`（小写n），但API调用者只需传 `fileName`\r
12. **第三方计费**：第三方接口无条件扣次数（counts必须>0），内部接口非会员有限频（1次/周期）但有免费额度\r
13. **COS路径格式**：上传文件在COS中的key格式为 `{preDir}{uuid}/{fileName}`，uuid从登录态自动获取\r
\r
## 参考资料\r
\r
- 完整API接口协议（源码验证版）：`references/api-protocol.md`\r
- API调用辅助脚本：`scripts/bone_age_api_client.py`\r