班级端悬浮球 · 使用说明
========================

【这是什么】
  教室电脑上的一个小圆球。不用的时候它就待在桌面角落，
  点一下就用浏览器打开班级端（没有地址栏，看起来像个独立软件）。
  有同学被呼唤时，它还会把班级端窗口自动弹到最前面 ——
  **即使班级端网页根本没打开，它也会自己把网页打开并弹出来给学生看。**

【第一次一定要做的设置：填班级码】
  球要自己知道「有没有人呼唤学生」，就得认识你们班，所以要填一次班级码：
    1. 右键点击球 → 「设置班级码…」
    2. 填上班级码（就是班级端网页登录时输的那串字母数字，如 SNKV2S；
       班级端登录页上能看到，也可以问班主任）
    3. 点「确定」——会立刻帮你检查一次，告诉你现在有没有呼唤
  填之前，球的右上角会有一颗小红点提醒你「还有东西没设置」；填好就消失了。
  如果班级端网页本来就在这台电脑上开着，那么网页也会把班级码自动告诉球，
  但网页没打开时球学不到，所以还是手动填一次最保险。

【怎么用】
  1. 把 ClassDeskBubble.exe 放到一个不会被删掉的位置
     （建议：D:\班级端\ 或 桌面。不要放"下载"文件夹，容易被清理）

  2. 双击运行。桌面角落会出现一个蓝色的圆球

  ★ 如果电脑上还有「旧版悬浮球」：直接双击这个新 exe 就行 ——
    新版一运行会自动检测并删除旧版的所有残留（旧脚本版 C:\ClassDesk 文件夹、
    旧的 ClassDeskBubble.exe 进程、旧快捷方式、旧开机自启），然后再启动。
    不用你手动去找哪个是旧的、去哪删。

  3. 左键单击圆球   → 以最大化窗口打开班级端（保留任务栏和缩小按钮；
                      已经开着就直接切过去，不会开出第二个窗口）
     按住左键拖动     → 挪到任意位置（会自动记住）
     右键单击圆球     → 打开菜单

【右键菜单】
  打开班级端              立即打开 / 切到班级端
  呼唤自动弹出：          下面三项都属于这一组
    状态：…               显示当前情况（正常 / 连不上服务器 / 未设置班级码）
    设置班级码…           填一次班级码，呼唤才能自动弹出（见上文）
    立即检查一次（测试）  手动问一次云端，马上告诉你现在有没有学生被呼唤
  设置球上文字…           把球上的字改成你的班级名，比如「5班」
  开机自动启动      ✓     勾上后，电脑开机自动运行这个球（推荐勾选）
  开机时自动打开班级端 ✓  勾上后，开机时连班级端网页一起打开
                          （勾这项会自动帮你勾上"开机自动启动"）
  始终显示在最前面  ✓     勾上后球不会被其他窗口盖住
  在桌面创建快捷方式      在桌面放一个图标，球被误关后双击就能重新打开
  回到默认位置            球被拖到屏幕外找不到了，用这个恢复
  退出                    关闭这个小工具

  说明：前面打勾 ✓ 的选项，点一下勾上、再点一下取消。

【第一次使用】
  打开班级端后需要输入「班级码 + 班级密码」，这跟平时在浏览器里打开是一样的。
  登录过一次之后，当天再打开就不用重复输入了；
  第二天第一次打开需要重新输入密码（班主任可以在小程序里关掉这个要求）。

【常见问题】

  Q：从老师点「呼唤」到教室电脑弹出大字，要等多久？
  A：班级端网页开着时：网页自己约 1 分钟内会显示大字，球负责把它弹到最前面；
     网页没打开时：球每 8 秒问一次云端，一般 10 秒内电脑上就会自己打开班级端并显示大字。
     （球是按网页状态自动调节查询快慢的：网页没开 8 秒、最小化 30 秒、前台 60 秒；夜间 22:00~7:00 统一每 5 分钟一问 ——
       白板网页白天约每 1 分钟问一次，夜间休息时间基本不轮询。）

  Q：老师在手机上点了「呼唤学生」，教室电脑却没弹出来？
  A：按顺序检查三件事：
     1. 球的右上角有没有小红点？有 → 说明「班级码」还没填（见上文）。
     2. 右键球 → 「状态」那一行写的是什么？
        「正常」= 球在正常守着，呼唤来了会弹；
        「连不上服务器」= 这台电脑网络不通，检查网线 / 无线；
        「未设置班级码」= 见第 1 条。
     3. 还是没弹？右键球 →「立即检查一次（测试）」，它会直接告诉你现在有没有呼唤。
     排查记录在 C:\Users\你的用户名\AppData\Roaming\ClassDeskBubble\log.txt，
     把这个文件发给我，一眼就能看出问题在哪。

  Q：电脑上弹出来了，但网页停在要输密码的界面？
  A：班级端每天第一次打开需要输入「班级密码」（这是防止学生在教室里乱用的设置）。
     输一次之后当天就记住了，球后面弹出的窗口都会直接是大字呼唤界面。

  Q：呼唤弹出来了，会不会一直弹、影响上课？
  A：不会。老师发出呼唤后，网页显示过一次就回执给云端，球就不再重复弹。
     万一老师忘了撤销，云端也只保留 10 分钟。

  Q：点球没反应？
  A：如果班级端已经开着，球会把它切到最前面（可能在别的窗口后面）。
     任务栏找一下，或者再点一次球。

  Q：杀毒软件报警怎么办？
  A：这是自己编译的小工具，没有数字签名，部分杀软会误报。
     选择"允许"或"信任此文件"即可。
     如果是从网页下载的 exe 弹了蓝色的"Windows 已保护你的电脑"，
     建议改用 ZIP 下载：解压出来的文件不会有这个提示。

  Q：怎么改球上的字？
  A：右键球 →「设置球上文字…」，输入班级名（最多 4 个字），比如 5班、高一3班。

  Q：球不小心退出了，怎么再打开？
  A：右键球 →「在桌面创建快捷方式」，会在桌面生成一个图标；
     以后双击桌面那个图标就能重新打开球。

  Q：想换班级端网址？
  A：配置文件在 C:\Users\你的用户名\AppData\Roaming\ClassDeskBubble\config.txt
     改里面的 url= 那一行，保存后重启小工具。

  Q：重装系统 / 换电脑后设置还在吗？
  A：不在。重新双击一次 exe，重新勾选"开机自动启动"、重新设置球上文字即可。

  Q：这个球会不会影响上课？
  A：球很小（58 像素），可以拖到角落。如果全屏放 PPT 时它挡住内容，
     右键关掉"始终显示在最前面"即可，或者直接退出。
