宿舍门禁，一点即开

第 1 步 · 拿到凭证

钥匙是服务端按门下发的，只有天猫校园知道、也只会下发给它。所以要「拿」到钥匙，就得让它自己开一次锁，同时把过程记下来。有 root 走 root 一键抓取；没 root 用补丁版天猫校园。

adb logcat -c
adb logcat -v time \
  VocLockHelperV2:V VocLockHelper:V VocLockJsBridge:V VocUnlockBridge:V \
  BluetoothHelper:V VocLockManager:V VocLockSession:V VocLockBridge:V \
  ZMUnlockBridge:V VocStatistics:V VocLogger:V Logger:V TLog:V \
  '*:S' > p0_capture.txt

cd fktm
pip install pycryptodome
python cli.py verify --log p0_capture.txt

activationKey : 0123456789ABCDEF0123456789ABCDEF
macAddress    : AA:BB:CC:DD:EE:FF

方式怎么选

第 2 步 · 导入凭证

在 TmallKey 首页点「+ 添加门锁凭证」，有三种填法：

• 手工填写—— 填「名称」（默认「宿舍门」）、「门锁地址」、activationKey，然后保存。地址必须是 AA:BB:CC:DD:EE:FF 格式，钥匙必须是 32 位十六进制。
• 粘贴 JSON—— 直接粘贴 fktm/credentials.json 的整段内容，点「解析并导入」。同时支持带 locks 数组的完整结构和单个凭证对象两种形式：

{
  "locks": [
    {
      "name": "宿舍门",
      "address": "AA:BB:CC:DD:EE:FF",
      "activationKey": "0123456789ABCDEF0123456789ABCDEF"
    }
  ]
}

• 自动同步—— 补丁版天猫校园里点一次开锁后，钥匙会自动出现在列表里，不用手动导入； root 抓取则会把钥匙填进表单，确认后点「保存」。

凭证保存在本机 Android Keystore 的加密区。

第 3 步 · 开锁

回到首页，点卡片中间那个大按钮即可。首次会申请蓝牙权限，允许一次即可。

• 冷启动首次开锁约 1.2 秒，60 秒内再次开锁约 0.4 秒；
• 页面底部的「收发时序」会逐条显示收发字节，方便确认每一步都通了；
• 「查电量」按钮可以顺便读门锁电量。

连接不是常驻的，按两条计时规则自动回收 —— 进入前台先自动预连接，30 秒内没有开锁就断开；一旦开锁则保活 60 秒，期间再开锁会重新计时；退到后台（含息屏）立即让出。这是有意为之：把门锁的并发连接让给真正要用的人，下次开锁会自动重新连上。首页顶部的状态角标（● 已预连接 / ◌ 预连接中 / ○ 未连接）可以直接看到当前状态。

抓不到凭证？按这个顺序排查

先确认一件事：天猫校园这次开锁到底有没有成功？门必须真的开了才有日志可抓，先别急着怀疑 TmallKey。

补丁版：回到 App 没看到门锁

还是不行就把诊断信息发给开发者：

adb shell su -c "cat /data/data/com.fktm.app/files/water_diag.txt"   # 需 root
adb shell su -c "cat /data/data/com.tmall.campus.and/files/tmxydump_probe.log"  # 模块侧

电脑 adb 抓取