dsh-mys-checkin

米游社签到（DSH 插件）

在 DSH 左侧栏新增一个「米游社签到」任务面板：扫码登录米哈游账号，每天在你设定的时间窗口内随机挑一个时刻，为已绑定的米哈游游戏自动签到。登录失效、触发人机验证或签到失败时，面板和界面顶部都会给出提示。

A DSH plugin that adds a 米游社 (Miyoushe) task panel to the sidebar: QR-code login, one randomized daily check-in per game, and in-UI alerts when the session expires or the check-in fails. Zero runtime dependencies — Node built-ins only.

• 支持游戏：原神、崩坏：星穹铁道、绝区零、崩坏3、未定事件簿、崩坏学园2
• 宿主侧完成全部网络请求与定时；浏览器侧只渲染面板，Cookie 不会经过浏览器
• 所有设置都在这个面板里，DSH 设置页不再新增分区
• 零运行时依赖（只用 Node 内置模块），不需要 pnpm 安装任何包

安装

先克隆到任意目录：

git clone https://github.com/Veersion/dsh-mys-checkin.git

安装由 DSH 的 profile 完成（下面以 desktop profile 为例），三件事缺一不可：

1. ~/.dsh/profiles/desktop/node_modules/@local/dsh-mys-checkin 指向克隆出来的目录（符号链接/目录联接）；
2. profile 的 package.json 里 dependencies 增加 "@local/dsh-mys-checkin": "link:<克隆目录的绝对路径>"；
3. 同一文件的 dsh.profile.bundles 数组里增加 "@local/dsh-mys-checkin"（只有列进 bundles 才会被启用）。

只写 dependencies 不写 bundles 是最常见的「装了但没生效」原因。

改完后 DSH 会通过 HMR 重新组合插件树；如果没有自动生效，重启 DSH 即可。

卸载：把上面两处条目和链接删掉，重启 DSH；再删除 ~/.dsh/mys-checkin/（里面有登录凭据）。

使用

1. 打开面板

左侧栏「自动化任务」旁边有一个同级的「米游社签到」面板（圆圈对勾图标）。任务由宿主后台调度器执行，不依赖某个会话是否打开，也不消耗模型 token。

为什么不是直接长在「自动化任务」页面里：DSH 那个页面只托管会话提醒（到点向某个会话投递提示词，由模型继续处理），没有给第三方插件留页面内插槽，也不能调度后台命令。所以签到做成同级面板，执行与可靠性由插件后台调度器保证。

2. 登录

在面板顶部点「扫码登录」，用米游社 App 右上角「扫一扫」扫描二维码并在手机上确认。

• 二维码只在本机生成，不上传到任何第三方；
• 若浏览器支持 BarcodeDetector，对话框会顺带做一次「二维码自检」，识别失败会提示刷新；
• 登录成功后状态变为「已登录」，并显示昵称与 UID；
• 登录优先走 App 扫码通道：服务端会在二维码里请求 SToken，确认后插件用 SToken 换取 ltoken 与 cookie_token，这样登录过期时才能自动续期。只有 App 通道创建二维码失败时，才退回网页通道；网页凭据可以签到，但不含 SToken，无法自动续期，面板会明确提示并提供重新扫码入口。
• 换到的 ltoken 是 V1 令牌，会和 ltuid / account_id 配对；插件会自动补齐这些 ID Cookie，避免出现「能查角色、签到却报 -100」。
• 0.2.1 会自动修复 0.2.0 存下的登录凭据，不需要重新扫码；更早的网页凭据仍建议重新扫码。
• 账号卡上的「删除登录」需要点击两次确认，会清空本机保存的凭据、错误提示与角色缓存。

登录凭据保存在 ~/.dsh/mys-checkin/state.json（明文，仅本机可读）。共享电脑上请注意这一点。

3. 自动签到

• 时间窗口：默认 18:00–18:30，可增删（最多 4 个）。每天只执行一次，实际时刻在窗口内均匀随机。
• 窗口编辑规则：开始时间晚于（或等于）结束时间时，结束时间自动变成「开始 + 1 分钟」，不会拒绝保存；多个窗口允许相同时间（调度器取第一个尚未结束的窗口）；「添加窗口」会在上一个窗口基础上后移 1 小时，方便直接微调。
• 错过窗口后补跑：若 DSH 在窗口结束后才启动、且当天还没签过，会在 3–10 分钟内随机补跑一次。可关闭。
• 游戏：只给勾选的游戏签到；没有角色的游戏会自动跳过并记录。
• 任务操作：页头的「立即运行」「暂停 / 启用」，以及任务卡片里的状态、频率、下次运行、上次运行摘要。
• 运行结果：顶部是汇总卡（今日签到账号数、是否自动签到、签到时间、已完成/总数），下面每个游戏一张卡，列出 UID、签到状态、今日奖励、累计签到天数。
• 运行日志：最近 200 条。

账号区显示的是米游社昵称 + 纯数字米游社 UID（来自 ltuid），并尽量加载社区头像；不再显示 mid 这类内部标识。

4. 提示与排错

• 面板顶部横幅：登录失效 → 提供「重新扫码」；人机验证 → 说明如何处理；其它失败 → 「重试签到」。
• 界面顶部小药丸（shell.overlay）：只要存在未清除的失败状态就会显示，可点 × 关闭当次提示。
• 「检测接口与登录」会实际请求一次绑定接口，报告网络是否可达、登录是否有效、耗时多少。
• 「运行日志」保留最近 200 条。

防检测设计

「用一段时间就失效」基本都不是签名问题，而是设备指纹与凭据刷新链的问题。插件按下面的原则实现：

仍无法完全避免风控：米游社的验证码与设备指纹策略会变化。不要在同一台机器上用同一个 DSH 频繁登录多个账号，也不要在短时间内反复手动补签。

协议实现说明

默认参数：x-rpc-app_version = 2.109.0，salt = d9200c846b10886e8c874fc33c8f308b。米哈游更新客户端后这两项可能都要换，可在「高级设置」里修改，无需改代码。

目录结构

.
  index.js             宿主插件入口（注册服务）
  client.js            浏览器 bundle（侧边栏任务面板 + 顶部提示）
  cordis.patch.yml     把插件插入 profile 配置树的 bundle patch
  lib/config.js        配置默认值、游戏表、校验
  lib/store.js         状态文件（原子写、迁移、日志环）
  lib/ds.js            DS 签名、请求头、Cookie 解析
  lib/http.js          带超时与重试的请求封装
  lib/mys.js           米游社协议（扫码/角色/签到/续期）
  lib/qr.js            二维码编码器（字节模式、M 级、版本 1–15）
  lib/scheduler.js     每日随机窗口调度（纯函数 + 定时器）
  lib/service.js       宿主服务：路由、登录态、签到流程
  test/                单元测试与端到端测试（假接口）
  .github/workflows/   CI：Node 22 / 24 上跑全部测试

测试

无需安装依赖：

node test/protocol.test.mjs
node test/schedule.test.mjs
node test/qr.test.mjs
node test/service.test.mjs

qr.test.mjs 内置一个独立的解码器：读回格式信息、反掩码、反交织、校验每个 Reed–Solomon 块的 syndrome 全为零，并核对数据模块数量与版本容量一致。

已知限制

• 无法自动通过验证码：1034 是全域人机验证，只能去米游社 App「我的 → 我的角色」处理。
• 网页凭据无法续期：只有 App 扫码通道下发 SToken；网页通道的凭据到期后必须重新扫码（面板会提示）。
• Cookie 明文落盘：这是本地自动签到的必要代价；如需更强保护，可把 ~/.dsh/mys-checkin 放在加密卷上。
• 只支持国服（*_cn 的 game_biz 与 luna 接口）。
• 一次运行约 1 分钟：为了避免特征化请求，游戏之间有随机间隔。

许可证

MIT。本项目仅用于个人账号的自动化，请自行承担使用风险。