dsh-staging-hunter

让 DSH 桌面端永远落在夜间版灰度的第一批。

它解决什么问题

DSH 桌面端用 electron-updater 的 staging 机制控制放量：官方 feed （https://download.deepseek.com/dsh-desk/feeds/win-x64/nightly.yml）里有一个 stagingPercentage（0–100）。本机是否入圈由 .updaterId 里的 UUID 决定：

// app.asar -> node_modules/electron-updater/out/AppUpdater.js
stagingPercentage = parseInt(updateInfo.stagingPercentage, 10) / 100
const val = UUID.parse(stagingUserId).readUint32BE(12)
const percentage = val / 0xffffffff
return percentage < stagingPercentage   // 严格小于

桶值是 UUID 的确定性哈希，所以一台机器永远落在同一位置——放量比例低于你的 桶值时，你就一直收不到新版本。本插件把 .updaterId 钉在一个极低的桶值上， 于是任何 stagingPercentage > 配置值 的发布你都在圈内。

行为

1. 启动时读 .updaterId；若桶值已低于上限就沿用现有身份（不换 UUID）。
2. 否则生成一个合法 v4 UUID，把 bytes[12..15] 精确写成目标桶值，备份原文件后写回。
3. 把钉住的 UUID 存进 .staging-hunter.json（sidecar），保证跨启动身份稳定。
4. fs.watch + 定时巡检守着文件：被应用改回随机值时立刻改回来。
5. 插件卸载时自动关闭 watcher 与定时器。

配置

键	默认	说明
enabled	true	总开关
targetPercentage	1	桶值上限（%）。桶值低于它即视为在第一批
uuid	''	钉死的 UUID；留空自动挑选/生成
updaterIdPath	''	.updaterId 路径覆盖；留空自动探测
checkIntervalMs	60000	巡检间隔；0 表示只靠 fs.watch

安装

从 npm（推荐）

dsh plugin add dsh-staging-hunter

按提示批准后重启 DSH，插件会自动挑一个低位桶 UUID 并通过 fs.watch 守住它。

从源码 / 手工挂进 profile

本仓库不会自动写入你的 profile。二选一：

A. 作为 bundle 包

# 1) 放进 profile 的 node_modules（目录联接，不触发 pnpm 重装）
cmd //c mklink /J "%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-staging-hunter" "E:\git\dsh-staging-hunter"

# 2) 在 ~/.dsh/profiles/desktop/package.json 的 dependencies 与
#    dsh.profile.bundles 里各加一行 "dsh-staging-hunter"

B. 直接写进 profile 的补丁层

在 ~/.dsh/profiles/desktop/cordis.patch.yml 追加：

- insert:
    - id: dsh-staging-hunter
      name: 'dsh-staging-hunter'
      config:
        targetPercentage: 1

改完重启 DSH 桌面端。启动日志里应出现：

[staging-hunter] pinned updaterId (startup) -> <uuid>  bucket=1.000000%
[staging-hunter] watching ...\.updaterId  ceiling=1%  pinnedBucket=1.000000%

注意

• 完整性不受影响：只改本地「我是谁」的标签，安装包仍从官方地址下载，并按 feed 里的 sha512 与安装器 publisherName 验签。
• 需要重启：AppUpdater 用 Lazy 缓存 stagingUserIdPromise，本插件写回的值 在下一次启动的更新检查中才生效。
• nightly 有风险：你会稳定收到 rc 版本，可能遇到崩溃或破坏性变更。
• 副作用：你不在圈内时，旧行为是「停在当前版本」；现在会持续跟进最新 nightly。

发布

npm 包通过 GitHub Actions 的 Trusted Publishing（OIDC）发布，仓库里不存任何 token。

# 1) 改版本号并提交
npm version patch -m "release: v%s"
# 2) 推送提交与 tag
git push --follow-tags
# 3) 在 GitHub 上发布对应 tag 的 Release —— Actions 会校验 tag == package.json 版本，跑测试后发布

首次发布（包在 npm 上还不存在时）需在本地 npm login 后手动 npm publish --access public； 之后在 npmjs.com 的包设置里把 Trusted Publisher 指到 ChenXu233/dsh-staging-hunter 与 publish.yml，后续版本即可全自动。