dsh-plugin-genshin-launch

LIMITATIONS

已知限制

- **反作弊很在意「谁把你拉起来的」。** 社区实测（2025 年「千星奇域」之后）：第三方启动器会在进入游戏约 3 分钟后触发游戏内弹窗「检测到非法工具，请重启机器。错误码：10612-4001」；把自写程序**改名成已知第三方工具的名字**能复现，说明它至少部分依赖**父进程名字黑名单**。DSH/Node 不在已知名单里（Collapse 这类正经第三方启动器据报也不在），所以**判断风险较低，但这属于会动到检测规则的东西，不是我们能保证的**。 - 想更保守：`launchMethod: shell`（父进程变成短命的 `cmd.exe`，语义等于双击），代价是失去「秒退判定」。 - 真要完全规避：`launchGame: false`，只用方案一。 - **原神本体与米哈游启动器都要求管理员权限（真机已确认）。** `YuanShen.exe` / `launcher.exe` 的清单是 `requireAdministrator`：用 `spawn` 直接起会被系统拒（`EACCES`），不会弹 UAC。插件的处理是——`spawn` 因权限失败后**自动改走一次 `shell`**，由 Windows 弹 UAC，**你点同意才提权**；点「否」就什么都不做。插件自己从不静默 `runas`（守「绝不主动提权」）。不想自动回退就设 `retryShellOnElevation: false`。 - **直接起游戏本体会跳过启动器的更新检查。** 客户端版本过低时游戏会自己报错退出——这时观察窗会捕获「秒退」并自动改起启动器。 - **`tasklist` 在某些受限环境里会被拒（`Access denied`）。** 这时「是否已在运行」判定退化为「不知道」，插件会选择照常启动而不是拒绝启动。 - **HoYoPlay 的注册表布局会变。** 我们已经见过 `HYP\standalone\14_0\hk4e_cn`（空残留）和 `HYP\1_1\hk4e_cn`（现役）两种；代码枚举整棵树并靠叶子名认游戏，但米哈游再改一次结构仍可能需要更新插件。 - **有界扫盘只认目录名和几个结构指纹**，不读文件内容、不联网。装在极其古怪的目录里仍可能漏；这时用 `gamePath` / `gameExe` 手填，或把它加进 `extraRoots`。 ---