故障排查与认证页采集
| 现象 | 优先检查 |
|---|---|
| 安装后没有菜单或页面报模块缺失 | 包型、依赖、Lua CBI 兼容性；重新登录 LuCI |
| 无法连接 Wi-Fi | SSID、无线密码、信号、无线电占用、企业认证及未应用的 UCI 修改 |
| 已连接 Wi-Fi，但无 IPv4 | DHCP、出口接口、防火墙与校园接入限制 |
| 已能上网，未发现认证地址 | 指定登录页或选择学校预设后继续探测；互联网连通性不提供网关地址本身 |
| 认证后缀为空或未读取到 | 认证页是否公开选项、预设是否记录；使用手动输入或网页采集 |
| 账号归属未能判断 | 该账号是否在线、网关是否返回账号/域信息、是否在相同线路；这不是后缀枚举结果 |
| 密码错误或认证拒绝 | 实际完整登录名、账号状态、密码与 AC_ID，不要将错误视为验证成功 |
| 网关可达，互联网不可达 | 网页认证结果、探测目标、当前线路和路由，结合具体错误排查 |
| 手动登出后再次上线 | 自动认证是否仍开启 |
| 多 WAN 某条线路失败 | 该账号的接口、IPv4、设备和认证参数，不以其他 WAN 在线代替判断 |
| 无线任务未完成回滚 | 是否有并发网络修改；依据提示检查 network / wireless / firewall |
提供问题信息时包含插件版本、固件与包管理器、接入方式、失败步骤、经过脱敏的相关日志。Wi-Fi 与校园认证使用不同密码；同一账号被其他客户端维护时可能相互抢占会话。
参数收集与问题反馈
优先使用插件的一键配置：先选择接入线路，探测认证地址和后缀，再填写账号。保存成功后可生成预设 Issue 草稿，操作说明见 贡献学校预设。
插件不能执行任意门户 JavaScript。对于动态选项、特殊编码或未公开后缀的页面，可手动填写已知值；若浏览器能登录而插件不能，请通过 学校不适配反馈 提供页面地址、出错步骤与脱敏日志。
需要进一步诊断时，可在浏览器开发者工具中核对正常登录请求的 ac_id、用户名后缀和登录参数。不要公开完整 HAR、Cookie、密码、challenge、token、info、chksum 或未经检查的原始响应。浏览器登录成功不代表插件已经适配，应分别说明结果。