zcode-pro 1.0.0 → 1.2.0

package/src/inject/features/session-switch.js

@@ -1,17 +1,23 @@
 // 会话快捷切换：alt+z 立即切到上次使用的会话（再按切回）；按住 alt 按 x/c 打开
-// MRU 弹窗前后移动高亮（x 更早 / c 更新，两端循环），松开 alt 切换，Esc / 点弹窗外
-// 取消，点行即切。MRU（最近使用序）从注入起记录（不回填历史库，上限 50 条），
+// MRU 弹窗前后移动高亮（x 更早 / c 更新，c 到底且还有更多时加载 5 条并选中新
+// 加载的第一条），alt+e 直接打开同一弹窗（初始显示最近 10 条），alt+r 打开
+// “运行中 / 运行完未查看”任务弹窗，松开 alt 切换，Esc / 点弹窗外取消，点行即切。
+// MRU（最近使用序）从注入起记录（不回填历史库，上限 50 条），
 // 与侧栏展示顺序无关；当前会话靠侧栏条目的 bg-selected 类识别（实测标记），
 // 事件驱动扫描（会话行增删/选中标记移动才触发）+ 低频兜底轮询——
 // 点击、新建任务自动跳转等任何方式的切换都能捕捉，聊天区流式输出不产生扫描。
 // 目标条目在折叠项目下时先展开项目行再点击（展开先例见 pinned-expand.js）。
-import { h, t, getConfig } from '../core.js';
+import { h, t, getConfig, DEFAULT_SHORTCUTS } from '../core.js';
 import { ensureStyle, showToast } from '../ui.js';
 import { findProjectRow } from './ws-rows.js';
+import { wsRunningKeys } from './ws-running.js';
 
 const MRU_LIMIT = 50;
 const SCAN_DEBOUNCE_MS = 150;   // 相关 DOM 变动后的去抖，合并连续变动
 const SCAN_FALLBACK_MS = 5000;  // 兜底轮询周期：仅补观察器覆盖不到的路径
+const INITIAL_COUNT = 10;       // 弹窗初始渲染条数（alt+e“最近 10 条”同此）
+const PAGE_SIZE = 5;            // c 到底再按时加载的条数
+const UNSEEN_LIMIT = 50;
 
 let mru = [];          // 会话键（data-task-item-key），最近使用的在最前
 let current = null;    // 当前会话键
@@ -20,6 +26,24 @@ let popupEl = null;    // 打开的切换弹窗（null = 未打开）
 let aliasesCache = {}; // 项目路径 → 别名（打开弹窗时预取，renderPopup 同步使用）
 let highlight = 0;
 let scanDebounce = 0;
+let popupMode = 'mru';   // 'mru'：最近使用（x/c/e）；'attention'：运行中 + 未查看（r）
+let visibleCount = INITIAL_COUNT;
+let unseen = new Set();  // 运行结束以来未再切入查看的会话键
+let lastRunKeys = null;  // 上次采样的运行键集合（用于识别“运行→结束”的转变）
+let movedSinceOpen = false; // 打开弹窗后是否移动过高亮（决定松开 alt 是提交还是保持）
+// 键位（alt+字母/数字）：默认见 core.js，可在设置 → 快捷键修改；
+// 设置保存时会派发 zcodepro:config-changed，这里刷新缓存
+let hotkeys = { ...DEFAULT_SHORTCUTS };
+function loadHotkeys() {
+  return getConfig(true).then((cfg) => {
+    const sc = cfg && cfg.shortcuts;
+    if (sc && typeof sc === 'object') {
+      for (const k of Object.keys(DEFAULT_SHORTCUTS)) {
+        if (typeof sc[k] === 'string' && /^[a-z0-9]$/.test(sc[k])) hotkeys[k] = sc[k];
+      }
+    }
+  }).catch(() => {});
+}
 
 function firstLineOf(item) {
   // 条目文本含相对时间等杂项，取首个截断类标题元素，兜底 innerText 首行
@@ -41,8 +65,9 @@ function findCurrent() {
   return null;
 }
 
-// 记录一次“切到 key”；顺带刷新在场条目的标题缓存
+// 记录一次“切到 key”；顺带刷新在场条目的标题缓存。切入即视为已查看
 function record(key) {
+  if (key) unseen.delete(key);
   if (key && key !== current) {
     current = key;
     mru = mru.filter((k) => k !== key);
@@ -111,13 +136,35 @@ async function switchTo(key) {
 
 // —— 切换弹窗（类 alt+tab）：居中列表卡，x/c 移动高亮，松开 alt / 点击提交 ——
 
+// attention 弹窗的列表：正在运行或运行完未查看的任务。MRU 只记录切入过的
+// 会话，而“未查看”的任务可能从未切入，不在 MRU 里——这部分（先运行中、
+// 再未查看，各按发现序）追加在 MRU 命中项之后
+function attentionList() {
+  const run = wsRunningKeys();
+  const listed = new Set();
+  const head = [];
+  for (const k of mru) {
+    if (run.has(k) || unseen.has(k)) { head.push(k); listed.add(k); }
+  }
+  const tail = [];
+  for (const k of run) if (!listed.has(k)) { tail.push(k); listed.add(k); }
+  for (const k of unseen) if (!listed.has(k)) { tail.push(k); listed.add(k); }
+  return [...head, ...tail];
+}
+
+// 弹窗当前列表：普通模式为 MRU 全量；attention 模式为运行中 + 未查看
+function activeList() {
+  return popupMode === 'attention' ? attentionList() : mru;
+}
+
 function closePopup(commit) {
   if (!popupEl) return;
   const idx = highlight;
+  const list = activeList();
   popupEl.remove();
   popupEl = null;
-  if (commit && idx > 0 && mru[idx] && mru[idx] !== current) {
-    void switchTo(mru[idx]).then((ok) => { if (!ok) showToast(t().switcherFailed, 'error'); });
+  if (commit && list[idx] && list[idx] !== current) {
+    void switchTo(list[idx]).then((ok) => { if (!ok) showToast(t().switcherFailed, 'error'); });
   }
 }
 
@@ -139,51 +186,94 @@ function renderPopup() {
   if (!popupEl) return;
   const L = t();
   const list = popupEl.querySelector('[data-zcodepro-switcher-list]');
-  list.replaceChildren(...mru.map((key, i) => {
+  const full = activeList();
+  const shown = full.slice(0, visibleCount);
+  // attention 模式每行标状态：运行中（绿）/ 未查看（琥珀）；普通模式不加
+  const run = popupMode === 'attention' ? wsRunningKeys() : null;
+  list.replaceChildren(...shown.map((key) => {
     const proj = projLabelOf(key, aliasesCache);
     return h('div', {
       class: 'zcodepro-switcher-row',
-      'data-active': i === highlight ? '' : undefined,
-      onClick: () => { highlight = i; closePopup(true); },
+      'data-active': full[highlight] === key ? '' : undefined,
+      onClick: () => { highlight = full.indexOf(key); closePopup(true); },
     },
       // 标题文本包 span：截断省略作用在文本节点上（flex 容器自身 ellipsis 无效）
       h('div', { class: 'zcodepro-switcher-title' },
-        i === 0 ? h('span', { class: 'zcodepro-switcher-tag' }, L.switcherCurrent) : null,
+        key === current ? h('span', { class: 'zcodepro-switcher-tag' }, L.switcherCurrent) : null,
+        run && run.has(key) ? h('span', { class: 'zcodepro-switcher-tag zcodepro-switcher-tag-run' }, L.switcherRunning) : null,
+        run && !run.has(key) ? h('span', { class: 'zcodepro-switcher-tag zcodepro-switcher-tag-new' }, L.switcherUnseen) : null,
         h('span', null, findTitle(key))),
       // 无项目归属（如置顶）时不渲染空行
       proj ? h('div', { class: 'zcodepro-switcher-ws' }, proj) : null);
   }));
+  if (full.length > shown.length) {
+    list.append(h('div', { class: 'zcodepro-switcher-more' },
+      L.switcherMore.replaceAll('{n}', String(full.length - shown.length))));
+  }
 }
 
-async function openPopup() {
+async function openPopup(mode = 'mru') {
   if (popupEl) return;
+  popupMode = mode;
+  visibleCount = INITIAL_COUNT;
+  highlight = 0;
+  movedSinceOpen = false;
   const cfg = await getConfig().catch(() => null);
   aliasesCache = (cfg && cfg.aliases && typeof cfg.aliases === 'object') ? cfg.aliases : {};
   ensureStyle();
   const L = t();
-  highlight = 0;
   popupEl = h('div', {
     class: 'zcodepro-switcher-overlay',
     // 点弹窗外 = 取消（不切）
     onMousedown: (e) => { if (e.target === popupEl) closePopup(false); },
   },
     h('div', { class: 'zcodepro-switcher' },
-      h('div', { class: 'zcodepro-switcher-hint' }, L.switcherHint),
+      // 提示行键位跟随当前配置（改键后新开的弹窗即用新键位）
+      h('div', { class: 'zcodepro-switcher-hint' },
+        (mode === 'attention' ? L.switcherAttentionHint : L.switcherHint)
+          .replaceAll('{prev}', hotkeys.switchPrev)
+          .replaceAll('{next}', hotkeys.switchNext)),
       h('div', { 'data-zcodepro-switcher-list': '1', class: 'zcodepro-switcher-list' })));
   document.body.append(popupEl);
   renderPopup();
 }
 
-function moveHighlight(delta) {
-  if (!popupEl || mru.length < 2) return;
-  highlight = (highlight + delta + mru.length) % mru.length;
-  renderPopup();
-  const row = popupEl.querySelector('[data-active]');
+function scrollHighlight() {
+  const row = popupEl && popupEl.querySelector('[data-active]');
   if (row) row.scrollIntoView({ block: 'nearest' });
 }
 
+function moveUp() {
+  const len = Math.min(activeList().length, visibleCount);
+  if (len < 2) return;
+  highlight = highlight > 0 ? highlight - 1 : len - 1; // 到顶循环回已加载的末尾
+  movedSinceOpen = true;
+  renderPopup();
+  scrollHighlight();
+}
+
+function moveDown() {
+  const full = activeList();
+  const len = Math.min(full.length, visibleCount);
+  if (len < 2) return;
+  if (highlight < len - 1) {
+    highlight += 1;
+  } else if (visibleCount < full.length) {
+    // 到底且还有更多：加载 5 条，高亮落在新加载的第一条
+    visibleCount = Math.min(visibleCount + PAGE_SIZE, full.length);
+    highlight = len;
+  } else {
+    highlight = 0; // 全部加载完后再到底：循环回顶部
+  }
+  movedSinceOpen = true;
+  renderPopup();
+  scrollHighlight();
+}
+
 export function startSessionSwitch() {
   scan();
+  void loadHotkeys();
+  window.addEventListener('zcodepro:config-changed', () => { void loadHotkeys(); });
   // 事件驱动为主：任务条目相关变动（去抖 150ms）立即重扫
   new MutationObserver((muts) => { if (taskRowMutations(muts)) scheduleScan(); })
     .observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['class'] });
@@ -191,6 +281,21 @@ export function startSessionSwitch() {
   setInterval(() => { if (!document.hidden) scan(); }, SCAN_FALLBACK_MS);
   document.addEventListener('visibilitychange', () => { if (!document.hidden) scan(); });
 
+  // “运行完未查看”跟踪：周期采样运行键集合（ws-running 维护的实时状态），
+  // 从运行集合消失（转终态）且结束时不是当前会话的记为未查看；
+  // 用户切入该会话（record）即清除。注入前已结束的任务无从判定，不追溯
+  setInterval(() => {
+    if (document.hidden) return;
+    const now = wsRunningKeys();
+    if (lastRunKeys) {
+      for (const k of lastRunKeys) {
+        if (!now.has(k) && k !== current) unseen.add(k);
+      }
+    }
+    lastRunKeys = now;
+    if (unseen.size > UNSEEN_LIMIT) unseen = new Set([...unseen].slice(-UNSEEN_LIMIT));
+  }, 10_000);
+
   // 点击兜底：bg-selected 标记不可用/未出现时，点条目（含本功能派发的合成点击）即记录
   document.addEventListener('click', (e) => {
     const item = e.target instanceof Element && e.target.closest('[data-task-item-key]');
@@ -205,17 +310,29 @@ export function startSessionSwitch() {
       closePopup(false);
       return;
     }
+    // 弹窗开着时方向键 / Enter 也可操作（此时用户往往已松开 alt）：
+    // ↑/↓ 与 x/c 同规则（下到底加载 5 条），Enter 提交高亮项
+    if (popupEl && (e.key === 'ArrowUp' || e.key === 'ArrowDown' || e.key === 'Enter')) {
+      e.preventDefault();
+      e.stopImmediatePropagation();
+      if (e.key === 'ArrowUp') moveUp();
+      else if (e.key === 'ArrowDown') moveDown();
+      else if (!e.repeat) closePopup(true);
+      return;
+    }
     if (!e.altKey || e.ctrlKey || e.metaKey || e.isComposing) return;
     // 我们的设置弹窗开着时不抢键（它有自己的 Esc/焦点逻辑）
     if (document.querySelector('.zcodepro-overlay')) return;
     const k = e.key.toLowerCase();
-    if (k !== 'z' && k !== 'x' && k !== 'c') return;
+    const isHot = k === hotkeys.switchLast || k === hotkeys.switchPrev || k === hotkeys.switchNext
+      || k === hotkeys.switchRecent || k === hotkeys.switchAttention;
+    if (!isHot) return;
     e.preventDefault();
     e.stopImmediatePropagation();
     void (async () => {
     const cfg = await getConfig(); // 带 3s 缓存
     if (cfg.features && cfg.features.sessionSwitch === false) return;
-    if (k === 'z') {
+    if (k === hotkeys.switchLast) {
       if (e.repeat) return;
       // 即时切换：关掉可能开着的弹窗，切到最近使用的会话（上次使用的会话）
       closePopup(false);
@@ -231,16 +348,34 @@ export function startSessionSwitch() {
       void switchTo(target).then((ok) => { if (!ok) showToast(t().switcherFailed, 'error'); });
       return;
     }
-    // x/c：弹窗导航（无可导航会话时与 z 一致轻提示）
+    // r：运行中 / 运行完未查看的任务（attention 弹窗）
+    if (k === hotkeys.switchAttention) {
+      if (e.repeat) return;
+      closePopup(false);
+      if (!attentionList().length) {
+        showToast(t().switcherAttentionEmpty);
+        return;
+      }
+      await openPopup('attention');
+      return;
+    }
+    // x/c/e：最近使用弹窗（无可导航会话时与 z 一致轻提示）
     if (mru.length < 2) { showToast(t().switcherEmpty); return; }
-    if (!popupEl) await openPopup();
+    // e 只负责打开（初始显示最近 10 条，c 可继续加载更早的）
+    if (k === hotkeys.switchRecent) {
+      if (!e.repeat && !popupEl) await openPopup('mru');
+      return;
+    }
+    if (!popupEl) await openPopup('mru');
     // 键位对调：alt+x 上移一位（更靠上/更近的键管向上），alt+c 下移
-    moveHighlight(k === 'x' ? -1 : 1);
+    if (k === hotkeys.switchPrev) moveUp(); else moveDown();
     })();
   }, true);
 
   document.addEventListener('keyup', (e) => {
-    if (e.key === 'Alt' && popupEl) closePopup(true); // 松开 alt：提交高亮项
+    // 松开 alt：移动过高亮则提交（alt+tab 流）；从未移动则保持弹窗打开，
+    // 让用户继续用方向键选择（alt+e / alt+r 打开后松手查看的场景）
+    if (e.key === 'Alt' && popupEl && movedSinceOpen) closePopup(true);
   }, true);
 
   // 窗口失焦（alt+tab 到别的应用等）视同取消

package/src/inject/features/settings-dialog.js

@@ -1,6 +1,6 @@
 // “ZCode Pro 增强设置”弹窗：功能开关 + 样式调整 + 运行状态。
 // 顶部标签页切换（视觉参考侧栏“分组/项目”切换）；配置写入 helper（~/.zcode/zcodepro.json）。
-import { h, t, rpc, getConfig, clearConfigCache, errText, HELPER_URL, isZhLocale, isNewProjectSidebar } from '../core.js';
+import { h, t, rpc, getConfig, clearConfigCache, errText, HELPER_URL, isZhLocale, isNewProjectSidebar, DEFAULT_SHORTCUTS } from '../core.js';
 import { openDialog, dialogFooter, btnPrimary, btnSecondary, btnSmall, settingRow, ensureStyle, showToast, numberField, unitField } from '../ui.js';
 import { comboField, providerOptionsOf, modelOptionsOf, modelPlaceholderOf, isManualConn } from '../provider-fields.js';
 import { refreshAliases } from './alias.js';
@@ -278,6 +278,40 @@ export function openSettingsDialog() {
           : L.pluginsUpToDate;
       })();
 
+      // 会话快捷切换：入口键位（“快捷键”标签页可改）；此处定义在 refreshRows 之前，
+      // 功能行的描述与快捷键面板共用同一份当前键位
+      const HK_ACTIONS = [
+        ['switchLast', 'hkAltZ'],
+        ['switchPrev', 'hkAltX'],
+        ['switchNext', 'hkAltC'],
+        ['switchRecent', 'hkAltE'],
+        ['switchAttention', 'hkAltR'],
+      ];
+      const hkNames = () => ({
+        switchLast: L.hkNameLast, switchPrev: L.hkNamePrev, switchNext: L.hkNameNext,
+        switchRecent: L.hkNameRecent, switchAttention: L.hkNameAttention,
+      });
+      // 当前生效键位：配置里合法的单字符覆盖默认，其余回退默认
+      const hkKeys = () => {
+        const sc = config.shortcuts || {};
+        const keys = {};
+        for (const [a] of HK_ACTIONS) {
+          keys[a] = /^[a-z0-9]$/.test(sc[a]) ? sc[a] : DEFAULT_SHORTCUTS[a];
+        }
+        return keys;
+      };
+      // 开关描述按当前键位渲染（改键后 refreshRows 重绘即更新）；
+      // prev/next 出现在“按住 alt 再按 {prev}/{next}”语境，用裸键位避免 alt 重复
+      const sessionSwitchDesc = () => {
+        const k = hkKeys();
+        return L.featureSessionSwitchDesc
+          .replaceAll('{last}', 'alt+' + k.switchLast)
+          .replaceAll('{prev}', k.switchPrev)
+          .replaceAll('{next}', k.switchNext)
+          .replaceAll('{recent}', 'alt+' + k.switchRecent)
+          .replaceAll('{attention}', 'alt+' + k.switchAttention);
+      };
+
       const refreshRows = () => {
         const f = config.features || {};
         rows.replaceChildren(
@@ -296,7 +330,7 @@ export function openSettingsDialog() {
             if (await setFeature('taskOrder', next)) f.taskOrder = next;
             refreshRows();
           }),
-          settingRow(L.featureSessionSwitch, L.featureSessionSwitchDesc, f.sessionSwitch !== false, async () => {
+          settingRow(L.featureSessionSwitch, sessionSwitchDesc(), f.sessionSwitch !== false, async () => {
             const next = !(f.sessionSwitch !== false);
             if (await setFeature('sessionSwitch', next)) f.sessionSwitch = next;
             refreshRows();
@@ -326,6 +360,11 @@ export function openSettingsDialog() {
             if (await setFeature('wsRunningSpin', next)) f.wsRunningSpin = next;
             refreshRows();
           }),
+          settingRow(L.featureNewtabPanels, L.featureNewtabPanelsDesc, f.newtabPanels !== false, async () => {
+            const next = !(f.newtabPanels !== false);
+            if (await setFeature('newtabPanels', next)) f.newtabPanels = next;
+            refreshRows();
+          }),
           (() => {
             // 标题 = “自动更新 duanluan/zcode-plugins 插件”，仓库名可点击跳转仓库
             const repoLink = h('span', {
@@ -398,6 +437,103 @@ export function openSettingsDialog() {
         h('div', {}, rows),
         communityCards,
       );
+      // “快捷键”：五个入口键可改（点“修改”后按下新键，字母/数字，Esc 取消），
+      // 弹窗内通用键（↑/↓、Enter、Esc、松开 alt）固定只读；开关仍在“功能”标签页。
+      // 键位与名称定义（HK_ACTIONS/hkNames/hkKeys）在 refreshRows 前共用
+      let hkRecording = null; // 正在录制新键的动作（null = 未在录制）
+      let hkKeyHandler = null;
+      const hkCard = h('div', { class: 'divide-y divide-border rounded-xl border border-border' });
+      const hkCell = (keyLabel, desc, extra) => h('div', { class: 'flex items-start gap-3 px-3 py-2.5' },
+        h('kbd', {
+          class: 'shrink-0 min-w-20 rounded-md border border-border px-2 py-0.5 text-center text-ui-xs text-foreground-subtle',
+          style: 'font-family: ui-monospace, SFMono-Regular, Menlo, monospace; line-height: 1.5;',
+        }, keyLabel),
+        h('div', { class: 'min-w-0 flex-1 text-ui-sm text-foreground-subtle' }, desc),
+        extra ? h('div', { class: 'ml-auto shrink-0 pl-3' }, extra) : null);
+      const renderShortcuts = () => {
+        const keys = hkKeys();
+        const names = hkNames();
+        hkCard.replaceChildren(
+          ...HK_ACTIONS.map(([a, descKey]) => {
+            const recording = hkRecording === a;
+            return hkCell(
+              recording ? L.hkRecording : 'alt + ' + keys[a],
+              L[descKey],
+              btnSmall(recording ? L.hkRecording : L.hkModify, () => { recording ? stopHkRecording() : startHkRecording(a); }));
+          }),
+          hkCell('↑ / ↓', L.hkArrow.replaceAll('{prev}', keys.switchPrev).replaceAll('{next}', keys.switchNext)),
+          hkCell('Enter', L.hkEnter),
+          hkCell('Esc', L.hkEsc),
+          hkCell(L.hkReleaseKey, L.hkRelease));
+      };
+      const stopHkRecording = () => {
+        hkRecording = null;
+        if (hkKeyHandler) {
+          document.removeEventListener('keydown', hkKeyHandler, true);
+          hkKeyHandler = null;
+        }
+        renderShortcuts();
+      };
+      const startHkRecording = (action) => {
+        hkRecording = action;
+        if (!hkKeyHandler) {
+          // 绑定本次弹窗实例：弹窗关闭（哪怕马上重开新弹窗）后旧监听器自摘，
+          // 不会吞掉新弹窗里的按键
+          const myOverlay = document.querySelector('.zcodepro-overlay');
+          hkKeyHandler = (e) => {
+            if (!myOverlay || !myOverlay.isConnected) { stopHkRecording(); return; }
+            if (e.isComposing) return;
+            e.preventDefault();
+            e.stopImmediatePropagation();
+            if (e.key === 'Escape') { stopHkRecording(); return; }
+            const k = e.key.toLowerCase();
+            if (!/^[a-z0-9]$/.test(k)) { showToast(L.hkInvalid, 'error'); return; }
+            const keys = hkKeys();
+            const names = hkNames();
+            const conflict = HK_ACTIONS.find(([a]) => a !== hkRecording && keys[a] === k);
+            if (conflict) {
+              showToast(L.hkConflict.replaceAll('{k}', k).replaceAll('{name}', names[conflict[0]]), 'error');
+              return;
+            }
+            const a = hkRecording;
+            stopHkRecording();
+            void (async () => {
+              const res = await rpc('/config', { method: 'POST', body: { shortcuts: { [a]: k } } });
+              clearConfigCache();
+              window.dispatchEvent(new CustomEvent('zcodepro:config-changed'));
+              if (!res.ok) { showToast(L.failed + ': ' + errText(res), 'error'); renderShortcuts(); return; }
+              if (res.config && res.config.shortcuts) config.shortcuts = res.config.shortcuts;
+              showToast(L.hkSaved, 'success');
+              refreshRows(); // 功能标签页的开关描述跟随新键位
+              renderShortcuts();
+            })();
+          };
+          document.addEventListener('keydown', hkKeyHandler, true);
+        }
+        renderShortcuts();
+      };
+      renderShortcuts();
+      // 重置为默认：五个入口键一次性写回默认值，保存路径与单个改键一致
+      const resetShortcuts = async () => {
+        stopHkRecording(); // 录制进行中点重置：先结束录制再写回默认
+        const all = {};
+        for (const [a] of HK_ACTIONS) all[a] = DEFAULT_SHORTCUTS[a];
+        const res = await rpc('/config', { method: 'POST', body: { shortcuts: all } });
+        clearConfigCache();
+        window.dispatchEvent(new CustomEvent('zcodepro:config-changed'));
+        if (!res.ok) { showToast(L.failed + ': ' + errText(res), 'error'); return; }
+        if (res.config && res.config.shortcuts) config.shortcuts = res.config.shortcuts;
+        showToast(L.hkResetDone, 'success');
+        refreshRows(); // 功能标签页的开关描述跟随默认键位
+        renderShortcuts();
+      };
+      const paneShortcuts = h('div', { role: 'tabpanel', class: 'mt-4', style: 'display:none' },
+        h('div', { class: 'mb-2 text-ui-sm font-medium' }, L.hkTitle),
+        h('div', { class: 'mb-2 flex items-center gap-2' },
+          h('div', { class: 'min-w-0 flex-1 text-ui-xs/relaxed text-foreground-subtle' }, L.hkEditHint),
+          h('div', { class: 'shrink-0' }, btnSmall(L.hkReset, () => { void resetShortcuts(); }))),
+        hkCard,
+      );
       const paneStyles = h('div', { role: 'tabpanel', class: 'mt-4', style: 'display:none' });
       const panePerf = h('div', { role: 'tabpanel', class: 'mt-4', style: 'display:none' });
       const paneAgents = h('div', { role: 'tabpanel', class: 'mt-2', style: 'display:none' });
@@ -408,9 +544,10 @@ export function openSettingsDialog() {
       const paneHeadroom = h('div', { role: 'tabpanel', class: 'mt-4', style: 'display:none' });
       const paneTitleGen = h('div', { role: 'tabpanel', class: 'mt-4', style: 'display:none' });
       const paneDebug = h('div', { role: 'tabpanel', class: 'mt-4', style: 'display:none' });
-      const panes = { features: paneFeatures, styles: paneStyles, perf: panePerf, agents: paneAgents, proxy: paneProxy, sync: paneSync, vision: paneVision, headroom: paneHeadroom, rtk: paneRtk, debug: paneDebug };
+      const panes = { features: paneFeatures, shortcuts: paneShortcuts, styles: paneStyles, perf: panePerf, agents: paneAgents, proxy: paneProxy, sync: paneSync, vision: paneVision, headroom: paneHeadroom, rtk: paneRtk, debug: paneDebug };
       const tabDefs = [
         ['features', L.tabFeatures],
+        ['shortcuts', L.tabShortcuts],
         ['agents', L.tabBehavior],
         ['styles', L.tabStyles],
         ['perf', L.tabPerformance],
@@ -433,6 +570,8 @@ export function openSettingsDialog() {
         }, label)));
       const switchTab = (name) => {
         activeTab = name;
+        // 切走“快捷键”标签页时结束键位录制：否则在其它标签页打字会被录制监听吞掉
+        if (name !== 'shortcuts' && hkRecording) stopHkRecording();
         for (const [id, pane] of Object.entries(panes)) pane.style.display = id === name ? '' : 'none';
         renderTabs();
       };
@@ -2256,6 +2395,7 @@ export function openSettingsDialog() {
         statusLine,
         tablist,
         paneFeatures,
+        paneShortcuts,
         paneAgents,
         paneStyles,
         panePerf,

package/src/inject/features/ws-running.js

@@ -640,6 +640,13 @@ export function wsRunningSnapshot() {
   };
 }
 
+// 当前所有运行中会话键的集合（会话切换的 alt+r 以此筛“正在运行”的任务）
+export function wsRunningKeys() {
+  const keys = new Set();
+  for (const set of runningByWs.values()) for (const k of set) keys.add(k);
+  return keys;
+}
+
 // 无感复核指定工作区当前是否仍有运行中会话（展开读行后原样收起）。
 // 返回 true = 确认无运行；false = 有运行、窗口隐藏或行不可达（一律视为忙，调用方不得回收）
 export async function verifyWorkspaceNotRunning(ws) {

package/src/inject/index.js

@@ -10,6 +10,7 @@ import { startAliasWatcher } from './features/alias.js';
 import { startAliasMigrationWatcher } from './features/alias-migration.js';
 import { startTaskOrderWatcher } from './features/task-order.js';
 import { startSessionSwitch } from './features/session-switch.js';
+import { startNewtabPanels } from './features/newtab-panels.js';
 import { startTitleLock } from './features/title-lock.js';
 import { startTitleGen } from './features/title-gen.js';
 import { startWsRunningSpin } from './features/ws-running.js';
@@ -58,6 +59,7 @@ import { ensureStyle } from './ui.js';
     try { startWsRunningSpin(); } catch { /* ignore */ }
     try { startIdleReclaim(); } catch { /* ignore */ }
     try { startToolbarIcons(); } catch { /* ignore */ }
+    try { startNewtabPanels(); } catch { /* ignore */ }
     try { startPinnedCollapse(); } catch { /* ignore */ }
     try { startStyleAdjustments(); } catch { /* ignore */ }
     try { startSettingsEntry(); } catch { /* ignore */ }

package/src/inject/ui.js

@@ -616,6 +616,20 @@ export function ensureStyle() {
       background-color: color-mix(in oklab, var(--color-primary, #111) 12%, transparent);
       color: var(--color-foreground-subtle, #666);
     }
+    /* attention 弹窗（alt+r）的行状态标签：运行中绿、未查看琥珀 */
+    .zcodepro-switcher-tag-run {
+      background-color: color-mix(in oklab, var(--color-emerald-500, #10b981) 20%, transparent);
+    }
+    .zcodepro-switcher-tag-new {
+      background-color: color-mix(in oklab, var(--color-amber-500, #f59e0b) 22%, transparent);
+    }
+    /* 列表底部“还有 N 条”提示行 */
+    .zcodepro-switcher-more {
+      padding: 6px 12px 2px;
+      font-size: 11px;
+      text-align: center;
+      color: var(--color-muted-foreground, #888);
+    }
     .zcodepro-switcher-ws {
       font-size: 11px;
       color: var(--color-muted-foreground, #888);