﻿========================================
  CTBU 校园网自动认证 v3.0.0
========================================

打开校园网认证页后，自动帮你：
  · 点选认证出口（可自己设置选哪个）
  · 识别验证码并自动填入、自动提交

不用再手点出口、不用再一个个数字敲验证码。

支持 Edge 和 Chrome。


────────────────────────────────────────
  使用须知（请先看一下）
────────────────────────────────────────

这个工具是个人学习做的，用来省掉每天重复点认证的麻烦。

  · 只用你自己的账号、你自己的设备、你自己的密码
  · 所有识别都在本机完成，不联网、不上传任何东西
  · 请遵守学校的校园网使用规定，风险自负
  · 不要转发到大群里，也不要用于别人的账号

它做的事本质上和「浏览器密码管理器 + 自动填表」没区别，
只是把「点出口」和「敲验证码」两步也省了。
但如果学校方面认为不合适，请立刻停用。
────────────────────────────────────────


----------------------------------------
一、安装（大约 1 分钟）
----------------------------------------

1. 把整个文件夹解压到一个不会被清理的地方
   （比如 D:\CTBU-AutoLogin 之类，别放"下载"文件夹里）

2. 打开浏览器的扩展管理页面：
     Edge   ：双击本文件夹里的「打开扩展管理页面.bat」
              如果没反应，就手动打开 Edge，地址栏输入 edge://extensions/
      Chrome ：手动打开 Chrome，地址栏输入 chrome://extensions/

3. 在页面左下角（Chrome 是右上角）打开「开发人员模式」

4. 点页面上方的「加载已解压的扩展程序」

5. 在弹出的文件选择框里，选中本文件夹里的 extension 目录
   （注意：选 extension 这一层，不是外面那层）

6. 列表里出现「CTBU 校园网自动认证」就装好了


----------------------------------------
二、使用
----------------------------------------

装好之后什么都不用做。

当你连上校园网、浏览器被劫持到认证页时，
扩展会自动接管：点出口 → 填验证码 → 提交。

页面右下角会有一个小提示条，显示它在做什么。


----------------------------------------
三、设置（可选）
----------------------------------------

点浏览器工具栏上的扩展图标（拼图图标 → 找到本扩展）。

可以设置：

  · 启用扩展        关掉之后什么都不做
  · 认证出口        默认是「学生移动出口」
  · 自动提交        关掉的话只填验证码，由你自己点「登 录」

出口有 5 个可选，对应认证页上的 5 个按钮：

     学生移动出口      移动
     学生联通出口      联通
     学生电信出口      电信
     新图书馆专用      校园网
     教职员工专用      default

⚠️ 出口别乱选。选错了会认证到错误的服务上（比如选成
   「教职员工专用」可能直接认证失败）。拿不准就用默认的。


----------------------------------------
四、常见问题
----------------------------------------

Q: 提示「没找到登录表单，请手动输入」？
A: 页面改版了，或者你不在认证页上。手动输一次验证码即可。

Q: 提示「没找到「学生移动出口」按钮，请手动点选」？
A: 学校改了按钮文字。提示条里会列出页面上的实际选项
   （格式是「按钮文字(serviceName)」），
   你可以去设置里换成对应的那个。

Q: 验证码识别错了怎么办？
A: 它会自动换一张重试（最多 6 次）。重试只花本地算力，
   只要不点提交就不消耗登录次数。

Q: 提示「不再自动提交」是怎么回事？
A: 两种情况，都是为了防止账号被锁：

   ① 上一次登录显示「密码错误」 → 扩展停手。因为再试也是白试，
      还白白增加失败次数。你把密码改对了自己点「登 录」就行
      （验证码已经帮你填好了）。

   ② 1 分钟内验证码错误超过 10 次 → 冷却 3 分钟。
      这通常说明验证码识别出问题了，先手动输几次。

   两种情况提示条里都会写出具体原因。

Q: 安全吗？会上传我的什么信息吗？
A: 完全离线。验证码识别模型（1 MB）打包在扩展里，
   扩展不发起任何网络请求，也不读取你的账号密码。
   学号密码还是由浏览器自带的密码管理器填充的。
   扩展只申请了 storage 一项权限，而且只用本地存储，
   不会把设置同步到微软账号（所以也不会出现在任何云端）。

Q: 会不会影响别的网站？
A: 不会。扩展只在这两类页面上生效：
   锐捷门户的 /eportal/ 页面，和 cas.ctbu.edu.cn 的登录页。
   主机权限为空，不访问任何网站数据。

Q: 提示条过一会儿自己消失了？
A: 正常。填完验证码后它会淡出，不挡你看页面。


----------------------------------------
五、更新版本
----------------------------------------

把新的 extension 目录整个覆盖进去，
然后到扩展管理页面点一下本扩展卡片上的刷新图标。

（路径别变：扩展 ID 由路径推导，换目录会被当成另一个扩展，设置会重置）


----------------------------------------
六、卸载
----------------------------------------

扩展管理页面 → 找到本扩展 → 移除。
然后把文件夹删掉即可。
