MiniMax签到助手
概述
本技能实现对 MiniMax Code（海螺AI） 的每日签到积分自动领取。签到按「连续签到天数」发积分，第 4 天、第 7 天为加码日（含额外奖励分），积分自到账起 30 天内有效。
签到机制与 MiniMax Code 客户端（Electron 桌面端，内部代号 mcode）完全一致：脚本读取客户端已落盘的登录凭证，按客户端同款参数与签名调用签到接口，完成「查状态 → 领积分」两步，全程接口直签，无需打开界面、无需手工复制 token。
核心逻辑封装在 scripts/minimax_checkin.py（纯 Python 标准库，无第三方依赖，跨平台）。
适用场景
当用户提出以下意图时触发本技能：
- "帮我 MiniMax 签到 / 海螺AI 自动签到"
- "每天自动领 MiniMax 积分"
- "设置定时任务，每天帮我去 MiniMax Code 签到"
- 需要在无界面环境下批量 / 定时领取 MiniMax Code 积分
凭证获取（全自动）
脚本按下列优先级自动挑选可用凭证，正常情况下无需用户提供任何内容：
| 优先级 | 来源 | 说明 |
|---|---|---|
| 1 | --token <accessToken> |
显式传入，用于排错 |
| 2 | 环境变量 MINIMAX_TOKEN |
适合 CI / 容器场景 |
| 3 | 本地缓存 ~/.minimax/checkin/token.json |
脚本自行维护，含身份信息与凭证 |
| 4 | 本机客户端登录态 | ~/.minimax/auth/prod/<区域>/mcode-public/auth.json，客户端明文 OAuth 凭证，随客户端自动保持最新 |
缓存与客户端登录态之间按凭证有效期取较新者；若全部过期，脚本会用 refresh_token 调用 POST {account}/oauth2/token 自动续期，并把新凭证回写客户端登录态，保证两边同步。
此外还内置 401 自愈：磁盘上的凭证可能按本地时间尚未过期、但已被服务端判定失效（客户端运行时会轮换 token，导致落盘凭证提前作废）。收到 401 时脚本会按 「当前凭证 → 本地缓存 → 客户端登录态」 顺序逐个尝试 refresh_token 续期并立即重试，同一 refresh_token 只试一次，任一来源成功即用其新凭证继续，不会「一次失败就放弃」。
> 因此：只要本机 MiniMax Code 客户端处于登录状态，本技能即可直接签到，无需任何人工操作。客户端凭证轮换、过期、被顶下线后重新登录，均由脚本自动处理。
>
> 详细的区域差异、手动兜底方式与常见问题见 @references/setup.md。
使用流程
1. 执行签到
使用 Bash 工具运行脚本（路径相对于本技能目录）：
python scripts/minimax_checkin.py
脚本会打印凭证来源、今日连续签到天数、今日状态与积分，并在可领取时自动领取。
常用参数：
| 参数 | 说明 |
|---|---|
--token <t> |
手动指定 accessToken（默认自动读取本机客户端登录态） |
--status-only |
仅查询签到状态，不领取 |
--json |
以 JSON 输出结果，便于被其他流程消费 |
--region cn\|global |
区域：cn 国内版（默认）、global 国际版 |
--store <path> |
自定义本地凭证缓存路径 |
示例：
python scripts/minimax_checkin.py --status-only
python scripts/minimax_checkin.py --json
2. 定时自动化（每日）
参考 @templates/daily-checkin.md，把脚本接入系统定时任务（Linux/macOS crontab、systemd timer，或 Windows 任务计划程序），每天固定时间（如 09:00）自动运行，实现无人值守签到。
由于凭证由脚本自动维护，定时任务不需要额外注入任何 token。
接口说明（自 MiniMax Code 桌面端 app.asar 还原）
| 用途 | 方法 | 路径 |
|---|---|---|
| 签到面板查询 | GET | {host}/minimax-cloud/api/v1/signin/status |
| 签到文案配置 | GET | {host}/minimax-cloud/api/v1/signin/config |
| 领取积分 | POST | {host}/minimax-cloud/api/v1/signin/claim |
| OAuth 续期 | POST | {account}/oauth2/token |
- 基础域名：国内版
https://agent.minimax.cn；国际版为https://agent.minimax.io，对应账号域名分别为account.minimax.cn/account.minimax.io。 - 鉴权头：
Authorization: Bearer <accessToken>；另含yy、x-timestamp、x-signature三个签名头。 - 请求参数：
device_platform / biz_id / app_id / version_code / unix / timezone_offset / is_desktop / desktop_version / uuid / device_id / user_id / op_ticket / screen_width / screen_height / client=desktop等，unix为秒对齐的毫秒时间戳。 - 签名算法（已在脚本中实现）：
x-signature = md5(秒级时间戳 + 固定盐 + 请求体字符串)yy = md5(encodeURIComponent(签名路径) + "_" + 请求体 + md5(毫秒时间戳) + "ooui")- 固定盐
I*7Cf%WZ#S&%1RlZJ&C2，后缀ooui - 签名路径 =
路径 + "?" + 全部参数（含 op_ticket=undefined、token=null）+ "&client=desktop" - 签到日状态码：
1=未开始、2=可领取、3=已领取、4=不可用；领取结果claim_result：1=领取成功、2=今日已领取。
排错
| 现象 | 处理 |
|---|---|
| 退出码 2：未找到可用凭证 | 打开 MiniMax Code 客户端完成登录，重新运行即可；或设置 MINIMAX_TOKEN / 使用 --token |
| HTTP 401（首次请求） | 脚本自动按「当前凭证 → 本地缓存 → 客户端登录态」逐个用 refresh_token 续期并重试，成功后凭证来源会显示为「… → 401 自愈续期」。常见诱因是客户端正在运行并轮换了 token，磁盘旧凭证被服务端提前判废 |
| 退出码 4：401 自愈后仍失败 | 各来源的 refresh_token 均已失效（通常是被顶下线或超过有效期）。让客户端联网运行，它会自动重新登录，随后重跑脚本即可 |
| 领取返回「今日已领取」 | 属正常，说明当天已领取，无需重复操作 |
| HTTP 429 频率限制 | 稍后重试，避免短时间内高频调用 |
| 网络超时 | 检查本机到 agent.minimax.cn 的连通性 |
版本说明
- v1.0.1：规范化修正。
- 显示名由「MinMax签到助手」修正为 「MiniMax签到助手」（I 大写，与 MiniMax 官方品牌一致）。
- 作者署名规范化：frontmatter
author与「关于作者」段统一为 龙猫科技说（longmaoit）。 - 模板样例文件
templates/daily-checkin.example重命名为templates/daily-checkin.md（消除自定义后缀，修复开放平台上传因「不允许的文件类型」被拒的问题）。 - v1.0.0：首发。实现「查状态 → 领积分」全流程，自动读取本机 MiniMax Code 客户端登录态并支持 OAuth 自动续期，纯标准库实现，支持状态查询、JSON 输出、区域切换与定时调度模板。
- 内置 401 自愈：收到 401 时按「当前凭证 → 本地缓存 → 客户端登录态」逐个用
refresh_token续期并重试，同一refresh_token只试一次，全部失败才以退出码 4 报错。
关于作者
本技能由 龙猫科技说（longmaoit）开发维护；相关更新、用法答疑与实战笔记发布于公众号 龙猫科技说。
