米游社签到（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 为例），三件事缺一不可：

~/.dsh/profiles/desktop/node_modules/@local/dsh-mys-checkin 指向克隆出来的目录（符号链接/目录联接）；
profile 的 package.json 里 dependencies 增加 "@local/dsh-mys-checkin": "link:<克隆目录的绝对路径>"；
同一文件的 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 条。

防检测设计

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

措施	实现
设备 ID 持久化	首次运行生成 UUID 并写入状态文件，之后永不改变；请勿删除 `state.json`，否则等同换机
签名与版本一致	`DS` 与 `x-rpc-app_version`、UA 尾部版本、salt 三者绑定，全部走同一份配置
每日一次	无论定时还是手动，当天成功跑过就不再自动执行；避免「一天多次全量签到」的特征
随机间隔	游戏之间随机 2–8 秒；定时时刻在窗口内均匀随机，不会整点触发
绑定查询缓存	`getUserGameRolesByCookie` 每个游戏每天最多一次
续期克制	只有服务端返回 `-100/-111/10001` 时才用 stoken 换一次 cookie_token，并只重试一次；不做定时刷新
失败即停	触发验证码（`1034/-999`）立即停止当日剩余游戏并提示，不反复重试
真实请求头	完整的 `x-rpc-*` 设备头、`Origin/Referer`、移动端 UA，随版本号统一

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

协议实现说明

环节	接口
扫码创建/轮询	优先 `POST passport-api.mihoyo.com/account/ma-cn-passport/app/createQRLogin` 与 `/app/queryQRLoginStatus`（`token_types=1`，返回 SToken）；失败时退回 `passport-api.miyoushe.com/.../web/...`
凭据续期	`GET passport-api.mihoyo.com/account/auth/api/getCookieAccountInfoBySToken`、`getLTokenBySToken`（登录阶段也会用 SToken 补齐 ltoken/cookie_token）
角色列表	`GET api-takumi.mihoyo.com/binding/api/getUserGameRolesByCookie?game_biz=…`
今日状态	`GET …/event/luna/{game}/info?act_id&region&uid` → `is_sign`、`total_sign_day`、`first_bind`（用于「累计签到」并在已签到时跳过签到请求）
账号昵称	`GET bbs-api.miyoushe.com/user/api/getUserFullInfo?uid=<ltuid>`（DS2 签名；失败时回退为游戏内昵称）
签到	`POST https://api-takumi.mihoyo.com/event/luna/{game}/sign`（绝区零用 `act-nap-api.mihoyo.com`）
签名	DS1：`md5("salt=<salt>&t=<t>&r=<6位随机>")` → `"<t>,<r>,<md5>"`；BBS 接口用 DS2（盐 `t0qEgfub…`，含 body/query）

默认参数：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。本项目仅用于个人账号的自动化，请自行承担使用风险。

米游社签到（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 为例），三件事缺一不可：

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

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

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

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

使用

1. 打开面板

为什么不是直接长在「自动化任务」页面里：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 条。

防检测设计

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

措施	实现
设备 ID 持久化	首次运行生成 UUID 并写入状态文件，之后永不改变；请勿删除 `state.json`，否则等同换机
签名与版本一致	`DS` 与 `x-rpc-app_version`、UA 尾部版本、salt 三者绑定，全部走同一份配置
每日一次	无论定时还是手动，当天成功跑过就不再自动执行；避免「一天多次全量签到」的特征
随机间隔	游戏之间随机 2–8 秒；定时时刻在窗口内均匀随机，不会整点触发
绑定查询缓存	`getUserGameRolesByCookie` 每个游戏每天最多一次
续期克制	只有服务端返回 `-100/-111/10001` 时才用 stoken 换一次 cookie_token，并只重试一次；不做定时刷新
失败即停	触发验证码（`1034/-999`）立即停止当日剩余游戏并提示，不反复重试
真实请求头	完整的 `x-rpc-*` 设备头、`Origin/Referer`、移动端 UA，随版本号统一

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

协议实现说明

环节	接口
扫码创建/轮询	优先 `POST passport-api.mihoyo.com/account/ma-cn-passport/app/createQRLogin` 与 `/app/queryQRLoginStatus`（`token_types=1`，返回 SToken）；失败时退回 `passport-api.miyoushe.com/.../web/...`
凭据续期	`GET passport-api.mihoyo.com/account/auth/api/getCookieAccountInfoBySToken`、`getLTokenBySToken`（登录阶段也会用 SToken 补齐 ltoken/cookie_token）
角色列表	`GET api-takumi.mihoyo.com/binding/api/getUserGameRolesByCookie?game_biz=…`
今日状态	`GET …/event/luna/{game}/info?act_id&region&uid` → `is_sign`、`total_sign_day`、`first_bind`（用于「累计签到」并在已签到时跳过签到请求）
账号昵称	`GET bbs-api.miyoushe.com/user/api/getUserFullInfo?uid=<ltuid>`（DS2 签名；失败时回退为游戏内昵称）
签到	`POST https://api-takumi.mihoyo.com/event/luna/{game}/sign`（绝区零用 `act-nap-api.mihoyo.com`）
签名	DS1：`md5("salt=<salt>&t=<t>&r=<6位随机>")` → `"<t>,<r>,<md5>"`；BBS 接口用 DS2（盐 `t0qEgfub…`，含 body/query）

目录结构

.
  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。本项目仅用于个人账号的自动化，请自行承担使用风险。

Veersion/dsh-mys-checkin

米游社签到（DSH 插件）

安装

使用

1. 打开面板

2. 登录

3. 自动签到

4. 提示与排错

防检测设计

协议实现说明

目录结构

测试

已知限制

许可证

Community comments

Veersion/dsh-mys-checkin

米游社签到（DSH 插件）

安装

使用

1. 打开面板

2. 登录

3. 自动签到

4. 提示与排错

防检测设计

协议实现说明

目录结构

测试

已知限制

许可证

Community comments