访问码页面逐项控件参考
本页按访问码页面的实际 UI 区域说明通知折叠区、感应状态、生成标签、网页绑定、图片识别和用户绑定。敏感值均不在本文展示。
页面整体结构
页面通常包含：
- 页面标题和说明；
- 可展开的变更通知；
- 卡片/感应支持状态；
- 网页领取/绑定按钮；
- 用户 ID 绑定入口；
- 一次性/长期访问码标签；
- 二维码和文本；
- 页面说明和错误提示；
- 回到顶部按钮。
账号未登录时，生成和绑定按钮可能不可用。当前账号、目标机台和页面权限要在操作前确认。
变更通知折叠区
通知默认可能收起。点击标题展开或收起不会发送请求。展开时应阅读：
- 当前推荐的领取方式；
- 备用访问码的使用条件；
- 是否需要在配方页面开启缓存/登录状态；
- 新旧流程的差异；
- 当前公告日期。
通知中的示例和旧日期只用于说明，不应直接复制到配置或反馈。
感应状态卡片
页面会根据浏览器/设备能力显示：
- 支持但尚未扫描；
- 正在扫描；
- 设备不支持；
- 扫描错误；
- 已读取卡片数据。
不支持感应不影响二维码文本流程。扫描时保持卡片靠近设备，完成后等待页面回调；不要连续快速启动多个扫描。
领取/绑定按钮
“在工坊领取”类按钮打开网页登录弹窗。它不是直接生成一次性码；弹窗内还要选择领取方式、输入二维码文本或选择图片，并可能选择目标机台。
“修改用户 ID 绑定”类按钮打开另一种绑定弹窗。两个弹窗的输入范围不同，不要把一个弹窗的字段复制到另一个。
一次性访问码标签
选择一次性标签后，点击生成按钮：
- 按钮进入处理中；
- 成功后显示二维码图像；
- 同时显示文本/编号；
- 页面说明其适合单次或临时使用；
- 失败时保留错误提示，不重复提交。
生成后只在目标设备使用一次，使用完删除截图和文本副本。过期后重新生成，不要用旧码测试网络。
长期访问码标签
长期码适合受保护设备的持续登录。生成后：
- 不要放公开聊天或公开网盘；
- 保存用途和生成时间；
- 泄露时先停止使用并通知管理员；
- 重新生成后更新目标设备；
- 用 Token 验证和最小登录流程验收。
长期码成功不代表一次性码也有效，两个生命周期要分开排查。
二维码预览
二维码预览区显示二维码和编号。移动端使用时：
- 保持四个定位点完整；
- 提高亮度；
- 不要裁剪边缘；
- 避免反光和压缩；
- 不要截取包含其它账号信息的整屏。
二维码显示成功只说明网页生成了文本，不代表机台已经读取或验证成功。
网页绑定弹窗：领取方式
弹窗可能提供两种标签：
- 主服务领取；
- 私房/离线领取。
切换标签只改变当前表单。切换后应重新检查必填项，不能把上一标签的内容直接当作当前标签有效。
主服务领取表单
二维码文本/图片
输入框可能提示“请输入访问码或选择二维码图片”。右侧“选择图片”按钮打开文件选择器。识别成功后填入文本，失败时显示错误。
自定义服务地址
通常提示“留空使用默认地址”。留空是首选；只有管理员明确要求时填写。不要把 Token、密码或二维码拼接到 URL。
目标机台 ID
有权限账号可能看到下拉列表，列表项优先显示本地别名，没有别名时显示标识。也可能提供自定义输入。提交前检查目标不是另一台机台，空值不要默认为当前目标。
人机验证
页面可能要求人机验证。验证结果只用于当前提交，不要保存、截图或写入日志。验证过期时重新完成页面流程。
备用/离线领取表单
备用流程可能不显示主服务二维码字段，但仍可能要求访问码、目标和自定义地址。页面显示哪些字段就填写哪些，不要凭主服务表单推测隐藏字段。
备用流程常与缓存/离线配方一起使用。领取成功后仍要做登录、记录和上传缓存验收，不要把“能进入机台”当作数据同步完成。
用户 ID 绑定弹窗
绑定弹窗可能提供：
- 二维码绑定标签；
- 用户 ID 绑定标签；
- 二维码文本/图片；
- 自定义地址；
- 纯数字用户 ID 输入；
- 取消/确认。
用户 ID 输入必须是页面要求的数字格式。不要把昵称、Token、访问码或机台标识填进该框。绑定结果不明确时先重新读取账号状态，不要更换一个随机 ID 重试。
通用按钮状态
| 状态 | 视觉表现 | 操作 |
|---|---|---|
| 未输入 | 按钮禁用或提交提示 | 补齐必填项 |
| 生成中 | 显示处理中 | 等待，不重复点 |
| 成功 | 二维码/文本出现 | 只在受信范围使用 |
| 失败 | 红色消息 | 记录非敏感消息和时间 |
| 过期 | 码不可用 | 重新生成 |
| 目标不符 | 绑定拒绝/无效果 | 核对目标机台和账号 |
访问码问题排查
| 现象 | 第一检查 | 第二检查 |
|---|---|---|
| 生成按钮没反应 | Token/页面加载 | 浏览器网络 |
| 图片识别失败 | 定位点/清晰度 | 改用文本 |
| 网页生成成功但机台拒绝 | 码生命周期 | 机台网络/目标 |
| 临时码可用、长期码不可用 | 生命周期/是否撤销 | 重新生成长期码 |
| 绑定后无变化 | 目标 ID/账号 | 重新读取和重启提示 |
| 感应不支持 | 浏览器/设备能力 | 使用二维码 |
页面级安全清理
完成后清理：
- 复制到剪贴板的长期码；
- 下载目录中的二维码图片；
- 图片识别临时文件；
- 未使用的临时码；
- 绑定弹窗草稿。
不要把完整访问码贴到故障反馈中。需要关联时使用脱敏别名、时间和错误消息。