Files

zhuhjay 68721d1abb refactor(qqmusic): 脚本改名 scrip_qqmusic_checkin.js 以匹配订阅白名单

订阅规则 ql repo 的 whitelist 参数是 "scrip_"，只有文件名带该前缀的才会被拉取。
原文件名 qqmusic_checkin.js 不在白名单内，青龙订阅拉不到。

- qqmusic/qqmusic_checkin.js -> qqmusic/scrip_qqmusic_checkin.js（git mv 保留历史）
- test_sign_run.js 的 require 路径同步
- qqmusic/README.md 与根 README.md 更新文件名与白名单约定说明
- 根 README 补 QQ音乐条目（环境变量 SH_QQMUSIC_KEY / cron 1 0,6 * * *）

依赖拉取不受影响：订阅命令的 dependence 参数 sendNotify|common 会额外拉这两个文件，
脚本的 require('../sendNotify') 仍指向青龙内置/仓库根的 sendNotify.js。

验证：node --check 通过 / 签名对拍 6 组向量全 PASS / 空 env 优雅跳过 /
单账号与 & 多账号解析正确 / 整串 cookie 形态解析正确

2026-11-04 20:49:54 +08:00

3.3 KiB

Raw Blame History

QQ音乐自动签到（scrip_qqmusic_checkin.js）

QQ音乐会员成长值任务 + 会员福利站自动签到，青龙面板 Node 零依赖。协议底座与 LDP924/auto-checkin（Python）逐字节同源： u6.y.qq.com/cgi-bin/musics.fcg 网关 + zzc 签名（sha1 重组 + 置乱表 + b64 去尾）+ qm_keyst cookie。

文件名必须带 scrip_ 前缀：本仓库的青龙订阅规则白名单是 scrip_，不带前缀的文件不会被订阅拉取（脚本、测试、文档同一约定）。

环境变量

变量	必填	说明
`SH_QQMUSIC_KEY`	✅	多账号：青龙同名 env 加多条（注入自动 `&` 连接）。单条格式 `<uin>#<qm_keyst>`，如 `123456789#Q_H_L_xxxx`。也接受整串 cookie（含 `qm_keyst=` 与 `uin=o...`）
`QM_KEY` / `QM_UIN`	备选	单账号兼容形态（`SH_QQMUSIC_KEY` 优先）
`QM_CACHE_DIR`	可选	key 缓存目录，默认 `/ql/data/qqmusic_cache`（青龙）/ `qqmusic/.cache`（本地）
`QM_PLAY_REPORT`	可选	`on` 才启用任务20播放上报（本版未实现模板，挂了开关占位）

凭证获取（web 抓一次，之后无限续）

浏览器打开 y.qq.com 登录（QQ/微信均可）
F12 → Application → Cookies → https://y.qq.com → 复制 qm_keyst 与 uin（o123456789 去掉 o）
青龙新建环境变量 SH_QQMUSIC_KEY，值 uin#qm_keyst

为什么抓一次就够：签名/g_tk 全是本地算法（无盐、无设备绑定、无动态 token）； qm_keyst 名义 72h，但续期接口 QQConnectLogin.LoginServer.QQLogin 旧 key 不吊销—— 脚本每次运行先续期，新 key 写缓存滚动，环境变量永远不用再动。只有脚本断跑超 72h 且缓存丢失（推送出现 🔴 2000）才需要重新抓。

缓存与订阅安全

续期产物存 /ql/data/qqmusic_cache/qm_<uin>.json（订阅仓库之外）。 git 的 reset/clean 只动 tracked 文件，untracked 目录在 git pull 下天然安全；且脚本读缓存优先、env 兜底，缓存丢失仅退化为"72h 内重新抓一次"。

定时

cron: 1 0,6 * * *

每天 00:01 + 06:02 双轮：任务20（收听节目）跨天滚动翻账本 + 福利站 0 点翻新兜底。

任务覆盖

层	内容	风险
任务中心	签到(15) / 挂件(5) / 装扮(5) / 听书(5) / 节目StartTask	低（等价 App 点击）
会员福利站	每日签到(15) / 礼券(+10心愿值) / 旅程激励 / 月里程碑 / 月度好礼 / 臻享抽奖	低（先探后做，无硬编码 ID）
播放上报	任务20 完整 +10 需 App 正常收听（伪造统计默认关）	中（默认关闭）
支付流水任务	4/5/6/12/14/18/21	不可伪造，不碰

状态三态机：Y=已完成零请求（防风控）/ W=进行中直接领 / N=执行动作。错误码处置：20020 冷却3s重领 · 30005 只读探测后补领 · 10006 写锁即停次日恢复 · 2000 登录态失效推送提示。

本地测试

node --check scrip_qqmusic_checkin.js     # 语法
node scrip_qqmusic_checkin.js             # 无 env 时优雅跳过
SH_QQMUSIC_KEY='123#Q_H_L_x' node -e "console.log(require('./scrip_qqmusic_checkin').parseAccounts())"

3.3 KiB Raw Blame History Unescape Escape