前言¶
跑 DeepSeek Harness（DSH）做智能体或自动化时，米游社 BBS 的每日签到往往仍是单独脚本或浏览器插件在管：要维护 cookie、要跟客户端版本走，还不能跟 dsh 的调度与工具面统一。社区插件 dsh-mys-checkin（维护者 Nico-2222）以 Cordis bundle 形式接入 dsh，用二维码登录、按游戏勾选、定时签到，并暴露给 Agent 的工具接口。下面介绍它定位什么、能做什么、怎么装怎么用，以及使用时的边界与安全注意。
这是什么¶
dsh-mys-checkin 是面向 DeepSeek Harness 的联网类插件：对账号下已绑定的角色，在国服米游社侧执行每日游戏签到，覆盖原神、崩坏：星穹铁道、绝区零、崩坏3、未定事件簿、崩坏学园2。插件自带 Web 面板与 YAML 可覆盖配置，状态落在本地 state.json；包内不预置账号或令牌，凭证仅在你扫码后出现。
在 SkillHub 插件目录 中归类为「联网工具」；源码与说明见 GitHub：Nico-2222/dsh-mys-checkin（许可证 MIT，当前 package 版本 0.1.0）。
核心功能¶
README 中列出的能力均可对照实现核对，主要包括：
- 二维码登录：米游社 App 扫一次码，插件自行用 ticket 换取长期凭证，无需浏览器 cookie jar，也不保存明文密码。
- 按游戏启用：在面板或配置里勾选玩的游戏；账号下各服已绑定角色会按启用列表签到。
- 每日调度：默认东八区 00:30，可加 0–120 分钟随机抖动；支持启动时补签（
catchUp）。签到幂等，返回码 -5003 表示当日已签，按成功处理。 - Agent 工具：
mys_checkin_status、mys_checkin_now、mys_checkin_games、mys_checkin_schedule，便于在对话或自动化里查状态、立即签到、改游戏列表或看调度。 - 审计记录：按角色记录结果、累计天数与当日奖励名称，保留最近 14 次运行。
局限写在官方 README：仅国服；不做米游币社区任务、云游戏签到或商城兑换；调度依赖 dsh 进程常驻，关机错过时刻靠启动补签弥补。
安装与启用¶
官方安装命令如下（勿自行拼接 github:owner/repo 形式）：
dsh plugin --profile <profile> add dsh-mys-checkin
本地开发时，可将插件目录复制到该 profile 的 node_modules，并在 profile 的 package.json 里把包名写入 dsh.profile.bundles。
重启 dsh 后，在浏览器打开面板（端口以你 profile 为准）：
http://127.0.0.1:<port>/mys-checkin
运行时要求 Node >= 22.19，并依赖 Cordis 生态中的 @deepseek-ai/cordis、cordis-plugin-timer、dsh-tools 等 peer 包（见仓库 package.json）。插件以当前 dsh 进程权限联网访问 *.mihoyo.com；安装前建议浏览源码与 MIT 许可证，确认符合你的使用与合规要求。
配置说明¶
多数用户只需在面板选游戏、登录即可。若要在 profile 的 cordis.patch.yml 里覆盖，可参考 README 示例：
- 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 |
每日 wall-clock，Asia/Shanghai |
jitterMinutes |
10 |
随机延迟上限（0–120） |
autoSign |
true |
是否启用定时器 |
catchUp |
true |
启动时若当日无记录则补跑 |
panelPath |
/mys-checkin |
面板路由 |
dataPath |
空 | 状态文件路径；空则 $DSH_HOME/data/mys-checkin/state.json |
典型用法¶
面板流程：重启后访问 /mys-checkin → 扫码登录 → 勾选要签到的游戏 → 依赖默认定时或手动在面板/工具触发。
YAML 流程：在 cordis.patch.yml 写好 games 与 signTime 等 → 重启 → 面板补全未选项。
Agent 流程：在已挂载该 bundle 的 profile 中调用工具，例如：
mys_checkin_now：立即执行签到；mys_checkin_status：查看近期运行与角色结果；mys_checkin_games/mys_checkin_schedule：调整游戏列表或查看调度。
凭证与历史写在 state.json（默认模式 0600）。退出登录可在面板点「退出登录」，或删除状态文件；一状态文件对应一账号，第二账号需另建 profile 并指定独立 dataPath。
安全、隐私与运维注意¶
- 令牌不出现在日志与工具明文输出中；面板 API 仅回显掩码后的 UID。
- 面板与 API 走 dsh 本机回环端口，无独立鉴权：不要将 dsh 端口暴露到公网或挂在公网反代后。
- 常见返回码：
0签到成功；-5003已签；-100/-1001凭证过期（会尝试用 stoken 刷新一次，否则需重新扫码）；-500001多与signgame或 DS salt 过期有关；10001可能与act_id陈旧有关（README 指向更新lib/games.js）。 - miHoYo 客户端大版本更新后，
BBS_VERSION/WEB_SALT可能需要维护者或自行 bump，症状多为-500001。 - 免责声明：个人低频自用自动化，与 miHoYo 无隶属关系；批量或商用可能致账号受限。
DSH 生态是「一切皆插件」；SkillHub 等为社区目录站点，与 DeepSeek / 幻方无官方从属关系，本文亦不将其描述为官方应用商店。
结尾¶
若你希望把米游社六款游戏的每日签到收进 dsh 调度，并与 Agent 工具共用同一套状态与审计，dsh-mys-checkin 提供从扫码、配置到补签的完整路径。进一步信息：
- 目录页：https://www.skillhub.cn/plugins/Nico-2222/dsh-mys-checkin
- 源码与 README：https://github.com/Nico-2222/dsh-mys-checkin
