dsh-plugin-genshin-launch

原神，启动！ —— 给 DeepSeek Harness（DSH）装一个插件：每次启动 DSH，先识别自己的端口，再把《原神》启动器安装包下载到桌面；下载不成（链接失效 / 目录不可写 / 体积可疑）就退化成打开官方下载页。

一句话简介（可直接用作 GitHub 仓库 About）：

DSH 插件：启动 DSH 时识别端口，并把《原神》启动器安装包下载到桌面，带 224MB 体积安全闸，下载失败自动改为打开官方下载页。

╔══════════════════════════════════════════════════════════╗
║  原神，启动！                                            ║
╚══════════════════════════════════════════════════════════╝
[genshin-launch] 识别到 DSH 端口：3080（http://127.0.0.1:3080）
[genshin-launch] 安装包目标目录：C:\Users\你\Desktop
[genshin-launch] 体积安全闸：只接受 174 MB ~ 274 MB（预期 224 MB ± 50.0 MB）
[genshin-launch] 直链可用：https://autopatchcn.yuanshen.com/.../pcbackup319/yuanshen_setup_20260817.exe
[genshin-launch] 发现更新一档的安装包：pcbackup319 → pcbackup320
[genshin-launch] 安装包链接：https://autopatchcn.yuanshen.com/.../pcbackup320/yuanshen_setup_20260817.exe
[genshin-launch] 安装包大小：223.5 MB（234381736 字节）
[genshin-launch] 下载完成：223.5 MB（234381736 字节），用时 15s
[genshin-launch] 文件位置：C:\Users\你\Desktop\yuanshen_setup_20260817.exe

网页右下角还有一个金边小面板，实时显示「原神，启动！ + DSH 端口 + 下载进度 + 被安全闸拒了几条链接」。

特性

• 端口识别：注入宿主 webServer 服务读 host/port，--port 0 由系统分配端口也能拿到；DSH_WEB_URL 兜底。
• 自动找最新版：候选直链可用时，还会在同一版本目录里向上探测更新的 pcbackup 序号（实测 319 → 320）。
• 体积安全闸（重点）：启动器安装包约 224 MiB，换版本不会大改。凡是体积与预期相差超过 50 MiB 的链接——不管它来自候选、缓存还是探测——都会被整条拒绝：不下载、不续传，连已经下了一半的 .part 一起删掉。体积拿不到也默认拒绝。
• 断点续传：HTTP Range，网络抖动重开一次 DSH 会接着下，不会重头再来。
• 落盘后复检：下载完成再核一次体积，不在区间内就把文件删掉，绝不留一个可疑安装器给你双击。
• 优雅退化：目标目录不可写 → 改到工作区目录 + 打开资源管理器；没有可用链接 / 下载失败 → 打开官方下载页。
• 已装就跳过：本机检测到原神（YuanShen.exe / GenshinImpact.exe）时直接跳过 224MB 下载。
• 零依赖：只用 Node 内置模块（node:fs / node:http / 内置 fetch），不需要编译，改代码即生效。

安装

从 GitHub 直接装（推荐，可固定版本）：

dsh plugin --profile web add github:Link258QAQ/dsh-plugin-genshin-launch
# 固定到某个 tag：
dsh plugin --profile web add github:Link258QAQ/dsh-plugin-genshin-launch#v0.2.0

本地开发用 link:：

dsh plugin --profile web add "link:D:\path\to\dsh-plugin-genshin-launch"

装完下一次 dsh --profile web 启动时自动跑一遍。

卸载：

dsh plugin --profile web remove dsh-plugin-genshin-launch

插件 ID 是 genshin-launch，包名 dsh-plugin-genshin-launch。 用 link: 安装时，改本目录的代码下次启动就生效，不用重装。 也可以在 DSH Market 里搜 dsh-plugin-genshin-launch（收录审核通过后可见）。

装之前请注意

• 这个插件真的会下 224 MB 到你的桌面（可以在配置里改成别的目录或改成只打开链接）。
• 如果安装时 pnpm 需要重新解析依赖树，而你的网络访问不了 GitHub（codeload.github.com），安装会失败并回滚。先确认 GitHub 通，或者按下面的「不动 pnpm 的装法」手工接线。

配置

在 $DSH_HOME/profiles/web/cordis.patch.yml 里按 id 覆盖：

- id: genshin-launch
  name: dsh-plugin-genshin-launch
  config:
    download: true                            # false = 只打开下载链接，不下载
    downloadDir: 'C:\Users\你\Desktop'        # 目标目录（默认桌面）
    expectedInstallerBytes: 234881024         # 预期体积（默认 224 MiB）
    sizeToleranceBytes: 52428800              # 体积容差（默认 50 MiB）
    openFileWhenDone: true                    # 下完打开所在目录
    openFallbackWhenFailed: true              # 失败时打开官方下载页

链接为什么会「自动更新」

米哈游没有给启动器安装包提供公开的“最新版”接口：游戏包有 hyp-connect API （getGamePackages / getGameBranches），但启动器安装包只挂在 CDN 的版本目录下， 目录名是「时间戳_随机 token」，无法推导。实际可用的规律是：

1. 你给的直链只要还活着就继续用（HEAD 检查 200 + 体积检查）；
2. 同一版本目录下的 pcbackup<NNN> 是顺序发布的安装包备份序号，号越大越新 （同一个安装器版本会同时挂 316/317/318/319/320 多个备份）。

所以插件先用你的直链，再顺手往上探一位，能拿到更新的就用更新的（实测 319 → 320）； 如果你的直链失效了，就一直往上找到还存在的最大的序号。探测结果缓存 7 天。

诚实的边界：如果米哈游换了整个版本目录（新的时间戳 + token）并下掉旧目录， pcbackup 往上探也没用，这时插件会按设计退化成打开官方下载页。 要覆盖这种情况，把新链接填进 url / extraUrls 即可。

自测

node tests/size-guard.test.mjs

验证记录

目录结构

dsh-plugin-genshin-launch/
├── package.json         # dsh.bundle.patch 声明，DSH 凭它识别为 profile 层
├── cordis.patch.yml     # 挂载声明（insert 一行 genshin-launch）
├── lib/
│   ├── index.js         # 宿主半侧：端口识别、路由、index 注入、下载编排、兜底
│   ├── resolve.js       # 链接解析：候选校验 + pcbackup 向上探测 + 缓存
│   ├── size-guard.js    # 体积安全闸：224MB ± 50MB，越界整条拒绝
│   ├── download.js      # 下载器：Range 续传、进度、大小校验
│   └── client.js        # 浏览器半侧：右下角「原神，启动！」进度面板
└── tests/
    └── size-guard.test.mjs

免责声明

本项目是 DSH 的第三方插件，与米哈游 / HoYoverse / DeepSeek 无任何关联。 它只做一件事：把官方 CDN 上的公开安装包直链下载到你指定目录（或打开官方下载页）。 《原神》及相关名称、素材归米哈游所有；请遵守游戏官方的用户协议。

License

MIT