Nico-2222/dsh-mys-checkin

给 DeepSeek Harness（dsh）用的 Cordis 插件：每天自动完成米游社（miHoYo BBS）里的游戏社区签到。

支持国服六个游戏，安装后在面板里自己勾选要签哪几个：

游戏	id	act_id
原神	genshin	e202311201442471
崩坏：星穹铁道	starrail	e202304121516551
绝区零	zzz	e202406242138391
崩坏3	honkai3rd	e202306201626331
未定事件簿	tears	e202202251749321
崩坏学园2	honkai2	e202203291431091

特性

• 扫码登录：用「米游社」App 扫一次码，插件自己换取并保存长期凭证；不读浏览器 cookie、不要密码。
• 逐游戏选择：面板勾选启用的游戏，每个游戏下所有绑定角色（含多区服）逐一签到。
• 米游社风格面板：官方「米游社」标识与六个游戏的官方社区头像，蓝青渐变、玻璃卡片；样式与图标随包发布，离线可用。
• 每日定时：默认 00:30（Asia/Shanghai）+ 0–10 分钟随机延迟；关机错过则启动时补签一次（签到幂等，-5003 视为已签）。
• agent 工具：mys_checkin_status / mys_checkin_now / mys_checkin_games / mys_checkin_schedule，可以直接让助手帮你查状态或立刻签到。
• 结果留痕：每次运行记录每个角色的结果、累计天数、当日奖励名，面板里可看最近 14 次。

安装

dsh plugin --profile <profile> add dsh-mys-checkin

或者本地开发时把目录复制进 profile 的 node_modules，并把包名加进 profile package.json 的 dsh.profile.bundles。

重启 dsh 后打开面板：

http://127.0.0.1:<port>/mys-checkin

（默认端口以 dsh web 打印为准；桌面端通常是 127.0.0.1:55113。）

首次使用：点「获取二维码」→ 米游社 App 扫码 → 手机确认 → 勾选游戏 → 保存设置。

配置

全部字段都有默认值，通常只在面板里改。需要写 YAML 时，在 profile 的 cordis.patch.yml 里按 row id 覆盖：

- id: mys-checkin
  name: dsh-mys-checkin
  config:
    games: [genshin, starrail, zzz]
    signTime: "00:30"
    jitterMinutes: 10
    autoSign: true
    catchUp: true
    panelPath: /mys-checkin

字段	默认	说明
games	[]	要签到的游戏；空表示还没选，面板里勾选后写入状态文件
signTime	00:30	每日执行时间（Asia/Shanghai）
jitterMinutes	10	随机延迟上限（0–120 分钟）
autoSign	true	是否自动执行
catchUp	true	启动时若当天没有运行记录则补签
panelPath	/mys-checkin	面板路径
dataPath	空	状态文件路径；空 = $DSH_HOME/data/mys-checkin/state.json

安全与隐私（重要）

• 插件不包含任何账号、token、cookie；凭证只在你本机扫码后生成。
• 凭证保存在 $DSH_HOME/data/mys-checkin/state.json，文件权限 0600，原子写入。
• 令牌只出现在发往 *.mihoyo.com 的请求头里：不写日志、不出现在 agent 工具返回值、面板接口只回传掩码后的 UID。
• 卸载/换账号时删掉该状态文件即可；面板也有「退出登录」。
• 面板与 API 只挂在 dsh 的 loopback 端口上，没有独立鉴权：请勿把该端口暴露到公网或反代到外网。
• 同一台机器只维护一份凭证（单账号）；多账号请用不同的 dataPath 起第二个 profile。

界面素材

lib/assets/ 下的「米游社」标识与六个游戏的官方社区头像取自米游社官网资源（bbs-static.miyoushe.com、fastcdn.mihoyo.com、www.miyoushe.com/assets），只为让面板认得出是哪个游戏。相关商标与美术资源版权归米哈游（miHoYo）所有，本项目不主张任何权利，也不代表官方；若官方有异议可随时移除这些图片（面板会退回纯文字）。

面板 HTML 放在 lib/panel.html，每次请求都会重新读取：改样式不用重新加载插件（重启 dsh 之后生效的那一次除外）。

返回码

retcode	含义	插件行为
0	签到成功	记录奖励名与累计天数
-5003	今日已签到	视为成功，继续下一个角色
-100 / -1001	凭证失效	用 stoken 换新的 cookie_token 重试一次；仍失败则提示重新扫码
-500001	缺 x-rpc-signgame 头或 DS 签名不匹配	检查游戏表里的 signgame / 客户端版本常量
10001	参数错误（act_id 过期等）	更新 lib/games.js 里的 act_id

已知限制

• 只支持国服（cn_gf01 / cn_qd01 等）；国际服（HoYoLAB）端点与 salt 不同，未包含。
• 米游社客户端更新后 BBS_VERSION / WEB_SALT 可能失效，表现为 -500001，需要跟进更新 lib/api.js。
• 只做游戏签到，不含米游币社区任务、云游戏签到、商城兑换。
• 定时依赖 dsh 进程存活；进程不在时靠下次启动的补签覆盖当天。

免责声明

本项目仅用于个人账号的签到自动化，与米哈游无关。请自行评估账号风险：保持低频率、只用本插件对自己的账号签到，不要用于批量/商业用途。因使用本插件造成的账号限制或损失，作者不承担责任。

License

MIT