RoleKey 功能全景：Agent 时代的岗位数据物理授权入口

用户8252

8月11日修改

一枚一闪 Key 蓝牙硬件 + 一款 Android 员工端 App + 一套企业 IT 管理后台，通过「物理手势 × 交接工单 × 岗位上下文包」三层机制，把大模型从"员工自己找着用的聊天框"变成"企业授权、全程留痕、岗位即生效的工作大脑"。单击在场确认、三击知情确认、双击承诺放行——三步物理背书才解锁岗位数据，审计贯穿全链路，设备报失即刻冻结，让 AI 真正走进新员工上岗、离职交接、岗位知识传承、敏感操作审批等高价值企业时刻。​

本模块调试所用硬件（HID蓝牙协议）：

模块	调试和实拍所用硬件	备注
RoleKey（员工端）	调试和拍摄手机：VIVO-Nex3S/ 荣耀500	本质均为HID蓝牙协议，均可跑通，限于测试设备和测试手机，分别用了2款
一闪AIkey（C端）	调试和拍摄手机：华为Mate40 Pro/ 荣耀500	本质均为HID蓝牙协议，均可跑通，限于测试设备和测试手机，分别用了2款

核心模块概览

模块详述

一、一闪 Key 硬件入口

功能概述： 手机是 C 端 AI 的主入口，但企业岗位授权的高价值时刻往往发生在离屏场景：新员工刚领到工牌和硬件的那一刻、离职交接 HR 当面回收设备的那一刻、紧急敏感操作需要本人在场背书的那一刻。这些时刻员工不能靠"掏手机→解锁→找 App→点按钮"完成授权，必须有一枚随身佩戴、物理可触的信任锚点。RoleKey 采用"物理优先"设计原则：真实 BLE GATT 通道已由安卓研发打通，硬件按键不再是模拟按钮，单击、三击、双击三种手势分别对应"在场、知情、承诺"三层语义，配合事件签名与防重放机制，让物理按键既符合人体工学直觉，又满足企业级安全要求。未来硬件形态可扩展至智能戒指、方向盘磁吸键、耳机触控区、眼镜镜腿，协议不变。​

核心功能点：

•
三段式手势模型：单击 = 在场确认（员工在现场）、三击 = 知情确认（员工清楚知晓授权内容）、双击 = 承诺放行（员工最终同意执行），三步必须顺序触发、缺一不可​

•
真实 BLE GATT 通道：不再使用屏幕 Mock 按钮，直接监听一闪 Key 蓝牙硬件的 GATT Notify 事件，延迟 < 200ms​

•
硬件身份校验：仅响应已配对的 RoleKey 设备广播，设备 MAC 地址与绑定员工一一对应，杜绝其他蓝牙设备误触发​

•
事件签名与防重放：每次按键事件生成带时间戳与设备序列号的硬件签名，后端校验时间窗口防重放攻击​

•
多形态扩展预留：GestureEvent 协议与硬件形态解耦，同一套手势语义可迁移至戒指/手表/车机按键/耳机/眼镜等任意可穿戴入口​

二、三步物理授权 UI

功能概述： 传统企业系统的"知情同意"就是一个勾选项，员工根本不看就点过。RoleKey 把授权这件事拆成三个有时间差的物理动作，每一步都在屏幕上清晰展示当前进度、当前语义、以及即将授予的权限范围。三步必须按序完成、中途失败自动回退到第一步，授权前强制展示预览清单（授给哪个 Agent、能访问什么数据、多久失效、风险等级），让员工在按下最后一次双击前完全清楚自己在做什么。​

核心功能点：

•
三步进度可视化：Step1 在场 → Step2 知情 → Step3 承诺放行，当前步骤高亮、已通过步骤打勾、未到步骤灰显​

•
手势语义提示：每一步屏幕下方提示"请单击一闪 Key 确认你在场""请三击表示你已阅读授权内容""请双击完成最终承诺"​

•
授权预览清单：最终双击前展示清单卡片——被授权方、授权范围、有效期、风险等级、所授数据类型​

•
失败回退与超时：任何一步超时或手势错误，自动回退到 Step1，防止连按误授权​

•
Step 锁定动效：未到交接节点时三步卡片全部置灰不可操作，配合 Fallback 页说明当前状态​

三、Android 员工端 App

功能概述： 员工端是 RoleKey 在员工侧的唯一入口，是硬件与后端之间的桥：既要持续监听 BLE 硬件事件（哪怕 App 在后台），又要在授权完成后打开 H5 网关容器呈现岗位上下文，还要在设备被冻结时立刻把 UI 切成红态拦截。App 采用 Jetpack Compose 构建，内置保活前台服务、开机自启接收器、悬浮窗快速返回、电池白名单引导，确保员工双击硬件时 App 总能在 1 秒内响应。顶栏提供设置按钮允许员工手动配置后端地址（适配不同企业内网环境）。​

核心功能点：

•
BLE 事件持续监听：前台保活服务常驻，App 后台/锁屏时仍接收一闪 Key 按键事件​

RoleKey 功能全景：Agent 时代的岗位数据物理授权入口​

RoleKey 功能全景：Agent 时代的岗位数据物理授权入口