@co0ontty/wand 1.33.0 → 1.35.0

package/dist/server.js

@@ -86,11 +86,33 @@ function compareSemver(a, b) {
         return -1;
     if (!pa.pre && !pb.pre)
         return 0;
-    // Both have prerelease: lexical compare handles debug.MMDDHHMM ordering.
-    if (pa.pre < pb.pre)
-        return -1;
-    if (pa.pre > pb.pre)
-        return 1;
+    // Both have prerelease: 按 . 分段比较 (数字段数值比, 非数字段字典序), 贴近标准 semver,
+    // 避免跨月/跨年的 debug.MMDDHHMM 后缀因纯字典序而排反。
+    const segA = pa.pre.split(".");
+    const segB = pb.pre.split(".");
+    const segLen = Math.max(segA.length, segB.length);
+    for (let i = 0; i < segLen; i++) {
+        const sa = segA[i];
+        const sb = segB[i];
+        if (sa === undefined)
+            return -1; // 段少者更小
+        if (sb === undefined)
+            return 1;
+        const na = Number(sa);
+        const nb = Number(sb);
+        const aIsNum = sa !== "" && !Number.isNaN(na);
+        const bIsNum = sb !== "" && !Number.isNaN(nb);
+        if (aIsNum && bIsNum) {
+            if (na !== nb)
+                return na < nb ? -1 : 1;
+        }
+        else if (aIsNum !== bIsNum) {
+            return aIsNum ? -1 : 1; // 数字段 < 非数字段
+        }
+        else if (sa !== sb) {
+            return sa < sb ? -1 : 1;
+        }
+    }
     return 0;
 }
 let cachedGitHubApk = null;
@@ -119,6 +141,7 @@ async function fetchGitHubLatestApk(forceRefresh = false) {
             downloadUrl: apkAsset.browser_download_url,
             fileName: apkAsset.name,
             size: apkAsset.size,
+            releaseNotes: release.body ? release.body.trim().slice(0, 500) : undefined,
         };
         gitHubApkCacheTs = now;
         return cachedGitHubApk;
@@ -148,6 +171,7 @@ async function resolveLatestApkVersion(configDir, config) {
             fileName: ghApk.fileName,
             size: ghApk.size,
             source: "github",
+            releaseNotes: ghApk.releaseNotes,
         };
     }
     return null;
@@ -461,7 +485,24 @@ async function resolveAndroidApkAsset(configDir, config) {
             fileStat,
         };
     }));
-    candidates.sort((a, b) => b.fileStat.mtimeMs - a.fileStat.mtimeMs);
+    // 按语义版本选"最新", 而非修改时间 —— cp/rsync/解压/checkout 都可能让低版本号文件的
+    // mtime 更新, 用 mtime 会把旧版本号当成 latest 上报。版本相同或都无版本号时退回 mtime。
+    candidates.sort((a, b) => {
+        const va = extractAndroidApkVersion(a.entry.name);
+        const vb = extractAndroidApkVersion(b.entry.name);
+        if (va && vb) {
+            const cmp = compareSemver(vb, va);
+            if (cmp !== 0)
+                return cmp;
+        }
+        else if (va && !vb) {
+            return -1;
+        }
+        else if (!va && vb) {
+            return 1;
+        }
+        return b.fileStat.mtimeMs - a.fileStat.mtimeMs;
+    });
     const selected = candidates[0];
     return {
         fileName: selected.entry.name,
@@ -936,22 +977,66 @@ export async function startServer(config, configPath) {
             fileName: updateAvailable ? latest.fileName : null,
             size: updateAvailable ? latest.size : null,
             source: latest.source,
+            releaseNotes: updateAvailable ? (latest.releaseNotes ?? null) : null,
         });
     });
-    app.get("/android/download", async (_req, res) => {
-        const androidApk = await resolveAndroidApkAsset(configDir, config);
+    app.get("/android/download", async (req, res) => {
         if (config.android?.enabled !== true) {
             res.status(404).json({ error: "Android APK 下载未启用。" });
             return;
         }
+        const androidApk = await resolveAndroidApkAsset(configDir, config);
         if (!androidApk) {
             res.status(404).json({ error: "当前没有可下载的 APK 文件。" });
             return;
         }
+        const total = androidApk.size;
         res.setHeader("Content-Type", "application/vnd.android.package-archive");
-        res.setHeader("Content-Length", String(androidApk.size));
         res.setHeader("Content-Disposition", `attachment; filename="${encodeURIComponent(androidApk.fileName)}"`);
-        createReadStream(androidApk.filePath).pipe(res);
+        // 声明支持断点续传 — 弱网/移动网络下中断后客户端可带 Range 续传, 而非从头重下。
+        res.setHeader("Accept-Ranges", "bytes");
+        // 解析 Range: bytes=start-end (含后缀范围 bytes=-N)。命中则返回 206 + 局部内容。
+        let start = 0;
+        let end = total - 1;
+        let isPartial = false;
+        const rangeHeader = req.headers.range;
+        if (rangeHeader) {
+            const match = /^bytes=(\d*)-(\d*)$/.exec(rangeHeader.trim());
+            if (match && (match[1] !== "" || match[2] !== "")) {
+                if (match[1] === "") {
+                    // bytes=-N: 最后 N 字节
+                    start = Math.max(0, total - Number(match[2]));
+                    end = total - 1;
+                }
+                else {
+                    start = Number(match[1]);
+                    end = match[2] === "" ? total - 1 : Math.min(Number(match[2]), total - 1);
+                }
+                isPartial = true;
+                if (start > end || start < 0 || start >= total) {
+                    res.status(416);
+                    res.setHeader("Content-Range", `bytes */${total}`);
+                    res.end();
+                    return;
+                }
+            }
+        }
+        if (isPartial) {
+            res.status(206);
+            res.setHeader("Content-Range", `bytes ${start}-${end}/${total}`);
+        }
+        res.setHeader("Content-Length", String(end - start + 1));
+        const stream = createReadStream(androidApk.filePath, { start, end });
+        stream.on("error", (err) => {
+            // 文件在 stat 之后被删/读错误时, 让客户端尽快感知断流, 而不是等满读超时。
+            if (!res.headersSent) {
+                res.status(500).json({ error: getErrorMessage(err, "读取 APK 文件失败。") });
+            }
+            else {
+                res.destroy();
+            }
+        });
+        stream.pipe(res);
     });
     // ── macOS DMG update & download (no auth required) ──
     app.get("/api/macos-dmg-update", async (req, res) => {

package/dist/web-ui/content/scripts.js

@@ -1390,7 +1390,7 @@
                 checkDmgAutoUpdate();
               }
               if (state.claudeHistoryExpanded && !state.claudeHistoryLoaded) {
-                loadClaudeHistory();
+                ensureClaudeHistoryLoaded();
               }
             });
           })
@@ -1462,8 +1462,11 @@
         // Suppress CSS transitions during initial DOM build
         document.documentElement.classList.add("no-transition");
 
-        // Apply persisted pin state before rendering
-        if (state.sidebarPinned && !isMobileLayout()) {
+        // Apply persisted pin state before rendering.
+        // 窄条（collapsed）形态不靠 .open 显示，靠 .pinned.collapsed 的 width:56px
+        // 常驻；此时强制 sessionsDrawerOpen=true 会与 toggleSidebarCollapsed 里设的
+        // false 打架，并在手机端误触发背景遮罩。窄条态下不强制 open。
+        if (state.sidebarPinned && !state.sidebarCollapsed && !isMobileLayout()) {
           state.sessionsDrawerOpen = true;
         }
         app.innerHTML = isLoggedIn ? renderAppShell() : renderLogin();
@@ -2912,7 +2915,7 @@
                   '<div id="android-auto-update-row" class="settings-toggle-row hidden">' +
                     '<div class="settings-toggle-text">' +
                       '<span class="settings-toggle-title">自动更新</span>' +
-                      '<span class="settings-toggle-desc" id="android-auto-update-hint">检测到新版 APK 将自动下载安装。</span>' +
+                      '<span class="settings-toggle-desc" id="android-auto-update-hint">检测到新版 APK 时自动拉起下载，安装仍需在系统中确认。</span>' +
                     '</div>' +
                     '<label class="settings-switch">' +
                       '<input type="checkbox" id="auto-update-apk-toggle" class="switch-toggle">' +
@@ -3558,6 +3561,11 @@
 
       function toggleManageMode(force) {
         state.sessionsManageMode = typeof force === "boolean" ? force : !state.sessionsManageMode;
+        if (state.sessionsManageMode && !state.claudeHistoryLoaded) {
+          // 进入管理模式即后台补齐 Claude 历史，让「已选 N」「全选」计数从一开始
+          // 就覆盖全部历史，而不是只统计已加载的那部分。
+          ensureClaudeHistoryLoaded().then(updateSessionsList);
+        }
         if (!state.sessionsManageMode) {
           clearManageSelections();
           closeSwipedItem();
@@ -3574,6 +3582,16 @@
       }
 
       function selectAllVisibleItems() {
+        // 全选语义 = 选中所有可管理项（会话 + 全部 Claude 历史）。历史在登录后
+        // 异步扫描，若用户在扫描完成前点「全选」，state.claudeHistory 仍为空会漏选，
+        // 删除时表现为"只删了已加载的，跨目录/未扫完的历史还在"。这里先确保历史
+        // 加载完成再全选。
+        if (!state.claudeHistoryLoaded) {
+          ensureClaudeHistoryLoaded().then(selectAllVisibleItems);
+          return;
+        }
+        // 展开 Claude 历史分组，让用户能直观看到这些历史项也被选中了。
+        state.claudeHistoryExpanded = true;
         var nextSessionIds = {};
         getSelectableSessions().forEach(function(session) {
           nextSessionIds[session.id] = true;
@@ -3782,6 +3800,21 @@
           });
       }
 
+      // 去重包装：登录后历史会异步扫描，多个入口（管理模式、全选、展开分组）
+      // 可能同时想确保历史就绪。共享同一个 in-flight Promise，避免重复 fetch，
+      // 且在已加载时立即 resolve。
+      var _claudeHistoryLoadingPromise = null;
+      function ensureClaudeHistoryLoaded() {
+        if (state.claudeHistoryLoaded) return Promise.resolve();
+        if (_claudeHistoryLoadingPromise) return _claudeHistoryLoadingPromise;
+        _claudeHistoryLoadingPromise = loadClaudeHistory().then(function() {
+          _claudeHistoryLoadingPromise = null;
+        }, function() {
+          _claudeHistoryLoadingPromise = null;
+        });
+        return _claudeHistoryLoadingPromise;
+      }
+
       function isMobileLayout() {
         return window.innerWidth <= 768;
       }
@@ -5892,11 +5925,17 @@
         if (sidebarMoreBtn && sidebarOverflow) {
           sidebarMoreBtn.addEventListener("click", function(e) {
             e.stopPropagation();
-            sidebarOverflow.classList.toggle("open");
+            var willOpen = !sidebarOverflow.classList.contains("open");
+            sidebarOverflow.classList.toggle("open", willOpen);
+            if (willOpen) positionSidebarOverflowMenu(sidebarOverflow);
           });
           document.addEventListener("click", function() {
             sidebarOverflow.classList.remove("open");
           });
+          // 视口尺寸变化时关闭，避免 clamp 后的定位与新尺寸不符。
+          window.addEventListener("resize", function() {
+            sidebarOverflow.classList.remove("open");
+          });
         }
         var homeBtn = document.getElementById("sidebar-home-btn");
         if (homeBtn) homeBtn.addEventListener("click", function() {
@@ -6964,7 +7003,7 @@
           event.stopPropagation();
           state.claudeHistoryExpanded = !state.claudeHistoryExpanded;
           if (state.claudeHistoryExpanded && !state.claudeHistoryLoaded) {
-            loadClaudeHistory();
+            ensureClaudeHistoryLoaded();
           }
           updateSessionsList();
           return;
@@ -9588,10 +9627,55 @@
           // 桌面端展开窄条 → 300px 全栏常驻。
           state.sessionsDrawerOpen = true;
         }
-        render();
+        // 轻量更新而非全量 render()：render() 会 teardown 并重建整个终端 DOM，
+        // 导致收窄/展开时终端闪烁、丢失滚动与渲染状态。这里只切布局 class
+        // （宽度 56↔300 走 CSS width transition）、重渲侧栏列表内容、刷新
+        // 收窄按钮自身的图标/文案，终端区保持不动。
+        updateLayoutState();
+        updateSessionsList();
+        updateSidebarCollapseButton();
+        hideCollapsedTileBubble();
         scheduleTerminalRefitAfterPaddingTransition();
       }
 
+      // 收窄按钮的图标/title/状态随 collapsed 切换。抽出来给轻量更新路径用，
+      // 避免为了换一个箭头方向就走全量 render()。
+      function updateSidebarCollapseButton() {
+        var btn = document.getElementById("sidebar-collapse-btn");
+        if (!btn) return;
+        var isCollapsed = !!state.sidebarPinned && !!state.sidebarCollapsed;
+        btn.classList.toggle("collapsed", isCollapsed);
+        btn.title = isCollapsed ? "展开侧栏" : "收起为窄条";
+        btn.setAttribute("aria-label", isCollapsed ? "展开侧栏" : "收起为窄条");
+        btn.innerHTML = isCollapsed
+          ? '<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><polyline points="10 6 16 12 10 18"/><line x1="20" y1="5" x2="20" y2="19"/></svg>'
+          : '<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><polyline points="14 6 8 12 14 18"/><line x1="4" y1="5" x2="4" y2="19"/></svg>';
+      }
+
+      // 「更多操作」下拉默认 right:0 贴 more 按钮右沿向左展开。手机窄屏下这条会把
+      // 菜单左缘顶出屏幕外。打开时按视口边界 clamp：先保持 CSS 默认右对齐，仅当
+      // 真的越界才改写 left/right 把菜单拉回视口内（留 8px 边距）。
+      function positionSidebarOverflowMenu(menu) {
+        if (!menu) return;
+        menu.style.left = "";
+        menu.style.right = "";
+        var parent = menu.offsetParent || menu.parentElement;
+        if (!parent) return;
+        var margin = 8;
+        var parentRect = parent.getBoundingClientRect();
+        var rect = menu.getBoundingClientRect();
+        var vw = window.innerWidth;
+        if (rect.left < margin) {
+          // 左缘越界：改用 left 定位，把左缘顶到视口左 margin。
+          menu.style.right = "auto";
+          menu.style.left = (margin - parentRect.left) + "px";
+        } else if (rect.right > vw - margin) {
+          // 右缘越界：拉回视口右 margin（桌面右对齐时几乎不会触发）。
+          menu.style.left = "auto";
+          menu.style.right = (parentRect.right - (vw - margin)) + "px";
+        }
+      }
+
 
       // Store last focused element for focus trap
       var lastFocusedElement = null;
@@ -10217,9 +10301,81 @@
             var autoUpdateWebToggle = document.getElementById("auto-update-web-toggle");
             if (autoUpdateWebToggle) autoUpdateWebToggle.checked = !!autoUpdate.web;
             var autoUpdateApkToggle = document.getElementById("auto-update-apk-toggle");
-            if (autoUpdateApkToggle) autoUpdateApkToggle.checked = !!autoUpdate.apk;
+            // 自动更新开关只对 APK 壳生效, 浏览器里不绑定状态(该行也保持隐藏), 避免静默写一个看不见的控件。
+            if (autoUpdateApkToggle) autoUpdateApkToggle.checked = !!_apkVersion && !!autoUpdate.apk;
             var autoUpdateDmgToggle = document.getElementById("auto-update-dmg-toggle");
-            if (autoUpdateDmgToggle) autoUpdateDmgToggle.checked = !!autoUpdate.dmg;
+            if (autoUpdateDmgToggle) autoUpdateDmgToggle.checked = !!_macAppVersion && !!autoUpdate.dmg;
+
+            // ── 原生包下载 helper（APK / DMG 共用）──
+            function safeNotify(msg, type) {
+              if (typeof window.wandAlert === "function") {
+                window.wandAlert(msg, { type: type === "error" ? "danger" : "info" });
+              } else if (typeof showToast === "function") {
+                showToast(msg, type === "error" ? "error" : "info");
+              } else if (type === "error") {
+                alert(msg);
+              }
+            }
+            // 同源本地下载：先 HEAD 探测状态码, 避免 window.open("_self") 把整页导航成裸 JSON;
+            // 命中则用隐藏 <a download> 触发下载, 并给出明确反馈。
+            function triggerLocalDownload(url, fileName, btn) {
+              var original = btn ? btn.textContent : "";
+              if (btn) { btn.disabled = true; btn.textContent = "下载中…"; }
+              function restore() { if (btn) { btn.disabled = false; btn.textContent = original; } }
+              fetch(url, { method: "HEAD", credentials: "same-origin" })
+                .then(function(resp) {
+                  if (!resp.ok) {
+                    safeNotify(resp.status === 404 ? "下载未启用或文件已移除" : ("下载失败 (HTTP " + resp.status + ")"), "error");
+                    restore();
+                    return;
+                  }
+                  var a = document.createElement("a");
+                  a.href = url;
+                  a.download = fileName || "";
+                  document.body.appendChild(a);
+                  a.click();
+                  document.body.removeChild(a);
+                  safeNotify("已开始下载，请在通知栏/下载管理中查看", "info");
+                  restore();
+                })
+                .catch(function(err) {
+                  safeNotify("下载失败: " + (err && err.message ? err.message : err), "error");
+                  restore();
+                });
+            }
+
+            // 设置页版本比较 (仅主版本三段, 预发布忽略) — 判断该升级 / 已最新 / 更旧。
+            function compareVer(a, b) {
+              function parse(v) {
+                return String(v || "").replace(/^v/, "").split("-")[0].split(".").map(function(n) { return parseInt(n, 10) || 0; });
+              }
+              var pa = parse(a), pb = parse(b);
+              for (var i = 0; i < 3; i++) {
+                var d = (pa[i] || 0) - (pb[i] || 0);
+                if (d !== 0) return d > 0 ? 1 : -1;
+              }
+              return 0;
+            }
+            // 壳内按钮: 据版本比较结果决定文案/可点性, 避免线上比已装旧时仍诱导"下载安装"。
+            function applyApkButton(btn, cmp, url, fileName, source) {
+              btn.classList.remove("hidden");
+              btn.disabled = false;
+              if (cmp > 0) {
+                btn.textContent = "升级";
+              } else if (cmp === 0) {
+                btn.textContent = "已是最新";
+                btn.disabled = true;
+              } else {
+                btn.textContent = "重新安装";
+              }
+              btn.onclick = btn.disabled ? null : function() {
+                try {
+                  WandNative.downloadUpdate(url, fileName, source);
+                } catch (e) {
+                  safeNotify("调用下载失败: " + (e && e.message ? e.message : e), "error");
+                }
+              };
+            }
 
             // ── Android APK version display ──
             var apkSection = document.getElementById("android-apk-section");
@@ -10234,7 +10390,9 @@
             var apkMessageEl = document.getElementById("android-apk-message");
             var androidApk = data.androidApk || {};
             var isInApk = !!_apkVersion;
-            var hasApkInfo = isInApk || !!androidApk.github || !!androidApk.local;
+            // 浏览器模式下若管理员未启用 Android 分发(enabled===false), 整段隐藏; 壳内保留以便自升级。
+            var apkEnabled = androidApk.enabled !== false;
+            var hasApkInfo = isInApk || (apkEnabled && (!!androidApk.github || !!androidApk.local));
             if (apkSection) {
               if (hasApkInfo) apkSection.classList.remove("hidden");
               else apkSection.classList.add("hidden");
@@ -10253,21 +10411,8 @@
                 apkGithubEl.textContent = ghLabel;
                 apkGithubRow.classList.remove("hidden");
                 if (apkGithubBtn) {
-                  apkGithubBtn.textContent = "下载安装";
-                  apkGithubBtn.classList.remove("hidden");
-                  apkGithubBtn.onclick = function() {
-                    try {
-                      WandNative.downloadUpdate(androidApk.github.downloadUrl, androidApk.github.fileName || "wand-update.apk", "github");
-                    } catch (e) {
-                      if (typeof window.wandAlert === "function") {
-                        window.wandAlert("调用下载失败: " + e.message, { type: "danger", title: "下载失败" });
-                      } else if (typeof showToast === "function") {
-                        showToast("调用下载失败: " + e.message, "error");
-                      } else {
-                        alert("调用下载失败: " + e.message);
-                      }
-                    }
-                  };
+                  var ghCmp = androidApk.github.version ? compareVer(androidApk.github.version, _apkVersion) : 1;
+                  applyApkButton(apkGithubBtn, ghCmp, androidApk.github.downloadUrl, androidApk.github.fileName || "wand-update.apk", "github");
                 }
               }
               // 本地版本
@@ -10277,21 +10422,8 @@
                 apkLocalEl.textContent = lcLabel;
                 apkLocalRow.classList.remove("hidden");
                 if (apkLocalBtn) {
-                  apkLocalBtn.textContent = "下载安装";
-                  apkLocalBtn.classList.remove("hidden");
-                  apkLocalBtn.onclick = function() {
-                    try {
-                      WandNative.downloadUpdate(androidApk.local.downloadUrl, androidApk.local.fileName || "wand-update.apk", "local");
-                    } catch (e) {
-                      if (typeof window.wandAlert === "function") {
-                        window.wandAlert("调用下载失败: " + e.message, { type: "danger", title: "下载失败" });
-                      } else if (typeof showToast === "function") {
-                        showToast("调用下载失败: " + e.message, "error");
-                      } else {
-                        alert("调用下载失败: " + e.message);
-                      }
-                    }
-                  };
+                  var lcCmp = androidApk.local.version ? compareVer(androidApk.local.version, _apkVersion) : 1;
+                  applyApkButton(apkLocalBtn, lcCmp, androidApk.local.downloadUrl, androidApk.local.fileName || "wand-update.apk", "local");
                 }
               }
               // 都没有时
@@ -10316,6 +10448,7 @@
                   apkGithubBtn.classList.remove("hidden");
                   apkGithubBtn.onclick = function() {
                     window.open(androidApk.github.downloadUrl, "_blank");
+                    safeNotify("正在打开下载页…", "info");
                   };
                 }
               }
@@ -10329,12 +10462,12 @@
                   apkLocalBtn.textContent = "下载";
                   apkLocalBtn.classList.remove("hidden");
                   apkLocalBtn.onclick = function() {
-                    window.open(androidApk.local.downloadUrl, "_self");
+                    triggerLocalDownload(androidApk.local.downloadUrl, androidApk.local.fileName || "wand-update.apk", apkLocalBtn);
                   };
                 }
               }
               if (!androidApk.github && !androidApk.local && apkMessageEl) {
-                apkMessageEl.textContent = "暂未提供";
+                apkMessageEl.textContent = apkEnabled ? "在线版本暂时获取失败，可稍后重试" : "Android 下载未在服务端启用";
                 apkMessageEl.classList.remove("hidden");
               }
             }
@@ -10352,7 +10485,8 @@
             var dmgMessageEl = document.getElementById("macos-dmg-message");
             var macosDmg = data.macosDmg || {};
             var isInMacApp = !!_macAppVersion;
-            var hasDmgInfo = isInMacApp || !!macosDmg.github || !!macosDmg.local;
+            var dmgEnabled = macosDmg.enabled !== false;
+            var hasDmgInfo = isInMacApp || (dmgEnabled && (!!macosDmg.github || !!macosDmg.local));
             if (dmgSection) {
               if (hasDmgInfo) dmgSection.classList.remove("hidden");
               else dmgSection.classList.add("hidden");
@@ -10370,21 +10504,8 @@
                 dmgGithubEl.textContent = dghLabel;
                 dmgGithubRow.classList.remove("hidden");
                 if (dmgGithubBtn) {
-                  dmgGithubBtn.textContent = "下载安装";
-                  dmgGithubBtn.classList.remove("hidden");
-                  dmgGithubBtn.onclick = function() {
-                    try {
-                      WandNative.downloadUpdate(macosDmg.github.downloadUrl, macosDmg.github.fileName || "wand-update.dmg", "github");
-                    } catch (e) {
-                      if (typeof window.wandAlert === "function") {
-                        window.wandAlert("调用下载失败: " + e.message, { type: "danger", title: "下载失败" });
-                      } else if (typeof showToast === "function") {
-                        showToast("调用下载失败: " + e.message, "error");
-                      } else {
-                        alert("调用下载失败: " + e.message);
-                      }
-                    }
-                  };
+                  var dghCmp = macosDmg.github.version ? compareVer(macosDmg.github.version, _macAppVersion) : 1;
+                  applyApkButton(dmgGithubBtn, dghCmp, macosDmg.github.downloadUrl, macosDmg.github.fileName || "wand-update.dmg", "github");
                 }
               }
               if (macosDmg.local && dmgLocalRow && dmgLocalEl) {
@@ -10393,21 +10514,8 @@
                 dmgLocalEl.textContent = dlcLabel;
                 dmgLocalRow.classList.remove("hidden");
                 if (dmgLocalBtn) {
-                  dmgLocalBtn.textContent = "下载安装";
-                  dmgLocalBtn.classList.remove("hidden");
-                  dmgLocalBtn.onclick = function() {
-                    try {
-                      WandNative.downloadUpdate(macosDmg.local.downloadUrl, macosDmg.local.fileName || "wand-update.dmg", "local");
-                    } catch (e) {
-                      if (typeof window.wandAlert === "function") {
-                        window.wandAlert("调用下载失败: " + e.message, { type: "danger", title: "下载失败" });
-                      } else if (typeof showToast === "function") {
-                        showToast("调用下载失败: " + e.message, "error");
-                      } else {
-                        alert("调用下载失败: " + e.message);
-                      }
-                    }
-                  };
+                  var dlcCmp = macosDmg.local.version ? compareVer(macosDmg.local.version, _macAppVersion) : 1;
+                  applyApkButton(dmgLocalBtn, dlcCmp, macosDmg.local.downloadUrl, macosDmg.local.fileName || "wand-update.dmg", "local");
                 }
               }
               if (!macosDmg.github && !macosDmg.local && dmgMessageEl) {
@@ -10430,6 +10538,7 @@
                   dmgGithubBtn.classList.remove("hidden");
                   dmgGithubBtn.onclick = function() {
                     window.open(macosDmg.github.downloadUrl, "_blank");
+                    safeNotify("正在打开下载页…", "info");
                   };
                 }
               }
@@ -10442,12 +10551,12 @@
                   dmgLocalBtn.textContent = "下载";
                   dmgLocalBtn.classList.remove("hidden");
                   dmgLocalBtn.onclick = function() {
-                    window.open(macosDmg.local.downloadUrl, "_self");
+                    triggerLocalDownload(macosDmg.local.downloadUrl, macosDmg.local.fileName || "wand-update.dmg", dmgLocalBtn);
                   };
                 }
               }
               if (!macosDmg.github && !macosDmg.local && dmgMessageEl) {
-                dmgMessageEl.textContent = "暂未提供";
+                dmgMessageEl.textContent = dmgEnabled ? "在线版本暂时获取失败，可稍后重试" : "macOS 下载未在服务端启用";
                 dmgMessageEl.classList.remove("hidden");
               }
             }

package/dist/web-ui/content/styles.css

@@ -574,9 +574,8 @@
       justify-content: center;
       padding: 0;
       box-shadow:
-        0 1px 3px rgba(184, 92, 55, 0.28),
-        inset 0 1px 0 rgba(255, 255, 255, 0.28),
-        inset 0 -1px 0 rgba(0, 0, 0, 0.08);
+        0 1px 2px rgba(184, 92, 55, 0.22),
+        inset 0 1px 0 rgba(255, 255, 255, 0.28);
       transition:
         filter var(--transition-fast),
         box-shadow 0.22s ease,
@@ -586,40 +585,31 @@
       filter: brightness(1.06);
       transform: translateY(-1px);
       box-shadow:
-        0 4px 12px -2px rgba(184, 92, 55, 0.42),
-        inset 0 1px 0 rgba(255, 255, 255, 0.35),
-        inset 0 -1px 0 rgba(0, 0, 0, 0.08);
+        0 4px 10px -3px rgba(184, 92, 55, 0.36),
+        inset 0 1px 0 rgba(255, 255, 255, 0.32);
     }
     /* History tile — softer cream tone to distinguish from active sessions */
     .sidebar-collapsed-tile.history {
       background: linear-gradient(145deg, #e8d3c0 0%, #d3b69d 50%, #b89478 100%);
       color: rgba(89, 58, 32, 0.88);
       box-shadow:
-        0 1px 3px rgba(120, 88, 56, 0.22),
-        inset 0 1px 0 rgba(255, 255, 255, 0.45),
-        inset 0 -1px 0 rgba(0, 0, 0, 0.06);
+        0 1px 2px rgba(120, 88, 56, 0.18),
+        inset 0 1px 0 rgba(255, 255, 255, 0.42);
     }
     .sidebar-collapsed-tile.history:hover {
       box-shadow:
-        0 4px 12px -2px rgba(120, 88, 56, 0.34),
-        inset 0 1px 0 rgba(255, 255, 255, 0.5),
-        inset 0 -1px 0 rgba(0, 0, 0, 0.06);
+        0 4px 10px -3px rgba(120, 88, 56, 0.3),
+        inset 0 1px 0 rgba(255, 255, 255, 0.48);
     }
-    /* Active — liquid glass crown: outer ring + warm halo + crisp top sheen */
+    /* Active — accent ring + 一层柔和暖投影 + 顶高光。原先 7 层叠加在 36px 小块上
+       糊成一团，精简到 3 层即可表达「升起 + 选中」。 */
     .sidebar-collapsed-tile.active {
       background: linear-gradient(145deg, #d27358 0%, #b35434 50%, #934128 100%);
       transform: translateY(-1px);
       box-shadow:
-        /* outer glow halo */
-        0 0 0 1px rgba(255, 255, 255, 0.7),
-        0 0 0 3px rgba(197, 101, 61, 0.32),
-        0 8px 22px -4px rgba(160, 74, 46, 0.55),
-        0 3px 8px -2px rgba(160, 74, 46, 0.32),
-        /* top sheen */
-        inset 0 1px 0 rgba(255, 255, 255, 0.45),
-        inset 1px 0 0 rgba(255, 255, 255, 0.18),
-        /* bottom depth */
-        inset 0 -1px 0 rgba(0, 0, 0, 0.16);
+        0 0 0 2px rgba(197, 101, 61, 0.3),
+        0 5px 14px -4px rgba(160, 74, 46, 0.45),
+        inset 0 1px 0 rgba(255, 255, 255, 0.4);
     }
     .sidebar-collapsed-tile:active {
       transform: translateY(0) scale(0.94);
@@ -9034,7 +9024,6 @@
       background: rgba(178, 79, 69, 0.12);
       color: var(--danger);
       transform: rotate(90deg);
-      box-shadow: 0 2px 8px rgba(178, 79, 69, 0.16);
     }
     .drawer-close-btn:active {
       background: rgba(178, 79, 69, 0.2);
@@ -9184,17 +9173,17 @@
       opacity: 1;
     }
 
-    /* ── Session item — clean card on glass ── */
+    /* ── Session item — clean card on glass ──
+       克制原则：基础态用 hairline 描边 + 极轻顶部高光让卡片「贴」在侧栏上，
+       不给每张卡都加漂浮投影；hover/active 才升起一层柔和投影。避免多层
+       box-shadow 在半透明侧栏里互相叠加显脏。 */
     .session-item {
-      background: linear-gradient(180deg, rgba(255, 255, 255, 0.62) 0%, rgba(255, 252, 247, 0.42) 100%);
-      border: 0.5px solid rgba(255, 255, 255, 0.55);
+      background: linear-gradient(180deg, rgba(255, 255, 255, 0.55) 0%, rgba(255, 252, 247, 0.38) 100%);
+      border: 1px solid rgba(125, 91, 57, 0.08);
       border-radius: 13px;
       padding: 11px 14px;
       margin-bottom: 6px;
-      box-shadow:
-        0 0 0 0.5px rgba(125, 91, 57, 0.05),
-        0 1px 2px rgba(125, 91, 57, 0.03),
-        inset 0 1px 0 rgba(255, 255, 255, 0.6);
+      box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.5);
       transition:
         background 0.2s ease,
         border-color 0.2s ease,
@@ -9211,53 +9200,39 @@
     }
     .session-item:hover {
       background: linear-gradient(180deg, rgba(255, 255, 255, 0.85) 0%, rgba(255, 253, 248, 0.62) 100%);
-      border-color: rgba(255, 255, 255, 0.7);
+      border-color: rgba(125, 91, 57, 0.14);
       transform: translateY(-1px);
-      box-shadow:
-        0 0 0 0.5px rgba(125, 91, 57, 0.08),
-        0 6px 16px -6px rgba(125, 91, 57, 0.18),
-        inset 0 1px 0 rgba(255, 255, 255, 0.8);
+      box-shadow: 0 4px 12px -4px rgba(125, 91, 57, 0.16);
     }
     .session-item:hover::before {
       opacity: 0.5;
       transform: scaleY(1);
     }
-    /* Selected (active) — true liquid glass pill with depth + accent glow */
+    /* Selected (active) — accent ring 用边框表达，再叠一层柔和暖投影 + 顶高光。
+       去掉原先的 6 层叠加（外环/光晕/底影/三向 inset），层数过多在玻璃上显脏。 */
     .session-item.active {
       background:
         linear-gradient(180deg, rgba(255, 252, 247, 0.92) 0%, rgba(255, 244, 232, 0.78) 100%);
-      border: 0.5px solid rgba(255, 255, 255, 0.85);
+      border: 1px solid rgba(197, 101, 61, 0.32);
       transform: translateY(-1px);
       backdrop-filter: blur(20px) saturate(180%);
       -webkit-backdrop-filter: blur(20px) saturate(180%);
       box-shadow:
-        /* outer accent ring (soft) */
-        0 0 0 1px rgba(197, 101, 61, 0.28),
-        /* warm glow halo */
-        0 8px 28px -6px rgba(197, 101, 61, 0.32),
-        /* base elevation */
-        0 2px 6px -1px rgba(125, 91, 57, 0.1),
-        /* top inner highlight — light from above */
-        inset 0 1px 0 rgba(255, 255, 255, 0.95),
-        /* bottom inner shadow — depth at base */
-        inset 0 -1px 0 rgba(197, 101, 61, 0.08),
-        /* left inner glint */
-        inset 1px 0 0 rgba(255, 255, 255, 0.4);
+        0 4px 14px -4px rgba(197, 101, 61, 0.24),
+        inset 0 1px 0 rgba(255, 255, 255, 0.7);
     }
+    /* ::before 的左侧高亮条受父级 overflow:hidden 裁切，原来的 box-shadow 光晕
+       根本显示不出来，移除以省一次绘制。 */
     .session-item.active::before {
       opacity: 1;
       transform: scaleY(1);
-      box-shadow: 0 0 8px rgba(197, 101, 61, 0.5);
     }
     /* Multi-select state — quieter glass tint, no accent halo */
     .session-item.selected {
       background:
         linear-gradient(180deg, rgba(255, 250, 244, 0.85) 0%, rgba(255, 246, 236, 0.65) 100%);
-      border: 0.5px solid rgba(255, 255, 255, 0.7);
-      box-shadow:
-        0 0 0 1px rgba(197, 101, 61, 0.18),
-        0 4px 14px -4px rgba(125, 91, 57, 0.14),
-        inset 0 1px 0 rgba(255, 255, 255, 0.85);
+      border: 1px solid rgba(197, 101, 61, 0.2);
+      box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.6);
     }
     .session-item.selected::before {
       opacity: 0.7;
@@ -9402,21 +9377,19 @@
       transform: scale(0.96);
       transition-duration: 0.06s;
     }
-    /* Footer tab active — same liquid glass language as .session-item.active */
+    /* Footer tab active — same liquid glass language as .session-item.active
+       （同步精简为 accent 边框 + 1 层柔和投影 + 顶高光） */
     .sidebar-footer-actions .btn.active {
       background:
         linear-gradient(180deg, rgba(255, 252, 247, 0.95) 0%, rgba(255, 242, 228, 0.78) 100%);
-      border: 0.5px solid rgba(255, 255, 255, 0.85);
+      border: 1px solid rgba(197, 101, 61, 0.28);
       color: var(--accent);
       transform: translateY(-1px);
       backdrop-filter: blur(16px) saturate(180%);
       -webkit-backdrop-filter: blur(16px) saturate(180%);
       box-shadow:
-        0 0 0 1px rgba(197, 101, 61, 0.28),
-        0 6px 18px -4px rgba(197, 101, 61, 0.32),
-        0 2px 4px -1px rgba(125, 91, 57, 0.08),
-        inset 0 1px 0 rgba(255, 255, 255, 0.95),
-        inset 0 -1px 0 rgba(197, 101, 61, 0.08);
+        0 3px 10px -3px rgba(197, 101, 61, 0.22),
+        inset 0 1px 0 rgba(255, 255, 255, 0.7);
     }
     .sidebar-footer-actions .btn.sidebar-logout:hover {
       background: rgba(178, 79, 69, 0.08);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@co0ontty/wand",
-  "version": "1.33.0",
+  "version": "1.35.0",
   "description": "A web terminal for local CLI tools like Claude.",
   "type": "module",
   "bin": {