@co0ontty/wand 1.55.0 → 1.55.1-beta.g00c1381

package/README.md

@@ -76,7 +76,6 @@ bash <(curl -Ls https://raw.githubusercontent.com/co0ontty/wand/master/install.s
 
 ### 部署与访问
 
-- **PWA 支持** — 可添加到主屏幕作为独立应用使用
 - **Android 客户端** — WebView 壳应用，支持加密连接码分发、APK 自动更新检查、原生通知推送、启动器图标切换
 - **HTTPS** — 可选自签证书，适合远程或移动端访问
 - **版本管理** — 内置更新检查与升级提示

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "6dd647276b78845194a8a030b868790ddbc7e269",
-  "builtAt": "2026-06-12T01:10:42.734Z",
-  "version": "1.55.0",
-  "channel": "stable"
+  "commit": "00c1381e078849c38a88064dfa899a9729012399",
+  "builtAt": "2026-06-12T04:06:55.082Z",
+  "version": "1.55.1-beta.g00c1381",
+  "channel": "beta"
 }

package/dist/cert.js

@@ -164,7 +164,7 @@ export function ensureCertificates(configDir, options = {}) {
         const fingerprint = computeFingerprint(ssl.cert);
         process.stdout.write(`[wand] 证书已写入 ${paths.certPath}\n` +
             `[wand] SHA-256 指纹: ${fingerprint}\n` +
-            `[wand] 注意：自签证书浏览器会标红；PWA / Service Worker 需要把它导入受信任根证书才能工作。\n` +
+            `[wand] 注意：自签证书浏览器会标红；可将它导入受信任根证书以消除警告。\n` +
             `[wand] HTTPS 启用后可通过 GET /cert/server.crt 在客户端下载安装。\n`);
         return { ...ssl, certPath: paths.certPath, fingerprint, userProvided: false };
     }

package/dist/server.js

@@ -1,5 +1,5 @@
 import crypto from "node:crypto";
-import { compareSemver, extractSemver } from "./version-utils.js";
+import { compareApkInstallOrder, compareSemver, extractSemver } from "./version-utils.js";
 import compression from "compression";
 import express from "express";
 import { createReadStream, existsSync, readFileSync, writeFileSync } from "node:fs";
@@ -11,7 +11,6 @@ import { promisify } from "node:util";
 import path from "node:path";
 import process from "node:process";
 import { WebSocketServer } from "ws";
-import { ensureAvatarSeed, getAvatarSvg } from "./avatar.js";
 import { createSession, readSessionCookie, revokeSession, SESSION_COOKIE_HTTP, SESSION_COOKIE_HTTPS, SESSION_COOKIE_LEGACY, setAuthStorage, validateSession, } from "./auth.js";
 import { ensureCertificates } from "./cert.js";
 import { buildChildEnv } from "./env-utils.js";
@@ -20,7 +19,6 @@ import { getCachedModels, refreshModels } from "./models.js";
 import { ProcessManager } from "./process-manager.js";
 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 { checkPackageUpdateAsync, installPackageGloballyAsync, normalizeUpdateChannel, resolveGlobalWandCli, } from "./npm-update-utils.js";
 import { repairServiceUnitAfterUpdate } from "./service-self-repair.js";
@@ -140,30 +138,39 @@ async function fetchGitHubLatestApk(forceRefresh = false) {
     }
 }
 async function resolveLatestApkVersion(configDir, config) {
-    // Priority 1: local APK file
+    // local 与 github 两个来源都看，按安装序取真正更新的那个（持平偏向 local：同源下载更快）。
+    // 旧逻辑是「local 存在就一票否决」——本地目录留着旧包时，会把线上新版压住不提示。
     const localApk = await resolveAndroidApkAsset(configDir, config);
-    if (localApk && localApk.version) {
-        return {
+    const local = localApk && localApk.version
+        ? {
             version: localApk.version,
             downloadUrl: localApk.downloadUrl,
             fileName: localApk.fileName,
             size: localApk.size,
             source: "local",
-        };
+        }
+        : null;
+    let github = null;
+    try {
+        const ghApk = await fetchGitHubLatestApk();
+        if (ghApk) {
+            github = {
+                version: ghApk.version,
+                downloadUrl: ghApk.downloadUrl,
+                fileName: ghApk.fileName,
+                size: ghApk.size,
+                source: "github",
+                releaseNotes: ghApk.releaseNotes,
+            };
+        }
     }
-    // Priority 2: GitHub Release
-    const ghApk = await fetchGitHubLatestApk();
-    if (ghApk) {
-        return {
-            version: ghApk.version,
-            downloadUrl: ghApk.downloadUrl,
-            fileName: ghApk.fileName,
-            size: ghApk.size,
-            source: "github",
-            releaseNotes: ghApk.releaseNotes,
-        };
+    catch {
+        // GitHub 不可达时静默回退 local
     }
-    return null;
+    if (local && github) {
+        return compareApkInstallOrder(github.version, local.version) > 0 ? github : local;
+    }
+    return local ?? github;
 }
 let cachedGitHubDmg = null;
 let gitHubDmgCacheTs = 0;
@@ -526,13 +533,15 @@ async function resolveAndroidApkAsset(configDir, config) {
             fileStat,
         };
     }));
-    // 按语义版本选"最新", 而非修改时间 —— cp/rsync/解压/checkout 都可能让低版本号文件的
+    // 按版本号选"最新", 而非修改时间 —— cp/rsync/解压/checkout 都可能让低版本号文件的
     // mtime 更新, 用 mtime 会把旧版本号当成 latest 上报。版本相同或都无版本号时退回 mtime。
+    // 注意用安装序比较（同三段时 debug > release，镜像 versionCode），不是标准 semver：
+    // wand-v1.55.0.apk 与 wand-v1.55.0-debug.x.apk 并存时，debug 才是装得上的更新包。
     candidates.sort((a, b) => {
         const va = extractAndroidApkVersion(a.entry.name);
         const vb = extractAndroidApkVersion(b.entry.name);
         if (va && vb) {
-            const cmp = compareSemver(vb, va);
+            const cmp = compareApkInstallOrder(vb, va);
             if (cmp !== 0)
                 return cmp;
         }
@@ -925,7 +934,6 @@ export async function startServer(config, configPath) {
     const storage = new WandStorage(resolveDatabasePath(configPath));
     setAuthStorage(storage);
     const configDir = resolveConfigDir(configPath);
-    const avatarSeed = await ensureAvatarSeed(configDir);
     const processes = new ProcessManager(config, storage, configDir);
     const structuredLogger = new SessionLogger(configDir, config.shortcutLogMaxBytes);
     const structuredSessions = new StructuredSessionManager(storage, config, structuredLogger);
@@ -943,7 +951,7 @@ export async function startServer(config, configPath) {
     app.get("/vendor/wterm/wterm.bundle.js", (req, res) => sendEmbeddedVendorAsset("/vendor/wterm/wterm.bundle.js", req, res));
     app.get("/vendor/wterm/terminal.css", (req, res) => sendEmbeddedVendorAsset("/vendor/wterm/terminal.css", req, res));
     app.get("/vendor/qrcode/qrcode.bundle.js", (req, res) => sendEmbeddedVendorAsset("/vendor/qrcode/qrcode.bundle.js", req, res));
-    // ── Web UI and PWA endpoints ──
+    // ── Web UI endpoints ──
     app.get("/", (_req, res) => {
         res.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
         res.type("html").send(renderApp(configPath));
@@ -992,24 +1000,6 @@ export async function startServer(config, configPath) {
             res.status(404).end();
         }
     });
-    app.get("/manifest.json", (_req, res) => {
-        res.setHeader("Content-Type", "application/manifest+json");
-        res.send(generatePwaManifest());
-    });
-    for (const [route, size] of [["/icon.svg", 192], ["/icon-192.png", 192], ["/icon-512.png", 512]]) {
-        app.get(route, (_req, res) => {
-            res.type("image/svg+xml").send(getAvatarSvg(avatarSeed, size));
-        });
-    }
-    app.get("/sw.js", (_req, res) => {
-        res.setHeader("Content-Type", "application/javascript");
-        res.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
-        res.setHeader("Service-Worker-Allowed", "/");
-        res.send(generateServiceWorker());
-    });
-    app.get("/offline", (_req, res) => {
-        res.type("html").send(renderApp(configPath));
-    });
     // ── Auth routes ──
     app.post("/api/login", (req, res) => {
         const clientIp = req.ip || req.socket.remoteAddress || "unknown";
@@ -1091,7 +1081,9 @@ export async function startServer(config, configPath) {
             res.json({ updateAvailable: false, currentVersion, latestVersion: null, downloadUrl: null, source: null });
             return;
         }
-        const updateAvailable = compareSemver(latest.version, currentVersion) > 0;
+        // 安装序比较（镜像 versionCode），不是标准 semver：只在系统安装器真能装上时才提示，
+        // 避免「提示升级 → 下载 → 被按降级拒装」的死循环（如已装 1.55.0-debug 提示装 1.55.0）。
+        const updateAvailable = compareApkInstallOrder(latest.version, currentVersion) > 0;
         res.json({
             updateAvailable,
             currentVersion,

package/dist/types.d.ts

@@ -79,7 +79,7 @@ export interface WandConfig {
     /**
      * 可选：使用用户自备的 TLS 证书/私钥（PEM 格式）。配了 `certPath` + `keyPath`
      * 且文件可读时，将跳过自签证书生成。用 mkcert/Let's Encrypt 等签的证书时，
-     * 浏览器视为受信任，PWA / Service Worker 才能正常注册。
+     * 浏览器可直接信任 HTTPS 连接。
      */
     tls?: {
         certPath?: string;

package/dist/version-utils.d.ts

@@ -14,3 +14,19 @@ export declare function extractSemver(text: string): string | null;
  *   贴近标准 semver，避免 debug.MMDDHHMM 后缀因纯字典序而跨月/跨年排反。
  */
 export declare function compareSemver(a: string, b: string): number;
+/**
+ * Android APK 安装序比较 —— 与 android/app/build.gradle 的 computeVersionCode 镜像一致，
+ * 回答「这个包能否覆盖安装到那个包之上 / 该不该提示升级」。返回正数 = a 比 b 新。
+ *
+ * 与标准 semver（compareSemver）的关键差异：同主版本三段时，带 `-debug` 后缀的包
+ * 【更新】而不是更旧 —— debug 包是 tag 之后的 master 构建（versionCode = base+1，
+ * release 是 base+0），系统安装器只认 versionCode。若在这里沿用 semver 的
+ * 「prerelease < release」规则，就会提示用户从 debug「升级」到同号 release，
+ * 下载后被系统按降级拒装。
+ *
+ * - 三段数值比较优先；
+ * - 同三段：带 -debug > 不带（镜像 versionCode base+1 > base+0）；
+ * - 两个 debug：按后缀分段比较（debug.MMDDHHMM 时间戳数值比），versionCode 相同、
+ *   系统允许互装，比较结果只用于「是否提示更新」。
+ */
+export declare function compareApkInstallOrder(a: string, b: string): number;

package/dist/version-utils.js

@@ -37,8 +37,12 @@ export function compareSemver(a, b) {
         return -1;
     if (!pa.pre && !pb.pre)
         return 0;
-    const segA = pa.pre.split(".");
-    const segB = pb.pre.split(".");
+    return comparePrereleaseSegments(pa.pre, pb.pre);
+}
+/** 按 `.` 分段比较 prerelease 后缀：数字段数值比、非数字段字典序、段少者更小。 */
+function comparePrereleaseSegments(preA, preB) {
+    const segA = preA.split(".");
+    const segB = preB.split(".");
     const segLen = Math.max(segA.length, segB.length);
     for (let i = 0; i < segLen; i++) {
         const sa = segA[i];
@@ -64,3 +68,38 @@ export function compareSemver(a, b) {
     }
     return 0;
 }
+/**
+ * Android APK 安装序比较 —— 与 android/app/build.gradle 的 computeVersionCode 镜像一致，
+ * 回答「这个包能否覆盖安装到那个包之上 / 该不该提示升级」。返回正数 = a 比 b 新。
+ *
+ * 与标准 semver（compareSemver）的关键差异：同主版本三段时，带 `-debug` 后缀的包
+ * 【更新】而不是更旧 —— debug 包是 tag 之后的 master 构建（versionCode = base+1，
+ * release 是 base+0），系统安装器只认 versionCode。若在这里沿用 semver 的
+ * 「prerelease < release」规则，就会提示用户从 debug「升级」到同号 release，
+ * 下载后被系统按降级拒装。
+ *
+ * - 三段数值比较优先；
+ * - 同三段：带 -debug > 不带（镜像 versionCode base+1 > base+0）；
+ * - 两个 debug：按后缀分段比较（debug.MMDDHHMM 时间戳数值比），versionCode 相同、
+ *   系统允许互装，比较结果只用于「是否提示更新」。
+ */
+export function compareApkInstallOrder(a, b) {
+    const parse = (v) => {
+        const [main, ...rest] = v.replace(/^v/, "").split("-");
+        const pre = rest.join("-");
+        const mainParts = main.split(".").map((n) => Number(n) || 0);
+        return { mainParts, pre, isDebug: pre.startsWith("debug") };
+    };
+    const pa = parse(a);
+    const pb = parse(b);
+    for (let i = 0; i < 3; i++) {
+        const diff = (pa.mainParts[i] || 0) - (pb.mainParts[i] || 0);
+        if (diff !== 0)
+            return diff;
+    }
+    if (pa.isDebug !== pb.isDebug)
+        return pa.isDebug ? 1 : -1;
+    if (pa.isDebug && pb.isDebug)
+        return comparePrereleaseSegments(pa.pre, pb.pre);
+    return 0;
+}