@co0ontty/wand 1.39.0 → 1.40.0

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

@@ -277,10 +277,9 @@
         quickCommitSubmitting: false,
         quickCommitGenerating: false,
         quickCommitError: "",
-        // primaryAction: "commit" (commit only, no push) or "commit-push" (commit then push).
-        // Whether the commit is also tagged is controlled by `makeTag` independently —
-        // that keeps "commit + tag, push later" possible.
-        quickCommitForm: { customMessage: "", makeTag: false, tag: "", primaryAction: "commit" },
+        // commitMode: "commit-tag" (commit + version tag) | "commit" (commit only).
+        // Pushing is a separate, standalone action — never bundled into the commit button.
+        quickCommitForm: { customMessage: "", tag: "", tagEdited: false, commitMode: "commit-tag" },
         // Which inline panel/dropdown is open. Only one can be open at a time, so a
         // single field beats juggling three sibling booleans with mutual-exclusion code.
         // Values: null | "action" | "push" | "tag-head".
@@ -1531,8 +1530,14 @@
               if (_macAppVersion) {
                 checkDmgAutoUpdate();
               }
-              if (state.claudeHistoryExpanded && !state.claudeHistoryLoaded) {
-                ensureClaudeHistoryLoaded();
+              // Warm up history in the background a beat after first paint so
+              // the inline 历史会话 count is real (not "···") and recent CLI
+              // sessions merge into the list without a manual expand. Deferred
+              // to avoid competing with the initial session/output load.
+              if (!state.claudeHistoryLoaded) {
+                setTimeout(function() {
+                  if (!state.claudeHistoryLoaded) ensureClaudeHistoryLoaded();
+                }, 600);
               }
             });
           })
@@ -1785,7 +1790,9 @@
         // isAnchored = 边栏占据布局空间（推开主内容）。桌面 pin 或 任意端窄条都算 anchored。
         var isMobile = isMobileLayout();
         var isCollapsed = !!state.sidebarPinned && !!state.sidebarCollapsed;
-        var isAnchored = isCollapsed || (!!state.sidebarPinned && !isMobile);
+        // 桌面端任何「可见」的侧栏都停靠（推开内容），绝不悬浮遮挡——避免主区被压到
+        // 侧栏下面。pinned 只表示「锁定常驻」，open 则是临时可见，两者都算停靠。
+        var isAnchored = isCollapsed || (!isMobile && (!!state.sidebarPinned || !!state.sessionsDrawerOpen));
         var collapsedCls = isCollapsed ? ' sidebar-collapsed' : '';
         var sidebarCollapsedCls = isCollapsed ? ' collapsed' : '';
         return '<div class="app-container">' +
@@ -1814,7 +1821,10 @@
                       '</button>' +
                     '</div>' +
                   '</div>' +
-                  '<button id="sidebar-collapse-btn" class="btn btn-ghost btn-sm sidebar-collapse-toggle' + (isCollapsed ? ' collapsed' : '') + '" type="button" title="' + (isCollapsed ? '展开侧栏' : '收起为窄条') + '" aria-label="' + (isCollapsed ? '展开侧栏' : '收起为窄条') + '">' +
+                  '<button id="sidebar-pin-btn" class="btn btn-ghost btn-sm sidebar-pin-toggle' + (state.sidebarPinned ? ' pinned' : '') + '" type="button" title="' + (state.sidebarPinned ? '已固定常驻（点击解除锁定）' : '固定侧栏常驻') + '" aria-label="' + (state.sidebarPinned ? '解除固定常驻' : '固定侧栏常驻') + '" aria-pressed="' + (state.sidebarPinned ? 'true' : 'false') + '">' +
+                    '<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><line x1="12" y1="17" x2="12" y2="22"/><path d="M5 17h14v-1.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V6h1a2 2 0 0 0 0-4H8a2 2 0 0 0 0 4h1v4.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24z"/></svg>' +
+                  '</button>' +
+                  '<button id="sidebar-collapse-btn" class="btn btn-ghost btn-sm sidebar-collapse-toggle' + (isCollapsed ? ' collapsed' : '') + '" type="button" title="' + (isCollapsed ? '展开为全尺寸' : '收起为窄条') + '" aria-label="' + (isCollapsed ? '展开为全尺寸' : '收起为窄条') + '">' +
                     (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>') +
@@ -1827,7 +1837,6 @@
                   '<div class="sessions-list" id="sessions-list">' + renderSessionsListContent() + '</div>' +
                 '</div>' +
               '</div>' +
-              '<div id="sidebar-history-region" class="sidebar-history-region">' + renderClaudeHistoryRegion() + '</div>' +
               '<div class="sidebar-footer">' +
                 '<button id="drawer-new-session-button" class="btn btn-primary btn-block"><span>+</span> 新会话</button>' +
                 '<div class="sidebar-footer-actions">' +
@@ -1912,7 +1921,7 @@
                   '</div>' +
                   '<div class="file-search-box">' +
                     '<span class="file-search-icon">' + wandFileIcon("search", { size: 14 }) + '</span>' +
-                    '<input type="text" id="file-search-input" class="file-search-input" placeholder="搜索当前目录…" autocomplete="off" />' +
+                    '<input type="text" id="file-search-input" class="file-search-input" placeholder="搜索当前目录…" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false" />' +
                     '<button class="file-search-clear" id="file-search-clear" type="button" aria-label="清除搜索" title="清除">' +
                       wandFileIcon("x", { size: 13 }) +
                     '</button>' +
@@ -2057,13 +2066,14 @@
                     '</div>' +
                   '</div>' +
                   renderExpandedShortcutsRow() +
-                  // Session info bar at bottom — 仅保留信息类徽章（Claude session id / exit code）。
+                  // Session info bar at bottom — 仅保留信息类徽章（历史会话 id / exit code）。
                   // 自动批准已从这里移到主 pill 行（renderAutoApproveChip）。
                   (selectedSession
                     ? (function() {
                         var bits = "";
-                        if (selectedSession.provider === "claude" && selectedSession.claudeSessionId) {
-                          bits += '<span id="claude-session-id-badge" class="claude-session-id-badge" data-claude-id="' + escapeHtml(selectedSession.claudeSessionId) + '" title="点击复制 Claude 会话 ID">' + iconSvg("cloud", { size: 11, strokeWidth: 1.7, cls: "claude-session-id-icon" }) + '<span class="claude-session-id-text">' + escapeHtml(selectedSession.claudeSessionId.slice(0, 8)) + '</span></span>';
+                        if ((selectedSession.provider === "claude" || selectedSession.provider === "codex") && selectedSession.claudeSessionId) {
+                          var historyIdTitle = selectedSession.provider === "codex" ? "点击复制 Codex thread ID" : "点击复制 Claude 会话 ID";
+                          bits += '<span id="claude-session-id-badge" class="claude-session-id-badge" data-claude-id="' + escapeHtml(selectedSession.claudeSessionId) + '" title="' + historyIdTitle + '">' + iconSvg("cloud", { size: 11, strokeWidth: 1.7, cls: "claude-session-id-icon" }) + '<span class="claude-session-id-text">' + escapeHtml(selectedSession.claudeSessionId.slice(0, 8)) + '</span></span>';
                         }
                         // 非结构化会话：进程退出后展示退出码（哪怕 0，告诉用户已正常结束）。
                         // 结构化会话：只在退出码非 0（即真有失败）时展示，避免成功的多轮对话也挂个 "退出码=0" 误导。
@@ -2095,7 +2105,7 @@
                     '<div id="folder-breadcrumb" class="folder-breadcrumb"></div>' +
                     '<div class="folder-picker">' +
                       '<span class="folder-picker-icon">' + iconSvg("folder", { size: 15, strokeWidth: 1.7 }) + '</span>' +
-                      '<input type="text" id="folder-picker-input" class="folder-picker-input" value="" placeholder="输入或选择工作目录..." autocomplete="off" />' +
+                      '<input type="text" id="folder-picker-input" class="folder-picker-input" value="" placeholder="输入或选择工作目录..." autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false" />' +
                     '</div>' +
                     '<div id="folder-picker-dropdown" class="folder-picker-dropdown hidden"></div>' +
                     '<div id="folder-picker-validation" class="folder-picker-validation"></div>' +
@@ -2162,7 +2172,8 @@
 
         var infoItems = "";
         if (hasClaudeId) {
-          infoItems += '<button class="topbar-more-item" data-action="copy-claude-session-id" type="button" role="menuitem">' + cloudIconSvg + '<span>复制 Claude 会话 ID</span></button>';
+          var historyIdLabel = session.provider === "codex" ? "复制 Codex thread ID" : "复制 Claude 会话 ID";
+          infoItems += '<button class="topbar-more-item" data-action="copy-claude-session-id" type="button" role="menuitem">' + cloudIconSvg + '<span>' + historyIdLabel + '</span></button>';
         }
         if (hasCwd) {
           infoItems += '<button class="topbar-more-item" data-action="copy-cwd" type="button" role="menuitem">' + folderIconSvg + '<span>复制工作目录</span></button>';
@@ -2232,16 +2243,17 @@
       var quickCommitEscHandler = null;
       var quickCommitDocClickHandler = null;
 
-      // Restore the user's last "primary action" choice so the split button feels sticky.
-      function readSavedPrimaryAction() {
+      // Restore the user's last commit-mode choice so the split button feels sticky.
+      // Modes: "commit-tag" (commit + version tag) | "commit" (commit only).
+      function readSavedCommitMode() {
         try {
-          var v = localStorage.getItem("wand.quickCommit.primaryAction");
-          if (v === "commit" || v === "commit-push") return v;
+          var v = localStorage.getItem("wand.quickCommit.commitMode");
+          if (v === "commit" || v === "commit-tag") return v;
         } catch (e) { /* localStorage may be blocked */ }
-        return "commit";
+        return "commit-tag"; // default: commit + tag
       }
-      function savePrimaryAction(value) {
-        try { localStorage.setItem("wand.quickCommit.primaryAction", value); } catch (e) { /* no-op */ }
+      function saveCommitMode(value) {
+        try { localStorage.setItem("wand.quickCommit.commitMode", value); } catch (e) { /* no-op */ }
       }
 
       function openQuickCommitModal() {
@@ -2251,9 +2263,11 @@
         state.quickCommitError = "";
         state.quickCommitForm = {
           customMessage: "",
-          makeTag: false,
           tag: "",
-          primaryAction: readSavedPrimaryAction(),
+          // Whether the user has manually edited the tag (so we stop auto-overwriting it).
+          tagEdited: false,
+          // "commit-tag" → commit + version tag; "commit" → commit only.
+          commitMode: readSavedCommitMode(),
         };
         state.quickCommitOpenMenu = null;
         state.quickCommitTagHeadForm = { tag: "", push: false };
@@ -2303,6 +2317,12 @@
         document.addEventListener("click", quickCommitDocClickHandler, true);
         loadGitStatus(state.selectedId, { force: true }).then(function() {
           if (!state.quickCommitOpen) return;
+          // Seed the tag field with the locally-derived suggestion so a tag is
+          // always shown by default (greyed until the toggle is turned on).
+          var st = state.gitStatus || {};
+          if (!state.quickCommitForm.tagEdited && st.suggestedTag) {
+            state.quickCommitForm.tag = st.suggestedTag;
+          }
           rerenderQuickCommitModal();
         });
       }
@@ -2354,23 +2374,31 @@
         var aiBtn = document.getElementById("quick-commit-ai-btn");
         if (aiBtn) aiBtn.addEventListener("click", generateCommitMessageAI);
         var msgEl = document.getElementById("quick-commit-message");
-        if (msgEl) msgEl.addEventListener("input", function() {
-          state.quickCommitForm.customMessage = msgEl.value;
-        });
-        var tagCb = document.getElementById("quick-commit-make-tag");
-        if (tagCb) tagCb.addEventListener("change", function() {
-          state.quickCommitForm.makeTag = tagCb.checked;
-          var row = document.getElementById("quick-commit-tag-row");
-          if (row) row.classList.toggle("hidden", !tagCb.checked);
-          if (tagCb.checked) {
-            var input = document.getElementById("quick-commit-tag");
-            if (input) setTimeout(function() { input.focus(); }, 0);
-          }
-        });
+        if (msgEl) {
+          msgEl.addEventListener("input", function() {
+            state.quickCommitForm.customMessage = msgEl.value;
+          });
+          // Cmd/Ctrl+Enter submits, matching the common editor shortcut.
+          msgEl.addEventListener("keydown", function(e) {
+            if ((e.metaKey || e.ctrlKey) && e.key === "Enter") {
+              e.preventDefault();
+              submitQuickCommit();
+            }
+          });
+        }
         var tagInput = document.getElementById("quick-commit-tag");
-        if (tagInput) tagInput.addEventListener("input", function() {
-          state.quickCommitForm.tag = tagInput.value;
-        });
+        if (tagInput) {
+          tagInput.addEventListener("input", function() {
+            state.quickCommitForm.tag = tagInput.value;
+            state.quickCommitForm.tagEdited = true;
+          });
+          tagInput.addEventListener("keydown", function(e) {
+            if (e.key === "Enter") {
+              e.preventDefault();
+              submitQuickCommit();
+            }
+          });
+        }
 
         var actionCaret = document.getElementById("quick-commit-action-caret");
         if (actionCaret) actionCaret.addEventListener("click", function(e) {
@@ -2380,17 +2408,24 @@
         });
         var actionMenu = document.getElementById("quick-commit-action-menu");
         if (actionMenu) {
-          var actionItems = actionMenu.querySelectorAll("[data-qc-action]");
+          var actionItems = actionMenu.querySelectorAll("[data-qc-commit-mode]");
           for (var i = 0; i < actionItems.length; i++) {
             (function(btn) {
               btn.addEventListener("click", function() {
-                var value = btn.getAttribute("data-qc-action");
-                if (value === "commit" || value === "commit-push") {
-                  state.quickCommitForm.primaryAction = value;
-                  savePrimaryAction(value);
+                // Keep what the user typed before the re-render.
+                var liveTag = document.getElementById("quick-commit-tag");
+                if (liveTag && !liveTag.disabled) state.quickCommitForm.tag = liveTag.value;
+                var value = btn.getAttribute("data-qc-commit-mode");
+                if (value === "commit" || value === "commit-tag") {
+                  state.quickCommitForm.commitMode = value;
+                  saveCommitMode(value);
                 }
                 state.quickCommitOpenMenu = null;
                 rerenderQuickCommitModal();
+                if (value === "commit-tag") {
+                  var inp = document.getElementById("quick-commit-tag");
+                  if (inp) setTimeout(function() { inp.focus(); var v = inp.value; inp.value = ""; inp.value = v; }, 0);
+                }
               });
             })(actionItems[i]);
           }
@@ -2400,7 +2435,14 @@
         if (tagHeadToggle) tagHeadToggle.addEventListener("click", function() {
           var willOpen = state.quickCommitOpenMenu !== "tag-head";
           state.quickCommitOpenMenu = willOpen ? "tag-head" : null;
-          if (willOpen) state.quickCommitTagHeadError = "";
+          if (willOpen) {
+            state.quickCommitTagHeadError = "";
+            // Pre-fill with the locally-derived suggestion (unless already set).
+            var sug = (state.gitStatus || {}).suggestedTag;
+            if (sug && !(state.quickCommitTagHeadForm.tag || "").trim()) {
+              state.quickCommitTagHeadForm.tag = sug;
+            }
+          }
           rerenderQuickCommitModal();
           if (willOpen) {
             var inp = document.getElementById("quick-commit-tag-head-input");
@@ -2487,14 +2529,19 @@
             var data = result.data || {};
             var aiMessage = typeof data.message === "string" ? data.message : "";
             var aiTag = typeof data.suggestedTag === "string" ? data.suggestedTag.trim() : "";
-            // Only fill fields that are currently empty; never overwrite user input.
+            // "AI 生成" recommends BOTH a commit message and a version tag.
+            // Fill the message only when empty (never clobber what the user typed).
             var currentMessage = (state.quickCommitForm.customMessage || "").trim();
             if (!currentMessage && aiMessage) {
               state.quickCommitForm.customMessage = aiMessage;
             }
-            var currentTag = (state.quickCommitForm.tag || "").trim();
-            if (state.quickCommitForm.makeTag && !currentTag && aiTag) {
-              state.quickCommitForm.tag = aiTag;
+            // Adopt the AI tag (smarter than the local patch-bump default) unless the
+            // user has manually edited it, and switch to "commit + tag" so the
+            // recommendation is actually applied on commit.
+            if (aiTag) {
+              if (!state.quickCommitForm.tagEdited) state.quickCommitForm.tag = aiTag;
+              state.quickCommitForm.commitMode = "commit-tag";
+              saveCommitMode("commit-tag");
             }
           })
           .catch(function(error) {
@@ -2513,21 +2560,22 @@
         var tagEl = document.getElementById("quick-commit-tag");
         if (tagEl) state.quickCommitForm.tag = tagEl.value;
         var form = state.quickCommitForm || {};
-        var userTag = form.makeTag ? (form.tag || "").trim() : "";
+        var withTag = form.commitMode === "commit-tag";
+        var userTag = withTag ? (form.tag || "").trim() : "";
         var message = (form.customMessage || "").trim();
         if (!message) {
-          state.quickCommitError = "请填写 commit message，或点击 AI 生成。";
+          state.quickCommitError = "请填写提交信息，或点击「AI 生成」。";
           rerenderQuickCommitModal();
           return;
         }
-        var willPush = form.primaryAction === "commit-push";
-        // 开了 tag 开关但没填 → 由后端在提交时调 AI 生成
+        // Commit no longer pushes — pushing is a separate, standalone action.
+        // 选了「提交并打 Tag」但 tag 留空 → 由后端在提交时调 AI 生成。
         var payload = {
           autoMessage: false,
           customMessage: message,
           tag: userTag,
-          autoTag: !!(form.makeTag && !userTag),
-          push: willPush
+          autoTag: !!(withTag && !userTag),
+          push: false
         };
         state.quickCommitSubmitting = true;
         state.quickCommitError = "";
@@ -2550,14 +2598,8 @@
             var subPrefix = subCommits.length > 0
               ? "已先提交 " + subCommits.length + " 个 submodule（" + subCommits.map(function(c) { return c.path; }).join("、") + "），"
               : "";
-            var base = subPrefix + "已提交" + (hash ? " " + hash : "") + (tagName ? "，已打 tag " + tagName : "");
-            if (willPush && data.pushError) {
-              var msg = base + "；push 失败：" + data.pushError;
-              if (typeof showToast === "function") showToast(msg, "error");
-            } else {
-              var okMsg = base + (data.pushed ? "，已 push" : "");
-              if (typeof showToast === "function") showToast(okMsg, "success");
-            }
+            var base = subPrefix + "已提交" + (hash ? " " + hash : "") + (tagName ? "，已打 Tag " + tagName : "");
+            if (typeof showToast === "function") showToast(base + "。可在「同步」区推送到远端。", "success");
             closeQuickCommitModal();
             if (state.selectedId) loadGitStatus(state.selectedId, { force: true });
           })
@@ -2697,16 +2739,37 @@
           });
       }
 
+      // Map a porcelain status (XY two-char, e.g. " M", "A.", "??") to a single
+      // VS-Code-style letter badge: pick the first meaningful char, color by kind.
+      function qcStatusBadge(status) {
+        var raw = (status || "").trim();
+        if (raw === "??") return { letter: "U", cls: "untracked", title: "未跟踪" };
+        if (raw === "!!") return { letter: "I", cls: "ignored", title: "已忽略" };
+        var c = "";
+        for (var i = 0; i < status.length; i++) {
+          if (status[i] && status[i] !== "." && status[i] !== " ") { c = status[i]; break; }
+        }
+        c = (c || raw[0] || "?").toUpperCase();
+        var map = {
+          A: { cls: "add", title: "新增" },
+          M: { cls: "mod", title: "修改" },
+          D: { cls: "del", title: "删除" },
+          R: { cls: "ren", title: "重命名" },
+          C: { cls: "ren", title: "复制" },
+          T: { cls: "mod", title: "类型变更" },
+          U: { cls: "del", title: "冲突" }
+        };
+        var hit = map[c] || { cls: "other", title: "已更改" };
+        return { letter: c, cls: hit.cls, title: hit.title };
+      }
+
       function renderQuickCommitFileRows(files) {
         var rows = files.map(function(item) {
-          var status = (item.status || "  ").substring(0, 2);
-          var flag = status.trim() || "?";
-          var cls = "qc-flag";
-          if (flag === "A" || status[0] === "A") cls += " qc-flag-add";
-          else if (flag === "D" || status[0] === "D") cls += " qc-flag-del";
-          else if (flag === "M" || status[0] === "M") cls += " qc-flag-mod";
-          else if (flag === "??" || status === "??") cls += " qc-flag-untracked";
-          else if (flag === "R") cls += " qc-flag-ren";
+          var badge = qcStatusBadge(item.status || "");
+          var fullPath = item.path || "";
+          var slash = fullPath.lastIndexOf("/");
+          var dir = slash >= 0 ? fullPath.slice(0, slash + 1) : "";
+          var base = slash >= 0 ? fullPath.slice(slash + 1) : fullPath;
           var subBadge = "";
           if (item.isSubmodule) {
             var st = item.submoduleState || {};
@@ -2717,7 +2780,13 @@
             var label = parts.length ? "submodule · " + parts.join(" / ") : "submodule";
             subBadge = '<span class="qc-submodule-badge">' + escapeHtml(label) + '</span>';
           }
-          return '<div class="qc-file-row"><span class="' + cls + '">' + escapeHtml(status) + '</span><span class="qc-file-path">' + escapeHtml(item.path || "") + '</span>' + subBadge + '</div>';
+          return '<div class="qc-file-row" title="' + escapeHtml(fullPath) + '">' +
+            '<span class="qc-file-badge qc-badge-' + badge.cls + '" title="' + escapeHtml(badge.title) + '">' + escapeHtml(badge.letter) + '</span>' +
+            '<span class="qc-file-path">' +
+              (dir ? '<span class="qc-file-dir">' + escapeHtml(dir) + '</span>' : '') +
+              '<span class="qc-file-name">' + escapeHtml(base) + '</span>' +
+            '</span>' + subBadge +
+          '</div>';
         }).join("");
         return rows || '<div class="qc-empty">没有可提交的改动。</div>';
       }
@@ -2726,23 +2795,25 @@
         return state.quickCommitSubmitting || state.quickCommitTagHeadSubmitting || state.quickCommitPushing;
       }
 
-      function renderQuickCommitPrimary(hasChanges) {
+      function renderQuickCommitCommitButton(hasChanges) {
         var f = state.quickCommitForm;
+        var withTag = f.commitMode === "commit-tag";
         var label;
         if (state.quickCommitSubmitting) label = "提交中…";
-        else if (f.primaryAction === "commit-push") label = "提交并 push";
-        else label = "仅提交";
+        else label = withTag ? "提交并打 Tag" : "提交";
         var disabled = !hasChanges || isQuickCommitOpInFlight();
         var menuOpen = state.quickCommitOpenMenu === "action";
         var caretActive = menuOpen ? " is-active" : "";
         var menuItems = [
-          { value: "commit", label: "仅提交", desc: "只 commit，不 push" },
-          { value: "commit-push", label: "提交并 push", desc: "commit 后立即 push 到远端" }
+          { value: "commit-tag", label: "提交并打 Tag", desc: "创建 commit，并为它打一个版本 Tag" },
+          { value: "commit", label: "仅提交", desc: "只创建 commit，不打 Tag" }
         ];
         var menuHtml = menuItems.map(function(item) {
-          var sel = f.primaryAction === item.value ? " is-selected" : "";
-          return '<button type="button" class="qc-dropdown-item' + sel + '" data-qc-action="' + item.value + '">' +
-            '<span class="qc-dropdown-item-title">' + escapeHtml(item.label) + '</span>' +
+          var sel = f.commitMode === item.value ? " is-selected" : "";
+          return '<button type="button" class="qc-dropdown-item' + sel + '" data-qc-commit-mode="' + item.value + '" role="menuitemradio" aria-checked="' + (f.commitMode === item.value ? 'true' : 'false') + '">' +
+            '<span class="qc-dropdown-item-main"><span class="qc-dropdown-check" aria-hidden="true">' +
+              (f.commitMode === item.value ? '<svg viewBox="0 0 16 16" width="13" height="13"><path d="M13 4.5l-6 6L3 7" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>' : '') +
+            '</span><span class="qc-dropdown-item-title">' + escapeHtml(item.label) + '</span></span>' +
             '<span class="qc-dropdown-item-desc">' + escapeHtml(item.desc) + '</span>' +
             '</button>';
         }).join("");
@@ -2750,7 +2821,7 @@
           '<button id="quick-commit-submit-btn" class="btn btn-primary qc-split-main" type="button"' + (disabled ? ' disabled' : '') + '>' +
             escapeHtml(label) +
           '</button>' +
-          '<button id="quick-commit-action-caret" class="btn btn-primary qc-split-caret' + caretActive + '" type="button" data-qc-dropdown-toggle="action"' + (disabled ? ' disabled' : '') + ' aria-haspopup="menu" aria-expanded="' + (menuOpen ? 'true' : 'false') + '" aria-label="更多提交方式">' +
+          '<button id="quick-commit-action-caret" class="btn btn-primary qc-split-caret' + caretActive + '" type="button" data-qc-dropdown-toggle="action"' + (disabled ? ' disabled' : '') + ' aria-haspopup="menu" aria-expanded="' + (menuOpen ? 'true' : 'false') + '" aria-label="切换提交方式">' +
             '<svg viewBox="0 0 12 12" width="10" height="10" aria-hidden="true"><path d="M2 4l4 4 4-4" stroke="currentColor" stroke-width="1.6" fill="none" stroke-linecap="round" stroke-linejoin="round"/></svg>' +
           '</button>' +
           (menuOpen ?
@@ -2781,18 +2852,19 @@
         var submitting = state.quickCommitTagHeadSubmitting;
         var generating = state.quickCommitTagHeadGenerating;
         return '<div class="qc-tag-head-panel">' +
+          '<div class="qc-tag-head-hint">为当前最新提交（HEAD）打 Tag，不创建新提交。</div>' +
           '<div class="qc-tag-head-row">' +
-            '<input type="text" id="quick-commit-tag-head-input" class="field-input" placeholder="输入 tag 名（例如 v1.2.0），或点 AI 建议" value="' + escapeHtml(thf.tag || "") + '"' + (submitting ? ' disabled' : '') + '>' +
+            '<input type="text" id="quick-commit-tag-head-input" class="field-input" placeholder="版本号，如 v1.2.0" value="' + escapeHtml(thf.tag || "") + '"' + (submitting ? ' disabled' : '') + '>' +
             '<button type="button" id="quick-commit-tag-head-ai" class="btn btn-ghost btn-sm"' + (generating || submitting ? ' disabled' : '') + '>' + (generating ? '建议中…' : 'AI 建议') + '</button>' +
           '</div>' +
           '<label class="qc-tag-head-push">' +
             '<input type="checkbox" id="quick-commit-tag-head-push"' + (thf.push ? ' checked' : '') + (submitting ? ' disabled' : '') + '>' +
-            '<span>打完 tag 立即推送这个 tag</span>' +
+            '<span>打完后立即推送这个 Tag 到远端</span>' +
           '</label>' +
           (state.quickCommitTagHeadError ? '<p class="error-message">' + escapeHtml(state.quickCommitTagHeadError) + '</p>' : '') +
           '<div class="qc-tag-head-actions">' +
             '<button type="button" id="quick-commit-tag-head-cancel" class="btn btn-ghost btn-sm"' + (submitting ? ' disabled' : '') + '>收起</button>' +
-            '<button type="button" id="quick-commit-tag-head-submit" class="btn btn-secondary btn-sm"' + (submitting ? ' disabled' : '') + '>' + (submitting ? '打 tag 中…' : '为 HEAD 打 tag') + '</button>' +
+            '<button type="button" id="quick-commit-tag-head-submit" class="btn btn-secondary btn-sm"' + (submitting ? ' disabled' : '') + '>' + (submitting ? '打 Tag 中…' : '打 Tag') + '</button>' +
           '</div>' +
         '</div>';
       }
@@ -2835,56 +2907,53 @@
 
       function renderQuickCommitModal() {
         var s = state.gitStatus || {};
-        var f = state.quickCommitForm || { customMessage: "", makeTag: false, tag: "", primaryAction: "commit" };
+        var f = state.quickCommitForm || { customMessage: "", tag: "", tagEdited: false, commitMode: "commit-tag" };
         var hasChanges = (s.modifiedCount || 0) > 0;
         var files = Array.isArray(s.files) ? s.files : [];
         var fileRows = renderQuickCommitFileRows(files);
 
-        // Subtitle: branch · N 改动 · ↑X ↓Y
+        // Subtitle: branch · N 改动 · ↑X ↓Y  (clean repos show a small ✓ badge instead of "0 个改动")
         var subParts = [];
         subParts.push(s.branch || "(no branch)");
-        subParts.push((s.modifiedCount || 0) + " 个改动");
+        if (hasChanges) subParts.push((s.modifiedCount || 0) + " 个改动");
         if (typeof s.ahead === "number" && s.ahead > 0) subParts.push("↑" + s.ahead);
         if (typeof s.behind === "number" && s.behind > 0) subParts.push("↓" + s.behind);
 
         // Section 1: changes + commit form (only when there are changes)
         var section1 = "";
         if (hasChanges) {
+          var genBusy = state.quickCommitGenerating;
+          var withTag = f.commitMode === "commit-tag";
           section1 = '<section class="qc-section qc-section--changes">' +
-            '<div class="qc-section-head"><span class="qc-section-title">暂存改动</span><span class="qc-section-meta">' + escapeHtml(s.modifiedCount + " 个文件") + '</span></div>' +
+            '<div class="qc-section-head"><span class="qc-section-title">更改</span><span class="qc-section-meta">' + escapeHtml(s.modifiedCount + " 个文件") + '</span></div>' +
             '<div class="qc-files-wrap">' + fileRows + '</div>' +
             '<div class="qc-message-row" id="quick-commit-message-row">' +
-              '<div class="qc-message-header"><label class="field-label" for="quick-commit-message">commit message</label>' +
-                '<div class="qc-ai-controls">' +
-                  '<button type="button" id="quick-commit-ai-btn" class="btn btn-ghost btn-sm"' + (state.quickCommitGenerating ? ' disabled' : '') + '>' + (state.quickCommitGenerating ? '生成中…' : 'AI 生成') + '</button>' +
-                  '<label class="qc-ai-tag-toggle" title="开启后，AI 会一并建议 tag，提交时会为本次 commit 打 tag">' +
-                    '<span class="qc-ai-tag-label">含 tag</span>' +
-                    '<span class="qc-switch qc-switch--compact">' +
-                      '<input type="checkbox" id="quick-commit-make-tag" class="switch-toggle" aria-label="同时为本次 commit 打 tag"' + (f.makeTag ? ' checked' : '') + ((state.quickCommitSubmitting || state.quickCommitGenerating) ? ' disabled' : '') + '>' +
-                      '<span class="switch-slider"></span>' +
-                    '</span>' +
-                  '</label>' +
-                '</div>' +
+              '<div class="qc-message-header">' +
+                '<label class="field-label qc-message-label" for="quick-commit-message">提交信息</label>' +
+                '<button type="button" id="quick-commit-ai-btn" class="btn btn-ghost btn-sm qc-ai-btn"' + (genBusy ? ' disabled' : '') + ' title="读取改动，用 AI 生成提交信息与版本 Tag">' +
+                  '<svg viewBox="0 0 16 16" width="13" height="13" aria-hidden="true"><path d="M8 1.5l1.4 3.6L13 6.5 9.4 7.9 8 11.5 6.6 7.9 3 6.5l3.6-1.4L8 1.5zM12.5 10.5l.7 1.8 1.8.7-1.8.7-.7 1.8-.7-1.8-1.8-.7 1.8-.7.7-1.8z" fill="currentColor"/></svg>' +
+                  '<span>' + (genBusy ? '生成中…' : 'AI 生成') + '</span>' +
+                '</button>' +
               '</div>' +
-              '<textarea id="quick-commit-message" class="field-input" rows="2" placeholder="输入 commit message 或点击 AI 生成"' + (state.quickCommitSubmitting ? ' disabled' : '') + '>' + escapeHtml(f.customMessage || "") + '</textarea>' +
+              '<textarea id="quick-commit-message" class="field-input qc-message-input" rows="3" placeholder="描述这次改动；或点「AI 生成」自动填写" ' + (state.quickCommitSubmitting ? 'disabled' : '') + '>' + escapeHtml(f.customMessage || "") + '</textarea>' +
             '</div>' +
-            '<div class="qc-tag-row' + (f.makeTag ? '' : ' hidden') + '" id="quick-commit-tag-row">' +
-              '<input type="text" id="quick-commit-tag" class="field-input" placeholder="输入 tag 名称；留空则提交时由 AI 自动生成" value="' + escapeHtml(f.tag || "") + '"' + (state.quickCommitSubmitting ? ' disabled' : '') + '>' +
+            '<div class="qc-tag-field' + (withTag ? '' : ' is-off') + '">' +
+              '<span class="qc-tag-field-label" title="' + (withTag ? '这次提交会打上这个版本 Tag' : '当前为「仅提交」，不会打 Tag') + '">Tag</span>' +
+              '<input type="text" id="quick-commit-tag" class="field-input qc-tag-field-input" placeholder="版本号，如 v1.2.0" value="' + escapeHtml(f.tag || "") + '"' + ((!withTag || state.quickCommitSubmitting) ? ' disabled' : '') + '>' +
+              (withTag ? '' : '<span class="qc-tag-field-note">仅提交</span>') +
             '</div>' +
             (state.quickCommitError ? '<p class="error-message">' + escapeHtml(state.quickCommitError) + '</p>' : '') +
             '<div class="qc-section-actions">' +
               '<button id="quick-commit-cancel-btn" class="btn btn-ghost btn-sm" type="button">取消</button>' +
-              renderQuickCommitPrimary(hasChanges) +
-            '</div>' +
-          '</section>';
-        } else {
-          section1 = '<section class="qc-section qc-section--empty">' +
-            '<div class="qc-empty-state">' +
-              '<span class="qc-empty-icon">✓</span>' +
-              '<div><div class="qc-empty-title">工作区干净</div><div class="qc-empty-sub">没有暂存改动可提交。仍可在下方为 HEAD 打 tag 或推送。</div></div>' +
+              '<div class="qc-action-group">' +
+                renderQuickCommitCommitButton(hasChanges) +
+                renderQuickCommitPushButton(s) +
+              '</div>' +
             '</div>' +
           '</section>';
         }
+        // When clean, we skip the big "changes" card entirely — a small green
+        // indicator in the header subtitle is enough of a signal (see below).
 
         // Section 2: repo status + secondary actions (always show when there's at least one commit)
         var section2 = "";
@@ -2892,32 +2961,38 @@
           var lc = s.lastCommit || {};
           var headLine = lc.shortHash ? lc.shortHash + " · " + (lc.subject || "") : (s.head ? s.head.substring(0, 7) : "(no commit)");
           var upstreamLine = s.upstream ? escapeHtml(s.branch || "") + " → " + escapeHtml(s.upstream) : escapeHtml(s.branch || "(no branch)") + " · 无 upstream";
+          var tagHeadOpen = state.quickCommitOpenMenu === "tag-head";
           section2 = '<section class="qc-section qc-section--repo">' +
-            '<div class="qc-section-head"><span class="qc-section-title">仓库状态</span><span class="qc-section-meta">' + upstreamLine + '</span></div>' +
+            '<div class="qc-section-head"><span class="qc-section-title">仓库 · 同步</span><span class="qc-section-meta">' + upstreamLine + '</span></div>' +
             '<div class="qc-head-card">' +
               '<span class="qc-head-label">HEAD</span>' +
               '<code class="qc-head-text">' + escapeHtml(headLine) + '</code>' +
             '</div>' +
             renderQuickCommitStatusChips(s) +
-            (state.quickCommitOpenMenu === "tag-head" ? renderQuickCommitTagHeadPanel() : '') +
+            (tagHeadOpen ? renderQuickCommitTagHeadPanel() : '') +
             '<div class="qc-section-actions qc-section-actions--secondary">' +
-              '<button id="quick-commit-tag-head-toggle" class="btn btn-ghost btn-sm" type="button"' + (state.quickCommitPushing ? ' disabled' : '') + '>' +
-                '<svg viewBox="0 0 16 16" width="14" height="14" aria-hidden="true" style="vertical-align:-2px;margin-right:4px;"><path d="M2 2h6.5l5 5-5.5 5.5L2 7.5V2z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linejoin="round"/><circle cx="5" cy="5" r="1" fill="currentColor"/></svg>' +
-                (state.quickCommitOpenMenu === "tag-head" ? '收起' : '为 HEAD 打 tag') +
+              '<button id="quick-commit-tag-head-toggle" class="btn btn-secondary btn-sm qc-tag-head-btn' + (tagHeadOpen ? ' is-open' : '') + '" type="button"' + (state.quickCommitPushing ? ' disabled' : '') + ' title="给当前最新提交（HEAD）打 Tag，不会创建新提交">' +
+                '<svg viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"><path d="M2 2h6.5l5 5-5.5 5.5L2 7.5V2z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linejoin="round"/><circle cx="5" cy="5" r="1" fill="currentColor"/></svg>' +
+                '<span>' + (tagHeadOpen ? '收起' : '为当前提交打 Tag') + '</span>' +
               '</button>' +
-              renderQuickCommitPushButton(s) +
+              // Push lives in the commit footer when there are changes; show it here otherwise.
+              (hasChanges ? '' : renderQuickCommitPushButton(s)) +
             '</div>' +
           '</section>';
         }
 
         var subtitleHtml = subParts.map(escapeHtml).join(" · ");
+        // Small "clean" badge shown inline in the header subtitle (replaces the old empty-state card).
+        var cleanBadge = (!hasChanges && s.isGit !== false)
+          ? '<span class="qc-clean-badge" title="工作区干净，没有待提交的改动"><svg viewBox="0 0 16 16" width="11" height="11" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M13 4.5l-6 6L3 7"/></svg>干净</span>'
+          : '';
 
         return '<section id="quick-commit-modal" class="modal-backdrop' + (state.quickCommitOpen ? '' : ' hidden') + '">' +
           '<div class="modal quick-commit-modal" role="dialog" aria-labelledby="quick-commit-title">' +
             '<div class="modal-header">' +
               '<div>' +
                 '<h2 id="quick-commit-title" class="modal-title">快捷提交</h2>' +
-                '<p class="modal-subtitle">' + subtitleHtml + '</p>' +
+                '<p class="modal-subtitle">' + subtitleHtml + cleanBadge + '</p>' +
               '</div>' +
               '<button id="quick-commit-close-btn" class="btn btn-ghost btn-icon modal-close-btn" type="button" aria-label="关闭"><svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" aria-hidden="true"><line x1="6" y1="6" x2="18" y2="18"/><line x1="18" y1="6" x2="6" y2="18"/></svg></button>' +
             '</div>' +
@@ -3509,14 +3584,16 @@
       }
 
       function renderSessions() {
-        // Claude history is no longer inlined here — it lives in its own
-        // collapsible region between .sidebar-body and .sidebar-footer, so
-        // the scrolling sessions list focuses on recent / archived sessions.
+        // Claude/Codex history is rendered INLINE as the final collapsible
+        // group of this same scrolling list (see renderClaudeHistoryGroup),
+        // styled like 已归档. There is no separate docked region anymore —
+        // that previously stranded an empty void above the footer.
         var archivedSessions = state.sessions.filter(function(session) { return session.archived; });
         var groups = [];
         groups.push(renderSessionManageBar());
 
         var recentEntries = getRecentEntries();
+        var historyGroup = renderClaudeHistoryGroup();
 
         if (recentEntries.length > 0) {
           groups.push(renderRecentGroup(recentEntries));
@@ -3524,9 +3601,12 @@
         if (archivedSessions.length > 0) {
           groups.push(renderArchivedGroup(archivedSessions));
         }
-        if (recentEntries.length === 0 && archivedSessions.length === 0) {
+        if (recentEntries.length === 0 && archivedSessions.length === 0 && !historyGroup) {
           return renderSessionManageBar() + '<div class="empty-state"><strong>还没有会话记录</strong><br>点击上方「新对话」开始你的第一次对话。</div>';
         }
+        if (historyGroup) {
+          groups.push(historyGroup);
+        }
         return groups.join("");
       }
 
@@ -3538,9 +3618,6 @@
 
       function renderCollapsedSessionTiles() {
         var entries = getRecentEntries();
-        if (entries.length === 0) {
-          return '<div class="sidebar-collapsed-empty" title="无会话">—</div>';
-        }
         var tiles = entries.map(function(e, i) {
           var idx = i + 1;
           if (e.kind === "session") {
@@ -3554,7 +3631,11 @@
           var hTitle = preview + " · " + formatHistoryTime(h.timestamp);
           return '<button class="sidebar-collapsed-tile history" type="button" data-collapsed-history-id="' + escapeHtml(h.claudeSessionId) + '" data-cwd="' + escapeHtml(h.cwd || "") + '" title="' + escapeHtml(hTitle) + '">' + idx + '</button>';
         }).join("");
-        return '<div class="sidebar-collapsed-tiles">' + tiles + '</div>';
+        // 窄条底部固定一个「+」快速新建会话方块，替代被隐藏的 footer 新会话入口。
+        var addTile = '<button class="sidebar-collapsed-tile add" type="button" data-collapsed-new-session="1" title="新建会话" aria-label="新建会话">' +
+          '<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/></svg>' +
+          '</button>';
+        return '<div class="sidebar-collapsed-tiles">' + tiles + addTile + '</div>';
       }
 
       function renderSessionsListContent() {
@@ -3582,19 +3663,21 @@
         var selectAllAction = allSelected ? "clear-selection" : "select-all-visible";
         var selectAllDisabled = selectable === 0 ? ' disabled' : '';
 
-        // Linear-style toolbar:
-        //   [N selected]  ─────────  [全选] [清空]  [delete (danger)] [完成 (primary)]
+        // Flat in-place toolbar (NOT a popped card): the same sub-header row
+        // morphs to [✕]  N 已选 ........ 全选/取消全选  删除. Sticky to the top
+        // of the scroll so the count + delete stay reachable while selecting.
+        var exitBtn = '<button class="session-manage-exit" data-action="toggle-manage-mode" type="button" aria-label="退出管理模式" title="退出管理模式">' +
+          '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" aria-hidden="true"><line x1="6" y1="6" x2="18" y2="18"/><line x1="18" y1="6" x2="6" y2="18"/></svg>' +
+        '</button>';
+        var summary = hasAny
+          ? '<span class="session-manage-count">' + totalCount + '</span><span class="session-manage-summary-label">已选择</span>'
+          : '<span class="session-manage-summary-label muted">选择要管理的项目</span>';
         return '<div class="session-manage-bar active">' +
-          '<div class="session-manage-summary">' +
-            '<span class="session-manage-count">' + totalCount + '</span>' +
-            '<span class="session-manage-summary-label">已选择</span>' +
-          '</div>' +
+          exitBtn +
+          '<div class="session-manage-summary">' + summary + '</div>' +
           '<div class="session-manage-actions">' +
             '<button class="btn btn-ghost btn-xs" data-action="' + selectAllAction + '" type="button"' + selectAllDisabled + '>' + selectAllLabel + '</button>' +
-            '<button class="btn btn-ghost btn-xs" data-action="clear-selection" type="button"' + (hasAny ? '' : ' disabled') + '>清空</button>' +
-            '<span class="session-manage-divider"></span>' +
-            '<button class="btn btn-danger btn-xs" data-action="delete-selected" type="button"' + (hasAny ? '' : ' disabled') + '>删除</button>' +
-            '<button class="btn btn-primary btn-xs" data-action="toggle-manage-mode" type="button">完成</button>' +
+            '<button class="btn btn-danger btn-xs" data-action="delete-selected" type="button"' + (hasAny ? '' : ' disabled') + '>删除' + (hasAny ? ' ' + totalCount : '') + '</button>' +
           '</div>' +
         '</div>';
       }
@@ -3621,8 +3704,9 @@
       }
 
       function renderRecentGroup(entries) {
-        var html = '<section class="session-group">' +
-          '<div class="session-group-title">最近</div>';
+        // No "最近" group title here — the section intro ("最近的会话记录") above
+        // already labels this group, so a second label would be redundant.
+        var html = '<section class="session-group session-group--recent">';
         html += entries.map(function(e) {
           return e.kind === "session"
             ? renderSessionItem(e.ref, "sessions")
@@ -3641,46 +3725,30 @@
         });
       }
 
-      // Render the docked Claude-history region that lives between
-      // `.sidebar-body` and `.sidebar-footer`. Collapsed by default — only
-      // shows a slim header ("历史消息" + count bubble). Expanded reveals the
-      // grouped-by-cwd list inside a scroll cap.
-      function renderClaudeHistoryRegion() {
+      // Render history as the final INLINE collapsible group of #sessions-list,
+      // styled like the 已归档 group. Returns '' when history is fully loaded
+      // and empty, so a workspace with no older CLI history shows no stray
+      // "历史会话 0" row (and no stranded bar above the footer).
+      function renderClaudeHistoryGroup() {
         var visibleHistory = getClaudeHistoryRegionItems();
-        var expanded = !!state.claudeHistoryExpanded;
         var loaded = !!state.claudeHistoryLoaded;
         var codexVisible = getVisibleCodexHistorySessions();
         var codexLoaded = !!state.codexHistoryLoaded;
+        var fullyLoaded = loaded && codexLoaded;
         var count = (loaded ? visibleHistory.length : 0) + (codexLoaded ? codexVisible.length : 0);
+        if (fullyLoaded && count === 0) return '';
 
-        var badgeCls = "history-bubble";
-        var badgeContent;
-        if (!loaded) {
-          badgeCls += " loading";
-          badgeContent = "···";
-        } else if (count === 0) {
-          badgeCls += " empty";
-          badgeContent = "0";
-        } else {
-          badgeContent = count > 999 ? "999+" : String(count);
-        }
-        var badge = '<span class="' + badgeCls + '">' + badgeContent + '</span>';
-
-        // Chevron rotates: collapsed → up (▲, suggests "expand upward"),
-        // expanded → down (▼, suggests "collapse downward").
-        var chevronSvg = '<svg class="sidebar-history-chevron" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><polyline points="6 15 12 9 18 15"/></svg>';
-
-        var headerCls = "sidebar-history-header" + (expanded ? " expanded" : "");
-        var header = '<button type="button" class="' + headerCls + '" id="claude-history-toggle" aria-expanded="' + expanded + '" aria-controls="sidebar-history-body" title="' + (expanded ? "收起历史消息" : "展开历史消息") + '">' +
-          '<span class="sidebar-history-label">历史消息</span>' +
-          '<span class="sidebar-history-right">' + badge + chevronSvg + '</span>' +
-        '</button>';
-
+        var expanded = !!state.claudeHistoryExpanded;
+        var chevron = expanded ? "&#9662;" : "&#9656;";
+        var countContent = fullyLoaded ? (count > 999 ? "999+" : String(count)) : "···";
+        var header = '<div class="session-group-title claude-history-toggle session-history-toggle" id="claude-history-toggle" role="button" tabindex="0" aria-expanded="' + expanded + '" title="' + (expanded ? "收起历史会话" : "展开历史会话") + '">' +
+          '<span class="chevron">' + chevron + '</span> 历史会话 ' +
+          '<span class="history-count' + (fullyLoaded ? '' : ' loading') + '">' + countContent + '</span>' +
+        '</div>';
         var body = expanded
-          ? '<div class="sidebar-history-body" id="sidebar-history-body">' + renderClaudeHistoryBodyContent(visibleHistory) + renderCodexHistoryBodyContent(codexVisible) + '</div>'
+          ? '<div class="session-history-body">' + renderClaudeHistoryBodyContent(visibleHistory) + renderCodexHistoryBodyContent(codexVisible) + '</div>'
           : '';
-
-        return header + body;
+        return '<section class="session-group session-group--history">' + header + body + '</section>';
       }
 
       function renderClaudeHistoryBodyContent(visibleHistory) {
@@ -3688,7 +3756,9 @@
           return '<div class="claude-history-loading">扫描历史会话中…</div>';
         }
         if (visibleHistory.length === 0) {
-          return '<div class="claude-history-loading">没有更早的 Claude 历史会话</div>';
+          // Group is only rendered when there is content somewhere (Claude or
+          // Codex); a Claude-empty/Codex-present case shows just the Codex list.
+          return '';
         }
         var groups = {};
         var groupOrder = [];
@@ -3714,14 +3784,6 @@
         return toolbar + '<div class="sidebar-history-scroll">' + listHtml + '</div>';
       }
 
-      // Re-render only the docked history region in place. Called by
-      // updateSessionsList() so existing callers (load complete, delete, etc.)
-      // keep working without changes.
-      function updateClaudeHistoryRegion() {
-        var region = document.getElementById("sidebar-history-region");
-        if (region) region.innerHTML = renderClaudeHistoryRegion();
-      }
-
       function getVisibleClaudeHistorySessions() {
         var managedIds = new Set();
         state.sessions.forEach(function(s) {
@@ -5535,9 +5597,10 @@
         var resumeButton = "";
         var checkbox = renderManageCheckbox("sessions", session.id, "选择会话 " + session.command);
 
-        if (session.provider === "claude" && session.claudeSessionId) {
+        if ((session.provider === "claude" || session.provider === "codex") && session.claudeSessionId) {
           if (session.status !== "running" && !state.sessionsManageMode && !isStructuredSession(session)) {
-            resumeButton = '<button class="session-action-btn" data-action="resume" data-session-id="' + session.id + '" type="button" aria-label="恢复会话" title="恢复 Claude 会话"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M1 4v6h6"/><path d="M3.51 15a9 9 0 105.64-11.36L3 10"/></svg></button>';
+            var resumeTitle = session.provider === "codex" ? "恢复 Codex 会话" : "恢复 Claude 会话";
+            resumeButton = '<button class="session-action-btn" data-action="resume" data-session-id="' + session.id + '" type="button" aria-label="' + resumeTitle + '" title="' + resumeTitle + '"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M1 4v6h6"/><path d="M3.51 15a9 9 0 105.64-11.36L3 10"/></svg></button>';
           }
         }
 
@@ -5556,7 +5619,7 @@
         // Title: summary or command
         var titleHtml = session.summary
           ? '<div class="session-title">' + escapeHtml(session.summary) + '</div>'
-          : '<div class="session-command">' + escapeHtml(session.resumedFromSessionId ? session.command.replace(/\s+--resume\s+\S+/, '') : session.command) + '</div>';
+          : '<div class="session-command">' + escapeHtml(session.resumedFromSessionId ? session.command.replace(/\s+--resume\s+\S+/, '').replace(/\s+resume\s+[0-9a-f-]+/, '') : session.command) + '</div>';
 
         // Activity description for running sessions
         var activityDesc = getSessionActivityDesc(session);
@@ -6120,15 +6183,9 @@
           sessionsList.addEventListener("mouseout", handleCollapsedTileLeave);
           initSwipeToDelete(sessionsList);
         }
-        // The docked history region lives outside #sessions-list now, but it
-        // still wants the same delegated handlers (toggle button, directory
-        // expand/collapse, history-item clicks, clear-all, etc.). Reuse the
-        // same callbacks so behavior stays identical.
-        var historyRegion = document.getElementById("sidebar-history-region");
-        if (historyRegion) {
-          historyRegion.addEventListener("click", handleSessionItemClick);
-          historyRegion.addEventListener("keydown", handleSessionItemKeydown);
-        }
+        // History now renders inline as the final group inside #sessions-list,
+        // so the delegated handlers above already cover its toggle / directory
+        // expand-collapse / item clicks / clear-all — no separate region wiring.
         window.addEventListener("scroll", hideCollapsedTileBubble, true);
         window.addEventListener("resize", hideCollapsedTileBubble);
 
@@ -6191,6 +6248,8 @@
         if (closeDrawerBtn) closeDrawerBtn.addEventListener("click", closeSessionsDrawer);
         var collapseBtn = document.getElementById("sidebar-collapse-btn");
         if (collapseBtn) collapseBtn.addEventListener("click", toggleSidebarCollapsed);
+        var pinBtn = document.getElementById("sidebar-pin-btn");
+        if (pinBtn) pinBtn.addEventListener("click", toggleSidebarPin);
         var sidebarMoreBtn = document.getElementById("sidebar-more-btn");
         var sidebarOverflow = document.getElementById("sidebar-overflow-menu");
         if (sidebarMoreBtn && sidebarOverflow) {
@@ -6672,7 +6731,7 @@
             topbarMoreBtn.setAttribute("aria-expanded", "false");
             switch (action) {
               case "copy-claude-session-id":
-                copySelectedSessionField("claudeSessionId", "Claude 会话 ID 已复制");
+                copySelectedSessionField("claudeSessionId", getSelectedSession() && getSelectedSession().provider === "codex" ? "Codex thread ID 已复制" : "Claude 会话 ID 已复制");
                 break;
               case "copy-cwd":
                 copySelectedSessionField("cwd", "工作目录已复制");
@@ -7248,6 +7307,12 @@
 
         var collapsedTile = target.closest(".sidebar-collapsed-tile");
         if (collapsedTile && collapsedTile instanceof HTMLElement) {
+          if (collapsedTile.dataset.collapsedNewSession) {
+            event.preventDefault();
+            event.stopPropagation();
+            openSessionModal();
+            return;
+          }
           if (collapsedTile.dataset.collapsedSessionId) {
             event.preventDefault();
             event.stopPropagation();
@@ -8576,7 +8641,7 @@
         state.sessions = [];
         state.claudeHistory = [];
         state.claudeHistoryLoaded = false;
-        state.claudeHistoryExpanded = true;
+        state.claudeHistoryExpanded = false;
         state.claudeHistoryExpandedDirs = {};
         state.sessionsDrawerOpen = false;
         render();
@@ -9513,10 +9578,8 @@
         var countEl = document.getElementById("session-count");
         if (listEl) listEl.innerHTML = renderSessionsListContent();
         if (countEl) countEl.textContent = String(state.sessions.length);
-        // The docked history region lives outside #sessions-list — refresh it
-        // too so callers that mutate state.claudeHistory (load complete,
-        // delete, clear) don't need to know about it.
-        updateClaudeHistoryRegion();
+        // History renders inline inside #sessions-list now, so the line above
+        // already refreshed it — no separate docked region to update.
         if (typeof hideCollapsedTileBubble === "function") hideCollapsedTileBubble();
         updateShellChrome();
         // Re-render cross-session queue (container may have been destroyed by DOM rebuild)
@@ -9730,7 +9793,7 @@
         // 与 renderAppShell 保持一致：手机端只允许窄条形态 anchored。
         var isMobile = isMobileLayout();
         var isCollapsed = !!state.sidebarPinned && !!state.sidebarCollapsed;
-        var isAnchored = isCollapsed || (!!state.sidebarPinned && !isMobile);
+        var isAnchored = isCollapsed || (!isMobile && (!!state.sidebarPinned || !!state.sessionsDrawerOpen));
         if (drawer) {
           drawer.classList.toggle("pinned", isAnchored);
           drawer.classList.toggle("collapsed", isCollapsed);
@@ -9739,6 +9802,13 @@
           mainLayout.classList.toggle("sidebar-pinned", isAnchored);
           mainLayout.classList.toggle("sidebar-collapsed", isCollapsed);
         }
+        var pinBtn = document.getElementById("sidebar-pin-btn");
+        if (pinBtn) {
+          pinBtn.classList.toggle("pinned", !!state.sidebarPinned);
+          pinBtn.title = state.sidebarPinned ? "已固定常驻（点击解除锁定）" : "固定侧栏常驻";
+          pinBtn.setAttribute("aria-label", state.sidebarPinned ? "解除固定常驻" : "固定侧栏常驻");
+          pinBtn.setAttribute("aria-pressed", state.sidebarPinned ? "true" : "false");
+        }
       }
 
       function updateDrawerState() {
@@ -9943,6 +10013,26 @@
         scheduleTerminalRefitAfterPaddingTransition();
       }
 
+      // 常驻（图钉）开关：把侧栏「留在原地」并排停靠 ⟷ 悬浮抽屉。
+      //   - 常驻 ON：停靠并推开内容；配合「收起为窄条」可在全尺寸/窄条间切换。
+      //   - 常驻 OFF：变为悬浮抽屉，交互时自动收起（非常驻）。
+      // 手机端不支持常驻（屏幕太窄），保持抽屉行为。
+      // 「图钉」只切换「是否锁定常驻」，绝不收起 / 隐藏侧栏——这是用户两次反馈的核心：
+      // 点图钉不该让侧栏消失，也不该把主区压到侧栏下面。
+      //   - 锁定（pinned）：常驻停靠，不会被「关闭(X)」一键收走的语义区分开。
+      //   - 解除锁定（unpinned）：仍然停靠可见（因为 isAnchored 把 open 也算停靠），
+      //     只是变成「可被 X 关闭」的临时态。
+      // 全尺寸 / 窄条由「收起为窄条」按钮控制，与图钉正交。
+      function toggleSidebarPin() {
+        if (isMobileLayout()) return;
+        state.sidebarPinned = !state.sidebarPinned;
+        // 关键：保持侧栏可见停靠，无论锁定与否，点图钉都不让它消失。
+        state.sessionsDrawerOpen = true;
+        try { localStorage.setItem("wand-sidebar-pinned", String(state.sidebarPinned)); } catch (e) {}
+        updateLayoutState();
+        scheduleTerminalRefitAfterPaddingTransition();
+      }
+
       // 收窄按钮的图标/title/状态随 collapsed 切换。抽出来给轻量更新路径用，
       // 避免为了换一个箭头方向就走全量 render()。
       function updateSidebarCollapseButton() {
@@ -12805,7 +12895,7 @@
 
             return ensureSessionReadyForInput(selectedSession).then(function(readySession) {
               if (!readySession) {
-                // ensureSessionReadyForInput / resumeClaudeSessionById 已经在失败路径里
+                // ensureSessionReadyForInput / resumeSession 已经在失败路径里
                 // 自行 toast，这里不再重复提示，避免叠两条消息。
                 return null;
               }
@@ -13599,14 +13689,14 @@
         var isCodex = selectedSession && selectedSession.provider === "codex";
         if (error && (error.errorCode === "SESSION_NOT_RUNNING" || error.errorCode === "SESSION_NO_PTY")) {
           return isCodex
-            ? "Codex 会话已结束，请新建会话后继续。"
+            ? "Codex 会话已结束；若存在 Codex 历史会话，将在你下次发送消息时自动恢复。"
             : "会话已结束；若存在 Claude 历史会话，将在你下次发送消息时自动恢复。";
         }
         if (error && error.errorCode === "SESSION_NOT_FOUND") {
           return "会话不存在，请重新选择或新建会话。";
         }
         return (error && error.message) || (isCodex
-          ? "Codex 会话暂不可用，请检查终端视图或新建会话。"
+          ? "Codex 会话暂不可用；若存在 Codex 历史会话，将自动尝试恢复。"
           : "会话暂不可用；若存在 Claude 历史会话，将自动尝试恢复。");
       }
 
@@ -13647,10 +13737,10 @@
       }
 
       function canAutoResumeSession(session) {
-        // 只要是 Claude provider + 非运行中 + 有 claudeSessionId，
+        // 只要是 Claude/Codex PTY provider + 非运行中 + 有可恢复历史 id，
         // 就允许在用户发送时静默触发恢复。不再要求 messages 里同时
         // 有 user + assistant 文本（slim 列表/截断历史会让该判断失真）。
-        return !!(session && session.provider === "claude" && session.status !== "running" && session.claudeSessionId);
+        return !!(session && !isStructuredSession(session) && (session.provider === "claude" || session.provider === "codex") && session.status !== "running" && session.claudeSessionId);
       }
 
       function ensureSessionReadyForInput(session, errorEl) {
@@ -13663,12 +13753,13 @@
           return Promise.resolve(session);
         }
         if (!canAutoResumeSession(session)) {
-          showToast("该会话没有可恢复的 Claude 历史上下文，请新建会话。", "error");
+          var providerLabel = session && session.provider === "codex" ? "Codex" : "Claude";
+          showToast("该会话没有可恢复的 " + providerLabel + " 历史上下文，请新建会话。", "error");
           return Promise.resolve(null);
         }
 
         // 静默恢复：不再弹 "正在恢复历史会话…" 提示，让用户发送动作看起来无缝。
-        return resumeClaudeSessionById(session.claudeSessionId, errorEl).then(function(data) {
+        return resumeSession(session.id, errorEl).then(function(data) {
           if (!data) return null;
           updateSessionSnapshot(data);
           updateSessionsList();
@@ -13941,24 +14032,24 @@
         { key: "down", label: "↓" },
         { key: "left", label: "←" }
       ];
-      // 外圈 8 功能：i=0 正上方起顺时针，与八分扇区 idx 对应
+      // 外圈功能键：N 个均分扇区，i=0 正上方起顺时针。
+      // 数组长度即扇区数 —— buildJoystickRingSvg / joystickHitTest 都是按
+      // OUTER_KEYS.length 动态算角度,所以这里随便加减都不需要改几何。
+      // 当前 4 键: 上=Enter 右=Ctrl+C 下=Esc 左=Shift+Tab。
+      // 选这 4 个的原因: Claude / Codex 交互里只有方向键 + Enter + Esc +
+      // Shift+Tab (back-tab) + Ctrl+C (abort) 有真实用途, 之前的 Tab /
+      // Ctrl+Z/D/L 在结构化 / chat / PTY claude 里都拿不到效果, 留着只是
+      // 占位 + 误点。
       var JOYSTICK_OUTER_KEYS = [
         { key: "enter", label: "Enter" },
-        { key: "escape", label: "Esc" },
-        { key: "tab", label: "Tab" },
-        { key: "shift_tab", label: "Shift+Tab" },
         { key: "ctrl_c", label: "Ctrl+C" },
-        { key: "ctrl_z", label: "Ctrl+Z" },
-        { key: "ctrl_d", label: "Ctrl+D" },
-        { key: "ctrl_l", label: "Ctrl+L" }
-      ];
-      // 钉住面板四角翻页键
-      var JOYSTICK_CORNER_KEYS = [
-        { key: "pageup", label: "PgUp" },
-        { key: "home", label: "Home" },
-        { key: "pagedown", label: "PgDn" },
-        { key: "end", label: "End" }
+        { key: "escape", label: "Esc" },
+        { key: "shift_tab", label: "Shift+Tab" }
       ];
+      // 钉住面板四角翻页键 —— 已弃用 (PgUp/Home/PgDn/End 在 Claude TUI 里
+      // 不是常用导航, 也跟终端历史回滚冲突)。留空数组让面板渲染逻辑自然
+      // 跳过这一排, 不删数组以保 ringSvg 之外别处 reference 安全。
+      var JOYSTICK_CORNER_KEYS = [];
 
       var ignoredInteractiveTargetIds = new Set([
         "mini-keyboard-fab",
@@ -14107,7 +14198,7 @@
               : "Enter 发送 · Shift+Enter 换行";
           }
         }
-        // 历史会话只要可自动恢复（Claude provider + 有 claudeSessionId），输入框/发送按钮
+        // 历史会话只要可自动恢复（Claude/Codex PTY + 有历史 id），输入框/发送按钮
         // 就保持可用——发送时由 ensureSessionReadyForInput 透明完成恢复。
         var canResumeOnSend = !structured && !isRunning && canAutoResumeSession(selectedSession);
         if (composer) {
@@ -14642,9 +14733,15 @@
         return resumeSession(sessionId).then(function(data) {
           if (!data) return null;
           if (data.claudeSessionId) {
-            state.claudeHistory = state.claudeHistory.filter(function(s) {
-              return s.claudeSessionId !== data.claudeSessionId;
-            });
+            if (data.provider === "codex") {
+              state.codexHistory = state.codexHistory.filter(function(s) {
+                return s.claudeSessionId !== data.claudeSessionId;
+              });
+            } else {
+              state.claudeHistory = state.claudeHistory.filter(function(s) {
+                return s.claudeSessionId !== data.claudeSessionId;
+              });
+            }
           }
           return activateSession(data).then(function() {
             return data;
@@ -14947,7 +15044,8 @@
       function handleInputBoxBlur() {
         resetInputPanelViewportSpacing();
         setTimeout(function() {
-          window.scrollTo(0, 0);
+          resetRootViewportScroll();
+          syncAppViewportHeight(false);
           // On mobile, force terminal refit + scroll after keyboard dismissal.
           // The container height restores but terminal needs time to
           // fill the expanded space, and the scroll position needs resetting.
@@ -14959,6 +15057,10 @@
             maybeScrollTerminalToBottom("keyboard");
           }
         }, 100);
+        setTimeout(function() {
+          resetRootViewportScroll();
+          syncAppViewportHeight(false);
+        }, 360);
       }
 
       function adjustInputBoxSelection(inputBox) {
@@ -15669,18 +15771,74 @@
       // adjustResize 不再自动 resize WebView 内容；同时仅给 input-panel
       // 加 padding-bottom 只是把 panel 内部底部撑空，并不会让 panel 自身
       // 上移。这里通过 CSS 变量驱动整层高度，是跨 WebView/Chrome/PWA 的
-      // 统一兜底。仅在视口比窗口明显变小时（典型 = 软键盘弹起）覆盖，
-      // 桌面与无键盘场景维持 100dvh 不抖。
-      function syncAppViewportHeight() {
+      // 统一兜底。iOS 的 100dvh 在键盘动画后会短暂滞后，所以这里持续用
+      // visualViewport 的实测高度驱动布局，桌面场景下该值基本等于窗口高度。
+      function getRootViewportScrollTop(vv) {
+        var values = [
+          window.scrollY || window.pageYOffset || 0,
+          document.documentElement ? document.documentElement.scrollTop || 0 : 0,
+          document.body ? document.body.scrollTop || 0 : 0
+        ];
+        if (vv) {
+          // pageTop is the visual viewport's top edge in layout coordinates.
+          // On iOS it captures the focus pan that can survive keyboard close.
+          if (typeof vv.pageTop === "number") {
+            values.push(vv.pageTop);
+          } else if (typeof vv.offsetTop === "number") {
+            values.push(vv.offsetTop);
+          }
+        }
+        return Math.max.apply(Math, values);
+      }
+
+      function resetRootViewportScroll() {
+        try { window.scrollTo(0, 0); } catch (e) {}
+        if (document.scrollingElement) document.scrollingElement.scrollTop = 0;
+        if (document.documentElement) document.documentElement.scrollTop = 0;
+        if (document.body) document.body.scrollTop = 0;
+      }
+
+      function syncAppViewportHeight(isKeyboardOpen) {
         var vv = window.visualViewport;
         if (!vv) return;
-        var diff = window.innerHeight - vv.height - vv.offsetTop;
         var root = document.documentElement;
-        if (diff > 50) {
-          root.style.setProperty('--app-viewport-height', vv.height + 'px');
-        } else {
-          root.style.removeProperty('--app-viewport-height');
+        var visualTop = window.__wandImeNative ? 0 : getRootViewportScrollTop(vv);
+        // iOS Safari 上 100dvh 在键盘 / 地址栏切换后有更新延迟, 经常"卡"在
+        // 上一刻的小值 -> body 比真实可见区还短一截, 输入框下方留出一大段
+        // 奶油色 html 背景。改成直接拿 visualViewport.height 当 body 高度的
+        // 权威值, 每帧实时跟随 (vv.resize/scroll 触发), 不再依赖 dvh。
+        // 桌面浏览器上 vv.height ≈ window.innerHeight, 同样无副作用。
+        // 之前的 diff > 50 阈值现在只用来判断"是不是真键盘上来了"以做
+        // iOS html 滚动复位 (offsetTop hack), 不再控制 body 高度。
+        //
+        // 但 iOS 还有一个更隐蔽的状态: 键盘收起后 visual viewport 已经变高,
+        // 根页面却仍停在键盘弹起时的 pageTop/scrollY。此时如果只写 vv.height,
+        // .app-container 的底边落在 visualViewport 顶点之前, input-panel 会悬在
+        // 屏幕底部上方。把 visualTop 临时加回高度, 再滚回 0; 后续 settle timer
+        // 会用新的 visualTop=0 覆盖回来。
+        root.style.setProperty('--app-viewport-height', Math.ceil(vv.height + Math.max(0, visualTop)) + 'px');
+        // iOS Safari: 当 textarea 获得焦点 / 键盘弹起时, 浏览器会主动把
+        // <html> 向上滚一段, 让焦点元素进可见区 —— 体现为 vv.offsetTop > 0。
+        // 但 body 已经被收缩到 vv.height, 这一段 offsetTop 就变成 body 底部
+        // (= .input-panel) 与键盘上沿之间的"空洞", 用户看到的就是
+        // "输入框离键盘还有很远一截"。这里强行把 html 滚回 0, 让 body 底部
+        // 重新贴回键盘上沿。Wand APK 内 (window.__wandImeNative=true) 走
+        // 原生 IME 回调精确 resize, 这里跳过避免双重补偿。
+        if (!window.__wandImeNative && (isKeyboardOpen || visualTop > 1)) {
+          resetRootViewportScroll();
+        }
+      }
+
+      function isEditableFocusTarget(el) {
+        if (!el) return false;
+        var tag = el.tagName;
+        if (tag === "TEXTAREA") return true;
+        if (tag === "SELECT") return true;
+        if (tag === "INPUT") {
+          var type = (el.getAttribute("type") || "text").toLowerCase();
+          return !/^(button|checkbox|color|file|hidden|image|radio|range|reset|submit)$/i.test(type);
         }
+        return !!el.isContentEditable;
       }
 
       // Visual viewport handling for better mobile keyboard support
@@ -15690,17 +15848,66 @@
         var vv = window.visualViewport;
         var lastHeight = vv.height;
         var keyboardOpen = false;
+        var lastViewportWidth = Math.max(window.innerWidth || 0, vv.width || 0);
+        var largestViewportHeight = Math.max(window.innerHeight || 0, vv.height || 0);
+        var viewportSettleTimers = [];
+
+        function getCurrentViewportHeightBaseline() {
+          return Math.max(window.innerHeight || 0, vv.height || 0);
+        }
+
+        function refreshViewportBaseline() {
+          var width = Math.max(window.innerWidth || 0, vv.width || 0);
+          var height = getCurrentViewportHeightBaseline();
+          if (Math.abs(width - lastViewportWidth) > 8) {
+            lastViewportWidth = width;
+            largestViewportHeight = height;
+            return;
+          }
+          if (height > largestViewportHeight) {
+            largestViewportHeight = height;
+          }
+        }
+
+        function detectKeyboardOpen(inputBox, offsetBottom) {
+          var activeEl = document.activeElement;
+          var hasEditableFocus = activeEl === inputBox || isEditableFocusTarget(activeEl);
+          var shrinkFromLargest = largestViewportHeight - vv.height;
+          var innerShrinkFromLargest = largestViewportHeight - (window.innerHeight || vv.height || 0);
+          if (offsetBottom > 80) return true;
+          // iOS/Chrome iOS sometimes resize window.innerHeight together with
+          // visualViewport.height, so offsetBottom stays near zero. The
+          // focused-editable + baseline shrink path catches that case.
+          if (hasEditableFocus && (shrinkFromLargest > 120 || innerShrinkFromLargest > 120)) return true;
+          // During close animation focus can disappear before viewport height
+          // is fully restored. Keep the "open" state until the shrink is small.
+          if (keyboardOpen && (shrinkFromLargest > 80 || offsetBottom > 32)) return true;
+          return false;
+        }
+
+        function scheduleViewportSettle() {
+          viewportSettleTimers.forEach(function(timer) { clearTimeout(timer); });
+          viewportSettleTimers = [60, 180, 360, 620].map(function(delay) {
+            return setTimeout(function() {
+              if (!window.__wandImeNative) {
+                resetRootViewportScroll();
+              }
+              syncAppViewportHeight(keyboardOpen);
+            }, delay);
+          });
+        }
 
         function updateViewport() {
           if (!vv) return;
           var inputBox = document.getElementById('input-box');
           var offsetBottom = window.innerHeight - vv.height - vv.offsetTop;
-          var isKeyboardOpen = offsetBottom > 50;
+          refreshViewportBaseline();
+          var isKeyboardOpen = detectKeyboardOpen(inputBox, offsetBottom);
           var heightChanged = Math.abs(vv.height - lastHeight) > 8;
 
           // 键盘开/关与视口尺寸变化时同步 --app-viewport-height，
           // 让 body 高度跟随可见区域，input-panel 自然贴键盘上沿。
-          syncAppViewportHeight();
+          syncAppViewportHeight(isKeyboardOpen);
 
           if (isKeyboardOpen && (!keyboardOpen || heightChanged) && shouldAdjustForKeyboard(vv, inputBox)) {
             syncInputBoxScroll(inputBox);
@@ -15720,6 +15927,21 @@
             // final scroll lands AFTER the animation settles.
             var wasStickToBottom = state.terminalAutoFollow || isTerminalNearBottom();
             ensureTerminalFit("keyboard-open", { forceReplay: true });
+            // iOS Safari 二次复位: 第一次 syncAppViewportHeight 在键盘动画
+            // 起始帧把 html 滚回 0, 但 iOS 在键盘动画收尾时还会再尝试一次
+            // "把焦点元素拽进可见区", 把 html 重新推上去 —— 留下用户报的
+            // "输入框距离键盘还有很长距离"。镜像 keyboard-close 的 200ms 兜底,
+            // 等键盘动画完整跑完后再清一次 scrollTop + 重算 viewport 高度,
+            // 让 input-panel 最终稳定贴在键盘上沿。
+            // Wand APK (__wandImeNative=true) 跳过, 原生 IME callback 已经在
+            // WebView 层精确 resize, 这里再 scroll 反而抖。
+            if (!window.__wandImeNative) {
+              setTimeout(function() {
+                resetRootViewportScroll();
+                syncAppViewportHeight(true);
+              }, 220);
+            }
+            scheduleViewportSettle();
             // Mirror the keyboard-close 200ms delay: by then the iOS / Android
             // keyboard slide-in animation is done, vv.height is final, and
             // scrollHeight reflects the post-replay grid. One more force
@@ -15742,8 +15964,8 @@
             // window.scrollTo(0,0) 不跑，页面停在键盘抬起时被 iOS 推上去的
             // 偏移位置，input-panel 看起来"没回到底"。
             // 这里在 visualViewport 检测到键盘收起的瞬间直接强制复位一次，
-            // 并把 --app-viewport-height 兜底清掉，确保 .app-container 回到
-            // 100dvh、input-panel 重新贴屏幕底部。
+            // 并把 --app-viewport-height 同步到键盘收起后的实测高度，确保
+            // input-panel 重新贴屏幕底部。
             //
             // Android APK (window.__wandImeNative=true) 跳过这段 iOS hack —
             // MainActivity 已经在 IME 动画 callback 里逐帧把 root setPadding,
@@ -15753,21 +15975,22 @@
             var rootEl = document.documentElement;
             var imeIsNative = !!window.__wandImeNative;
             if (!imeIsNative) {
-              rootEl.style.removeProperty('--app-viewport-height');
-              window.scrollTo(0, 0);
-              if (document.scrollingElement) document.scrollingElement.scrollTop = 0;
-              rootEl.scrollTop = 0;
-              if (document.body) document.body.scrollTop = 0;
+              // 不要 removeProperty('--app-viewport-height') —— 那样会让 body 退回
+              // 到 100dvh, 而 iOS Safari 的 100dvh 在键盘动画跑完前经常还停留
+              // 在小值, body 立刻短一截 -> 输入框下方露出大段奶油色 html 背景。
+              // 直接让 syncAppViewportHeight 把它更新为新的 vv.height (键盘已收
+              // 起所以是全可见高度), body 平滑过渡, 不出现空洞。
+              syncAppViewportHeight(false);
+              resetRootViewportScroll();
             }
+            scheduleViewportSettle();
             setTimeout(function() {
               if (!imeIsNative) {
                 // 二次复位：等键盘收起动画 + iOS 自身的回滚跑完后再清一次，
                 // 防止 iOS 在动画过程中又把 scrollTop 推上去。
-                window.scrollTo(0, 0);
-                if (document.scrollingElement) document.scrollingElement.scrollTop = 0;
-                rootEl.scrollTop = 0;
-                if (document.body) document.body.scrollTop = 0;
-                syncAppViewportHeight();
+                resetRootViewportScroll();
+                if (rootEl) rootEl.scrollTop = 0;
+                syncAppViewportHeight(false);
               }
               ensureTerminalFit("keyboard-close", { forceReplay: true });
               // 同 handleInputBoxBlur：尊重 terminalAutoFollow，避免把上滚
@@ -15883,11 +16106,18 @@
       // 不改动终端背景的 touch/scroll/wheel —— 单指空白处仍是原生滚动看历史。
 
       function isJoystickAvailable() {
-        // 触屏与桌面网页端都显示（球球用 Pointer Events，鼠标拖拽同样可用）
-        if (state.currentView !== "terminal") return false;
+        // 触屏与桌面网页端都显示（球球用 Pointer Events，鼠标拖拽同样可用）。
+        // 不再用 currentView/isStructuredSession 关掉:
+        // - chat 视图 (含 PTY Claude 的对话视图): 用户偶尔要给底层 PTY 发
+        //   方向键 / Esc / Shift+Tab 选权限菜单, 但只能切到 terminal 视图才点
+        //   摇杆 —— 现在 chat 视图直接可用。sendJoystickKey 已经走 /input
+        //   接口, 服务端不挑视图。
+        // - 结构化会话: 大多数键 (方向 / Tab) 在 SDK runner 里没真实 effect,
+        //   但 Ctrl+C / Esc 都映射到 query.interrupt() 中断当前回复, 用户
+        //   场景是"等不及当前回答, 想停掉重发"。sendJoystickKey 里按 session
+        //   类型分支处理: PTY 走原本 sequence, 结构化只接受中断意图键。
         var session = getSelectedSession();
         if (!session) return false;
-        if (isStructuredSession(session)) return false;
         return true;
       }
 
@@ -15934,16 +16164,21 @@
         for (i = 0; i < JOYSTICK_OUTER_KEYS.length; i++) {
           fnRow += keyBtn(JOYSTICK_OUTER_KEYS[i].key, JOYSTICK_OUTER_KEYS[i].label, "");
         }
-        var cornerRow = "";
-        for (i = 0; i < JOYSTICK_CORNER_KEYS.length; i++) {
-          cornerRow += keyBtn(JOYSTICK_CORNER_KEYS[i].key, JOYSTICK_CORNER_KEYS[i].label, "");
-        }
-        var modRow = keyBtn("ctrl", "Ctrl", "wjp-mod") + keyBtn("alt", "Alt", "wjp-mod");
-        return '<div class="wjp-title">遥控面板</div>' +
+        // 角键 (PgUp/Home/PgDn/End) 与修饰键 (Ctrl/Alt) 排已被裁剪 ——
+        // 当前外圈 4 键全是独立功能键 (Enter / Ctrl+C / Esc / Shift+Tab),
+        // 没有"先按 Ctrl 再按字母"的复合组合, 所以修饰键 toggle 没意义。
+        // CORNER_KEYS 为空时, 对应的 grid 不渲染, 面板高度自动收缩。
+        var html = '<div class="wjp-title">遥控面板</div>' +
           dpad +
-          '<div class="wjp-grid wjp-fnkeys">' + fnRow + "</div>" +
-          '<div class="wjp-grid wjp-corners">' + cornerRow + "</div>" +
-          '<div class="wjp-grid wjp-mods">' + modRow + "</div>";
+          '<div class="wjp-grid wjp-fnkeys">' + fnRow + "</div>";
+        if (JOYSTICK_CORNER_KEYS.length > 0) {
+          var cornerRow = "";
+          for (i = 0; i < JOYSTICK_CORNER_KEYS.length; i++) {
+            cornerRow += keyBtn(JOYSTICK_CORNER_KEYS[i].key, JOYSTICK_CORNER_KEYS[i].label, "");
+          }
+          html += '<div class="wjp-grid wjp-corners">' + cornerRow + "</div>";
+        }
+        return html;
       }
 
       function joystickPolar(r, deg) {
@@ -15993,12 +16228,17 @@
             '<path d="' + joystickSectorPath(JOYSTICK_R0, JOYSTICK_R1, center - 45 + gap, center + 45 - gap) + '"/>' +
             joystickLabelMarkup(k.label, lp.x, lp.y) + "</g>";
         }
-        for (i = 0; i < JOYSTICK_OUTER_KEYS.length; i++) {
+        // 外圈扇区宽度跟随 OUTER_KEYS.length 动态计算: 4 键 → 90° 每片,
+        // 8 键 → 45° 每片。half 是单片半宽 (扇区中心两侧各延半个 step)。
+        var outerCount = JOYSTICK_OUTER_KEYS.length;
+        var outerStep = outerCount > 0 ? 360 / outerCount : 360;
+        var outerHalf = outerStep / 2;
+        for (i = 0; i < outerCount; i++) {
           k = JOYSTICK_OUTER_KEYS[i];
-          center = -90 + i * 45;
+          center = -90 + i * outerStep;
           lp = joystickPolar((JOYSTICK_R1 + JOYSTICK_R2) / 2, center);
           svg += '<g class="wjr-sector wjr-outer" data-key="' + k.key + '">' +
-            '<path d="' + joystickSectorPath(JOYSTICK_R1, JOYSTICK_R2, center - 22.5 + gap, center + 22.5 - gap) + '"/>' +
+            '<path d="' + joystickSectorPath(JOYSTICK_R1, JOYSTICK_R2, center - outerHalf + gap, center + outerHalf - gap) + '"/>' +
             joystickLabelMarkup(k.label, lp.x, lp.y) + "</g>";
         }
         svg += '<circle class="wjr-hub" cx="0" cy="0" r="' + (JOYSTICK_R0 - 1) + '"/>';
@@ -16248,10 +16488,14 @@
           if (Math.abs(dy) >= Math.abs(dx)) return { zone: "inner", key: dy < 0 ? "up" : "down" };
           return { zone: "inner", key: dx < 0 ? "left" : "right" };
         }
-        // 外圈：8 等分扇区，正上方为 0，顺时针递增；+π/8 让扇区中心对准按钮
+        // 外圈：OUTER_KEYS.length 等分扇区，正上方为 0，顺时针递增；
+        // +halfStep 让扇区中心对准按钮 (原本 N=8 时是 +π/8)。
         var ang = Math.atan2(dx, -dy);
         if (ang < 0) ang += Math.PI * 2;
-        var idx = Math.floor((ang + Math.PI / 8) / (Math.PI / 4)) % 8;
+        var outerCount = JOYSTICK_OUTER_KEYS.length;
+        if (outerCount === 0) return { zone: "dead", key: null };
+        var outerStepRad = (Math.PI * 2) / outerCount;
+        var idx = Math.floor((ang + outerStepRad / 2) / outerStepRad) % outerCount;
         return { zone: "outer", key: JOYSTICK_OUTER_KEYS[idx].key };
       }
 
@@ -16356,6 +16600,24 @@
           updateJoystickPanelUI();
           return;
         }
+        var session = getSelectedSession();
+        // ── 结构化会话分支 ──
+        // SDK / claude -p 通道没有 PTY 可写, 把原始 escape 序列丢给
+        // /api/sessions/:id/input 会被结构化 sendMessage 当成对话文本 (例如
+        // 把 "\x1b[A" 作为 prompt 发出去), 既无效又污染上下文。
+        // 这里按"中断意图"白名单转发: Ctrl+C / Esc → query.interrupt()。
+        // 其他键 (方向 / Enter / Shift+Tab) 在结构化里没有合理 mapping, 静默
+        // no-op, 同时震一下做反馈。
+        if (session && isStructuredSession(session)) {
+          if (key === "ctrl_c" || key === "escape") {
+            interruptStructuredSessionFromJoystick(session, key);
+          }
+          // 不论是否真发出去, 都消化掉修饰键 + 更新 UI, 避免下次发送残留状态
+          clearModifiers();
+          updateJoystickPanelUI();
+          return;
+        }
+        // ── PTY 会话原路径 ──
         var seq = buildPtySequence(key, {
           ctrl: state.modifiers.ctrl,
           alt: state.modifiers.alt,
@@ -16367,6 +16629,44 @@
         scheduleShortcutResync();
       }
 
+      // 摇杆触发的结构化会话中断: 复用 /api/structured-sessions/:id/messages
+      // 的 interrupt=true 路径 (sendMessage 内部走 query.interrupt 优雅停止,
+      // 失败 fallback 到 abortController.abort)。空 input + interrupt=true =
+      // "停掉当前回复但不发新消息", 跟用户从摇杆按 Ctrl+C/Esc 的预期一致。
+      function interruptStructuredSessionFromJoystick(session, key) {
+        if (!session || !session.id) return;
+        fetch("/api/structured-sessions/" + session.id + "/messages", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          credentials: "same-origin",
+          body: JSON.stringify({ input: "", interrupt: true, preserveQueue: true }),
+        })
+        .then(function(res) {
+          if (!res.ok) return res.json().catch(function() { return {}; }).then(function(p) {
+            throw new Error((p && p.error) || ("中断失败 (key=" + key + ")"));
+          });
+          return res.json();
+        })
+        .then(function(snapshot) {
+          if (snapshot && snapshot.id) {
+            updateSessionSnapshot(snapshot);
+            if (snapshot.id === state.selectedId) {
+              var refreshed = state.sessions.find(function(s) { return s.id === snapshot.id; }) || snapshot;
+              state.currentMessages = buildMessagesForRender(refreshed, getPreferredMessages(refreshed, snapshot.output, false));
+              renderChat(true);
+              if (typeof updateQueueBar === "function") updateQueueBar();
+            }
+          }
+        })
+        .catch(function(err) {
+          // 已经在 SDK 内部完成 / 没有 pending query 时, 服务端会返回 400,
+          // 这里静默吃掉, 避免给用户冒出"中断失败"toast (按了也是想停, 没东西可停就当成功)。
+          if (window && window.console && err && err.message) {
+            console.debug("[wand] joystick interrupt no-op:", err.message);
+          }
+        });
+      }
+
       function toggleJoystickPanel() {
         if (state.joystickPinnedOpen) closeJoystickPanel();
         else openJoystickPanel();