歌蓝健康数据整理归纳

### 第 1 步：检查登录状态

`node ./index.js auth check-login`

### 第 2 步：未登录时进行登录

扫码方式登录（命令会打开浏览器）：

`node ./index.js auth login`

无法打开浏览器的环境（如远程服务器、CI） → 手动设置凭证：

node ./index.js auth set-unionid --unionid <unionid> --token <token>

凭证需向用户索取，不要凭空编造。用户需要到歌蓝健康小程序的设置里面的绑定里面获取unionid，`node ./index.js auth set-unionid` 有两个参数可以单独设置，优先设置`unionid`

登录后再次运行 `auth check-login` 确认登录成功，确认成功后才可继续。

### 第 3 步：上传文件
根据文件类型选择命令：

图片（支持一次上传多张）：

`node ./index.js tidyinduction upload-images <image1> [image2 ...]`

PDF（一次仅支持一个文件）：

`node ./index.js tidyinduction upload-pdf <file>`

两个命令均可加 `--interpret` 选项开启报告解读（默认关闭）。

### 第 4 步：记录并反馈结果
上传成功后，命令会返回 order_id。必须完成以下事项：

提取并保存 order_id：从命令输出中解析 order_id。
反馈给用户：向用户报告上传结果（成功/失败、上传的文件数量），并明确告知 order_id。
告知后续用途：提示用户可凭该 order_id，通过"歌蓝健康查询"技能获取对应的归纳整理结果。
反馈示例：

✅ 已成功上传 2 张体检报告图片。
📋 订单号（order_id）：xxxxxxxx
归纳整理需要一定处理时间，稍后可使用该订单号通过"歌蓝健康查询"获取整理结果。

与"歌蓝健康查询"技能的衔接
order_id 是本技能与"歌蓝健康查询"技能之间的唯一关联凭证，务必完整保留并告知用户。
若用户上传后立即要求查看归纳整理结果，应携带 order_id 切换到"歌蓝健康查询"技能进行查询，而不是在本技能内处理。
若同一会话中有多次上传，需分别记录每次的 order_id，并向用户说明各自对应的文件。
命令参考
命令	说明
auth check-login	检查是否已登录
auth login	扫码登录（需要浏览器）
auth set-unionid --unionid <unionid> --token <token>	手动设置登录凭证，两个选项可单独使用
auth logout	登出并清除本地凭证
tidyinduction upload-images [options] <images...>	上传一张或多张体检报告图片，成功后返回 order_id
tidyinduction upload-pdf [options] <file>	上传体检报告 PDF 文件，成功后返回 order_id
-V, --version	查看版本号
-h, --help	查看帮助
参数校验规则
--unionid：必须以 oGY7V5头，总长度 28 位。格式不符时提示用户重新提供，不要直接执行。
上传前确认文件路径存在、文件类型正确（图片走 upload-images，PDF 走 upload-pdf）。
若用户同时提供图片和 PDF，分别调用对应命令，并分别记录各自返回的 order_id。

## 免费额度与会员说明

新用户免费赠送 30 张上传额度，图片与 PDF 共用该额度。

当累计上传超过 30 张后，以下命令会被拦截，无法继续上传，需要使用歌蓝健康会员开通 skill 开通会员才能继续上传，歌蓝健康会员的技能名称是 szgran-member-skill：

**处理规则（务必遵守，按顺序执行）：**

1. **先询问用户意愿**：提示免费额度已用完，询问用户是否要开通歌蓝健康会员。**不要在未征得用户同意的情况下自行获取或使用会员技能。**
2. 用户确认要开通会员后，首先检查本地 skill 目录中是否已存在 `szgran-member-skill`。若已存在，直接使用本地该技能，**不要**到 skillhub 下载。
3. 仅当本地 skill 目录中**不存在** `szgran-member-skill` 时，才到 skillhub 下载该技能后再使用。
4. 用户拒绝开通会员时，停止上传流程，告知用户当前额度已用完即可，不要继续其他操作。

- `node ./index.js tidyinduction upload-images <image1> [image2 ...]`
- `node ./index.js tidyinduction upload-pdf <file>`



### 错误处理
情况	处理方式
npm install 失败	检查 Node 版本与网络，将错误信息反馈给用户
check-login 显示未登录	引导用户完成第 2 步登录流程
凭证无效或过期	执行 logout 后引导用户重新登录
上传失败	展示错误信息，确认文件路径和登录状态后重试一次
上传成功但未返回 order_id	视为异常，将完整输出反馈给用户，提示可能无法查询整理结果
上传被拦截（超过 30 张免费额度）	先提示用户免费额度已用完并询问是否开通会员；用户同意后，再检查本地 skill 目录是否已有 szgran-member-skill（有则直接使用），没有时才从 skillhub 下载，然后根据 szgran-member-skill 的使用方式开通会员；用户不同意则停止上传流程
### 完整示例

cd scripts && npm install                              # 首次安装依赖
node ./index.js auth check-login                       # 检查登录
node ./index.js auth login                             # 扫码登录（或用 auth set-unionid 设置凭证）
node ./index.js tidyinduction upload-images ./report1.jpg ./report2.jpg   # 上传图片，返回 order_id
node ./index.js tidyinduction upload-pdf ./health_report.pdf              # 上传 PDF，返回 order_id
node ./index.js auth logout                            # 登出
注意事项
本技能仅负责体检报告的上传、整理与归纳，不提供报告解读功能。若用户要求解读报告内容，请告知超出本技能范围。
查询归纳整理结果不属于本技能，需凭 order_id 使用"歌蓝健康查询"技能完成。
体检报告属敏感健康数据，不要将文件内容或凭证输出到不必要的地方。
不要在未确认登录状态的情况下直接执行上传命令。





**本次新增内容：**

1. **第 4 步升级**：从单纯"反馈结果"改为"记录并反馈结果"，要求模型必须解析输出中的 `order_id`、告知用户并说明用途，附带反馈话术示例。
2. **新增"衔接"章节**：明确 `order_id` 是两个技能间的唯一关联凭证，规定用户要查结果时应切换到"歌蓝健康查询"技能，并处理多次上传对应多个 `order_id` 的场景。
3. **错误处理补充**：新增"上传成功但未返回 `order_id`"的异常处理。
4. **description 与注意事项同步更新**：让技能路由知道上传后有 `order_id` 可供后续查询，同时划清查询功能的边界。