前言¶
DeepSeek Harness 桌面端侧边栏插件，用于一键查看主流二游的当期卡池与活动起止。在管理二游资源时，快速确认当前版本、卡池与活动的起止时间是一项高频需求。该插件通过侧边栏悬浮面板提供这一能力，支持联网自动刷新与多源自动回退。
核心功能¶
插件主要包含以下能力：
- 侧边栏悬浮面板：侧边栏底部「📅 二游日历」按钮，点击展开悬浮面板。面板按行展示每款游戏的当期卡池、卡池起止、当期活动、活动起止。
- 倒计时与详情：显示剩余时间；悬停可查看卡池/活动的完整名称与源站原文。
- 自动刷新机制：
- 启动强制刷新：插件更新或首次安装时强制刷新一次，悬停可查看上次完全成功的时间。
- 按间隔刷新：其余刷新按设置间隔（1–42 天）进行，从上次成功刷新起算。
- 刷新提示与失败归类：顶行显示刷新状态，按「成功 / 卡池失败 / 活动失败 / 新卡池未公布 / 新活动未公布」归类。悬停可查看逐条原因。”来源报错”计入失败，”源站还没收录当期”不算失败。
- 多来源独立与自动回退：各游戏来源独立（官方公告 / 官方 Wiki / 第三方站），失败时自动回退备选源。设置页可切换来源或填自定义地址。
- 自定义与自检：设置页支持自定义条目（名称+图标+来源链接）、展示顺序、条目显隐/删除。提供解析器自检功能，可逐个来源跑一遍，报告解析问题，用于定位源站改版。
安装与启用¶
通过官方命令安装：
dsh plugin --profile desktop add dsh-gacha-calendar
或手动安装：将仓库复制到 profile 的 node_modules 目录下，重启 DSH Desktop。
安装前需确认 DSH 版本满足 peer 依赖范围：
>=0.1.1-rc.2 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0（cordis ^4.0.1、schemastery >=3.18.0 <4）。
典型用法¶
- 查看排期：点击侧边栏底部的「📅 二游日历」按钮，展开悬浮面板查看各游戏状态。
- 切换来源：进入设置页，针对特定游戏切换数据来源或填入自定义地址。
- 解析器自检：在设置页点击解析器自检，查看各源站抓取与解析的执行情况。
适用场景与注意事项¶
- 适用场景：主要面向需要频繁查看二游卡池与活动排期的用户。
- 权限与安全：插件以当前 DSH 进程权限运行。鉴于其为开源项目，安装前建议检查源码与许可证（MIT）。
- 免责声明：本项目为非营利性质的个人项目，与各游戏厂商、发行商及官方/社区 Wiki 均不存在隶属或合作关系。卡池、活动等排期数据均取自各游戏公开的官方公告与社区 Wiki、第三方站，仅作信息聚合展示，不提供亦不存储任何游戏资源。
短结尾¶
该插件通过聚合多源数据并提供自动刷新与回退机制，解决了二游排期查询的痛点。更多细节可参考项目主页或 GitHub 仓库。
