检测插件
晓葆检测插件是面向宿主小程序的嵌入式健康检测能力。宿主通过wx.navigateTo 唤起插件，即可获得蓝牙设备配对、检测数据采集与上报、 AI 解读等完整链路，无需自行实现 BLE 协议与指标解析。
产品概述
插件以微信小程序插件包形式交付，宿主声明引用后即可嵌入。 宿主只需实现两端逻辑：
| 端 | 宿主需实现 |
|---|---|
| 服务端 | ① 跳转签名接口（生成加密档案 + HMAC-SHA256 签名） ② Webhook 接收端（接收检测结果推送） |
| 前端（小程序） | ① app.json 声明插件② wx.navigateTo 携带跳转参数唤起插件③ onShow 读取出参 |
安全铁律：
appSecret 只能在宿主服务端持有， 禁止写入小程序前端代码。签名与档案加密必须在服务端完成后再传给前端。接入场景
同一套插件支持三种宿主场景，差异体现在跳转参数组合上：
| 场景 | 宿主示例 | 用户体系 | 典型用途 |
|---|---|---|---|
| 第三方渠道 | 保险公司 → 慢病管理小程序 | 匿名 / 渠道用户 ID | B 端合作，检测数据经渠道服务端中转 |
| 健康站 | 晓葆健康站（设备二维码扫码进站） | 晓葆登录态（微信 / 手机号） | 线下站点，扫码直连指定设备 |
| 品牌应用 | 晓葆自有品牌小程序 | 晓葆登录态 | 家用设备、App 内嵌检测 |
第三方渠道场景（匿名用户）在跳转参数中传
thirdUserId + 加密档案； 健康站 / 品牌应用场景传 sessionToken（晓葆登录态）。 当前开放平台文档以第三方渠道场景为主，其他场景联系商务对接。支持设备
| deviceKey | 设备类型 | 跳转入口 | 备注 |
|---|---|---|---|
HOME_MULTI_BIO_MONITOR | 多合一生化仪（血压 / 血糖） | bind | 需传 measureMode（BP / BG） |
HOME_SPO2_RING | 指环血氧仪 | bind | — |
HEARTLOG_ECG_RECORDER | 心电记录仪 | bind | 约 30s 采集；报告含 PDF |
BODY_COMPOSITION_ANALYSIS | 人体成分秤（体脂） | bind | userProfile 中 height / gender / birth_date 必填 |
接入流程
| 步骤 | 操作方 | 说明 |
|---|---|---|
| ① 商务开通 | 宿主 | 联系晓葆商务，获取凭证（appKey / appSecret / webhookSecret / 插件 AppID） |
| ② 微信配置 | 宿主前端 | 在微信公众平台申请插件，app.json 声明引用 |
| ③ 服务端实现 | 宿主服务端 | 实现「跳转签名接口」（加密档案 + 签名）和「Webhook 接收端」 |
| ④ 前端接入 | 宿主前端 | wx.navigateTo 唤起插件，onShow 读取出参 |
| ⑤ 联调验收 | 宿主 + 晓葆 | 沙箱端到端验证：Mock 检测 → Webhook 接收 → 业务写入正确 |
凭证说明
商务审批通过后，沙箱与生产各下发一套凭证：
| 凭证 | 存放位置 | 用途 |
|---|---|---|
appKey | 服务端环境变量（可明文传前端） | 应用标识，插件启动时携带 |
appSecret | 仅服务端，禁止进前端 | 签名计算 + 档案加密密钥 |
webhookSecret | 仅服务端（宿主在开发者门户自行设置） | Webhook 推送验签 |
| 插件 AppID | 小程序 app.json | 声明引用晓葆检测插件 |