dsh-gacha-calendar

DeepSeek Harness 桌面端侧边栏插件：一键查看主流二游的当期卡池与活动起止，支持联网自动刷新，支持手动添加或删除条目。 全程使用 DeepSeek Harness 进行 Vibe Coding 开发。

截图

功能

• 侧边栏底部「📅 二游排期」按钮 → 悬浮面板，按行展示每款游戏的当期卡池、卡池起止、当期活动、活动起止
• 倒计时显示剩余时间，悬停查看卡池/活动全名原始文本
• 联网抓取：各游戏来源独立（官网公告 / Wiki / 第三方站），失败自动降级；来源可在设置页切换或自定义地址
• 刷新提示：顶行按「成功 / 卡池失败 / 活动失败 / 新卡池未公布 / 新活动未公布」归类，过长省略号截断，悬停看逐条原因；"来源报错"与"源站还没收录当期"分开算——前者计入失败，后者不算失败。某一列没拿到新数据时，该列悬停会补一行括号说明；若该列沿用了上次缓存，说明另起一行接在旧内容下面。游戏名悬停可看上次完全成功的时间
• 设置页：自动刷新开关与频率（1–42 天）、展示顺序、条目显隐/删除、新增自定义条目（名称+图标+来源链接，内容由链接解析产出）
• 自动刷新时机：启动时判一次（不是"连续开机到点才刷"）——① 插件版本变化（缓存不是当前版本产出的）与② 首次安装（还没刷过）会强制刷新一次，不看自动刷新开关：悬停格式、来源地址、解析器、样式等改动一刷新就生效；③ 其余情况按设置间隔到点才刷，间隔从「上次成功刷新」起算
• 解析器自检（设置页按钮）：逐个来源跑一遍，报告「哪个源解析不出当期内容 / 哪个源抓取报错」——源站改版后一键定位问题；只读，不改动设置与缓存

内置覆盖 11 款游戏：

数据来源

排期数据实时抓取自各游戏官方公告 / Wiki / 第三方站

重返未来：1999 的逐期「征集时间」来自官方游戏内公告接口（notice.sl916.com）——官网 CMS 公告里没有这项数据，只有维护时间与活动名。该接口的定位参考了开源项目 MAA1999/M9A（它的 tools/activity_data 长期使用同一接口抓「版本活动一览」），在此致谢。

安装

dsh plugin --profile desktop add dsh-gacha-calendar

或将仓库复制到 profile 的 node_modules 后重启 DSH Desktop。

开发

npm run build   # src/ → lib/（确定性拼接，无第三方依赖）
npm run check   # 只校验：src/ 拼出来的结果是否与产物一致（不写盘）

一个仓库，两个 npm 包

本仓库同时发布两个包，源码只有一份（抓取/解析核心）：

npm run publish:plugin   # 发布 DSH 插件包（dsh-gacha-calendar）
npm run publish:core     # 发布中立核心包（gacha-calendar-core，版本号跟随根包）

源站改版时只需改一处：改 src/client/30-parsers.js 等核心文件 → npm run build → 两个包一起发版， 各平台重新构建即可。core 包的入口是 packages/core/core.mjs（由 build.mjs 生成，不要手改）。

• src/ 是唯一真源，lib/ 与 packages/core/ 都是构建产物。
• 构建由 build.mjs 完成：把 src/client/*.js 按 ORDER 顺序原样拼接成 lib/client.js（DSH 的 __ModuleLoader__ 工厂形态）、把 src/index.js 复制成 lib/index.js、 再把 core 主体包成 packages/core/core.mjs（ESM 导出 createEngine）。 拼接是逐字节确定的，所以 check 能给出"一致/不一致"的确定结论。
• 源文件约定：LF 换行、UTF-8 无 BOM、Tab 缩进。build.mjs 会强制校验（带 BOM 会让 DSH 启动直接失败，见 .githooks/pre-commit）；.githooks/pre-commit 还会在提交 src/**、lib/**、packages/** 或 build.mjs 时自动跑一次 check，防止有人绕过源码直接改产物。
• 钩子怎么生效：npm install 会自动执行 prepare 脚本把 core.hooksPath 指到 .githooks （旧版只有钩子文件、没有这个脚本，新克隆时守卫是静默不生效的）。若你跳过了 install， 手工执行一次即可：git config core.hooksPath .githooks。
• 历史说明：本仓库此前只提交了打包产物（没有 src/），package.json 里声明的 tsc && tsdown 从未真正可用。当前构建脚本是从产物回填源码时一并落地的替代方案， 目标是"改一处源码 → 确定性产出产物"，也便于把同一份解析/抓取核心复用到浏览器扩展。

插件结构

dsh-gacha-calendar/
├── build.mjs        # 构建脚本（确定性拼接 + --check 校验）
├── src/             # 唯一真源
│   ├── index.js     # host 端：配置 schema + 同源代理（CORS/Referer 反爬绕行，白名单域名）
│   └── client/      # web 端，按原产物 //#region 顺序切分（拼接顺序见 build.mjs 的 ORDER）
│       ├── 00-head.js       # DSH 模块加载壳 + react require
│       ├── 10-config.js     # 配置常量 / 刷新频率选项
│       ├── 20-sources.js    # SOURCES 来源注册表（11 款游戏 / 25 个来源）
│       ├── 30-parsers.js    # 全部解析器（纯函数）
│       ├── 40-fetchers.js   # 抓取器 + GACHA_FETCHERS / EVENT_FETCHERS 注册表
│       ├── 50-refresh.js    # 刷新编排、失败沿用旧值、提示归类
│       ├── 60-helpers.js    # 格式化 / 悬停 / 排序 helpers
│       ├── 70-styles.js     # 样式
│       ├── 80-components.js # React 组件（面板 + 设置页）
│       ├── 90-plugin.js     # apply(ctx)：slots / settingsScope / 悬停 marquee
│       └── 99-tail.js       # exports.apply / exports.inject
├── lib/             # 构建产物（npm 包只发布这里）
│   ├── index.js
│   └── client.js
├── package.json     # dsh.bundle.patch + dsh.client.inject（DSH 加载规范）
├── cordis.patch.yml # bundle patch
└── README.md

License

MIT