zcode-pro 0.18.0 → 0.19.0

package/src/inject/features/title-gen.js

@@ -0,0 +1,169 @@
+// 任务名提示词（自动起名）：官方在新会话首轮后自动起名的提示词写死在运行时
+// 里、不可配置，起出的名字常不合适。本功能在“新会话”出现后，把会话区的
+// 用户消息交给 helper（/title-gen/run），用设置弹窗里选择的供应商与提示词
+// 重新生成标题，并按“手动重命名”写入任务索引（title_overridden=1）：
+// - 触发信号 = 侧栏出现一个全新的任务行（本页面生命周期内没见过的
+//   data-task-item-key）且它是当前选中会话——项目展开/滚动复现的旧行、切换
+//   到老会话、后台建的任务都不会触发；
+// - 生成时机 = 模型开始作答（会话区出现用户消息以外的内容变动）。提问阶段
+//   的全部用户消息都会进入标题——新建任务连问两次、第一次还没得到回答的
+//   场景，两次提问都算数；迟迟没有作答时按静默时长兜底生成；
+// - 官方自动起名从此不会再覆盖索引里的名字（索引层尊重重命名标记），界面
+//   层偶发的覆盖显示由 title-lock 按锁定表钉回；写库成功后立即更新侧栏行
+//   并刷新锁定表，新名即刻上屏；
+// - 失败静默（一次生成失败不打扰用户），每个会话只尝试一次。
+// 扫描事件驱动（任务行相关变动去抖 300ms）+ 低频兜底轮询，选法同 title-lock。
+import { rpc, getConfig } from '../core.js';
+import { setRowTitle, refreshPinnedTitles } from './title-lock.js';
+
+const CONV = '[class*="@md/conversation"]';
+const USER_ROW = '[class*="user-row"]';
+const SCAN_DEBOUNCE_MS = 300;    // 任务行相关 DOM 变动后的去抖
+const SCAN_FALLBACK_MS = 5000;   // 兜底轮询周期（补观察器覆盖不到的路径）
+const SELECT_WAIT_MS = 2000;     // 新行出现后等它成为当前会话的时间
+const MSG_WAIT_MS = 10000;       // 任务行先于消息上屏时，等首条消息的最长时间
+const QUIET_FALLBACK_MS = 120000; // 迟迟没有作答时的静默兜底（期间追加的提问也会带上）
+const COLLECT_MAX_MS = 600000;   // 收集期上限（10 分钟内始终没等到作答就放弃）
+
+let installed = false;
+const knownKeys = new Set(); // 页面生命周期内见过的任务键（含启动时已在侧栏的）
+const attempted = new Set(); // 已处理过（成功或失败）的会话 id，防重复
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+function sessIdOf(key) {
+  // 会话键格式 <workspace_path>:<sess_id>；sess 段固定以 "sess_" 开头（见 session-switch.js）
+  const i = key.indexOf(':sess_');
+  return i > 0 ? key.slice(i + 1) : '';
+}
+
+function currentKey() {
+  for (const el of document.querySelectorAll('[data-task-item-key]')) {
+    if ((el.className + '').includes('bg-selected')) return el.getAttribute('data-task-item-key') || '';
+  }
+  return '';
+}
+
+// 会话区全部用户消息文本（按 DOM 顺序）；没有用户消息时返回空数组
+function userTexts() {
+  return [...document.querySelectorAll(`${CONV} ${USER_ROW}`)]
+    .map((r) => {
+      const el = r.querySelector('.whitespace-pre-wrap');
+      return ((el ? el.textContent : r.innerText) || '').trim();
+    })
+    .filter(Boolean);
+}
+
+async function onNewTaskRow(key) {
+  // 新任务行创建时选中标记可能晚一拍；短暂等待它成为当前会话，
+  // 期间没选中（其他入口建的任务）就不处理
+  const selDeadline = Date.now() + SELECT_WAIT_MS;
+  while (currentKey() !== key && Date.now() < selDeadline) await sleep(200);
+  if (currentKey() !== key) return;
+
+  const cfg = await getConfig().catch(() => null);
+  if (!cfg || !cfg.titleGen || cfg.titleGen.enabled !== true) return;
+
+  const sessId = sessIdOf(key);
+  if (!sessId || attempted.has(sessId)) return;
+  attempted.add(sessId);
+
+  // 任务行可能先于消息渲染出现：等首条用户消息上屏
+  let texts = [];
+  const msgDeadline = Date.now() + MSG_WAIT_MS;
+  while (Date.now() < msgDeadline) {
+    texts = userTexts();
+    if (texts.length) break;
+    await sleep(400);
+  }
+  if (!texts.length) return;
+
+  // 收集期：会话区出现用户消息以外的内容变动 = 模型开始作答，提问阶段结束，
+  // 立即生成；期间追加的用户消息会刷新收集与静默计时。切到别的会话时暂停
+  // 收集（不把别的会话的内容混进来），切回来继续
+  let assistantSeen = false;
+  const convObserver = new MutationObserver((muts) => {
+    if (currentKey() !== key) return;
+    for (const m of muts) {
+      const t = m.type === 'characterData' ? m.target.parentElement : m.target;
+      if (t instanceof Element && t.closest(USER_ROW)) continue; // 用户消息自身的变动不算作答
+      for (const n of [t, ...m.addedNodes]) {
+        if (n instanceof Element && n.closest && n.closest(CONV)) { assistantSeen = true; return; }
+      }
+    }
+  });
+  convObserver.observe(document.body, { childList: true, subtree: true, characterData: true });
+  const startAt = Date.now();
+  let lastCount = texts.length;
+  let lastChange = Date.now();
+  try {
+    while (Date.now() - startAt < COLLECT_MAX_MS) {
+      await sleep(500);
+      if (currentKey() !== key) { lastChange = Date.now(); continue; } // 切走：暂停收集
+      texts = userTexts();
+      if (texts.length !== lastCount) {
+        lastCount = texts.length;
+        lastChange = Date.now();
+      }
+      if (assistantSeen) break;
+      if (Date.now() - lastChange >= QUIET_FALLBACK_MS) break;
+    }
+  } finally { convObserver.disconnect(); }
+  if (!texts.length) return;
+
+  const res = await rpc('/title-gen/run', { method: 'POST', body: { sessId, text: texts.join('\n') } }).catch(() => null);
+  // written=false 常见于用户已抢先手动重命名——尊重手动命名，不提示
+  if (res && res.ok && res.written && res.title) {
+    setRowTitle(key, res.title);
+    void refreshPinnedTitles();
+  }
+}
+
+function scanForNewRows() {
+  for (const el of document.querySelectorAll('[data-task-item-key]')) {
+    const key = el.getAttribute('data-task-item-key') || '';
+    if (!key || knownKeys.has(key)) continue;
+    knownKeys.add(key);
+    void onNewTaskRow(key);
+  }
+}
+
+// 只有任务条目相关变动才重扫（选法同 title-lock.js）；聊天区流式输出等
+// 高频变动在此滤掉
+const TASK_SEL = '[data-task-item-key]';
+const inTaskRow = (node) => !!(node instanceof Element && node.closest && node.closest(TASK_SEL));
+function taskRowMutations(muts) {
+  for (const m of muts) {
+    if (m.type === 'attributes') {
+      if (inTaskRow(m.target)) return true;
+    } else if (m.type === 'characterData') {
+      if (m.target.parentElement && inTaskRow(m.target.parentElement)) return true;
+    } else if (inTaskRow(m.target)) {
+      return true;
+    } else {
+      for (const n of m.addedNodes) {
+        if (n instanceof Element && (n.matches(TASK_SEL) || !!n.querySelector(TASK_SEL))) return true;
+      }
+    }
+  }
+  return false;
+}
+
+let scanDebounce = 0;
+function scheduleScan() {
+  if (scanDebounce) return;
+  scanDebounce = setTimeout(() => { scanDebounce = 0; scanForNewRows(); }, SCAN_DEBOUNCE_MS);
+}
+
+export function startTitleGen() {
+  if (installed || typeof document === 'undefined') return;
+  installed = true;
+  // 启动先记下已在侧栏的任务键：此后出现的才是新会话
+  scanForNewRows();
+
+  new MutationObserver((muts) => { if (taskRowMutations(muts)) scheduleScan(); })
+    .observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['class'], characterData: true });
+
+  setInterval(() => { if (!document.hidden) scanForNewRows(); }, SCAN_FALLBACK_MS);
+  document.addEventListener('visibilitychange', () => { if (!document.hidden) scanForNewRows(); });
+}

package/src/inject/features/title-lock.js

@@ -202,6 +202,20 @@ async function bootstrap() {
   if (map) scan();
 }
 
+// 供智能起名（title-gen.js）复用：把指定会话键的所有侧栏行标题改为 text
+// （同一会话可能多行呈现，与失配回写共用同一套元素定位与写法）
+export function setRowTitle(key, text) {
+  for (const item of findRows(key)) {
+    for (const el of titleElsOf(item)) writeTitle(el, text);
+  }
+}
+
+// 供智能起名在写库成功后立即刷新锁定表（拉最新标题表并全量复核一次），
+// 之后官方推送的自动标题由本功能按新表钉回
+export function refreshPinnedTitles() {
+  return fetchPinned().then((m) => { if (m) scan(); });
+}
+
 export function startTitleLock() {
   if (installed || typeof document === 'undefined') return;
   installed = true;

package/src/inject/features/toolbar-icons.js

@@ -103,6 +103,9 @@ function rebuild() {
   menu.classList.add(HIDE_CLASS);
   origs = next;
   rowEl?.remove();
+  // 原生顶栏新建按钮（文件子页会展开的那个）钉死收起：新建入口统一由我们
+  // 的行提供，省去随子页进出显隐自己按钮的同步
+  navRow.classList.add('zcodepro-tb-hidden-native');
   const L = t();
   const mk = (kind, orig, nameSel, fallback) => h('button', {
     type: 'button',
@@ -129,7 +132,15 @@ function rebuild() {
   const pIcon = iconOf(next.plugin);
   if (pIcon) pluginBtn.append(pIcon);
   rowEl = h('div', { class: 'zcodepro-tb-row' }, newBtn, searchBtn, autoBtn, pluginBtn);
-  navRow.append(rowEl);
+  // 插在容器内“更新”按钮之前（实测容器子序：侧栏切换/后退/前进/原生新建
+  // 容器/更新按钮）。更新按钮无 testid，按绿色胶囊的 bg-success 样式类定位
+  //（实测当前主题；老主题为 bg-emerald，一并匹配），找不到退回末尾追加——
+  // 更新按钮只在有新版本时出现。容器内追加/前插都是框架长期容忍的位置，
+  // 不要插到容器外侧（React 重渲染会把外侧插入点挤漂移）
+  const updBtn = [...navRow.querySelectorAll('button')]
+    .find((b) => /bg-(success|emerald)/.test(b.className || ''));
+  if (updBtn) updBtn.before(rowEl);
+  else navRow.append(rowEl);
   return true;
 }
 
@@ -171,14 +182,32 @@ function sync() {
   if (sidebarCollapsed() || sidebarTooNarrow()) {
     if (rowEl) rowEl.style.display = 'none';
     menu.classList.remove(HIDE_CLASS);
+    // 这两种形态藏起我们的整行：原生新建按钮要放出来（去掉钉死类），
+    // 否则收起侧栏时顶栏没有任何新建入口
+    document.querySelectorAll('.zcodepro-tb-hidden-native').forEach((el) => el.classList.remove('zcodepro-tb-hidden-native'));
     return;
   }
+  // 旧引用是否全部仍可用；不可用时先试重建，重建未就绪（React 分批挂载，
+  // 菜单/导航容器还没上屏）则保留现有行原样等待重试——若在这里提前把旧行
+  // 拆掉，重试成功前图标会整行消失，只能等兜底轮询补上（表现为返回会话后
+  // 图标迟两三秒才回来）
   const alive = origs && origs.menu === menu
     && origs.newTask.isConnected && origs.search.isConnected
     && origs.auto.isConnected && origs.plugin.isConnected
     && rowEl && rowEl.isConnected;
-  if (!alive && !rebuild()) return;
-  // 界面重渲染可能整体重写容器的 class，隐藏类兜底重加
+  if (!alive && !rebuild()) {
+    // 菜单在而原节点断连：界面正在换节点，行先藏着等重试。观察器监听菜单
+    // 挂载、命中即恢复（150ms 去抖）；万一变动被滤掉，这里再排短程重试
+    // 兜底，不依赖 5 秒轮询
+    if (rowEl) rowEl.style.display = 'none';
+    setTimeout(scheduleSync, 400);
+    setTimeout(scheduleSync, 1200);
+    return;
+  }
+  // 界面重渲染可能整体重写容器的 class，隐藏类兜底重加；钉死原生新建按钮的
+  // 类同理（收起分支会摘掉它，展开回来若节点仍活着不会触发 rebuild，须在此补）
+  const navRow = document.querySelector('[data-testid="desktop-top-nav-back"]')?.parentElement;
+  if (navRow) navRow.classList.add('zcodepro-tb-hidden-native');
   menu.classList.add(HIDE_CLASS);
   if (rowEl) rowEl.style.display = '';
   syncActive();
@@ -219,7 +248,12 @@ function relevantMutations(muts) {
 function teardown() {
   rowEl?.remove();
   rowEl = null;
-  if (origs) { origs.menu.classList.remove(HIDE_CLASS); origs = null; }
+  if (origs) {
+    origs.menu.classList.remove(HIDE_CLASS);
+    // 恢复原生子页新建按钮（功能关闭时不再钉死）
+    document.querySelectorAll('.zcodepro-tb-hidden-native').forEach((el) => el.classList.remove('zcodepro-tb-hidden-native'));
+    origs = null;
+  }
 }
 
 async function refreshConfig() {

package/src/inject/index.js

@@ -10,6 +10,7 @@ import { startAliasWatcher } from './features/alias.js';
 import { startTaskOrderWatcher } from './features/task-order.js';
 import { startSessionSwitch } from './features/session-switch.js';
 import { startTitleLock } from './features/title-lock.js';
+import { startTitleGen } from './features/title-gen.js';
 import { startPinnedExpandSuppression } from './features/pinned-expand.js';
 import { startWsRunningSpin } from './features/ws-running.js';
 import { startIdleReclaim } from './features/idle-reclaim.js';
@@ -50,6 +51,7 @@ import { ensureStyle } from './ui.js';
     try { startTaskOrderWatcher(); } catch { /* ignore */ }
     try { startSessionSwitch(); } catch { /* ignore */ }
     try { startTitleLock(); } catch { /* ignore */ }
+    try { startTitleGen(); } catch { /* ignore */ }
     try { startImageMenu(); } catch { /* ignore */ }
     try { startPinnedExpandSuppression(); } catch { /* ignore */ }
     try { startWsRunningSpin(); } catch { /* ignore */ }

package/src/inject/provider-fields.js

@@ -0,0 +1,71 @@
+// 供应商 / 模型 / 接口地址 / API Key 的共用选择逻辑：智能起名与视觉代理两个
+// 设置面板共用，后续其他面板直接复用这里的组件与规则。供应商取值约定：
+// - ''：不跟随（自填接口地址 + API Key + 协议直连）；
+// - 'session'：跟随当前会话（连接由会话侧解析，不存地址密钥）；
+// - 其余：供应商 id；已删的 id 保留为「已删除」选项，调用方靠保存的地址/
+//   密钥副本继续直连。
+import { h } from './core.js';
+
+export const PROVIDER_FIELD_CLS = 'h-8 w-full rounded-lg border border-border bg-input px-2.5 text-ui-sm text-foreground outline-none transition-shadow placeholder:text-foreground-subtle focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/40';
+
+// 「下拉 + 手输」组合（供应商与模型选择共用）：下拉选择列表项，也可以直接
+// 输入；当前值不在列表里（条目被删或手输 id）时保留为带 staleLabel 标注的
+// 选项，不清空、不跳值；当前值为空时插入一个 emptyLabel 空选项，避免下拉框
+// 假装选中第一项而配置里其实没选
+export function comboField(current, options, onChange, { disabled = false, placeholder = '', staleLabel = '（手动输入）', emptyLabel = '' } = {}) {
+  const sel = h('select', { class: PROVIDER_FIELD_CLS, disabled: disabled || undefined });
+  const input = h('input', { type: 'text', value: current, placeholder, class: PROVIDER_FIELD_CLS, disabled: disabled || undefined });
+  const sync = () => {
+    const cur = input.value;
+    const opts = [...options];
+    if (cur && !opts.some((o) => o.value === cur)) opts.push({ value: cur, label: `${cur}${staleLabel}` });
+    if (!cur && !opts.some((o) => o.value === '')) opts.unshift({ value: '', label: emptyLabel });
+    sel.replaceChildren(...opts.map((o) => h('option', { value: o.value, title: o.value }, o.label)));
+    sel.value = cur;
+  };
+  sel.addEventListener('change', () => { input.value = sel.value; onChange(sel.value, 'select'); });
+  input.addEventListener('input', () => onChange(input.value, 'type'));
+  input.addEventListener('blur', () => sync());
+  sync();
+  return h('div', { class: 'flex flex-col gap-1' }, sel, input);
+}
+
+// 供应商下拉选项：不跟随（自填地址）/ 跟随当前会话 / 供应商列表
+export function providerOptionsOf(providers, L) {
+  return [
+    { value: '', label: L.titleGenProviderNone },
+    { value: 'session', label: L.titleGenProviderSession },
+    ...providers.map((p) => ({ value: p.id, label: p.name })),
+  ];
+}
+
+// 模型下拉选项：具体供应商 = 该供应商的模型；跟随会话 = 汇总全部供应商的
+// 模型（去重，方便快速选一个）；不跟随 / 已删供应商 = 空列表（纯手输）。
+// followSession = true 时，跟随会话的选项表头部多一个“跟随当前会话当前模型”
+//（值为空）：任务名提示词与视觉代理（zcode-vision ≥1.6.1）都在运行时把它
+// 解析为会话当前模型；不需要该能力的场景不传即可
+export function modelOptionsOf(providerValue, providers, { followSession = false, followSessionLabel = '' } = {}) {
+  const v = (providerValue || '').trim();
+  const cur = providers.find((p) => p.id === v);
+  if (cur) return cur.models.map((m) => ({ value: m, label: m }));
+  if (v === 'session') {
+    const head = followSession && followSessionLabel ? [{ value: '', label: followSessionLabel }] : [];
+    return [...head, ...[...new Set(providers.flatMap((p) => p.models))].map((m) => ({ value: m, label: m }))];
+  }
+  return [];
+}
+
+// 模型输入框的提示文案（按供应商模式选）
+export function modelPlaceholderOf(providerValue, L) {
+  const v = (providerValue || '').trim();
+  if (v === 'session') return L.titleGenModelSessionHint;
+  if (v === '') return L.titleGenModelManualHint;
+  return L.titleGenModelHint;
+}
+
+// 是否手动连接（不跟随，或供应商 id 已不在列表里）：调用方据此决定接口
+// 地址 / API Key / 协议字段是否显示
+export function isManualConn(providerValue, providers) {
+  const v = (providerValue || '').trim();
+  return v === '' || (v !== 'session' && !providers.some((p) => p.id === v));
+}

package/src/inject/ui.js

@@ -38,7 +38,7 @@ const contentClass = 'w-full sm:max-w-md rounded-2xl border-none bg-popover/98 p
 // Esc 只关最上层，避免一次 Esc 把两层一起关掉
 let dialogStack = [];
 
-export function openDialog({ title, description, onMount, onClose, width = 'sm:max-w-md', overlay = 'dim', draggable = false, posKey = '', dismissOnOutside = true }) {
+export function openDialog({ title, description, onMount, onClose, width = 'sm:max-w-md', overlay = 'dim', draggable = false, posKey = '', dismissOnOutside = true, bodyClass = '' }) {
   const L = t();
   const prevActive = document.activeElement;
   let cleanupDrag = null;
@@ -77,7 +77,9 @@ export function openDialog({ title, description, onMount, onClose, width = 'sm:m
     // 注意不能把 null 直接传给 append：DOM 会把 null 渲染成字面量 "null" 文本
     ...(description ? [h('p', { class: 'mt-2 text-ui-sm/relaxed text-foreground-subtle' }, description)] : [])
   );
-  const body = h('div', { class: 'mt-4 zcodepro-dialog-body' });
+  // bodyClass 覆盖默认的 mt-4（标题与内容间距）：设置弹窗标题下还有状态行和
+  // 标签栏，需要更紧凑时传更小的间距类
+  const body = h('div', { class: 'zcodepro-dialog-body ' + (bodyClass || 'mt-4') });
   content.append(body);
   let restorePos = null;
   if (draggable) {
@@ -329,14 +331,16 @@ export function settingRow(name, desc, checked, onToggle, extra) {
   }, knob);
   const extraEl = extra
     ? h('div', {
-      class: 'flex shrink-0 items-center pt-0.5',
+      class: 'flex shrink-0 items-center',
       onClick: (e) => { e.stopPropagation(); },
       onMousedown: (e) => { e.stopPropagation(); },
       onWheel: (e) => { e.stopPropagation(); },
     }, extra)
     : null;
+  // items-center：简介换行成多行时，开关与整个“标题+简介”块垂直居中
+  //（顶对齐会把开关吊在第一行的高度上）
   const row = h('div', {
-    class: `flex cursor-pointer items-start gap-2 rounded-lg ${desc ? 'p-2' : 'p-1.5'} transition-colors hover:bg-surface-hover`,
+    class: `flex cursor-pointer items-center gap-2 rounded-lg ${desc ? 'p-2' : 'p-1.5'} transition-colors hover:bg-surface-hover`,
     onClick: () => { onToggle(); },
   },
     h('div', { class: 'min-w-0 flex-1' },
@@ -420,13 +424,14 @@ export function ensureStyle() {
       align-items: center;
       justify-content: center;
       height: 24px;
-      padding: 0 14px;
+      padding: 0 8px;
       border: none;
       border-radius: 9999px;
       background: transparent;
       cursor: pointer;
       font-size: 12px;
       line-height: 1;
+      white-space: nowrap;
       color: var(--color-muted-foreground, #888);
       transition: color 0.15s ease, background-color 0.15s ease;
     }
@@ -515,6 +520,8 @@ export function ensureStyle() {
     .zcodepro-textarea:disabled { opacity: 0.5; }
     /* 小型文本域（视觉代理提示词等）：11rem 最小高度只属于全局提示词大编辑框，这里按 rows 定高 */
     .zcodepro-textarea.zcodepro-textarea-sm { min-height: 0; }
+    /* 全局提示词大编辑框：默认/最大高度都比默认文本域更高 */
+    .zcodepro-textarea.zcodepro-textarea-lg { min-height: 16rem; max-height: 40rem; }
     /* 行高滑杆（样式调整标签页） */
     .zcodepro-range {
       -webkit-appearance: none;
@@ -700,6 +707,14 @@ export function ensureStyle() {
     }
     /* 原侧栏菜单整体隐藏（toolbar-icons 开启时） */
     .zcodepro-tb-hidden { display: none !important; }
+    /* 原生顶栏新建任务按钮（文件查看等子页展开的那个）：常驻 DOM、靠动画容器
+       在 w-7/w-0 间切换显隐。功能开启期间整体钉死收起态——新建入口统一由我们
+       的按钮行提供，也就不再需要随子页进出动态显隐自己的新建按钮 */
+    .zcodepro-tb-hidden-native div[class*="transition-[opacity,width]"] {
+      width: 0 !important;
+      opacity: 0 !important;
+      pointer-events: none !important;
+    }
     /* 已置顶分区可折叠（pinned-collapse.js）：标题整行可点，折叠时藏起任务列表，
        chevron 旋向与“项目”分区一致（收起指向右侧） */
     .zcodepro-pin-head {