feat: 二维码登录改用 Release 直链 + 通知/令牌/代码精简优化

[xfxx2022]

kgcheckin 完整变更清单（合并前期修复 + 本次二维码登录修复）

本 PR 基于 xfxx2022/kgcheckin:main → develop202/kgcheckin:main
相对上游 upstream/main 共 16 个提交，改动 15 个文件，+966 / -299 行。

---

一、二维码登录功能（核心修复链路）

1.1 展示方案演进（解决"看不到 / 扫不上"）

阶段	方案	问题	结果
初版	ASCII 字符画（双宽 ██ / UTF-8 半块）	终端字体渲染、字符间距、屏幕缩放破坏像素对齐，手机扫不上	弃用
改进	Step Summary 内嵌 PNG <img> data URI	Summary 页面空白/不显示，且运行日志原生不支持图片	弃用
改进	自包含 HTML 登录页（artifact 上传）	GitHub artifact 强制打包成 .zip 压缩包，需解压才能看	弃用
最终	GitHub Release 直链	浏览器点开链接即显示图片本体，零解压	✅ 用户实测扫码登录成功

1.2 关键 Bug 修复

• gen 步骤不退出导致后续步骤不执行、二维码超时失效
  • 根因：genMode() 为 async 但入口未 await/.catch，且末尾无 process.exit(0)，Node 进程因悬挂资源无法退出 → GitHub 认为 step 未完成 → 后续 wait / artifact 步骤全为空心圆不执行。
  • 修复：入口加 .then(() => process.exit(0)).catch(e => process.exit(1))；close_api() 包裹 Promise.race([close_api, setTimeout(3000)]) 防止挂死。
• EADDRINUSE 127.0.0.1:3000 导致 wait 步骤崩溃
  • 根因：close_api() 仅给 npm 发 kill()，但 npm 不转发信号给子进程（真正的 Express 服务），3000 端口未释放，wait 再启动冲突。
  • 修复：startService 改用 detached: true 独立进程组；close_api 改用 process.kill(-pid, 'SIGKILL') 强杀整个进程组；移除 stderr 中的 throw（避免 npm 警告误触发崩溃）。
• 字符画渲染崩溃：修复 this 上下文丢失与参数顺序错误。
• Summary 图片/空白问题：多轮修复 Summary 写入时机与 <img> 渲染。

1.3 体验优化

• qrcodeLogin.js 拆分为 gen / wait 两种模式，跨 step 用 qrkeys.json 传递密钥。
• workflow 拆分为「生成二维码」→「发布直链」→「等待扫码」→「清理」多个独立 step。
• 登录后自动删除本次 Release（gh release delete qr-{run_id}），旧 Release 仅保留最近 3 个，避免持续堆积。
• 删除 Summary 内冗余二维码描述与日志中多余的 htmlpreview 链接，页面更整洁。
• 合并 qrcodeLogin.yml 等 workflow，统一二维码登录入口。

涉及文件：qrcodeLogin.js、utils/utils.js、.github/workflows/二维码登录.yml、.github/workflows/签到.yml、.github/workflows/手机号登录.yml、.github/workflows/合并.yml 等。

---

二、运行结果通知功能（前期）

• 新增 utils/notify.js 模块，支持 10 种通知渠道，全部使用 Node.js 内置模块实现，零外部依赖：
  企业微信机器人、钉钉机器人、飞书机器人、云湖机器人、Server酱、PushPlus、Telegram、Bark(iOS)、Discord、邮箱 SMTP。
• 通知内容包含：运行日期、账号数量、成功/失败统计、各账号听歌领取状态、VIP 领取次数、VIP 到期时间、错误信息。

---

三、令牌功能分析（前期）

• 梳理项目两类令牌：
  • GitHub PAT（Secrets.PAT）：通过 gh CLI 自动将酷狗登录信息写回 USERINFO Secret；每周日自动刷新酷狗 Token。
  • 酷狗登录 Token（Secrets.USERINFO）：酷狗 API 身份认证，签到核心凭证。

---

四、代码精简与优化（前期）

• 提取共享逻辑：新增 utils/userinfo.js，消除 phoneLogin.js 与 qrcodeLogin.js 中约 60 行重复代码。
• 修复拼写错误：youth_listen_song.js 中 encryptTyPe → encryptType。
• 修复变量遮蔽：qrcodeLogin.js 内层循环 i 遮蔽外层 i，改为 n/j。
• 清理冗余代码：移除 utils.js 注释代码、优化 notify.js 死代码与超时定时器。
• 净代码量 +525 新增 / -132 删除（通知模块与文档占主要增量，业务代码实际净减少）。
• 更新 README.md 说明二维码登录与令牌机制。

---

五、验证情况

• 二维码登录：本地桩服务模拟验证 gen 干净退出（exit 0）、wait 正常轮询到登录成功；GitHub Actions 实测扫码登录成功。
• 端口释放：Windows / Linux 双环境验证 close_api 不崩溃且端口可释放。
• 通知 / 令牌 / 精简：对应提交已通过日常 Actions 运行验证。