dsh-selfupdater 0.4.19 → 0.4.22

package/client/settings-card.js

@@ -238,6 +238,8 @@ const CARD_CSS = `
 .dshsu-step-active{background:var(--dshsu-accent);animation:dshsu-pulse 1.1s ease-in-out infinite}
 @keyframes dshsu-pulse{50%{opacity:.35}}
 .dshsu-actions{display:flex;align-items:center;gap:8px;margin-top:2px}
+.dshsu-channel{display:flex;align-items:center;gap:6px;margin-top:8px;font-size:12px;opacity:.75;cursor:pointer;user-select:none}
+.dshsu-channel input{accent-color:var(--dshsu-accent,#c9a227)}
 .dshsu-spacer{flex:1}
 .dshsu-btn{appearance:none;border:1px solid var(--dshsu-border);border-radius:8px;cursor:pointer;
   padding:6px 14px;font-size:13px;background:transparent;color:inherit;display:inline-flex;
@@ -389,7 +391,7 @@ function headBadge(text, isNew) {
  * 上半部分 = DSH 更新小节；下半部分 = 插件更新小节。
  * 两组状态相互独立、互不阻塞；样式共享同一套 CSS 类与主题变量。
  */
-function UpdateCard({ t, status, busy, checking, onCheck, onUpgrade,
+function UpdateCard({ t, status, busy, checking, onCheck, onUpgrade, onChannelChange,
     plugin, pluginBusy, pluginChecking, pluginMsg, onPluginCheck, onPluginUpgrade }) {
 
     // 与插件小节保持一致：以后端 semver 权威判定为准，避免仅靠字符串 !== 误判预发布版本号
@@ -456,6 +458,17 @@ function UpdateCard({ t, status, busy, checking, onCheck, onUpgrade,
                 : ['error', 'done_failed'].includes(status?.state) ? h('span', { className: 'dshsu-pill dshsu-pill-bad' }, t.failed)
                     : null,
         ),
+        // alpha 预发布渠道开关：默认关闭（alpha 可能与旧插件 client bundle 不兼容，
+        // 0.1.2-alpha.3 实测升级后 web 端进不去），开启后检测/升级都会纳入 alpha 渠道。
+        h('label', { className: 'dshsu-channel' },
+            h('input', {
+                type: 'checkbox',
+                checked: status?.channel === 'alpha',
+                disabled: busy,
+                onChange: (e) => onChannelChange(e.target.checked === true),
+            }),
+            t.alphaChannel,
+        ),
 
         /* ---- 分隔线：视觉上把 DSH 更新与插件更新分成两区 ---- */
         h('div', { className: 'dshsu-divider' }),
@@ -580,6 +593,7 @@ const FALLBACK_DICT = {
         currentVersion: '当前版本', latestVersion: '最新版本',
         lastCheck: '上次检查', never: '从未', processing: '处理中…',
         updateAvailable: '可更新', upgraded: '已升级', failed: '失败',
+        alphaChannel: '追踪 alpha 预发布渠道（可能不稳定）',
         pluginNav: '插件更新',
         pluginUpdating: '插件更新进行中…', checkingLabel: '正在检查更新…',
         checkFailed: '检查更新失败',
@@ -592,6 +606,7 @@ const FALLBACK_DICT = {
         currentVersion: 'Current', latestVersion: 'Latest',
         lastCheck: 'Last check', never: 'never', processing: 'Working…',
         updateAvailable: 'Update', upgraded: 'Upgraded', failed: 'Failed',
+        alphaChannel: 'Track alpha prereleases (may be unstable)',
         pluginNav: 'Plugin Updates',
         pluginUpdating: 'Plugin update in progress…', checkingLabel: 'Checking…',
         checkFailed: 'Check failed',
@@ -648,7 +663,10 @@ function apply(ctx) {
                 ...data,
                 message: agedMessage('dsh', data.message, FINAL_MSG_STATES.includes(data.state)),
             };
-            upgradeStarting = false; // 服务端状态已接管视觉
+            // 仅当服务端给出"进行中"或终态时才撤销乐观视觉：perform 受理初期
+            // 状态可能仍是旧的 idle，若此时撤销会退回"发现新版本"且按钮恢复
+            // 可点，造成重复点击（0.4.19 实测踩坑）。
+            if (isBusyState(latestStatus) || FINAL_MSG_STATES.includes(data.state)) upgradeStarting = false;
         } catch { /* 服务重启期间拉不到状态属正常：保持 starting 视觉 */ }
         refresh();
         // 升级中高频轮询，空闲低频保活。
@@ -739,6 +757,17 @@ function apply(ctx) {
         }
     }
 
+    /** 切换 DSH 检测渠道（alpha 预发布开关）：保存到后端并刷新回显。 */
+    async function handleChannelChange(enabled) {
+        try {
+            await api('/channel', { method: 'POST', body: JSON.stringify({ channel: enabled ? 'alpha' : 'stable' }) });
+        } catch (err) {
+            console.warn(`[${NS}] 保存渠道设置失败:`, err);
+        }
+        // 无论成败都刷新：开关以服务端落盘的真实渠道为准（保存失败会弹回）
+        await pollStatus();
+    }
+
     async function handleCheck() {
         checking = true;
         refresh();
@@ -787,6 +816,7 @@ function apply(ctx) {
                 currentVersion: dict('currentVersion'), latestVersion: dict('latestVersion'),
                 lastCheck: dict('lastCheck'), never: dict('never'), processing: dict('processing'),
                 updateAvailable: dict('updateAvailable'), upgraded: dict('upgraded'), failed: dict('failed'),
+                alphaChannel: dict('alphaChannel'),
                 pluginNav: dict('pluginNav'),
                 pluginUpdating: dict('pluginUpdating'), checkingLabel: dict('checkingLabel'),
                 pendingRestart: dict('pendingRestart'),
@@ -796,6 +826,7 @@ function apply(ctx) {
             checking,
             onCheck: handleCheck,
             onUpgrade: handleUpgrade,
+            onChannelChange: handleChannelChange,
             plugin: pluginData,
             pluginBusy: pluginBusy || pluginStarting,
             pluginChecking,

package/lib/index.js

@@ -230,6 +230,20 @@ export function apply(ctx) {
             return { ...raw, state: baseState };
         };
 
+        /* ---------- DSH 检测渠道设置（alpha 预发布开关） ---------- */
+        // 开关持久化在 workspace/.dsh/selfupdate-config.json，插件更新/重启都不丢。
+        // alpha 是官方预发布通道，可能与旧插件 client bundle 不兼容（0.1.2-alpha.3
+        // 实测升级后 web 端 boot 报错），因此默认关闭，由用户在设置卡片显式开启。
+        const channelFile = join(dshStateDir, 'selfupdate-config.json');
+        const readChannel = () => {
+            try {
+                return JSON.parse(readFileSync(channelFile, 'utf8'))?.channel === 'alpha' ? 'alpha' : 'stable';
+            } catch { return 'stable'; }
+        };
+        // 检测用渠道 tag 列表：stable 只看 latest+next（与 build.sh 取版策略一致）；
+        // alpha 开启后纳入 alpha 渠道（显式尝鲜）。
+        const dshTags = () => (readChannel() === 'alpha' ? ['latest', 'next', 'alpha'] : ['latest', 'next']);
+
         /* ---------- GET /dsh-selfupdater/status ---------- */
         registerRoute('GET', '/dsh-selfupdater/status', (_req, res) => {
             const status = dshStatusView();
@@ -243,6 +257,8 @@ export function apply(ctx) {
                 state: status.state ?? 'idle',
                 message: status.message ?? null,
                 lastCheck: status.updatedAt ?? null,
+                // 当前检测渠道（前端 alpha 开关的回显依据）
+                channel: readChannel(),
             });
         });
 
@@ -253,7 +269,8 @@ export function apply(ctx) {
                 return;
             }
             try {
-                const latest = await fetchLatestVersion(PKG);
+                // 渠道 tag 按 UI 开关传入：stable 只看 latest+next，alpha 开启后多查 alpha
+                const latest = await fetchLatestVersion(PKG, { tags: dshTags() });
                 const current = currentDshVersion(appDir);
                 const updateAvailable = isNewer(latest, current);
                 // 检查结果落盘（内部自动建目录），UI 刷新后仍能看到上次检查时间。
@@ -310,6 +327,15 @@ export function apply(ctx) {
                 sendJson(res, 500, { error: `写入锁文件失败：${err.message}` });
                 return;
             }
+            // 受理即落盘 running 状态：给前端乐观视觉一个服务端依据（转圈 + 按钮禁用），
+            // 避免宿主退出前轮询仍读到旧的 idle/"发现新版本" 而误判升级没发生、
+            // 允许重复点击。latestVersion 等历史字段原样保留，供归位判定使用。
+            writeStatus(dshStateDir, {
+                ...readStatus(dshStateDir),
+                state: 'running',
+                message: '升级已受理，服务即将切换到升级脚本…',
+                updatedAt: new Date().toISOString(),
+            });
             const child = spawn(process.execPath, [
                 join(PLUGIN_ROOT, 'lib', 'updater.mjs'),
                 '--pid', String(process.pid),
@@ -317,7 +343,12 @@ export function apply(ctx) {
                 '--workspace', workspace,
                 '--port', String(port),
                 '--pkg', PKG,
-            ], { detached: true, stdio: 'ignore', env: process.env });
+            ], {
+                detached: true,
+                stdio: 'ignore',
+                // alpha 开关透传给升级脚本（updater.mjs 的 distTags 读该环境变量）
+                env: readChannel() === 'alpha' ? { ...process.env, DSHSU_DSH_CHANNEL: 'alpha' } : process.env,
+            });
             child.unref();
 
             host.logger?.info?.(`[dsh-selfupdater] 升级进程已启动 pid=${child.pid}，主程序即将退出`);
@@ -327,6 +358,36 @@ export function apply(ctx) {
             sendJson(res, 202, { accepted: true, note: '服务将自动退出并由升级脚本接管' });
         });
 
+        /* ---------- POST /dsh-selfupdater/channel ---------- */
+        /** 读取并解析 JSON 请求体（仅一个开关字段，无需引入框架式解析）。 */
+        const readJsonBody = (req) => new Promise((resolve) => {
+            let raw = '';
+            req.on('data', (chunk) => {
+                raw += chunk;
+                if (raw.length > 4096) { resolve({}); req.destroy(); }
+            });
+            req.on('end', () => { try { resolve(JSON.parse(raw || '{}')); } catch { resolve({}); } });
+            req.on('error', () => resolve({}));
+        });
+        registerRoute('POST', '/dsh-selfupdater/channel', async (req, res) => {
+            if (!sameOrigin(req)) {
+                sendJson(res, 403, { error: 'untrusted request' });
+                return;
+            }
+            const body = await readJsonBody(req);
+            // 只允许两个合法值，其余一律归为 stable（含 undefined/乱传）
+            const channel = body?.channel === 'alpha' ? 'alpha' : 'stable';
+            try {
+                mkdirSync(dshStateDir, { recursive: true });
+                writeFileSync(channelFile, JSON.stringify({ channel, updatedAt: new Date().toISOString() }, null, 2));
+            } catch (err) {
+                sendJson(res, 500, { error: `保存渠道设置失败：${err.message}` });
+                return;
+            }
+            host.logger?.info?.(`[dsh-selfupdater] DSH 检测渠道已切换为 ${channel}`);
+            sendJson(res, 200, { channel });
+        });
+
         /* ---------- GET /dsh-selfupdater/plugins ---------- */
         /**
          * 插件更新小节只针对本插件自身（dsh-selfupdater）：

package/lib/plugin-update-task.mjs

@@ -88,8 +88,20 @@ function registryCandidates() {
     return [...new Set(list.filter((v) => typeof v === 'string' && v !== ''))];
 }
 
-/** 除 latest 外额外追踪的官方发布渠道 tag（官方习惯把新版先挂在 next/alpha 上）。 */
-const EXTRA_DIST_TAGS = ['next', 'alpha'];
+/**
+ * 追踪的发布渠道 tag 列表。
+ * 默认 latest + next，与 build.sh 的取版策略保持一致（构建 FPK 时优先
+ * dist-tags.next）：官方把 alpha 当预发布通道，可能与旧插件 client bundle
+ * 不兼容（0.1.2-alpha.3 实测升级后 web 端报 boot manifest batches must be
+ * an array 进不去），因此默认不追；仅当环境变量 DSHSU_DSH_CHANNEL 含
+ * alpha（逗号分隔）时才纳入，显式尝鲜才开启。
+ */
+function distTags() {
+    const tags = ['latest', 'next'];
+    const channels = (process.env.DSHSU_DSH_CHANNEL ?? '').split(',').map((s) => s.trim());
+    if (channels.includes('alpha')) tags.push('alpha');
+    return tags;
+}
 
 /**
  * 从单个 registry 的版本级端点（/<pkg>/<tag>）取文档（含 dist.tarball）。
@@ -119,12 +131,13 @@ async function fetchVersionDoc(base, pkg, tag = 'latest') {
  *
  * @returns {{version: string, tarball: string|null}} 全部失败时抛聚合错误。
  */
-async function fetchLatestRelease(pkg) {
+async function fetchLatestRelease(pkg, opts = {}) {
     const candidates = registryCandidates();
-    // 每个 registry × 每个渠道 tag（latest/next/alpha）并行查询：
-    // 只查 /latest 会漏掉挂在 next/alpha tag 上的新版（0.1.2-alpha.2 实测踩坑），
-    // 与 build.sh 优先取 dist-tags.next 的官方发版习惯保持一致。
-    const tags = ['latest', ...EXTRA_DIST_TAGS];
+    // 每个 registry × 每个渠道 tag 并行查询：
+    // 只查 /latest 会漏掉挂在 next/alpha tag 上的新版（0.1.2-alpha.2 实测踩坑）；
+    // 渠道范围默认由 distTags() 决定（latest+next，alpha 需环境变量显式开启），
+    // 也允许调用方显式传入 tags（DSH 检测路由按 UI 开关传入）。
+    const tags = opts.tags ?? distTags();
     const targets = candidates.flatMap((base) => tags.map((tag) => ({ base, tag })));
     const results = await Promise.allSettled(targets.map((t) => fetchVersionDoc(t.base, pkg, t.tag)));
     let best = null;
@@ -140,9 +153,9 @@ async function fetchLatestRelease(pkg) {
     return best;
 }
 
-/** 只取最新版本号（检查更新路由使用）。 */
-export async function fetchLatestVersion(pkg) {
-    return (await fetchLatestRelease(pkg)).version;
+/** 只取最新版本号（检查更新路由使用）；opts.tags 可覆盖默认渠道。 */
+export async function fetchLatestVersion(pkg, opts = {}) {
+    return (await fetchLatestRelease(pkg, opts)).version;
 }
 
 /* ------------------------------------------------------------------ *

package/lib/updater.mjs

@@ -241,8 +241,19 @@ function registryCandidates() {
     return [...new Set(list.filter((v) => typeof v === 'string' && v !== ''))];
 }
 
-/** 除 latest 外额外追踪的官方发布渠道 tag（官方习惯把新版先挂在 next/alpha 上）。 */
-const EXTRA_DIST_TAGS = ['next', 'alpha'];
+/**
+ * 追踪的发布渠道 tag 列表（与 plugin-update-task.mjs 的 distTags 一致）。
+ * 默认 latest + next，与 build.sh 取版策略保持一致；alpha 为官方预发布
+ * 通道，可能与旧插件 client bundle 不兼容（0.1.2-alpha.3 实测升级后 web
+ * 端 boot manifest 报错进不去），默认不追，仅当 DSHSU_DSH_CHANNEL 含
+ * alpha 时显式纳入。
+ */
+function distTags() {
+    const tags = ['latest', 'next'];
+    const channels = (process.env.DSHSU_DSH_CHANNEL ?? '').split(',').map((s) => s.trim());
+    if (channels.includes('alpha')) tags.push('alpha');
+    return tags;
+}
 
 /**
  * 从单个 registry 的版本级端点（/<pkg>/<tag>）取文档（含 dist.tarball）。
@@ -270,10 +281,10 @@ async function fetchVersionDoc(base, pkg, tag = 'latest') {
  */
 async function fetchLatestRelease(pkg) {
     const candidates = registryCandidates();
-    // 每个 registry × 每个渠道 tag（latest/next/alpha）并行查询：
-    // 只查 /latest 会漏掉挂在 next/alpha tag 上的新版（0.1.2-alpha.2 实测踩坑），
-    // 与 build.sh 优先取 dist-tags.next 的官方发版习惯保持一致。
-    const tags = ['latest', ...EXTRA_DIST_TAGS];
+    // 每个 registry × 每个渠道 tag 并行查询：
+    // 只查 /latest 会漏掉挂在 next/alpha tag 上的新版（0.1.2-alpha.2 实测踩坑）；
+    // 渠道范围由 distTags() 决定（默认 latest+next，alpha 需环境变量显式开启）。
+    const tags = distTags();
     const targets = candidates.flatMap((base) => tags.map((tag) => ({ base, tag })));
     const results = await Promise.allSettled(targets.map((t) => fetchVersionDoc(t.base, pkg, t.tag)));
     let best = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-selfupdater",
-  "version": "0.4.19",
+  "version": "0.4.22",
   "description": "Self-update plugin for DeepSeek Harness: DSH core upgrades via detached swap script; plugin self-update installs in-place without killing the host and prompts for restart. DSH 主程序与已装插件的一站式在线更新插件。",
   "license": "MIT",
   "type": "module",