⭐️ 夸克网盘自动签到

通过 GitHub Actions 自动完成夸克网盘每日签到并领取空间奖励，支持单账号和多账号。

🚀 功能

• 北京时间每天约 09:00 执行签到，13:00 进行失败兜底。
• 当天所有账号成功后写入日期缓存，第二次任务自动跳过。
• 多账号逐个执行；某个账号失败不会阻断其他账号。
• 任何账号失败时工作流返回失败，并保留当天第二次重试机会。
• 每月在独立的 heartbeat 分支生成保活提交，不污染 main 历史。

📋 使用方法

1. Fork 并启用 Actions

Fork 本仓库后进入 Actions 页面。如果 GitHub 显示工作流尚未启用，请点击 I understand my workflows, go ahead and enable them。

工作流已经声明所需的最小权限：签到工作流仅使用 contents: read，保活工作流使用 contents: write。通常不需要手动把整个仓库的 Workflow permissions 改成读写权限；如果组织策略禁止保活分支写入，请联系组织管理员调整。

2. 获取签到参数

使用手机抓包工具（例如 ProxyPin）：

1. 开启 HTTPS 抓包后，在夸克 App 中进入网盘签到/领空间页面。
2. 搜索请求地址：https://drive-m.quark.cn/1/clouddrive/act/growth/reward。
3. 确认该 URL 的查询参数中包含 kps、sign 和 vcode。
4. 复制完整 URL，并按下方格式保存。

推荐格式：

user=张三; url=https://drive-m.quark.cn/1/clouddrive/act/growth/reward?...&kps=abcdefg&sign=hijklmn&vcode=111111111;

旧格式仍然兼容：

user=张三; kps=abcdefg; sign=hijklmn; vcode=111111111;

user 只是日志中的账号备注，可以自行填写。参数具有账号操作权限，绝不要提交到代码、Issue 或公开截图中；如怀疑泄露，请立即在夸克 App 中退出登录并重新获取。

3. 配置 GitHub Secret

进入 Fork 仓库的 Settings → Secrets and variables → Actions → New repository secret：

• Name：COOKIE_QUARK
• Secret：粘贴上一步整理的账号配置

多账号可以用换行分隔：

user=账号一; url=https://...;
user=账号二; url=https://...;

也可以使用 && 分隔：

user=账号一; url=https://...; && user=账号二; url=https://...;

4. 手动测试

进入 Actions → 夸克网盘每日签到 → Run workflow。第一次运行会真实请求签到接口；当天全部账号已经成功后，再次运行将显示“今日已全部签到成功，跳过重复执行”。

🔁 执行与重试逻辑

1. 工作流按北京时间生成当天的缓存键。
2. 如果缓存命中，签到相关步骤全部跳过。
3. 如果没有命中，逐个处理 COOKIE_QUARK 中的账号。
4. 所有账号成功或已签到时，保存当天成功标记。
5. 任一账号配置错误、凭证失效或接口异常时，工作流失败且不保存标记，13:00 会再次尝试。

❓ 常见问题

提示“缺少必要参数”

检查每个账号是否都包含 kps、sign、vcode，或者完整 URL 是否确实带有这三个查询参数。空行会自动忽略。

单账号正常，多账号失败

请确认账号之间使用换行或 && 分隔，并且每个账号都是一套完整参数。新版脚本会继续处理后续账号，并在日志中明确指出失败的是第几个账号。

提示“获取成长信息失败”或“凭证失效”

通常表示抓取的参数已经过期或不完整，请重新抓取并更新 COOKIE_QUARK。接口临时异常也会让工作流失败，但不会写入当日成功缓存，因此仍会保留第二次重试机会。

定时任务没有准点运行

GitHub Actions 的计划任务可能延迟数分钟到数十分钟，这是平台调度机制导致的正常现象。工作流还会加入最多 60 秒的随机延迟。

保活分支为什么每月被强制更新

heartbeat 是专门的孤儿分支，每月仅保留最新一条空提交，用于避免长期无活动的 Fork 被 GitHub 自动停用定时任务；它不会改动 main。

⚠️ 注意事项

• 本项目仅供学习交流，请勿用于非法用途。
• 夸克接口和参数可能随官方更新而变化；出现集中失效时请先查看 Issues。
• 频繁手动触发可能被服务限制，请谨慎操作。
• 本项目采用 MIT License。复制和分发时请保留原作者版权及许可声明。

本项目基于 BNDou/Auto_Check_In 的夸克签到功能修改而来。

🙏 贡献者

感谢以下贡献者对项目的改进：

• @Spectrollay — 优化签到工作流与自动化逻辑（#1）
• @haozihong — 将保活提交迁移至独立分支，保持主分支历史整洁（#4）
• @HSSkyBoy — 优化签到流程结构与按日期缓存机制（#16）

📧 联系邮箱：liucan01234@gmail.com

欢迎提交 Issue、PR 和 Star 支持项目发展。