用户进入 App 的第一段路径。注册必须使用邀请码；登录成功后进入授权校验；被踢出、设备禁用、授权过期在这里拦截。
蓝牙写卡工具
使用管理员提供的邀请码开通账户
请检查输入后重新登录。连续失败时仍停留在登录页，不进入设备控制台。
请确认邀请码是否输入正确，或联系管理员重新生成邀请码。
App 已清理本地登录状态。请重新登录，或联系管理员解除限制。
DEVICE_DISABLED · 重新登录也会被拒绝
LICENSE_EXPIRED · 无法进入写卡流程
登录成功后的工具首页。这里承接账号授权校验，并集中展示当前设备、当前模拟卡槽、卡槽管理、本地卡片、围栏自动写卡和最近记录。
电量 82% · 固件 2.0.1 · 当前模拟卡槽 03。围栏自动写卡已开启，到达区域后自动写入指定卡槽。
进入公司园区后自动写入“公司门禁卡”到卡槽 03，无需再次选择文件或卡槽。
卡槽 03 · 公司门禁卡
查看 01-08 卡槽并写入或设为当前
选择写入来源或读取一张新卡
到达指定区域后自动写入绑定数据
围栏自动写卡 1 次 · 蓝牙断开 1 次
当前账号可使用蓝牙写卡功能，有效期至 2027-04-27。
orange@sanchuan.ic
本机在线 · 单设备登录中
2027-04-27 23:59
主写卡流程的设备准备段。按顺序处理蓝牙权限、系统蓝牙开关、设备扫描、连接中和连接成功。
App 只使用蓝牙连接写卡设备，不会扫描无关数据。
用于扫描和连接写卡设备
三川IC助手需要通过蓝牙连接写卡设备。开启后会自动继续扫描附近设备。
系统蓝牙开关未开启
RSSI -48 · 上次连接 18 秒前
RSSI -61 · 可连接
请保持设备靠近手机
正在握手、读取固件版本和卡槽状态，请不要关闭蓝牙。
BLE GATT 通道已建立
电量、固件、卡槽数量
电量 82% · 固件 2.0.1 · 8 个卡槽可用
选择卡片数据并写入设备卡槽
当前模拟卡槽 03
设备连接成功后选择本次要写入的卡片数据。这里可以直接选本地卡片，也可以分流到“读取新卡”。
MIFARE Classic · UID 04:A7:9C:21
MIFARE Classic · 已写入过 03
NTAG · 只读备份
读取成功后立即进入写入流程
UID 04:A7:9C:21 · 16 个扇区 · 本地保存
1K
可写入 Chameleon Ultra
此卡片数据无法写入当前设备或目标模式。请更换卡片数据后重试。
设备固件不支持该卡片类型
从“选择卡片”分出的支线。读取成功后命名保存，并把新卡作为已选写入内容回流到卡片确认。
正在读取 UID、卡片类型和可写数据。读取过程中请保持卡片贴近设备。
已连接 · 电量 82%
请勿移动卡片或关闭蓝牙
UID 04:A7:9C:21 · 1K · 16 个扇区
新读取的卡片默认作为本次写入内容
卡片移动过快或距离设备过远。请重新贴近设备后再次读取。
等待卡片响应超时
保持卡片贴近设备并重新读取
手动写入来源最终回到这里：本地卡片、读取新卡，都必须选择目标卡槽并确认覆盖风险。围栏自动写卡的卡槽在规则创建时预先绑定。
写入后卡槽 03 的原有数据会被替换。建议先复制到本地再继续。
公司门禁卡
卡槽 03 · 停车卡
MIFARE Classic · 1K
电量 82% · 已连接
写入后可设为当前模拟
主写卡闭环的结束段。写入过程中保持设备连接，成功后可设为当前模拟；失败和断开直接贴在写入节点旁边。
72% · 正在写入扇区 11/16。写入过程中请不要关闭蓝牙或离开页面。
校验完成
传输中
等待执行
公司门禁卡已成功写入 Chameleon Ultra，可立即设为当前模拟卡槽。
公司门禁卡 → 卡槽 03
设备当前模拟卡槽已切换到 03，可以直接使用设备进行刷卡。
当前模拟：公司门禁卡
卡槽 03
设备距离过远或蓝牙连接不稳定。卡槽可能处于未完成状态，建议重新写入。
扇区 11 写入超时
靠近设备后重新写入同一卡槽
写入流程已暂停。重新连接同一设备后，可以继续或重新开始写入。
2026-04-28 09:41 · 写入成功
2026-04-27 18:30 · 蓝牙超时
2026-04-28 08:58 · 自动写入卡槽 03 成功
2026-04-27 18:31 · 距离过远
日志导出、DFU 固件升级、围栏订阅/分享/同步暂不展开
从设备控制台进入的核心支线。围栏自动写卡必须完整配置四步：设置围栏点、配置写入文件、选择写入卡槽、保存规则数据。
需要允许定位，才能在本机判断是否进入围栏
后台自动写卡依赖系统定位能力，关闭后不会自动触发
搜索小区、公司或停车场后再调整边界点
点击地图添加多个点形成区域
5 个点 · 可拖动调整
MIFARE Classic · UID 04:A7:9C:21
MIFARE Classic · 已写入过 03
NTAG · 只读备份
将作为围栏命中后的自动写入来源
MIFARE Classic · 可写入 Chameleon Ultra
目标卡槽在规则保存前固定。命中围栏时不再弹出选择卡槽页面。
进入围栏后自动把“公司门禁卡”写入卡槽 03。规则保存前必须完成一次风险确认。
公司园区 · 5 个边界点
公司门禁卡 · MIFARE Classic
卡槽 03 · 进入围栏后自动覆盖写入
定位命中后直接进入写入流程并推送结果通知
通知不是独立业务，而是主流程和围栏自动写卡的结果反馈。写入完成、自动写卡中、蓝牙断开都要能落回对应处理页。
写入完成、写入失败、蓝牙断开、进入围栏自动写卡时，需要通过本地通知提醒。
成功、失败、写入中断
进入区域后自动写入和结果提醒
写卡或刷卡模式中设备断开
已写入 Chameleon Ultra 的卡槽 03。点击通知后进入此页面，可继续设为当前模拟。
卡槽 03 · 公司门禁卡
打开写入结果详情
规则已命中，正在把“公司门禁卡”自动写入 Chameleon Ultra 的卡槽 03。
公司园区 · 进入围栏区域
公司门禁卡 · MIFARE Classic
卡槽 03 · 自动覆盖写入
正在写入扇区 11/16
写卡或刷卡模式可能已中断。点击通知后进入此页面，优先引导用户重新连接。
蓝牙连接丢失或设备距离过远
写入流程已暂停，等待重新连接
这些不是组件库展示，而是挂在对应操作节点上的确认和异常反馈：覆盖、最终写入、写入中退出、退出登录、权限拒绝、围栏自动写卡确认。
底部弹窗用于二次确认高风险覆盖操作。
原有“停车卡”数据会被替换。建议确认已备份后继续。
MIFARE Classic · 1K
电量 82% · 已连接
即将写入
写入过程中请勿关闭蓝牙、退出页面或移动设备。
正在写入扇区 11/16。
退出可能导致目标卡槽数据不完整。建议等待写入完成。
正在读取设备信息。
取消后需要重新扫描附近设备。
蓝牙权限被拒绝时，无法扫描或连接 Chameleon 设备。
请在系统设置中允许蓝牙权限，否则无法连接设备并开始写卡。
通知权限被拒绝时，写入结果、蓝牙断开和围栏触发只能在 App 内展示。
请在系统设置中允许通知权限，否则离开 App 后无法收到写卡和围栏提醒。
设备当前模拟卡槽已切换。
点击“重新校验授权”后，成功只显示短反馈；如果服务端返回过期、踢出或设备禁用，立即跳转登录拦截页。
当前账号已授权，正在本机单设备登录。
退出后会清理本地登录状态，需要重新登录才能继续使用写卡功能。
蓝牙断开时先用顶部 Banner 提醒，再引导用户处理。
扇区 11 写入超时。
建议靠近设备后重新写入同一卡槽。
进入公司园区后将自动把“公司门禁卡”写入卡槽 03。触发时不再二次选择文件或卡槽。
进入围栏时没有可用蓝牙设备，因此没有执行自动写卡。
完整实现登录注册、授权校验、单设备在线校验和设备控制台闭环：蓝牙权限、通知权限、蓝牙关闭、设备扫描、连接、当前模拟卡槽、本地卡片、读取新卡、01-08 卡槽管理、覆盖确认、写入进度、成功、设为当前模拟、失败、断开重连、地图多点绘制围栏区域、选择自动写卡数据、绑定目标卡槽、进入围栏后自动写入。
完整卡包高级管理、复杂自动化编排、围栏订阅/分享/同步、DFU 固件升级、日志导出、本地高级工具、复杂账号中心暂时不展开。第一阶段只保留本地卡片选择、手动卡槽写入、围栏区域配置、自动写卡数据绑定、目标卡槽绑定、进入围栏自动写入和结果通知。
底部只保留 3 个入口：设备、记录、我的。第一阶段默认进入设备控制台；记录展示写卡、蓝牙断开、围栏自动写卡记录；我的只展示授权、登录状态和退出登录。
写入失败、蓝牙断开、授权失效、设备被禁用、通知权限关闭、覆盖写入确认、写入中退出确认必须优先设计并实现。写卡类 App 不能只做成功路径。