zcode-pro 1.0.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcode-pro",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "ZCode Pro — 为 ZCode 桌面版增加界面增强（不修改客户端文件，通过 ZCode Pro 快捷方式启动即可），核心功能：项目自定义别名",
   "type": "module",
   "bin": {

package/src/host/helper.mjs

@@ -17,7 +17,7 @@ import { reorderWorkspaceTasks, reorderGroupMembers } from './taskOrder.mjs';
 import { webdavRequest, webdavPutWithMkcol, webdavHttpText, parseWebdavListing, findCurl } from './webdav.mjs';
 import { resolveZcodeExecutable } from './paths.mjs';
 
-const VERSION = '1.0.0';
+const VERSION = '1.1.0';
 
 // 全局提示词固定在用户主目录：官方加载器按 HOME/USERPROFILE 拼 .zcode/AGENTS.md，
 // 不读 ZCODE_DATA_BASE_DIR（数据根迁走时全局指令仍在原位）。
@@ -339,6 +339,15 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
         if (body && typeof body === 'object' && body.styles && typeof body.styles === 'object') {
           current.styles = applyStylesPartial(current.styles, body.styles);
         }
+        // 会话快捷切换的键位（设置 → 快捷键里修改）：键名固定，值限单个字母或数字
+        if (body && typeof body === 'object' && body.shortcuts && typeof body.shortcuts === 'object') {
+          const patch = {};
+          for (const k of ['switchLast', 'switchPrev', 'switchNext', 'switchRecent', 'switchAttention']) {
+            const v = body.shortcuts[k];
+            if (typeof v === 'string' && /^[a-z0-9]$/.test(v)) patch[k] = v;
+          }
+          current.shortcuts = { ...(current.shortcuts || {}), ...patch };
+        }
         if (body && typeof body === 'object' && body.titleGen && typeof body.titleGen === 'object') {
           current.titleGen = mergeTitleGenConfig({ ...current.titleGen, ...body.titleGen });
         }

package/src/inject/core.js

@@ -38,6 +38,16 @@ export async function getConfig(force = false) {
 }
 export function clearConfigCache() { configCache = { value: null, at: 0 }; }
 
+// 会话快捷切换的默认键位（按住 alt 再按）；settings 的“快捷键”标签页可改，
+// 配置存在 config.shortcuts，未写的项回退到这里
+export const DEFAULT_SHORTCUTS = {
+  switchLast: 'z',       // 立即切到上次会话
+  switchPrev: 'x',       // 弹窗中上移
+  switchNext: 'c',       // 弹窗中下移
+  switchRecent: 'e',     // 打开最近 10 条
+  switchAttention: 'r',  // 打开运行中 / 未查看
+};
+
 // —— ZCode 版本判断（按官方版本启用/停用功能）——
 // 版本来源：启动器从 app.asar 读出后写进 bootstrap（window.__ZCODEPRO__.zcodeVersion），
 // helper 的 /config 响应也附加同名字段。读不到时为空串，各判断保持旧行为。
@@ -190,7 +200,7 @@ const zh = {
   featureTaskOrder: '侧边栏会话拖动排序',
   featureTaskOrderDesc: '让置顶、项目与分组中的会话拖动后记住顺序，刷新后保持。',
   featureSessionSwitch: '会话快捷切换',
-  featureSessionSwitchDesc: 'alt+z 在当前与上次会话间来回切换；按住 alt 再按 x/c 弹出最近会话列表前后选择，松开 alt 切换（类 alt+tab）。',
+  featureSessionSwitchDesc: '{last} 在当前与上次会话间来回切换；按住 alt 再按 {prev}/{next} 弹出最近会话列表前后选择（初始 10 条，{next} 到底再加载 5 条），{recent} 直接打开最近 10 条，{attention} 打开运行中与运行完未查看的任务；方向键同样可选，Enter 或松开 alt 切换（类 alt+tab）',
   featureTitleLock: '重命名会话名锁定',
   featureTitleLockDesc: '手动重命名过的会话不再被自动标题覆盖：会话有新回答后界面可能改显自动标题，重启后又变回，本功能让侧栏始终显示重命名后的名字。',
   tabTitleGen: '任务名提示词',
@@ -218,7 +228,7 @@ const zh = {
   titleGenTestOk: '生成结果：',
   titleGenTestFailed: '生成失败',
   featureWsRunning: '折叠时任务运行中提示',
-  featureWsRunningDesc: '有会话在运行时，折叠的项目与“任务”“已置顶”等分区头显示与任务运行中同款的加载图标，全部结束后消失；3.16.1 之前每 60 秒会在后台短暂展开项目复核再收起。',
+  featureWsRunningDesc: '有会话在运行时，折叠的项目与“任务”“已置顶”等分区头显示与任务运行中同款的加载图标，全部结束后消失。',
   tabPerformance: '性能',
   perfDesc: 'ZCode 为每个打开过的项目常驻一个会话进程，应用自身不会回收，项目多了内存占用就高。开启后，长时间未使用且没有任务在跑的项目会被自动释放：会话记录不受影响，再次打开时自动恢复，仅首次回复有几秒等待。正在使用的项目、运行中的会话与后台命令、定时任务都不会被回收。后台命令检测依赖系统进程信息（Linux / macOS / Windows 各走系统自带工具），检测不可用时功能自动停用。',
   featureIdleReclaim: '空闲项目内存回收',
@@ -246,10 +256,40 @@ const zh = {
   userFontDesc: '会话中提问内容的字体；选“默认”时跟随界面字体。',
   assistantFontName: '回答字体',
   assistantFontDesc: '会话中回答正文的字体（代码块仍用等宽字体）；选“默认”时跟随界面字体。',
-  switcherHint: 'x / c 选择，松开 alt 切换，Esc 取消',
+  switcherHint: '{prev} / {next} 或 ↑ / ↓ 选择，Enter 或松开 alt 切换，Esc 取消',
   switcherCurrent: '当前',
   switcherEmpty: '暂无上次会话（切换过会话后可用）',
   switcherFailed: '未能切换到该会话（可能已删除）',
+  switcherMore: '还有 {n} 条 · 按 c 加载',
+  switcherRunning: '运行中',
+  switcherUnseen: '未查看',
+  switcherAttentionHint: '运行中 / 运行完未查看的任务 · {prev} / {next} 或 ↑ / ↓ 选择，Enter 或松开 alt 切换',
+  switcherAttentionEmpty: '暂无运行中或未查看的任务',
+  tabShortcuts: '快捷键',
+  hkTitle: '会话快捷切换',
+  hkAltZ: '在当前与上次使用的会话间来回切换',
+  hkAltX: '弹窗中上移高亮（更早的会话）',
+  hkAltC: '弹窗中下移高亮（更新的会话）；到底且还有更多时加载 5 条并选中新加载的第一条',
+  hkAltE: '打开最近 10 条任务列表',
+  hkAltR: '打开正在运行与运行完未查看的任务列表',
+  hkArrow: '弹窗打开时移动高亮（与 alt + {prev} / alt + {next} 同规则）',
+  hkEnter: '确认切换到高亮的会话',
+  hkEsc: '取消并关闭弹窗',
+  hkRelease: '移动过高亮时松开即切换；从未移动则弹窗保持打开，继续选择',
+  hkReleaseKey: '松开 alt',
+  hkModify: '修改',
+  hkRecording: '按下新键…',
+  hkInvalid: '快捷键只支持单个字母或数字',
+  hkConflict: 'alt+{k} 已用于“{name}”',
+  hkSaved: '快捷键已更新',
+  hkNameLast: '切换上次会话',
+  hkNamePrev: '上移高亮',
+  hkNameNext: '下移高亮',
+  hkNameRecent: '最近 10 条',
+  hkNameAttention: '运行中 / 未查看',
+  hkEditHint: '点击“修改”后按下新按键（字母或数字），Esc 取消',
+  hkReset: '重置为默认',
+  hkResetDone: '已恢复默认键位',
   featureFileActions: '文件菜单增强',
   featureFileActionsDesc: '在会话中文件链接的右键菜单里新增“默认应用打开”与“打开所在目录”。',
   featureImageCopy: '图片右键复制',
@@ -374,7 +414,7 @@ const zh = {
   headroomStoppedWarn: '代理已停止；指向 127.0.0.1 的供应商将无法连接',
   headroomBackend: '压缩设备',
   headroomBackendAuto: '自动 · 显卡优先',
-  headroomBackendCpu: 'CPU · 省电',
+  headroomBackendCpu: '省电 · CPU 优先',
   headroomBackendNative: '（原生值）',
   headroomBackendDesc: '自动：headroom 选最快设备（CUDA/MPS 显卡优先）；CPU：强制 CPU 压缩，省电且不占显存。也支持 headroom 原生值（onnx、pytorch_mps 等）。切换会重启代理立即生效。',
   headroomPower: '省电自动切换',
@@ -412,7 +452,7 @@ const zh = {
   aliasSaved: '别名已更新',
   aliasCleared: '已恢复真实名称',
   aliasHint: '磁盘目录名不变：终端、文件管理器与其他引用真实路径的界面仍显示原名。',
-  featureProjectMenuDescNew: '项目“更多”菜单中的切换文件夹、打开文件夹与复制路径。官方已支持修改项目名称（编辑项目），自定义别名已停用。',
+  featureProjectMenuDescNew: '项目“更多”菜单中的打开文件夹与复制路径。官方已支持修改项目名称（编辑项目），自定义别名已停用。',
   aliasMigrateTitle: '迁移项目别名',
   aliasMigrateDesc: '当前 ZCode 已支持修改项目名称（项目“更多”菜单 → 编辑项目），自定义别名功能已停用。可把已保存的别名写入官方项目名称，勾选要迁移的项目；迁移只改项目名称，磁盘目录不受影响。',
   aliasMigrateItemHint: '迁移后将作为项目名称保存（可随时在“编辑项目”中再改）。仅无标记的条目可勾选；已迁移、已并入、项目已删除、本机不存在（旧机器路径）以及项目已重命名的都不可勾选——要改这些项目的名字，直接用项目“更多”菜单里的“编辑项目”。',
@@ -581,7 +621,7 @@ const en = {
   featureTaskOrder: 'Sidebar session drag ordering',
   featureTaskOrderDesc: 'Makes session drags in Pinned, Projects and Groups persist across refreshes.',
   featureSessionSwitch: 'Session quick switch',
-  featureSessionSwitchDesc: 'alt+z toggles between the current and the last session; hold alt and press x/c to move the highlight across recently used sessions, release alt to switch (like alt+tab).',
+  featureSessionSwitchDesc: '{last} toggles between the current and the last session; hold alt and press {prev}/{next} to move the highlight across recently used sessions (10 shown initially, pressing {next} at the bottom loads 5 more), {recent} opens the last 10 directly, {attention} opens running / finished-but-unseen tasks; arrow keys also move the highlight, Enter or release alt to switch (like alt+tab)',
   featureTitleLock: 'Keep renamed session titles',
   featureTitleLockDesc: 'Sessions you renamed keep their custom title: after new replies the app may show an auto-generated title instead, which reverts after a restart; this keeps the renamed title in the sidebar.',
   tabTitleGen: 'Task name prompt',
@@ -609,7 +649,7 @@ const en = {
   titleGenTestOk: 'Result: ',
   titleGenTestFailed: 'Generation failed',
   featureWsRunning: 'Running indicator when collapsed',
-  featureWsRunningDesc: 'Shows the same spinning loader as running tasks on collapsed projects and on section headers (“Tasks”, “Pinned”) while any session is running; clears when they all finish. Before ZCode 3.16.1 the project is briefly re-expanded in the background every 60 s to re-check.',
+  featureWsRunningDesc: 'Shows the same spinning loader as running tasks on collapsed projects and on section headers (“Tasks”, “Pinned”) while any session is running; clears when they all finish.',
   tabPerformance: 'Performance',
   perfDesc: 'ZCode keeps a session process resident for every project you have opened and never reclaims it, so memory grows with projects. When enabled, projects unused for a while with nothing running release their memory automatically: sessions are untouched and reload when reopened, with a few seconds wait on the first reply. The project in use, running sessions, background commands and scheduled tasks are never reclaimed. Background-command detection reads system process info via built-in tools (Linux / macOS / Windows); when unavailable, the feature disables itself.',
   featureIdleReclaim: 'Idle project memory reclaim',
@@ -637,10 +677,40 @@ const en = {
   userFontDesc: 'Font of question text in conversations; "default" follows the UI font.',
   assistantFontName: 'Answer font',
   assistantFontDesc: 'Font of answer text in conversations (code blocks stay monospaced); "default" follows the UI font.',
-  switcherHint: 'x / c to choose, release alt to switch, Esc to cancel',
+  switcherHint: '{prev} / {next} or ↑ / ↓ to choose, Enter or release alt to switch, Esc to cancel',
   switcherCurrent: 'current',
   switcherEmpty: 'No previous session yet (available after you switch sessions)',
   switcherFailed: 'Failed to switch to that session (it may have been deleted)',
+  switcherMore: '{n} more · press c to load',
+  switcherRunning: 'running',
+  switcherUnseen: 'unseen',
+  switcherAttentionHint: 'Running / finished but unseen tasks · {prev} / {next} or ↑ / ↓ to choose, Enter or release alt to switch',
+  switcherAttentionEmpty: 'No running or unseen tasks',
+  tabShortcuts: 'Shortcuts',
+  hkTitle: 'Session quick switch',
+  hkAltZ: 'Toggle between the current and the last-used session',
+  hkAltX: 'Move the highlight up (earlier sessions) in the popup',
+  hkAltC: 'Move the highlight down (recent sessions); at the bottom it loads 5 more and highlights the first newly loaded entry',
+  hkAltE: 'Open the last 10 tasks',
+  hkAltR: 'Open running / finished-but-unseen tasks',
+  hkArrow: 'Move the highlight while the popup is open (same rules as alt + {prev} / alt + {next})',
+  hkEnter: 'Switch to the highlighted session',
+  hkEsc: 'Cancel and close the popup',
+  hkRelease: 'Releasing alt switches once the highlight has moved; otherwise the popup stays open for further selection',
+  hkReleaseKey: 'release alt',
+  hkModify: 'Change',
+  hkRecording: 'press a key…',
+  hkInvalid: 'Shortcuts accept a single letter or digit only',
+  hkConflict: 'alt+{k} is already used by "{name}"',
+  hkSaved: 'Shortcut updated',
+  hkNameLast: 'last session',
+  hkNamePrev: 'move up',
+  hkNameNext: 'move down',
+  hkNameRecent: 'last 10 tasks',
+  hkNameAttention: 'running / unseen',
+  hkEditHint: 'Click "Change", press a new key (letter or digit); Esc cancels',
+  hkReset: 'Reset to defaults',
+  hkResetDone: 'Shortcuts reset to defaults',
   featureFileActions: 'File menu actions',
   featureFileActionsDesc: 'Adds "Open with default app" and "Reveal in file manager" to the right-click menu of file links in chat.',
   featureImageCopy: 'Image right-click copy',
@@ -765,7 +835,7 @@ const en = {
   headroomStoppedWarn: 'Proxy stopped; providers pointing at 127.0.0.1 cannot connect.',
   headroomBackend: 'Compression device',
   headroomBackendAuto: 'Auto · GPU first',
-  headroomBackendCpu: 'CPU · power saving',
+  headroomBackendCpu: 'Power saving · CPU first',
   headroomBackendNative: ' (native)',
   headroomBackendDesc: 'Auto lets headroom pick the fastest device (CUDA/MPS); CPU forces CPU compression (power saving, no VRAM). Native headroom values (onnx, pytorch_mps, …) also work. Switching restarts the proxy to apply.',
   headroomPower: 'Power-save auto switch',
@@ -803,7 +873,7 @@ const en = {
   aliasSaved: 'Alias updated.',
   aliasCleared: 'Real name restored.',
   aliasHint: 'The directory name on disk is unchanged: terminals, file managers and other path-based UI still show the real name.',
-  featureProjectMenuDescNew: 'Switch folder, open folder and copy path in the project "More" menu. Renaming is built in since ZCode 3.16.1 ("Edit project"), so the custom alias is retired.',
+  featureProjectMenuDescNew: 'Open folder and copy path in the project "More" menu. Renaming is built in since ZCode 3.16.1 ("Edit project"), so the custom alias is retired.',
   aliasMigrateTitle: 'Migrate project aliases',
   aliasMigrateDesc: 'This ZCode supports renaming projects (project "More" menu → Edit project), so the custom alias feature is retired. Write your saved aliases into the official project names by picking the projects below; only the project name changes, folders on disk are untouched.',
   aliasMigrateItemHint: 'The alias becomes the project name (re-editable anytime via "Edit project"). Only unmarked entries can be checked; migrated, merged, deleted, not-on-this-machine and manually-renamed ones cannot — to rename those projects, use "Edit project" in the project "More" menu directly.',

package/src/inject/features/sandbox-reclaim.js

@@ -0,0 +1,121 @@
+// 插件界面沙箱回收：宿主为每个插件交互卡片（识图卡片、压缩记录、评审面板等）
+// 保留一个沙箱，全局上限 64 个（主进程注册表与窗口页面管理器各一道闸），已卸下
+// 的名额默认要等 6 小时 TTL 才自动回收——多卡片会话很快把名额耗尽，之后所有新
+// 卡片报“插件界面数量已达上限”。本功能平时不动作，只在沙箱数量达到上限
+//（sandboxReclaimBudget，默认 60，8–64；留少量余量，避免新卡片抢名额时恰好撞上
+// 64 硬上限）时，调用官方桥 window.zcodePluginSandbox.disposeSandbox 释放最早
+// 创建的沙箱，把数量压回上限以下：被释放的卡片位置退回占位（可能显示已停止
+// 提示），重新打开所在会话即恢复，会话文本内容不受影响。
+//
+// 驱逐顺序：最早创建的优先，但可见的（正在查看的卡片）排最后——先在不可见
+// 沙箱里挑最早的；全部可见时才动最早创建的可见沙箱。
+//
+// 观察手段均为宿主稳定标识，不依赖压缩后的内部变量名：
+// 1) window 消息 zcode:plugin-sandbox-ports：沙箱端口建立时广播 {sandboxId, initId}；
+// 2) webview[data-zcode-retained-sandbox]：src 含 /instance/<sandboxId>/；
+// 3) 可见性：webview 所在页根 div[data-sandbox-page-root] 的 opacity——展示中的
+//    页根 opacity:1 且按卡片占位几何摆放；卡片切走/滚下后宿主把页根收进停靠区
+//   （[data-sandbox-page-parking] 下，opacity:0.001 + inert 或 display:none）。
+//    页根是固定定位、DOM 挂载点与视觉位置解耦，不能按父容器判断可见性。
+//
+// 窗口最小化/后台不改变布局尺寸，可见性判定不受影响（最小化期间不驱逐）。
+// 开关：features.sandboxReclaim（默认开）。
+import { getConfig } from '../core.js';
+
+const CHECK_MS = 30_000;       // 巡检周期
+const MIN_BUDGET = 8;
+const MAX_BUDGET = 64;
+const RETRY_COOLDOWN_MS = 10 * 60_000;  // 同一沙箱释放失败后的重试冷却
+
+const seen = new Map();     // sandboxId → { initId, firstSeen }
+const cooldown = new Map(); // sandboxId → 释放失败冷却截止时刻
+let disabledLogged = false;
+
+function onPortsMessage(e) {
+  const d = e.data;
+  if (!d || d.type !== 'zcode:plugin-sandbox-ports' || typeof d.sandboxId !== 'string') return;
+  // 端口广播≈沙箱创建时刻；页面刷新后宿主按幂等键复用同一沙箱并再次广播，
+  // 创建时刻随之刷新（视作新名额重新排队）
+  seen.set(d.sandboxId, { initId: Number(d.initId) || 0, firstSeen: Date.now() });
+}
+
+function extractSandboxId(wv) {
+  const m = /instance\/(sb-[0-9a-f]+)\//.exec(wv.getAttribute('src') || '');
+  return m ? m[1] : null;
+}
+
+// 展示中的页根 opacity:1 且按卡片占位几何摆放；停靠保活的页根 opacity:0.001 +
+// inert（或 display:none）。宿主用固定定位按占位几何摆放页根，DOM 挂载点不代表
+// 视觉位置（可见卡片的页根也可能挂在停靠容器下），因此按 opacity 与布局判定
+function isVisible(wv) {
+  const root = wv.closest('[data-sandbox-page-root]');
+  if (!root) return wv.getClientRects().length > 0;
+  if (!root.getClientRects().length) return false;
+  return Number(getComputedStyle(root).opacity) > 0.5;
+}
+
+async function tick() {
+  const cfg = await getConfig();
+  if ((cfg.features || {}).sandboxReclaim === false) {
+    seen.clear();
+    return;
+  }
+  // 沙箱桥只在宿主主窗口存在（guest 沙箱页与旧版宿主没有）：不在时静默跳过
+  const bridge = window.zcodePluginSandbox;
+  if (!bridge || typeof bridge.disposeSandbox !== 'function') {
+    if (!disabledLogged) {
+      disabledLogged = true;
+      console.info('[zcodepro] sandbox-reclaim: 当前窗口无 zcodePluginSandbox 桥，沙箱回收跳过');
+    }
+    return;
+  }
+  let budget = Number(cfg.sandboxReclaimBudget);
+  if (!Number.isFinite(budget)) budget = 60;
+  budget = Math.min(MAX_BUDGET, Math.max(MIN_BUDGET, budget));
+
+  const now = Date.now();
+  const live = new Map(); // sandboxId → 是否可见
+  for (const wv of document.querySelectorAll('webview[data-zcode-retained-sandbox]')) {
+    const id = extractSandboxId(wv);
+    if (id) live.set(id, isVisible(wv));
+  }
+  // 端口广播登记过但 DOM 已无对应 webview 的条目（guest 已销毁）：清掉，防 Map 无限增长
+  for (const id of [...seen.keys()]) {
+    if (!live.has(id)) seen.delete(id);
+  }
+  // 重注入后端口广播没赶上（Map 为空）的兜底：首次观察到时按现在起算创建时刻
+  for (const id of live.keys()) {
+    if (!seen.has(id)) seen.set(id, { initId: undefined, firstSeen: now });
+  }
+
+  while (live.size > budget) {
+    // 驱逐顺序：不可见的按创建时间最早的 → 全可见时最早的可见沙箱
+    const candidates = [...live.entries()]
+      .filter(([id]) => (cooldown.get(id) || 0) <= now)
+      .sort((a, b) => (a[1] - b[1]) || ((seen.get(a[0]) || {}).firstSeen || 0) - ((seen.get(b[0]) || {}).firstSeen || 0));
+    if (!candidates.length) break;
+    const [id] = candidates[0];
+    const entry = seen.get(id);
+    try {
+      await bridge.disposeSandbox(id, entry && entry.initId);
+      console.info('[zcodepro] sandbox-reclaim: 沙箱满 ' + live.size + ' 个，已驱逐最早的 ' + id);
+    } catch (err) {
+      console.warn('[zcodepro] sandbox-reclaim: 释放失败 ' + id, err);
+    }
+    seen.delete(id);
+    live.delete(id);
+    cooldown.set(id, now + RETRY_COOLDOWN_MS);
+  }
+  if (cooldown.size > 256) {
+    for (const [k, v] of cooldown) {
+      if (v <= now) cooldown.delete(k);
+    }
+  }
+}
+
+export function startSandboxReclaim() {
+  window.addEventListener('message', onPortsMessage);
+  const loop = () => { tick().catch(() => { /* 单次巡检失败不影响后续 */ }); };
+  loop();
+  setInterval(loop, CHECK_MS);
+}

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 到别的应用等）视同取消