触觉接触标定
触觉接触标定为「单个用户 + 单只手套」训练专属的接触检测模型,让触觉热力图准确区分接触与未接触。每个「用户 + 手套」组合至少完成一次标定,更换用户或手套后重新标定即可。
开始前需先登录 Studio 用户。触觉标定模型按用户保存,未登录无法开始标定。创建方法见使用前准备 > 用户档案。
触觉接触标定仅适用于 Wuji Glove(触觉手套),与设备标定(指尖捏合、四指弯曲等姿态标定)相互独立,互不影响。
标定主页
进入前请先在 设备管理 页连接要标定的 Wuji Glove。点击 Activity bar 的 Tactile Calibration 图标 进入标定主页:左侧 Devices 边栏列出已连接手套及其标定状态,右侧居中显示标题、流程说明与启动按钮。

在边栏选中手套,点击 Start calibration 进入标定流程。已标定手套显示 Re-calibrate,点击为重新标定,两者流程相同。
启动按钮在以下情况不可用:
- 未连接手套:提示 Connect a Wuji Glove first
- 已连接但未选中:提示 Select a Wuji Glove in the device tree on the left
- 后台服务启动中:提示 sidecar starting…,稍候即可
开始标定
全程戴着手套做空手动作,不要触碰任何物体。这一步在建立「未接触」基线,碰到桌面、手指或其他物体都会污染数据,导致接触判定不准。
标定按顺序采集 4 个引导动作,每个采集 10 秒。各动作的图示与操作要点见下方 动作总览。
完成一个动作
每个动作的操作一致:
- 阅读当前动作的提示和图示
- 点击 Start,开始 10 秒采集倒计时,在这 10 秒内把该动作重复做 3 次
- 采集结束后点击 Next motion 进入下一个动作
对结果不满意点击 Re-record 重录当前动作。采集中可随时点击 Cancel 取消并返回主页。
动作总览
| 步骤 | 图示 | 动作 | 操作要点 |
|---|---|---|---|
| 1 | ![]() | Fold four fingers down, then thumb in | 四指伸直并拢,在指根处下折约 90° 再张开,反复进行。最后一次下折时,拇指横向收进掌心 |
| 2 | ![]() | Five-finger claw | 五指(含拇指)一起向掌心蜷曲成爪形,再张开,反复进行 |
| 3 | ![]() | Spread & close | 五指伸直,尽量张开到最大,再并拢,反复进行 |
| 4 | ![]() | Curl fingers one by one | 从食指到小指,依次将每根手指弯向掌心 |
标定完成
采完第 4 个动作后自动开始训练,界面显示 Training… 与进度。训练完成后进入实时验证:按压手套不同位置(指尖、掌心),对应区域在热力图上变红,并提示 Press different spots on the glove (fingertips, palm) — matching areas should light up red.
完成页提供三个操作:
| 操作 | 说明 |
|---|---|
| Done | 确认效果,完成标定。界面显示 Calibration complete,模型已为当前用户与该手套保存 |
| Re-calibrate | 效果不理想时从头重新标定 |
| Back | 返回标定主页 |
标定模型自动保存,绑定当前 Studio 用户与手套 SN,下次订阅触觉数据时自动加载。
模型保存位置
标定生成的触觉接触模型按当前 Studio 用户档案与手套隔离保存:
~/.wuji/sdk/models/users/<用户档案 ID>/<手套 SN>/目录下包含 contact.safetensors(模型权重)和 contact.npz(参考数据)两个文件。每个用户档案独立保存一份,切换用户或更换手套互不影响,SDK 按当前用户与手套自动加载对应模型,无需手动指定。
何时需要重新标定
出现以下情况建议重新标定:
- 更换使用者或更换手套
- 触觉热力图接触判定明显异常(轻触不亮,或未接触却变红)
- 设备维修或更换部件后
操作:在验证页点 Re-calibrate,或回到标定主页选中手套、点 Start calibration(已标定显示 Re-calibrate)重做。
调整接触灵敏度
页面右上角的 Contact sensitivity 控件控制热力图中「多大压力判定为接触」:
| 项 | 说明 |
|---|---|
| 范围 | 0.5×–3.0×,默认 1.0×(Less 更难触发,More 更易触发) |
| 作用 | 数值越高,更轻的按压也会判定为接触 |
| 生效 | 按手套独立保存,调整后立即生效,无需重新标定 |
异常处理
触觉标定中可能遇到以下情况:
| 现象 | 原因 | 处理 |
|---|---|---|
| 主页提示 sidecar starting…,启动按钮不可用 | 后台标定服务尚未就绪 | 稍候几秒,服务就绪后按钮自动可用 |
| 提示 Sidecar stopped,标定已中止 | 后台服务中断 | 重新进入主页点 Start calibration 重试 |
| 采集或训练失败,提示 Operation failed. Check the device connection and try again. | 设备连接异常或数据中断 | 检查手套连接,重新开始标定 |
| 反复失败 | / | 重启 Studio,仍失败请联系 support@wuji.tech |



