zcode-pro 0.16.0__py3-none-any.whl

zcode_pro/app/src/inject/features/image-menu.js

@@ -0,0 +1,215 @@
+// 图片右键“复制图片”：覆盖会话内容列（[data-v4-timeline-content-column]）里的图片与
+// 点击放大的预览弹窗（role=dialog 内的大图），复制到系统剪贴板。
+// 按渲染尺寸过滤行内技术图标（material-icons 约 16px）；blob:/data:/file: 源经 fetch 取 blob，
+// 取不到回退 canvas，非 PNG 一律经 canvas 转 PNG（剪贴板只可靠支持 image/png）。
+import { h, t, getConfig } from '../core.js';
+import { showToast } from '../ui.js';
+
+const MIN_SIZE = 48; // 过滤行内小图标（真实截图/照片远大于此值）
+
+// 复制目标判定：target 是会话内容列或弹窗内的 <img> 且渲染尺寸达标。
+// 预览大图上方常有透明交互层（缩放/拖拽捕获），右键的 target 不是 img 本身，
+// 此时在弹窗内按坐标找被命中的图片（取面积最大者，避免命中角落装饰图）。
+function copyTargetOf(el, x, y) {
+  const sizeOk = (img) => {
+    const r = img.getBoundingClientRect();
+    return Math.min(r.width, r.height) >= MIN_SIZE;
+  };
+  if (el instanceof HTMLImageElement) {
+    if (!el.closest('[data-v4-timeline-content-column]') && !el.closest('[role="dialog"]')) return null;
+    return sizeOk(el) ? el : null;
+  }
+  if (!(el instanceof Element)) return null;
+  const dialog = el.closest('[role="dialog"]');
+  if (!dialog) return null;
+  let best = null;
+  for (const img of dialog.querySelectorAll('img')) {
+    const r = img.getBoundingClientRect();
+    if (x < r.left || x > r.right || y < r.top || y > r.bottom) continue;
+    if (!sizeOk(img)) continue;
+    const area = r.width * r.height;
+    if (!best || area > best.area) best = { img, area };
+  }
+  return best ? best.img : null;
+}
+
+let menuEl = null;
+let hideMenu = () => {};
+
+function showMenu(x, y, img) {
+  hideMenu();
+  const L = t();
+  // 菜单打开时就预取图片数据：点击复制时若图片已被卸载（如弹窗关闭）仍可完成
+  const preBlob = fetchImageBlob(img);
+  menuEl = h('div', {
+    role: 'menu',
+    class: 'fixed rounded-xl border border-border bg-menu p-1 text-ui-sm text-foreground',
+    style: 'z-index:2147483000;min-width:9rem;box-shadow:0 10px 30px rgba(0,0,0,.18);pointer-events:auto',
+  },
+    h('div', {
+      role: 'menuitem',
+      tabindex: '0',
+      class: 'zcodepro-imgmenu-item flex cursor-pointer select-none items-center gap-2 rounded-lg px-2.5 py-1.5',
+      onClick: () => {
+        hideMenu();
+        void copyImage(img, preBlob);
+      },
+    },
+      hCopyIcon(),
+      document.createTextNode(L.imageCopy)));
+  document.body.append(menuEl);
+  const r = menuEl.getBoundingClientRect();
+  menuEl.style.left = Math.max(8, Math.min(x, window.innerWidth - r.width - 8)) + 'px';
+  menuEl.style.top = Math.max(8, Math.min(y, window.innerHeight - r.height - 8)) + 'px';
+
+  const onPointerDown = (e) => {
+    if (menuEl && menuEl.contains(e.target)) {
+      // 菜单内的按下交给菜单项自身 click 处理；stopPropagation 防止预览弹窗
+      // （Radix“点击外部关闭”）连带关闭、图片被卸载导致复制落空
+      e.stopPropagation();
+      return;
+    }
+    e.preventDefault();
+    e.stopPropagation();
+    hideMenu();
+  };
+  const onKeyDown = (e) => {
+    if (e.key !== 'Escape') return;
+    e.preventDefault();
+    hideMenu(); // 只负责收起菜单；预览弹窗自身的 Esc 关闭不受影响
+  };
+  hideMenu = () => {
+    if (menuEl) { menuEl.remove(); menuEl = null; }
+    window.removeEventListener('blur', hideMenu);
+    window.removeEventListener('resize', hideMenu);
+    document.removeEventListener('scroll', hideMenu, true);
+    document.removeEventListener('pointerdown', onPointerDown, true);
+    document.removeEventListener('keydown', onKeyDown, true);
+    hideMenu = () => {};
+  };
+  window.addEventListener('blur', hideMenu);
+  window.addEventListener('resize', hideMenu);
+  document.addEventListener('scroll', hideMenu, true);
+  document.addEventListener('pointerdown', onPointerDown, true);
+  document.addEventListener('keydown', onKeyDown, true);
+}
+
+// 取图片二进制：blob:/data:/file: 源走 fetch，失败或非图片时回退 canvas
+async function fetchImageBlob(img) {
+  const src = img.currentSrc || img.src || '';
+  if (src) {
+    try {
+      const resp = await fetch(src);
+      if (resp.ok) {
+        const blob = await resp.blob();
+        if (/^image\//.test(blob.type)) return blob;
+      }
+    } catch { /* 跨域等场景回退 canvas */ }
+  }
+  return await fromCanvas(img);
+}
+
+async function copyImage(img, preBlob) {
+  const L = t();
+  try {
+    let blob = await (preBlob || fetchImageBlob(img));
+    if (!blob) throw new Error('empty image');
+    if (blob.type !== 'image/png') blob = await toPng(blob);
+    await navigator.clipboard.write([new ClipboardItem({ 'image/png': blob })]);
+    showToast(L.imageCopied);
+  } catch {
+    // 部分 Electron/Linux 组合上 navigator.clipboard 写图片报 DataError（写文本正常），
+    // 回退 execCommand：选中 <img> 后复制，Chromium 会把图片本体写入剪贴板
+    if (copyViaSelection(img)) showToast(L.imageCopied);
+    else showToast(L.imageCopyFailed, 'error');
+  }
+}
+
+function copyViaSelection(img) {
+  try {
+    // 预览大图带 select-none（user-select:none），复制期间临时改为可选中
+    const prevSelect = img.style.userSelect;
+    img.style.userSelect = 'text';
+    const range = document.createRange();
+    range.selectNode(img);
+    const sel = window.getSelection();
+    const saved = sel.rangeCount > 0 ? sel.getRangeAt(0) : null;
+    sel.removeAllRanges();
+    sel.addRange(range);
+    const ok = document.execCommand('copy');
+    sel.removeAllRanges();
+    if (saved) sel.addRange(saved);
+    img.style.userSelect = prevSelect;
+    return ok;
+  } catch {
+    return false;
+  }
+}
+
+// 从已渲染的 img 直接画 canvas（同源/blob/data 图片可用；跨域图片会因画布污染失败）
+function fromCanvas(img) {
+  return new Promise((resolve) => {
+    try {
+      const c = document.createElement('canvas');
+      c.width = img.naturalWidth || 0;
+      c.height = img.naturalHeight || 0;
+      if (!c.width || !c.height) { resolve(null); return; }
+      c.getContext('2d').drawImage(img, 0, 0);
+      c.toBlob((b) => resolve(b), 'image/png');
+    } catch {
+      resolve(null);
+    }
+  });
+}
+
+async function toPng(blob) {
+  const bmp = await createImageBitmap(blob);
+  const c = document.createElement('canvas');
+  c.width = bmp.width;
+  c.height = bmp.height;
+  c.getContext('2d').drawImage(bmp, 0, 0);
+  const png = await new Promise((resolve) => c.toBlob(resolve, 'image/png'));
+  if (!png) throw new Error('png convert failed');
+  return png;
+}
+
+function hCopyIcon() {
+  const ns = 'http://www.w3.org/2000/svg';
+  const svg = document.createElementNS(ns, 'svg');
+  svg.setAttribute('viewBox', '0 0 24 24');
+  svg.setAttribute('fill', 'none');
+  svg.setAttribute('stroke', 'currentColor');
+  svg.setAttribute('stroke-width', '2');
+  svg.setAttribute('stroke-linecap', 'round');
+  svg.setAttribute('stroke-linejoin', 'round');
+  svg.setAttribute('class', 'size-4 shrink-0 text-foreground-subtle');
+  const rect = document.createElementNS(ns, 'rect');
+  rect.setAttribute('width', '14');
+  rect.setAttribute('height', '14');
+  rect.setAttribute('x', '8');
+  rect.setAttribute('y', '8');
+  rect.setAttribute('rx', '2');
+  rect.setAttribute('ry', '2');
+  svg.append(rect);
+  const p = document.createElementNS(ns, 'path');
+  p.setAttribute('d', 'M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2');
+  svg.append(p);
+  return svg;
+}
+
+export function startImageMenu() {
+  if (typeof window === 'undefined') return;
+  if (typeof navigator.clipboard?.write !== 'function' || typeof window.ClipboardItem === 'undefined') return;
+  // preventDefault 必须同步做，功能开关用最近一次配置结果判断（右键时顺带刷新）
+  let enabled = true;
+  const refresh = () => { void getConfig().then((c) => { enabled = !(c.features && c.features.imageCopy === false); }); };
+  refresh();
+  document.addEventListener('contextmenu', (e) => {
+    if (e.defaultPrevented) return;
+    const img = copyTargetOf(e.target, e.clientX, e.clientY);
+    if (!img) return;
+    e.preventDefault();
+    if (enabled) showMenu(e.clientX, e.clientY, img);
+    refresh();
+  }, true);
+}

zcode_pro/app/src/inject/features/open-folder.js

@@ -0,0 +1,43 @@
+// “打开文件夹”：项目“更多”菜单中在系统文件管理器里打开项目目录。
+// 走 helper /open-folder：三平台行为一致（宿主桥 openInFileManager 在 macOS 是定位而非打开）。
+import { h, t, rpc, closeRadixMenu } from '../core.js';
+
+export function appendOpenFolderItem(menu, anchorItem, project) {
+  if (menu.querySelector('[data-zcodepro-item="open-folder"]')) return;
+  const L = t();
+  const item = anchorItem.cloneNode(true);
+  item.removeAttribute('data-testid');
+  item.removeAttribute('data-highlighted');
+  item.setAttribute('data-zcodepro-item', 'open-folder');
+  for (const child of [...item.childNodes]) child.remove();
+  const origIcon = anchorItem.querySelector('svg');
+  const iconClass = origIcon ? origIcon.getAttribute('class') : 'h-3.5 w-3.5';
+  item.append(hFolderIcon(iconClass), document.createTextNode(L.openFolderItem));
+  item.addEventListener('mouseenter', () => {
+    for (const el of menu.querySelectorAll('[role="menuitem"]')) el.removeAttribute('data-highlighted');
+    item.setAttribute('data-highlighted', '');
+  });
+  item.addEventListener('mouseleave', () => item.removeAttribute('data-highlighted'));
+  item.addEventListener('click', () => {
+    closeRadixMenu(menu);
+    try { void rpc('/open-folder', { method: 'POST', body: { path: project.path } }); } catch { /* ignore */ }
+  });
+  anchorItem.before(item);
+}
+
+function hFolderIcon(cls) {
+  const ns = 'http://www.w3.org/2000/svg';
+  const svg = document.createElementNS(ns, 'svg');
+  svg.setAttribute('viewBox', '0 0 24 24');
+  svg.setAttribute('fill', 'none');
+  svg.setAttribute('stroke', 'currentColor');
+  svg.setAttribute('stroke-width', '2');
+  svg.setAttribute('stroke-linecap', 'round');
+  svg.setAttribute('stroke-linejoin', 'round');
+  svg.setAttribute('class', cls);
+  // lucide folder
+  const p = document.createElementNS(ns, 'path');
+  p.setAttribute('d', 'M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 0-1.69.9l-.58.87A2 2 0 0 1 8.93 8H4a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2Z');
+  svg.append(p);
+  return svg;
+}

zcode_pro/app/src/inject/features/pinned-collapse.js

@@ -0,0 +1,132 @@
+// 已置顶分区可折叠：原生侧栏“项目”“分组”的分区头是可折叠按钮（悬停显现
+// chevron），“已置顶”只是静态标题。本功能把该标题变成同样的折叠开关：
+// 标题内追加自有 chevron 按钮、整行可点，折叠时藏起分区里的任务列表；
+// 状态记在 localStorage，界面重渲染后由观察器自动补回。不增删应用节点
+// 结构（往标题里插外来子节点与顶栏图标按钮同理，界面框架不排斥）。
+import { h, t, getConfig } from '../core.js';
+import { ensureStyle } from '../ui.js';
+
+const COLLAPSED_CLASS = 'zcodepro-pin-collapsed';
+const HEAD_CLASS = 'zcodepro-pin-head';
+const STORE_KEY = 'zcodepro:pinned-collapsed';
+const SYNC_DEBOUNCE_MS = 300;   // 相关 DOM 变动后的去抖
+const SCAN_FALLBACK_MS = 5000;  // 兜底轮询周期
+
+let enabled = true;   // 配置开关（features.pinnedCollapse !== false）
+let syncTimer = 0;
+
+// 已置顶标题的识别不依赖文案（跟随界面语言）：h3 的下一个兄弟是含任务行的列表
+function findPinnedHeader() {
+  for (const h3 of document.querySelectorAll('h3')) {
+    const ul = h3.nextElementSibling;
+    if (ul && ul.tagName === 'UL' && ul.querySelector('li[data-task-item-key]')) return h3;
+  }
+  return null;
+}
+
+function chevronSvg() {
+  // 优先克隆应用“项目”分区头的 chevron（应用改图标自动跟随），取不到再内建
+  const proto = document.querySelector('svg[data-purpose-section-chevron]');
+  if (proto) {
+    const clone = proto.cloneNode(true);
+    clone.removeAttribute('class');
+    clone.removeAttribute('data-purpose-section-chevron');
+    return clone;
+  }
+  const ns = 'http://www.w3.org/2000/svg';
+  const svg = document.createElementNS(ns, 'svg');
+  svg.setAttribute('viewBox', '0 0 24 24');
+  svg.setAttribute('fill', 'none');
+  svg.setAttribute('stroke', 'currentColor');
+  svg.setAttribute('stroke-width', '1.5');
+  svg.setAttribute('stroke-linecap', 'round');
+  svg.setAttribute('stroke-linejoin', 'round');
+  const path = document.createElementNS(ns, 'path');
+  path.setAttribute('d', 'm6 9 6 6 6-6');
+  svg.append(path);
+  return svg;
+}
+
+function isCollapsed() {
+  try { return localStorage.getItem(STORE_KEY) === '1'; } catch { return false; }
+}
+
+function toggle() {
+  try { localStorage.setItem(STORE_KEY, isCollapsed() ? '0' : '1'); } catch { /* ignore */ }
+  apply();
+}
+
+function apply() {
+  const h3 = findPinnedHeader();
+  if (!h3) return false;
+  const sect = h3.parentElement;
+  const collapsed = isCollapsed();
+  sect.classList.toggle(COLLAPSED_CLASS, collapsed);
+  const existing = h3.querySelector('.zcodepro-pin-chevron');
+  if (h3.classList.contains(HEAD_CLASS) && existing) {
+    existing.setAttribute('aria-expanded', collapsed ? 'false' : 'true');
+    return true;
+  }
+  h3.classList.add(HEAD_CLASS);
+  // 整行可点（与“项目”分区头一致）；开关禁用后旧监听变空转，无需摘除
+  h3.addEventListener('click', () => { if (enabled) toggle(); });
+  const btn = h('button', {
+    type: 'button',
+    class: 'zcodepro-pin-chevron',
+    'aria-label': t().pinnedToggleAria,
+    'aria-expanded': collapsed ? 'false' : 'true',
+    onClick: (e) => { e.stopPropagation(); if (enabled) toggle(); },
+  });
+  btn.append(chevronSvg());
+  h3.append(btn);
+  return true;
+}
+
+function sync() {
+  if (enabled) apply();
+}
+
+function scheduleSync() {
+  if (syncTimer) return;
+  syncTimer = setTimeout(() => { syncTimer = 0; sync(); }, SYNC_DEBOUNCE_MS);
+}
+
+// 侧栏相关变动才重扫：分区/任务行的新增删除（重渲染、切分组/项目视图）
+function relevantMutations(muts) {
+  for (const m of muts) {
+    for (const list of [m.addedNodes, m.removedNodes]) {
+      for (const n of list) {
+        if (!(n instanceof Element)) continue;
+        if (n.tagName === 'H3' || n.matches('li[data-task-item-key]')
+          || n.querySelector('h3, li[data-task-item-key]')) return true;
+      }
+    }
+  }
+  return false;
+}
+
+function teardown() {
+  for (const h3 of document.querySelectorAll('.' + HEAD_CLASS)) {
+    h3.classList.remove(HEAD_CLASS);
+    h3.querySelector('.zcodepro-pin-chevron')?.remove();
+    h3.parentElement?.classList.remove(COLLAPSED_CLASS);
+  }
+}
+
+async function refreshConfig() {
+  // 强制拉取：配置可能经设置弹窗以外的途径改动（缓存 3 秒内会是旧值）
+  const cfg = await getConfig(true).catch(() => null);
+  enabled = !cfg || !cfg.features || cfg.features.pinnedCollapse !== false;
+  if (enabled) sync();
+  else teardown();
+}
+
+export function startPinnedCollapse() {
+  ensureStyle();
+  window.addEventListener('zcodepro:config-changed', () => { void refreshConfig(); });
+  void refreshConfig();
+  new MutationObserver((muts) => { if (relevantMutations(muts)) scheduleSync(); })
+    .observe(document.body, { childList: true, subtree: true });
+  setInterval(() => { if (!document.hidden) sync(); }, SCAN_FALLBACK_MS);
+  document.addEventListener('visibilitychange', () => { if (!document.hidden) sync(); });
+}

zcode_pro/app/src/inject/features/pinned-expand.js

@@ -0,0 +1,142 @@
+// 置顶会话展开抑制（v4，实验性）：
+// 已知缺陷：无法真正拦截展开（store 在应用闭包内不可达，渲染层无拦截点），
+// 只能在展开发生后收起，因此视觉上“先展开再缩起”，大会话期间可能闪烁。
+
+// 点击折叠项目的置顶会话时，应用展开该项目；且会话内容加载完成（正文渲染）后还会再展开一次。
+// 固定延时不可靠（会话有大有小：空白时就收起会被“内容出现后的二次展开”覆盖）。
+// v4 改为事件驱动：点击后开始监听该项目的 DOM 变化，
+// 以“会话区渲染出实质内容（文本节点增多/任务行出现）且短暂稳定”作为加载完成信号，
+// 之后若项目仍展开则收起；最长等待 15s 兜底。
+// 开关：helper pinnedKeepCollapsed（默认 true = 保持折叠，增强）。
+import { rpc } from '../core.js';
+
+let installed = false;
+let keepCollapsed = false; // 默认关闭：实现为“先展开再缩起”，有闪烁（应用无拦截点，详见文件头）
+
+const CONFIG_POLL_MIN_MS = 5000;   // 配置未变化时逐次拉长轮询间隔，减轻常驻开销
+const CONFIG_POLL_MAX_MS = 60000;
+let pollMs = CONFIG_POLL_MIN_MS;
+
+// 返回本次请求是否改变了开关值（用于轮询间隔回弹）
+async function refreshConfig() {
+  try {
+    const res = await rpc('/config');
+    if (res && res.ok && res.config && res.config.features) {
+      const next = res.config.features.pinnedKeepCollapsed !== false;
+      if (next !== keepCollapsed) {
+        keepCollapsed = next;
+        return true;
+      }
+    }
+  } catch { /* helper 未就绪时保持默认 */ }
+  return false;
+}
+
+// 自适应轮询：值未变化间隔 ×1.5 直至上限，变化即回到最短；页面隐藏时跳过请求
+function pollConfig() {
+  setTimeout(async () => {
+    if (document.hidden) pollMs = CONFIG_POLL_MAX_MS;
+    else pollMs = (await refreshConfig()) ? CONFIG_POLL_MIN_MS : Math.min(Math.round(pollMs * 1.5), CONFIG_POLL_MAX_MS);
+    pollConfig();
+  }, pollMs);
+}
+
+export function startPinnedExpandSuppression() {
+  if (installed || typeof document === 'undefined') return;
+  installed = true;
+  void refreshConfig();
+  pollConfig();
+  // 回到前台立即补一次，避免长退避期间拿不到刚改的配置
+  document.addEventListener('visibilitychange', () => { if (!document.hidden) void refreshConfig(); });
+
+  document.addEventListener('click', (e) => {
+    if (!keepCollapsed) return;
+    const taskRow = e.target.closest && e.target.closest('[data-testid^="task-item-"]');
+    if (!taskRow) return;
+    const key = taskRow.getAttribute('data-task-item-key') || '';
+    const sep = key.lastIndexOf(':');
+    if (sep <= 0) return;
+    const wsKey = key.slice(0, sep);
+    const wsRow = document.querySelector(`[data-testid="workspace-item-${cssEscape(wsKey)}"]`);
+    if (!wsRow || wsRow.getAttribute('aria-expanded') !== 'false') return;
+
+    const head = wsRow.matches('[aria-expanded]') ? wsRow : wsRow.querySelector('[aria-expanded]');
+    if (!head) return;
+    // 等会话加载完成（内容渲染且稳定）后再收起
+    collapseAfterContentLoaded(wsRow);
+  }, true);
+
+  // 用户点项目行头部 = 主动展开，永不干预（事件捕获，先于应用处理）
+  document.addEventListener('click', (e) => {
+    const row = e.target.closest && e.target.closest('[data-testid^="workspace-item-"]');
+    if (row) row.__zcodeproUserTouched = Date.now();
+  }, true);
+}
+
+// 收起用的点击必须点回当前会话：应用把项目行点击当作“切换到该项目”，只点项目行
+// 会把当前会话取消选中、主视图跳进新建任务。还原行必须在点项目行之前就记住——
+// 点击会立刻取消选中（3.14.4 实测），事后再按选中标记找就找不到了，回点落空
+// 会把视图留在该项目的新会话页；元素被 React 重挂载时按记住的会话键重找。
+function currentTaskRow() {
+  for (const el of document.querySelectorAll('[data-task-item-key]')) {
+    if ((el.className + '').includes('bg-selected')) return el;
+  }
+  return null;
+}
+function collapseNavSafe(head) {
+  const cur = currentTaskRow();
+  const backKey = cur ? cur.getAttribute('data-task-item-key') : '';
+  head.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true }));
+  if (!backKey) return;
+  const back = (cur && cur.isConnected)
+    ? cur
+    : document.querySelector(`[data-task-item-key="${cssEscape(backKey)}"]`);
+  if (back) back.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true }));
+}
+
+// 实测时序（探针 v2）：点击后 ~6s 出现第一次自动展开并被收起；
+// 正文文字在点击后 ~8-14s 才开始增长，期间应用还会再次展开项目。
+// 因此收起不能是单次动作：在 25s 监听期内持续压制（发现展开即收起），
+// 直到“正文出现增长且稳定 1s”（会话真正加载完成）后再做最后一次收起并结束。
+function collapseAfterContentLoaded(wsRow) {
+  const deadline = Date.now() + 25000;
+  let lastLen = (document.querySelector('main') || document.body).innerText.length;
+  let grewAt = 0;
+  let settledAt = 0;
+
+  const headOf = () => {
+    const h = wsRow.matches('[aria-expanded]') ? wsRow : wsRow.querySelector('[aria-expanded]');
+    return h || null;
+  };
+  const userTouched = () => wsRow.__zcodeproUserTouched && Date.now() - wsRow.__zcodeproUserTouched < 800;
+
+  const tick = () => {
+    if (!keepCollapsed || Date.now() > deadline || !wsRow.isConnected) return done();
+    const len = (document.querySelector('main') || document.body).innerText.length;
+    if (len > lastLen) grewAt = Date.now();          // 正文开始/持续增长
+    if (grewAt && Date.now() - grewAt >= 1000) settledAt = settledAt || Date.now(); // 增长后稳定 1s
+    lastLen = len;
+
+    const head = headOf();
+    // 持续压制：监听期内任何展开都收起（用户刚点过头部则跳过）
+    if (head && head.getAttribute('aria-expanded') === 'true' && !userTouched()) {
+      collapseNavSafe(head);
+    }
+    // 结束条件：正文已增长且稳定 1s（此时收起已完成）——再做最后一次确认收起
+    if (settledAt && Date.now() - settledAt >= 1000) {
+      const h2 = headOf();
+      if (h2 && h2.getAttribute('aria-expanded') === 'true' && !userTouched()) {
+        collapseNavSafe(h2);
+      }
+      return done();
+    }
+    setTimeout(tick, 200);
+  };
+  const done = () => { wsRow.__zcodeproSuppending = false; };
+  wsRow.__zcodeproSuppending = true;
+  setTimeout(tick, 400);
+}
+
+function cssEscape(s) {
+  return String(s).replace(/(["\\\]])/g, '\\$1');
+}

zcode_pro/app/src/inject/features/plugin-updates.js

@@ -0,0 +1,28 @@
+// 启动时检查 duanluan-zcode-plugins 市场的插件更新：
+// 有新版本 → 开了“自动更新插件”直接更新，否则 toast 提醒一次（同一批更新只提醒一次）。
+// 实际的 marketplace 同步与安装/更新都由 helper 的 /plugins/* 端点执行。
+import { rpc, getConfig, t } from '../core.js';
+import { showToast } from '../ui.js';
+
+const NOTIFIED_KEY = 'zcodepro-plugin-updates-notified';
+
+export async function startPluginUpdateCheck() {
+  const status = await rpc('/plugins/status');
+  if (!status.ok || !Array.isArray(status.updates)) return;
+  const L = t();
+  if (status.updates.length === 0) return;
+
+  const config = await getConfig();
+  if ((config.features || {}).autoUpdatePlugins === true) {
+    const res = await rpc('/plugins/update', { method: 'POST', body: { installMissing: true } });
+    if (res.ok) showToast(L.pluginsAutoUpdated, 'success');
+    else showToast(L.pluginsUpdateFailed + ': ' + (res.error || ''), 'error');
+    return;
+  }
+  const sig = status.updates.map((u) => `${u.name}:${u.installed}>${u.latest}`).join(',');
+  let seen = '';
+  try { seen = window.localStorage.getItem(NOTIFIED_KEY) || ''; } catch { /* ignore */ }
+  if (seen === sig) return;
+  try { window.localStorage.setItem(NOTIFIED_KEY, sig); } catch { /* ignore */ }
+  showToast(L.pluginsUpdatesAvailable.replaceAll('{n}', String(status.updates.length)), 'info');
+}

zcode_pro/app/src/inject/features/project-menu.js

@@ -0,0 +1,58 @@
+// 功能二：项目“更多”下拉菜单中新增“自定义别名”。
+// 识别方式：菜单内存在带 data-testid（值中含项目绝对路径）且文案为“移除/Remove”的菜单项。
+// 项目路径优先从 data-testid 提取；提取失败时回退为按项目名匹配 helper 返回的最近项目列表。
+import { rpc, getConfig, itemsOf, itemText } from '../core.js';
+import { appendAliasItem } from './alias.js';
+import { appendRelocateItem } from './relocate-dialog.js';
+import { appendOpenFolderItem } from './open-folder.js';
+import { appendCopyPathItem } from './copy-path.js';
+
+const REMOVE_TEXTS = ['移除', 'Remove'];
+
+// data-testid 实测格式为 "<前缀>-<绝对路径>"（如 workspace-close-/home/x/y），
+// 也兼容 ":"、"=" 等分隔符与 Windows 盘符路径。
+function extractPathFromTestId(testid) {
+  let m = testid.match(/[-:=,|](\/.+)$/); // Unix 绝对路径
+  if (m) return m[1];
+  m = testid.match(/[-:=,|]([A-Za-z]:\\.*)$/); // Windows 盘符路径
+  return m ? m[1] : null;
+}
+
+function basenameOf(p) {
+  return String(p || '').replace(/[\\/]+$/, '').split(/[\\/]/).pop() || '';
+}
+
+async function resolveProjectPath(removeItem) {
+  const testid = removeItem.getAttribute('data-testid') || '';
+  const extracted = extractPathFromTestId(testid);
+  if (!extracted) return null;
+  // 与 helper 的最近项目列表核对（仅用于确认路径有效；任务派生的项目可能不在列表中）
+  const res = await rpc('/projects');
+  if (res.ok && Array.isArray(res.projects)) {
+    const norm = (p) => String(p).replace(/[\\/]+$/, '');
+    const hit = res.projects.find((p) => norm(p.path) === norm(extracted));
+    if (hit) return hit;
+  }
+  return { path: extracted, name: basenameOf(extracted) };
+}
+
+export function handleProjectMenu(content) {
+  if (content.querySelector('[data-zcodepro-item="alias"]')) return;
+  const items = itemsOf(content);
+  const removeItem = items.find(
+    (el) => el.hasAttribute('data-testid') && REMOVE_TEXTS.some((x) => itemText(el).startsWith(x))
+  );
+  if (!removeItem) return;
+  void (async () => {
+    const config = await getConfig();
+    // 一组开关控制整组菜单项（别名 / 切换文件夹 / 打开文件夹 / 复制路径）
+    if (config.features && config.features.projectMenu === false) return;
+    const project = await resolveProjectPath(removeItem);
+    if (!project) return;
+    // 菜单顺序：自定义别名 → 切换文件夹 → 打开文件夹 → 复制路径 → 移除（均插在“移除”之前）
+    appendAliasItem(content, removeItem, project);
+    appendRelocateItem(content, removeItem, project);
+    appendOpenFolderItem(content, removeItem, project);
+    appendCopyPathItem(content, removeItem, project);
+  })();
+}