@co0ontty/wand 1.48.1 → 1.49.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "357b85bac85ea7570863c051def1badcea5d2b62",
-  "builtAt": "2026-06-02T00:14:42.639Z",
-  "version": "1.48.1",
+  "commit": "6066201e006fdce04120be0b3e0add7d68770375",
+  "builtAt": "2026-06-02T01:47:00.843Z",
+  "version": "1.49.0",
   "channel": "stable"
 }

package/dist/npm-update-utils.d.ts

@@ -11,6 +11,25 @@
  * 我们的策略：安装前备份当前全局包，补齐 npm 子进程 PATH，清掉
  * `@co0ontty/.wand-*` 残留目录；失败时恢复备份，避免运行中的服务被半成品安装拆掉。
  */
+export declare const PACKAGE_NAME = "@co0ontty/wand";
+export type UpdateChannel = "stable" | "beta";
+export interface PackageUpdateInfo {
+    channel: UpdateChannel;
+    current: string;
+    latest: string | null;
+    updateAvailable: boolean;
+    distTag: "latest" | "beta";
+    installSpec: string;
+}
+export declare function normalizeUpdateChannel(value: unknown): UpdateChannel;
+export declare function getUpdateDistTag(channel: UpdateChannel): "latest" | "beta";
+export declare function getInstallSpecForChannel(channel: UpdateChannel): string;
+export declare function getStableTagVersion(version: string): string;
+export declare function isBetaPackageVersion(version: string): boolean;
+export declare function isPureStableVersion(version: string): boolean;
+export declare function buildPackageUpdateInfo(currentVersion: string, channel: UpdateChannel, latestVersion: string | null): PackageUpdateInfo;
+export declare function checkPackageUpdateAsync(currentVersion: string, channel: UpdateChannel, timeoutMs?: number): Promise<PackageUpdateInfo>;
+export declare function checkPackageUpdateSync(currentVersion: string, channel: UpdateChannel, timeoutMs?: number): PackageUpdateInfo;
 /**
  * 解析当前 `npm root -g` 的目录。失败返回 null。
  */

package/dist/npm-update-utils.js

@@ -18,13 +18,99 @@ import path from "node:path";
 import process from "node:process";
 import { promisify } from "node:util";
 import { whichSync } from "./path-repair.js";
+import { compareSemver } from "./version-utils.js";
 const execFileAsync = promisify(execFile);
-const PACKAGE_NAME = "@co0ontty/wand";
+export const PACKAGE_NAME = "@co0ontty/wand";
 const PACKAGE_SCOPE = "@co0ontty";
 const PACKAGE_BASENAME = "wand";
 const NPM_BIN = process.platform === "win32" ? "npm.cmd" : "npm";
 const COMMON_UNIX_PATHS = ["/usr/local/sbin", "/usr/local/bin", "/usr/sbin", "/usr/bin", "/sbin", "/bin"];
 const INSTALL_MAX_BUFFER = 10 * 1024 * 1024;
+const NPM_VIEW_TIMEOUT_MS = 15_000;
+export function normalizeUpdateChannel(value) {
+    return value === "beta" ? "beta" : "stable";
+}
+export function getUpdateDistTag(channel) {
+    return channel === "beta" ? "beta" : "latest";
+}
+export function getInstallSpecForChannel(channel) {
+    return `${PACKAGE_NAME}@${getUpdateDistTag(channel)}`;
+}
+function cleanVersion(value) {
+    return value.trim().replace(/^v/, "");
+}
+export function getStableTagVersion(version) {
+    return cleanVersion(version).split("+")[0]?.split("-")[0] ?? cleanVersion(version);
+}
+export function isBetaPackageVersion(version) {
+    return /(?:^|-)beta(?:[.-]|$)/i.test(cleanVersion(version));
+}
+export function isPureStableVersion(version) {
+    return /^\d+\.\d+\.\d+$/.test(cleanVersion(version));
+}
+function computeUpdateAvailable(currentVersion, latestVersion, channel) {
+    if (!latestVersion)
+        return false;
+    const current = cleanVersion(currentVersion);
+    const latest = cleanVersion(latestVersion);
+    const currentTag = getStableTagVersion(current);
+    const latestTag = getStableTagVersion(latest);
+    const tagCompare = compareSemver(latestTag, currentTag);
+    if (channel === "beta") {
+        if (tagCompare < 0)
+            return false;
+        if (tagCompare > 0)
+            return true;
+        // Beta follows the beta npm dist-tag exactly. The suffix contains the short
+        // git SHA, so recency comes from the dist-tag pointer instead of semver order.
+        return latest !== current;
+    }
+    if (tagCompare < 0)
+        return false;
+    if (tagCompare > 0)
+        return true;
+    // Stable intentionally tracks only the pure tag version. If the current build
+    // is a beta with the same base tag, switching back to stable should reinstall
+    // the clean npm @latest package.
+    return current !== latestTag;
+}
+export function buildPackageUpdateInfo(currentVersion, channel, latestVersion) {
+    const latest = latestVersion?.trim() || null;
+    const stableLatest = channel === "stable" && latest ? getStableTagVersion(latest) : latest;
+    return {
+        channel,
+        current: cleanVersion(currentVersion),
+        latest: stableLatest,
+        updateAvailable: computeUpdateAvailable(currentVersion, stableLatest, channel),
+        distTag: getUpdateDistTag(channel),
+        installSpec: getInstallSpecForChannel(channel),
+    };
+}
+async function viewPackageVersionAsync(channel, timeoutMs = NPM_VIEW_TIMEOUT_MS) {
+    try {
+        const { stdout } = await execFileAsync(NPM_BIN, ["view", getInstallSpecForChannel(channel), "version"], { timeout: timeoutMs, env: getChildEnv(), maxBuffer: INSTALL_MAX_BUFFER });
+        const version = String(stdout || "").trim();
+        return version || null;
+    }
+    catch {
+        return null;
+    }
+}
+function viewPackageVersionSync(channel, timeoutMs = NPM_VIEW_TIMEOUT_MS) {
+    const res = runNpmSync(["view", getInstallSpecForChannel(channel), "version"], timeoutMs);
+    if (res.status !== 0 || !res.stdout)
+        return null;
+    const version = res.stdout.trim();
+    return version || null;
+}
+export async function checkPackageUpdateAsync(currentVersion, channel, timeoutMs = NPM_VIEW_TIMEOUT_MS) {
+    const latest = await viewPackageVersionAsync(channel, timeoutMs);
+    return buildPackageUpdateInfo(currentVersion, channel, latest);
+}
+export function checkPackageUpdateSync(currentVersion, channel, timeoutMs = NPM_VIEW_TIMEOUT_MS) {
+    const latest = viewPackageVersionSync(channel, timeoutMs);
+    return buildPackageUpdateInfo(currentVersion, channel, latest);
+}
 function getChildEnv() {
     const entries = [
         path.dirname(process.execPath),
@@ -291,8 +377,8 @@ export async function installPackageGloballyAsync(pkg, timeoutMs, log) {
             }
         }
         // 终极兜底：uninstall + force install
-        // 卸载用固定包名 PACKAGE_NAME，而不是从 install spec 反推：spec 可能是 git
-        // 形式（`github:co0ontty/wand#beta`），用正则 strip @tag 反推会得到错误的卸载目标。
+        // 卸载用固定包名 PACKAGE_NAME，而不是从 install spec 反推：spec 带 npm tag
+        // 或版本号时，用正则 strip @tag 反推会误伤 scoped package 名。
         try {
             await runNpmAsync(["uninstall", "-g", PACKAGE_NAME], timeoutMs);
         }

package/dist/server.js

@@ -22,7 +22,7 @@ import { SessionLogger } from "./session-logger.js";
 import { StructuredSessionManager } from "./structured-session-manager.js";
 import { generatePwaManifest, generateServiceWorker } from "./pwa.js";
 import { getErrorMessage, registerClaudeHistoryRoutes, registerSessionRoutes } from "./server-session-routes.js";
-import { installPackageGloballyAsync, resolveGlobalWandCli } from "./npm-update-utils.js";
+import { checkPackageUpdateAsync, installPackageGloballyAsync, normalizeUpdateChannel, resolveGlobalWandCli, } from "./npm-update-utils.js";
 import { repairServiceUnitAfterUpdate } from "./service-self-repair.js";
 import { computeRelaunch } from "./relaunch.js";
 import { isServiceInstalled } from "./tui/commands.js";
@@ -47,29 +47,27 @@ const PKG_VERSION = PKG_JSON.version;
 const PKG_NODE_REQ = PKG_JSON.engines?.node ?? ">=22.5.0";
 const PKG_REPO_URL = "https://github.com/co0ontty/wand";
 // ── Update check cache ──
-let cachedLatestVersion = null;
-let cacheTimestamp = 0;
 const CACHE_TTL_MS = 10 * 60 * 1000; // 10 minutes
 /** Cached update result broadcast to new clients on connect. */
 let cachedUpdateInfo = null;
-async function checkNpmLatestVersion(forceRefresh = false) {
+const packageUpdateCache = new Map();
+async function checkLatestPackageVersion(channel, forceRefresh = false) {
     const now = Date.now();
-    if (forceRefresh || !cachedLatestVersion || (now - cacheTimestamp > CACHE_TTL_MS)) {
-        try {
-            const { stdout } = await execAsync(`npm view ${PKG_NAME} version`, { timeout: 15000 });
-            cachedLatestVersion = stdout.trim();
-            cacheTimestamp = now;
-        }
-        catch {
-            cachedLatestVersion = null;
-        }
+    const cached = packageUpdateCache.get(channel);
+    if (!forceRefresh && cached && now - cached.timestamp < CACHE_TTL_MS) {
+        return applyLocalBuildUpdateOverride(cached.info);
     }
-    const latest = cachedLatestVersion || PKG_VERSION;
-    return {
-        current: PKG_VERSION,
-        latest,
-        updateAvailable: latest !== PKG_VERSION && compareSemver(latest, PKG_VERSION) > 0,
-    };
+    const info = await checkPackageUpdateAsync(PKG_VERSION, channel);
+    if (info.latest) {
+        packageUpdateCache.set(channel, { info, timestamp: now });
+    }
+    return applyLocalBuildUpdateOverride(info);
+}
+function applyLocalBuildUpdateOverride(info) {
+    if (info.channel === "stable" && BUILD_INFO.channel === "beta" && info.latest) {
+        return { ...info, updateAvailable: true };
+    }
+    return info;
 }
 /** 读取 dist/build-info.json（由 scripts/stamp-build-info.js 在 build 时生成）。 */
 function readBuildInfo() {
@@ -89,54 +87,6 @@ function readBuildInfo() {
     }
 }
 const BUILD_INFO = readBuildInfo();
-// owner/repo（从 PKG_REPO_URL 派生），用于拼 beta 分支 raw 地址与 git 安装 spec。
-const PKG_REPO_SLUG = PKG_REPO_URL.replace(/^https?:\/\/github\.com\//, "").replace(/\.git$/, "");
-const BETA_BRANCH = "beta";
-const BETA_BUILD_INFO_URL = `https://raw.githubusercontent.com/${PKG_REPO_SLUG}/${BETA_BRANCH}/dist/build-info.json`;
-const BETA_INSTALL_SPEC = `github:${PKG_REPO_SLUG}#${BETA_BRANCH}`;
-let cachedBetaInfo = null;
-let betaCacheTs = 0;
-/**
- * 通过 beta 分支的 dist/build-info.json 判定 beta 更新。
- * 比对本地构建 commit 与远端 commit（两者记录的都是「构建源自的 master commit」）。
- * 取不到远端 → updateAvailable=false（不冒进）。
- */
-async function checkBetaUpdate(forceRefresh = false) {
-    const now = Date.now();
-    if (!forceRefresh && cachedBetaInfo && now - betaCacheTs < CACHE_TTL_MS) {
-        return cachedBetaInfo;
-    }
-    const localCommit = BUILD_INFO.commit;
-    let remoteCommit = null;
-    let remoteBuiltAt = null;
-    try {
-        const resp = await fetch(BETA_BUILD_INFO_URL, {
-            headers: { "User-Agent": "wand-server", Accept: "application/json" },
-            signal: AbortSignal.timeout(10000),
-        });
-        if (resp.ok) {
-            const j = (await resp.json());
-            remoteCommit = typeof j.commit === "string" && j.commit ? j.commit : null;
-            remoteBuiltAt = typeof j.builtAt === "string" && j.builtAt ? j.builtAt : null;
-        }
-    }
-    catch {
-        /* 网络失败：保持 null，下面判定为无更新 */
-    }
-    const short = (c) => (c ? c.slice(0, 7) : "unknown");
-    const info = {
-        channel: "beta",
-        current: short(localCommit),
-        latest: short(remoteCommit),
-        updateAvailable: !!remoteCommit && remoteCommit !== localCommit,
-        localCommit,
-        remoteCommit,
-        remoteBuiltAt,
-    };
-    cachedBetaInfo = info;
-    betaCacheTs = now;
-    return info;
-}
 let cachedGitHubApk = null;
 let gitHubApkCacheTs = 0;
 const GITHUB_APK_CACHE_TTL = 10 * 60 * 1000; // 10 minutes
@@ -1472,30 +1422,20 @@ export async function startServer(config, configPath) {
             process.stdout.write(`${line}\n`);
         });
     }
-    /** 当前更新通道：stable（npm @latest，semver）或 beta（GitHub beta 分支，按 commit）。 */
-    const getUpdateChannel = () => storage.getConfigValue("updateChannel") === "beta" ? "beta" : "stable";
+    /** 当前更新通道：stable（npm @latest，纯 tag）或 beta（npm @beta，tag + commit 尾标）。 */
+    const getUpdateChannel = () => normalizeUpdateChannel(storage.getConfigValue("updateChannel"));
     app.get("/api/check-update", async (_req, res) => {
         try {
             const channel = getUpdateChannel();
-            if (channel === "beta") {
-                const b = await checkBetaUpdate(true);
-                res.json({
-                    channel: "beta",
-                    current: b.current,
-                    latest: b.latest,
-                    updateAvailable: b.updateAvailable,
-                    builtAt: b.remoteBuiltAt,
-                });
-                return;
-            }
-            const result = await checkNpmLatestVersion(true);
-            // 离开 beta 边界：当前跑的是 beta 构建、但通道切回 stable 时，强制提示可更新，
-            // 让用户能从 beta 装回干净的正式版（否则 semver 相等会卡在 beta 构建上）。
-            const onBetaBuild = BUILD_INFO.channel === "beta";
+            const info = await checkLatestPackageVersion(channel, true);
             res.json({
-                channel: "stable",
-                ...result,
-                updateAvailable: result.updateAvailable || onBetaBuild,
+                ...info,
+                build: {
+                    commit: BUILD_INFO.commit,
+                    shortCommit: BUILD_INFO.commit ? BUILD_INFO.commit.slice(0, 7) : null,
+                    builtAt: BUILD_INFO.builtAt,
+                    channel: BUILD_INFO.channel,
+                },
             });
         }
         catch (error) {
@@ -1511,33 +1451,22 @@ export async function startServer(config, configPath) {
         updateInFlight = true;
         try {
             const channel = getUpdateChannel();
-            let installSpec;
-            let targetLabel;
-            if (channel === "beta") {
-                const b = await checkBetaUpdate(true);
-                if (!b.updateAvailable) {
-                    res.json({ ok: true, message: "已是最新 Beta 构建。" });
-                    return;
-                }
-                installSpec = BETA_INSTALL_SPEC;
-                targetLabel = `Beta ${b.latest}`;
+            const info = await checkLatestPackageVersion(channel, true);
+            if (!info.latest) {
+                res.status(502).json({ error: "无法连接到 npm registry。" });
+                return;
             }
-            else {
-                const { updateAvailable, latest } = await checkNpmLatestVersion(true);
-                const onBetaBuild = BUILD_INFO.channel === "beta";
-                if (!updateAvailable && !onBetaBuild) {
-                    res.json({ ok: true, message: "已经是最新版本。" });
-                    return;
-                }
-                installSpec = `${PKG_NAME}@latest`;
-                targetLabel = onBetaBuild ? "最新正式版" : latest;
+            if (!info.updateAvailable) {
+                res.json({ ok: true, message: channel === "beta" ? "已是最新 Beta 版本。" : "已经是最新版本。" });
+                return;
             }
+            const targetLabel = info.latest;
             if (!canUseDetachedUpdateHelper()) {
                 res.status(500).json({ error: "当前平台暂不支持 Web 异步更新，请在终端运行 install.sh 更新。" });
                 return;
             }
             const helper = startDetachedUpdateHelper({
-                installSpec,
+                installSpec: info.installSpec,
                 configPath,
                 parentPid: process.pid,
                 cliArgs: process.argv.slice(2),
@@ -1553,7 +1482,7 @@ export async function startServer(config, configPath) {
             wsManager.emitEvent({
                 type: "notification",
                 sessionId: "__system__",
-                data: { kind: "auto-update-restart", current: PKG_VERSION, latest: targetLabel },
+                data: { kind: "auto-update-restart", current: info.current, latest: targetLabel },
             });
             res.json({
                 ok: true,
@@ -2258,19 +2187,9 @@ export async function startServer(config, configPath) {
     // ── Auto-update logic ──
     async function performAutoUpdate() {
         const channel = getUpdateChannel();
-        let info;
-        let updateSpec;
-        if (channel === "beta") {
-            const b = await checkBetaUpdate(true);
-            info = { current: b.current, latest: b.latest, updateAvailable: b.updateAvailable };
-            updateSpec = BETA_INSTALL_SPEC;
-        }
-        else {
-            info = await checkNpmLatestVersion(true);
-            updateSpec = `${PKG_NAME}@latest`;
-        }
+        const info = await checkLatestPackageVersion(channel, true);
         cachedUpdateInfo = info;
-        if (!info.updateAvailable)
+        if (!info.latest || !info.updateAvailable)
             return;
         const autoEnabled = storage.getConfigValue("autoUpdateWeb") === "true";
         if (!autoEnabled) {
@@ -2291,7 +2210,7 @@ export async function startServer(config, configPath) {
             data: { kind: "auto-update-start", current: info.current, latest: info.latest },
         });
         try {
-            await npmInstallGlobal(updateSpec, 120000);
+            await npmInstallGlobal(info.installSpec, 120000);
             // 镜像 install.sh：装完用全局安装刷新服务 unit（ExecStart/PATH），重启才会跑到新版。
             const repair = repairServiceUnitAfterUpdate(configPath);
             if (repair.scope)

package/dist/tui/attach.js

@@ -5,7 +5,7 @@
  * 日志面板：因为日志在主进程里，attach 端没法直接看；这里改成"活动流"——
  *   监听 snapshot 差分，把会话起止 / 总数变化打到 log 面板。
  */
-import { checkUpdate, copyToClipboard, installService, installUpdate, isServiceInstalled, openInBrowser, uninstallService, } from "./commands.js";
+import { checkUpdate, copyToClipboard, installService, installUpdate, isServiceInstalled, openInBrowser, readUpdateChannel, uninstallService, } from "./commands.js";
 import { spawnSync } from "node:child_process";
 import { repairServiceUnitAfterUpdate } from "../service-self-repair.js";
 import { IpcClient } from "./ipc-client.js";
@@ -203,25 +203,27 @@ export function startAttachTui(deps) {
     }
     async function handleUpdate() {
         layout.showToast("正在检查更新…", "info", 2000);
-        const info = await runOffMicrotask(() => checkUpdate(deps.pidInfo.version));
+        const channel = await runOffMicrotask(() => readUpdateChannel(deps.configPath));
+        const info = await runOffMicrotask(() => checkUpdate(deps.pidInfo.version, channel));
         if (!info.latest) {
-            layout.showToast("无法连接到 npm registry", "error", 3500);
+            layout.showToast(info.channel === "beta" ? "无法读取 npm beta 版本" : "无法连接到 npm registry", "error", 3500);
             return;
         }
         if (!info.hasUpdate) {
-            layout.showToast(`已是最新版本 (v${info.current})`, "success", 3000);
+            layout.showToast(info.channel === "beta" ? `已是最新 Beta 版本 (${info.current})` : `已是最新版本 (v${info.current})`, "success", 3000);
             return;
         }
+        const channelLabel = info.channel === "beta" ? "Beta" : "正式版";
         const go = await layout.confirm({
             title: "发现新版本",
-            body: `当前 v${info.current} → 最新 v${info.latest}，立即升级？升级后请按 R 重启服务。`,
+            body: `通道 ${channelLabel}：当前 ${info.current} → 最新 ${info.latest}，立即升级？升级后请按 R 重启服务。`,
             yes: "回车 / y 安装",
             no: "Esc / n 取消",
         });
         if (!go)
             return;
         layout.showToast("正在执行 npm install -g …", "info", 5000);
-        const r = await runOffMicrotask(() => installUpdate());
+        const r = await runOffMicrotask(() => installUpdate(info.channel));
         layout.showToast(r.message, r.ok ? "success" : "error", 5000);
         if (r.detail)
             layout.showDetail(r.ok ? "更新输出" : "更新失败", r.detail);

package/dist/tui/commands.d.ts

@@ -4,6 +4,7 @@
  * 所有命令统一返回 CommandResult，UI 层负责把结果渲染到 toast / 弹窗 / 日志。
  * 命令本身不直接写 stdout / stderr —— TUI 模式下 stderr 已经被 log-bus 劫持。
  */
+import { type UpdateChannel } from "../npm-update-utils.js";
 export interface CommandResult {
     ok: boolean;
     /** 给用户看的简短状态行（一行）。 */
@@ -18,14 +19,17 @@ export interface CommandResult {
  */
 export declare function restartSelf(): CommandResult;
 export interface UpdateInfo {
+    channel: UpdateChannel;
     current: string;
     latest: string | null;
     hasUpdate: boolean;
+    installSpec: string;
 }
-/** 通过 npm view 拿到最新版本号。失败返回 latest=null。 */
-export declare function checkUpdate(currentVersion: string): UpdateInfo;
+export declare function readUpdateChannel(configPath: string): UpdateChannel;
+/** 通过 npm dist-tag 拿到当前通道最新版本号。失败返回 latest=null。 */
+export declare function checkUpdate(currentVersion: string, channel?: UpdateChannel): UpdateInfo;
 /**
- * 执行 `npm install -g @co0ontty/wand@latest`。
+ * 执行 `npm install -g @co0ontty/wand@<dist-tag>`。
  *
  * 此调用同步阻塞（TUI 上层应在另一线程的 setImmediate 调度，或直接 await）。
  * 通过 npm-update-utils 自动处理 `.wand-XXXXXX` 残留目录和 ENOTEMPTY 回退，
@@ -33,7 +37,7 @@ export declare function checkUpdate(currentVersion: string): UpdateInfo;
  *
  * 返回 npm 输出供调试。
  */
-export declare function installUpdate(): CommandResult;
+export declare function installUpdate(channel?: UpdateChannel): CommandResult;
 export declare function openInBrowser(url: string): CommandResult;
 export declare function copyToClipboard(text: string): CommandResult;
 /**

package/dist/tui/commands.js

@@ -5,15 +5,15 @@
  * 命令本身不直接写 stdout / stderr —— TUI 模式下 stderr 已经被 log-bus 劫持。
  */
 import { spawn, spawnSync } from "node:child_process";
-import { compareSemver } from "../version-utils.js";
-import { existsSync, mkdirSync, writeFileSync, unlinkSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import process from "node:process";
-import { installPackageGloballySync, resolveGlobalWandCli } from "../npm-update-utils.js";
+import { fileURLToPath } from "node:url";
+import { checkPackageUpdateSync, getInstallSpecForChannel, installPackageGloballySync, normalizeUpdateChannel, resolveGlobalWandCli, } from "../npm-update-utils.js";
 import { whichSync } from "../path-repair.js";
 import { computeRelaunch } from "../relaunch.js";
-const PACKAGE_NAME = "@co0ontty/wand";
+import { ensureDatabaseFile, resolveDatabasePath, WandStorage } from "../storage.js";
 // ─── 重启 ────────────────────────────────────────────────────────────────
 /**
  * 重启当前进程。
@@ -48,24 +48,44 @@ export function restartSelf() {
         return { ok: false, message: `重启失败: ${errMsg(err)}` };
     }
 }
-/** 通过 npm view 拿到最新版本号。失败返回 latest=null。 */
-export function checkUpdate(currentVersion) {
-    const res = spawnSync("npm", ["view", PACKAGE_NAME, "version"], {
-        encoding: "utf8",
-        timeout: 15_000,
-    });
-    if (res.status !== 0 || !res.stdout) {
-        return { current: currentVersion, latest: null, hasUpdate: false };
+// ─── 检查 / 安装更新 ────────────────────────────────────────────────────
+const TUI_MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
+function readLocalBuildChannel() {
+    try {
+        const raw = readFileSync(path.resolve(TUI_MODULE_DIR, "..", "build-info.json"), "utf8");
+        const parsed = JSON.parse(raw);
+        return typeof parsed.channel === "string" ? parsed.channel : null;
+    }
+    catch {
+        return null;
     }
-    const latest = res.stdout.trim();
+}
+export function readUpdateChannel(configPath) {
+    const dbPath = resolveDatabasePath(configPath);
+    ensureDatabaseFile(dbPath);
+    const storage = new WandStorage(dbPath);
+    try {
+        return normalizeUpdateChannel(storage.getConfigValue("updateChannel"));
+    }
+    finally {
+        storage.close();
+    }
+}
+/** 通过 npm dist-tag 拿到当前通道最新版本号。失败返回 latest=null。 */
+export function checkUpdate(currentVersion, channel = "stable") {
+    const info = checkPackageUpdateSync(currentVersion, channel);
+    const updateAvailable = info.updateAvailable ||
+        (channel === "stable" && !!info.latest && readLocalBuildChannel() === "beta");
     return {
-        current: currentVersion,
-        latest,
-        hasUpdate: compareSemver(latest, currentVersion) > 0,
+        channel: info.channel,
+        current: info.current,
+        latest: info.latest,
+        hasUpdate: updateAvailable,
+        installSpec: info.installSpec,
     };
 }
 /**
- * 执行 `npm install -g @co0ontty/wand@latest`。
+ * 执行 `npm install -g @co0ontty/wand@<dist-tag>`。
  *
  * 此调用同步阻塞（TUI 上层应在另一线程的 setImmediate 调度，或直接 await）。
  * 通过 npm-update-utils 自动处理 `.wand-XXXXXX` 残留目录和 ENOTEMPTY 回退，
@@ -73,8 +93,8 @@ export function checkUpdate(currentVersion) {
  *
  * 返回 npm 输出供调试。
  */
-export function installUpdate() {
-    const res = installPackageGloballySync(`${PACKAGE_NAME}@latest`, 180_000);
+export function installUpdate(channel = "stable") {
+    const res = installPackageGloballySync(getInstallSpecForChannel(channel), 180_000);
     const out = (res.stdout || "") + (res.stderr ? "\n" + res.stderr : "");
     const trail = res.attempts.length > 1
         ? `\n\n尝试过的命令：\n  ${res.attempts.join("\n  ")}`

package/dist/tui/index.js

@@ -1,4 +1,4 @@
-import { checkUpdate, copyToClipboard, installService, installUpdate, isServiceInstalled, openInBrowser, restartSelf, uninstallService, } from "./commands.js";
+import { checkUpdate, copyToClipboard, installService, installUpdate, isServiceInstalled, openInBrowser, readUpdateChannel, restartSelf, uninstallService, } from "./commands.js";
 import { repairServiceUnitAfterUpdate } from "../service-self-repair.js";
 import { buildLayout } from "./layout.js";
 import { installLogBus, restoreLogBus } from "./log-bus.js";
@@ -161,25 +161,27 @@ export function startTui(deps) {
     }
     async function handleUpdate() {
         layout.showToast("正在检查更新…", "info", 2000);
-        const info = await runOffMicrotask(() => checkUpdate(deps.version));
+        const channel = await runOffMicrotask(() => readUpdateChannel(deps.configPath));
+        const info = await runOffMicrotask(() => checkUpdate(deps.version, channel));
         if (!info.latest) {
-            layout.showToast("无法连接到 npm registry", "error", 3500);
+            layout.showToast(info.channel === "beta" ? "无法读取 npm beta 版本" : "无法连接到 npm registry", "error", 3500);
             return;
         }
         if (!info.hasUpdate) {
-            layout.showToast(`已是最新版本 (v${info.current})`, "success", 3000);
+            layout.showToast(info.channel === "beta" ? `已是最新 Beta 版本 (${info.current})` : `已是最新版本 (v${info.current})`, "success", 3000);
             return;
         }
+        const channelLabel = info.channel === "beta" ? "Beta" : "正式版";
         const go = await layout.confirm({
             title: "发现新版本",
-            body: `当前 v${info.current} → 最新 v${info.latest}，是否立即升级？`,
+            body: `通道 ${channelLabel}：当前 ${info.current} → 最新 ${info.latest}，是否立即升级？`,
             yes: "回车 / y 安装",
             no: "Esc / n 取消",
         });
         if (!go)
             return;
         layout.showToast("正在执行 npm install -g …", "info", 5000);
-        const r = await runOffMicrotask(() => installUpdate());
+        const r = await runOffMicrotask(() => installUpdate(info.channel));
         layout.showToast(r.message, r.ok ? "success" : "error", 5000);
         if (r.detail)
             layout.showDetail(r.ok ? "更新输出" : "更新失败", r.detail);