zcode-pro 0.19.0 → 0.20.0

package/src/host/setup.mjs

@@ -1,5 +1,5 @@
 // zcode-pro setup：本机集成设置入口（npm / pip 等包管理器安装不写系统目录，
-// 需要菜单入口等集成时显式运行本子命令）。按「设置项」组织（id / 标题 /
+// 需要菜单入口等集成时显式运行本子命令）。按“设置项”组织（id / 标题 /
 // install / uninstall），以后新增设置项往 items 里加即可。
 // setup 不依赖 ZCode 运行，在 main.run 里先于 ZCode 定位处理。
 //
@@ -291,17 +291,17 @@ function plistContent(hasIcon) {
 
 const shortcutItem = {
   id: 'desktop-shortcut',
-  title: '快捷方式“ZCode Pro”（应用菜单/开始菜单，图标复用 ZCode）',
+  title: 'Shortcut "ZCode Pro" (app/start menu, icon reuses ZCode)',
   supported: (plat) => SUPPORTED.includes(plat),
 
   install(plat, opts = {}) {
     const cmd = commandInPath(plat);
     if (!cmd) {
-      throw new Error('未在 PATH 中找到 zcode-pro 命令，无法创建快捷方式；请确认安装方式后重试。');
+      throw new Error('zcode-pro command not found in PATH, cannot create shortcut; check your install and retry');
     }
     if (!sameInstall(cmd, plat)) {
-      throw new Error(`PATH 中的 zcode-pro（${cmd}）不属于当前运行的这份安装，` +
-        '为避免快捷方式指向旧版本已跳过；请用那份安装自己的方式管理快捷方式。');
+      throw new Error(`the zcode-pro in PATH (${cmd}) is not part of this installation, ` +
+        'skipped so the shortcut will not point at an old version; manage shortcuts with that installation instead');
     }
     if (plat === 'linux') return this.installLinux(cmd, opts);
     if (plat === 'win32') return this.installWindows(cmd, opts);
@@ -312,7 +312,7 @@ const shortcutItem = {
     // 系统级（AUR 等）已有同名条目时不再建用户级：desktop 文件 id 相同时用户级
     // 会遮蔽系统级（项目既有约定），残留后表现为菜单一直运行另一份
     if (existsSync('/usr/share/applications/zcode-pro.desktop')) {
-      return { skipped: '检测到系统级 ZCode Pro 快捷方式（AUR 等已安装），用户级条目会遮蔽它，已跳过' };
+      return { skipped: 'system-level shortcut detected (e.g. AUR); a user entry would shadow it, skipped' };
     }
     const appsDir = applicationsDir();
     const target = join(appsDir, DESKTOP_FILE);
@@ -320,21 +320,21 @@ const shortcutItem = {
     if (existsSync(target)) {
       const cur = readFileSync(target, 'utf-8');
       if (!cur.includes(SETUP_MARK)) {
-        return { skipped: `${target} 已存在且非 setup 创建（如 install.sh），未覆盖` };
+        return { skipped: `${target} exists and was not created by setup (e.g. install.sh), not overwritten` };
       }
       // 早期版本写过 0644 的条目：即使内容无需重写也补上执行位（原因见 writeDesktopEntry）
       chmodSync(target, 0o755);
       const exec = (cur.match(/^Exec=(.+)$/m) || [])[1] || '';
       if (exec.includes(cmd)) {
-        parts.push('应用菜单条目已存在且指向当前命令，无需重复创建');
+        parts.push('app-menu entry already exists and points to the current command, nothing to do');
       } else {
         writeDesktopEntry(target, cmd);
-        parts.push(`已更新 ${target}（Exec=${cmd}）`);
+        parts.push(`updated ${target} (Exec=${cmd})`);
       }
     } else {
       mkdirSync(appsDir, { recursive: true });
       writeDesktopEntry(target, cmd);
-      parts.push(`已写入 ${target}（Exec=${cmd}）`);
+      parts.push(`written ${target} (Exec=${cmd})`);
     }
     try { execFileSync('update-desktop-database', [appsDir], { stdio: 'ignore' }); } catch { /* 无该命令时忽略 */ }
     // 桌面条目独立判断（不因菜单条目幂等而短路）
@@ -347,13 +347,13 @@ const shortcutItem = {
         // GNOME 的桌面（Nautilus）额外要求 trusted 元数据才显示“允许启动”；
         // 其他环境无 gio / 写不进元数据时忽略
         try { execFileSync('gio', ['set', dTarget, 'metadata::trusted', 'true'], { stdio: 'ignore' }); } catch { /* 非 GNOME 忽略 */ }
-        parts.push(`桌面 ${dTarget}`);
+        parts.push(`desktop ${dTarget}`);
       } else {
-        parts.push('桌面已存在非 setup 创建的条目，未覆盖');
+        parts.push('desktop entry exists and was not created by setup, not overwritten');
       }
     }
-    if (parts.length === 1 && parts[0].startsWith('应用菜单条目已存在')) return { skipped: parts[0] };
-    return { detail: parts.join('；') };
+    if (parts.length === 1 && parts[0].startsWith('app-menu entry already exists')) return { skipped: parts[0] };
+    return { detail: parts.join('; ') };
   },
 
   installWindows(cmd, opts = {}) {
@@ -367,9 +367,9 @@ const shortcutItem = {
     const plan = windowsShortcutPlan(cmd, !!opts.desktop, wshOk, !menuForeign);
     if (menuForeign && (!opts.desktop || deskForeign)) {
       return { skipped: [
-        menuForeign ? `已存在其他方式创建的 ${plan.lnkPath}，未覆盖` : '',
-        deskForeign ? `桌面 ${deskPath} 已存在其他方式创建的条目，未覆盖` : '',
-      ].filter(Boolean).join('；') };
+        menuForeign ? `${plan.lnkPath} exists (created elsewhere), not overwritten` : '',
+        deskForeign ? `desktop ${deskPath} exists (created elsewhere), not overwritten` : '',
+      ].filter(Boolean).join('; ') };
     }
     if (wshOk) {
       mkdirSync(plan.vbsDir, { recursive: true });
@@ -377,14 +377,14 @@ const shortcutItem = {
     }
     runPowerShell(plan.psScript);
     const how = wshOk
-      ? `经 ${plan.vbsPath} 静默启动`
-      : '本机 WSH 异常，经 cmd 最小化启动（启动时会短暂闪烁控制台窗口）';
+      ? `silent launch via ${plan.vbsPath}`
+      : 'WSH unavailable on this machine; minimized cmd launch (console flashes briefly on start)';
     const parts = [];
     parts.push(menuForeign
-      ? `开始菜单 ${plan.lnkPath} 已存在其他方式创建的条目，未覆盖`
-      : `已创建 ${plan.lnkPath}`);
-    if (opts.desktop) parts.push(deskForeign ? `桌面 ${deskPath} 已存在其他方式创建的条目，未覆盖` : '已创建桌面快捷方式');
-    return { detail: `${parts.join('；')}（${how}）` };
+      ? `start menu ${plan.lnkPath} exists (created elsewhere), not overwritten`
+      : `created ${plan.lnkPath}`);
+    if (opts.desktop) parts.push(deskForeign ? `desktop ${deskPath} exists (created elsewhere), not overwritten` : 'desktop shortcut created');
+    return { detail: `${parts.join('; ')} (${how})` };
   },
 
   installMac(cmd, opts = {}) {
@@ -392,7 +392,7 @@ const shortcutItem = {
     const contents = join(app, 'Contents');
     const marker = join(contents, 'zcodepro-setup-marker');
     if (existsSync(app) && !existsSync(marker)) {
-      return { skipped: `${app} 已存在且非 setup 创建，未覆盖` };
+      return { skipped: `${app} exists and was not created by setup, not overwritten` };
     }
     let iconCopied = false;
     for (const src of [join('/', 'Applications', 'ZCode.app', 'Contents', 'Resources', 'app.icns'),
@@ -411,15 +411,15 @@ const shortcutItem = {
     chmodSync(launcher, 0o755);
     writeFileSync(join(contents, 'Info.plist'), plistContent(iconCopied));
     writeFileSync(marker, '');
-    let detail = `已创建 ${app}（启动器指向 ${cmd}${iconCopied ? '，图标已复制' : ''}）`;
+    let detail = `created ${app} (launcher -> ${cmd}${iconCopied ? ', icon copied' : ''})`;
     if (opts.desktop) {
       const link = macDesktopLink();
       if (existsSync(link)) {
-        detail += '；桌面已存在同名入口，未覆盖';
+        detail += '; desktop entry with the same name exists, not overwritten';
       } else {
         try {
           symlinkSync(app, link);
-          detail += `；桌面 ${link}`;
+          detail += `; desktop ${link}`;
         } catch { /* 建链接失败仅省略桌面入口 */ }
       }
     }
@@ -445,16 +445,16 @@ const shortcutItem = {
       rmSync(dTarget);
       removed.push(dTarget);
     }
-    if (!removed.length) return { skipped: '未发现 setup 创建的快捷方式' };
+    if (!removed.length) return { skipped: 'no setup-created shortcuts found' };
     try { execFileSync('update-desktop-database', [applicationsDir()], { stdio: 'ignore' }); } catch { /* 无该命令时忽略 */ }
-    return { detail: `已移除 ${removed.join('、')}` };
+    return { detail: `removed ${removed.join(', ')}` };
   },
 
   uninstallWindows() {
     const paths = windowsPaths();
     const hadVbs = existsSync(paths.vbsPath);
     const hadLnk = existsSync(paths.lnkPath);
-    if (!hadVbs && !hadLnk) return { skipped: '未发现 setup 创建的快捷方式' };
+    if (!hadVbs && !hadLnk) return { skipped: 'no setup-created shortcuts found' };
     // .lnk 可能已被 install.ps1 等重建并指向它自己：只有 Arguments 带本功能归属
     // 标记才删；校验失败也保留 .lnk（宁可漏删不误删）
     let lnkRemoved = false;
@@ -488,29 +488,29 @@ const shortcutItem = {
           vbsCleaned = true;
         } catch {
           vbsCleaned = !existsSync(paths.vbsPath);
-          if (!vbsCleaned) console.error(`  （${paths.vbsDir} 删除失败，可能被占用，可稍后手动删除）`);
+          if (!vbsCleaned) console.error(`  (${paths.vbsDir} could not be deleted (may be in use); remove it manually later)`);
         }
       }
     }
     const parts = [];
     if (hadLnk) {
-      parts.push(lnkRemoved ? '开始菜单/桌面快捷方式' : verified ? '快捷方式已非本功能创建，未删除' : '快捷方式归属校验失败，未删除 .lnk');
+      parts.push(lnkRemoved ? 'start-menu/desktop shortcut' : verified ? 'shortcut not created by setup, kept' : 'shortcut ownership check failed, .lnk kept');
     }
-    if (hadVbs) parts.push(vbsCleaned ? '生成的启动脚本' : '启动脚本（删除失败）');
-    return { detail: `已移除：${parts.join('；')}` };
+    if (hadVbs) parts.push(vbsCleaned ? 'generated launcher script' : 'launcher script (delete failed)');
+    return { detail: `removed: ${parts.join(', ')}` };
   },
 
   uninstallMac() {
     const app = macAppBundle();
     const marker = join(app, 'Contents', 'zcodepro-setup-marker');
-    if (!existsSync(marker)) return { skipped: '未发现 setup 创建的应用包' };
+    if (!existsSync(marker)) return { skipped: 'no setup-created app bundle found' };
     // setup --desktop 建的桌面入口一并清理（只删指向本应用包的链接）
     const link = macDesktopLink();
     try {
       if (existsSync(link) && realpathSync(link) === realpathSync(app)) rmSync(link);
     } catch { /* 链接失效则忽略 */ }
     rmSync(app, { recursive: true, force: true });
-    return { detail: `已移除 ${app}` };
+    return { detail: `removed ${app}` };
   },
 };
 
@@ -532,22 +532,25 @@ function rmSyncWithRetry(target, tries = 4) {
 const items = [shortcutItem];
 
 export async function runSetup({ uninstall = false, platform: plat = platform(), desktop = false } = {}) {
-  console.log(`[zcodepro] setup ${uninstall ? '卸载' : '安装'}本机集成${desktop && !uninstall ? '（含桌面）' : ''}：`);
+  // 输出全用 ASCII 英文：setup 常在 GBK 代码页的 cmd/PowerShell 里跑，中文经
+  // 管道输出时极易乱码（chcp 适配也不是所有入口都来得及生效）；ASCII 文案
+  // 在任何代码页下都稳定显示
+  console.log(`[zcodepro] setup ${uninstall ? 'remove' : 'install'} local integration${desktop && !uninstall ? ' (with desktop)' : ''}:`);
   let failed = 0;
   for (const item of items) {
     if (!item.supported(plat)) {
-      console.log(`  · ${item.title}：当前平台（${plat}）暂不支持，跳过`);
+      console.log(`  - ${item.title}: not supported on ${plat}, skipped`);
       continue;
     }
     try {
       const res = uninstall ? item.uninstall(plat) : item.install(plat, { desktop });
-      if (res && res.skipped) console.log(`  · ${item.title}：${res.skipped}`);
-      else console.log(`  ✓ ${item.title}：${res && res.detail ? res.detail : '完成'}`);
+      if (res && res.skipped) console.log(`  - ${item.title}: ${res.skipped}`);
+      else console.log(`  [OK] ${item.title}: ${res && res.detail ? res.detail : 'done'}`);
     } catch (err) {
       failed++;
-      console.error(`  ✗ ${item.title}：${err?.message || err}`);
+      console.error(`  [FAIL] ${item.title}: ${err?.message || err}`);
     }
   }
-  console.log(uninstall ? '' : '  撤销：zcode-pro setup --uninstall');
+  console.log(uninstall ? '' : '  undo: zcode-pro setup --uninstall');
   if (failed) process.exitCode = 1;
 }

package/src/host/taskIndex.mjs

@@ -206,6 +206,28 @@ export async function listOverriddenTitles(dataRoot) {
   return { titles };
 }
 
+// 智能起名的前置判定：会话是否已被手动重命名（或已被起名写过）。双写前先查它，
+// 已重命名就整体跳过——避免起名晚到的写入盖掉用户的 custom 标题。读取失败按
+// 未重命名处理（后续写入自带原子守卫兜底）
+export async function isTaskTitleOverridden(dataRoot, sessId) {
+  const dbFile = taskIndexPath(dataRoot);
+  if (!existsSync(dbFile)) return false;
+  const driver = await loadDriver();
+  if (!driver) return false;
+  try {
+    if (driver.kind === 'node') {
+      const db = new driver.DatabaseSync(dbFile, { readOnly: true });
+      try {
+        const r = db.prepare('SELECT title_overridden FROM tasks WHERE task_id = ? AND deleted = 0').get(sessId);
+        return r?.title_overridden === 1;
+      } finally { db.close(); }
+    }
+    const esc = (v) => "'" + String(v).replace(/'/g, "''") + "'";
+    const r = runCli(dbFile, `SELECT title_overridden FROM tasks WHERE task_id = ${esc(sessId)} AND deleted = 0;`);
+    return /^1/m.test(r.stdout);
+  } catch { return false; }
+}
+
 // 智能起名写入：把生成标题按“手动重命名”存入索引（title_overridden = 1），
 // 之后官方自动标题不会再覆盖这条记录。仅在会话未删除、且从未被手动重命名过
 // （title_overridden = 0）时写入——手动重命名永远优先。返回 { written, title }；
@@ -266,10 +288,35 @@ function isBusyError(err) {
 // { providerId, modelId }；没有斜线时 providerId 退回 provider 列的值。
 // 会话不存在返回 null；读取失败按 null 处理（调用方换明确报错）
 export async function getTaskProviderModel(dataRoot, sessId) {
-  const dbFile = taskIndexPath(dataRoot);
-  if (!existsSync(dbFile)) return null;
   const driver = await loadDriver();
   if (!driver) return null;
+  const esc = (v) => "'" + String(v).replace(/'/g, "''") + "'";
+
+  // 优先读 CLI 会话库的 model_usage：首个 turn 开始时即写入，比任务索引的
+  // model 列早十几秒（任务索引由桌面同步器延迟写；新会话头十几秒里它还是
+  // 空值，起名第一次调用会因此解析到不存在的模型，实测 400 模型不存在）
+  const usageFile = join(dataRoot, 'cli', 'db', 'db.sqlite');
+  if (existsSync(usageFile)) {
+    try {
+      if (driver.kind === 'node') {
+        const db = new driver.DatabaseSync(usageFile, { readOnly: true });
+        try {
+          const r = db.prepare(
+            "SELECT provider_id, model_id FROM model_usage WHERE session_id = ? AND provider_id IS NOT NULL AND provider_id != '' ORDER BY started_at DESC LIMIT 1"
+          ).get(sessId);
+          if (r && r.model_id) return { providerId: r.provider_id, modelId: r.model_id };
+        } finally { db.close(); }
+      } else {
+        const r = runCli(usageFile,
+          `SELECT coalesce(json_object('provider_id', provider_id, 'model_id', model_id), 'null') FROM (SELECT provider_id, model_id FROM model_usage WHERE session_id = ${esc(sessId)} AND provider_id IS NOT NULL AND provider_id != '' ORDER BY started_at DESC LIMIT 1);`);
+        const parsed = JSON.parse(r.stdout.trim() || 'null');
+        if (parsed && parsed.model_id) return { providerId: parsed.provider_id, modelId: parsed.model_id };
+      }
+    } catch { /* 表不存在（旧版 CLI）等：走任务索引兜底 */ }
+  }
+
+  const dbFile = taskIndexPath(dataRoot);
+  if (!existsSync(dbFile)) return null;
   let row = null;
   try {
     if (driver.kind === 'node') {
@@ -279,7 +326,6 @@ export async function getTaskProviderModel(dataRoot, sessId) {
         row = db.prepare('SELECT provider, model FROM tasks WHERE task_id = ? AND deleted = 0').get(sessId) || null;
       } finally { db.close(); }
     } else {
-      const esc = (v) => "'" + String(v).replace(/'/g, "''") + "'";
       const r = runCli(dbFile,
         `SELECT coalesce(json_object('provider', provider, 'model', model), 'null') FROM tasks WHERE task_id = ${esc(sessId)} AND deleted = 0;`);
       const parsed = JSON.parse((r.stdout.trim() || 'null'));
@@ -336,3 +382,132 @@ function runCli(dbFile, script) {
   if (r.status !== 0) throw new Error('sqlite3 CLI 执行失败: ' + (r.stderr || r.stdout || ('exit ' + r.status)));
   return r;
 }
+
+// CLI 会话库（~/.zcode/cli/db/db.sqlite）的会话标题权威写入：title + title_source=
+// 'custom'（官方 setCustomSessionTitle 同款语义）。custom 后官方运行时彻底知情：
+// 自动起名写回后的自动校正：桌面端打开会话时会把运行时内存缓存的旧标题写回
+// 任务索引（实测点开会话的瞬间发生，运行时不知道我们直写过 CLI 库），索引里的
+// 标题因此被改回旧值。CLI 库的 custom 标题才是权威——对“我们写过、且 CLI 标题
+// 仍等于我们所写”的会话，索引标题若不同就改回 CLI 值。只认自己写过的记录：
+// 官方手动改名（renameTask）两库同步更新不会分歧；其 v4 同步失败时索引比 CLI 新
+// （历史会话场景），不认记录就绝不会误回滚用户的手动改名。
+// writtenMap: { sessId → { title, at } }；返回本次校正的会话数（失败静默，下次再试）
+export async function reconcileCustomTitles(dataRoot, writtenMap) {
+  const repaired = [];
+  if (!writtenMap || typeof writtenMap !== 'object') return repaired;
+  const driver = await loadDriver();
+  if (!driver) return repaired;
+  const esc = (v) => "'" + String(v).replace(/'/g, "''") + "'";
+  const cliFile = join(dataRoot, 'cli', 'db', 'db.sqlite');
+  const idxFile = taskIndexPath(dataRoot);
+  if (!existsSync(cliFile) || !existsSync(idxFile)) return repaired;
+
+  const readCli = async (sessId) => {
+    if (driver.kind === 'node') {
+      const db = new driver.DatabaseSync(cliFile, { readOnly: true });
+      try {
+        return db.prepare("SELECT title, title_source FROM session WHERE id = ?").get(sessId) || null;
+      } finally { db.close(); }
+    }
+    const r = runCli(cliFile, `SELECT coalesce(json_object('title', title, 'title_source', title_source), 'null') FROM session WHERE id = ${esc(sessId)};`);
+    const parsed = JSON.parse(r.stdout.trim() || 'null');
+    return parsed && typeof parsed === 'object' ? parsed : null;
+  };
+
+  for (const [sessId, rec] of Object.entries(writtenMap)) {
+    if (!/^sess_[A-Za-z0-9._-]+$/.test(sessId) || !rec || typeof rec.title !== 'string') continue;
+    let cli;
+    try { cli = await readCli(sessId); } catch { continue; }
+    // CLI 已不是我们所写的 custom 标题：别人改过（手动改名/官方），不碰
+    if (!cli || cli.title_source !== 'custom' || cli.title !== rec.title) continue;
+    try {
+      if (driver.kind === 'node') {
+        const db = new driver.DatabaseSync(idxFile);
+        try {
+          db.exec(`PRAGMA busy_timeout = ${BUSY_TIMEOUT_MS}`);
+          db.exec('BEGIN IMMEDIATE');
+          try {
+            const r = db.prepare(
+              'UPDATE tasks SET title = ? WHERE task_id = ? AND deleted = 0 AND title_overridden = 1 AND title != ?'
+            ).run(rec.title, sessId, rec.title);
+            db.exec('COMMIT');
+            if (r.changes > 0) repaired.push(sessId);
+          } catch (err) {
+            try { db.exec('ROLLBACK'); } catch { /* 已回滚 */ }
+            throw err;
+          }
+        } finally { db.close(); }
+      } else {
+        const r = runCli(idxFile,
+          'BEGIN IMMEDIATE;\n'
+          + `UPDATE tasks SET title = ${esc(rec.title)} WHERE task_id = ${esc(sessId)} AND deleted = 0 AND title_overridden = 1 AND title != ${esc(rec.title)};\n`
+          + 'SELECT changes();\nCOMMIT;');
+        if (Number(r.stdout.trim()) > 0) repaired.push(sessId);
+      }
+    } catch { /* 占用等：下次再校正 */ }
+  }
+  return repaired;
+}
+
+// 自动起名在写回前重读时看到 custom 会放弃（session-title.ts 的 custom_title 短路），
+// 桌面同步器（zcodeTaskIndexSyncer）会把 custom 标题带着 titleOverridden=1 写回
+// 任务索引——单写任务索引被官方排队的自动标题覆盖的竞态（实测 14 秒后覆盖）由此
+// 消除。time_title_updated/time_updated 与官方 updateSession 一致（title 变更即刷新，
+// time_updated 只增不减）；title_message_id 保留原值。旧版 CLI 库没有 title_source
+// 列时返回 skipped（缺 custom 语义，写了也守不住，退回单写任务索引的旧行为）。
+// 库被占用时抛 index-busy（与任务索引写入同款重试语义）。
+export async function setCustomSessionTitle(dataRoot, sessId, title) {
+  const dbFile = join(dataRoot, 'cli', 'db', 'db.sqlite');
+  if (!existsSync(dbFile)) return { written: false, skipped: 'no-cli-db' };
+  const driver = await loadDriver();
+  if (!driver) {
+    const err = new Error('缺少 SQLite 支持（需要 Node ≥23.4 或 sqlite3 命令）');
+    err.code = 'index-error';
+    throw err;
+  }
+  try {
+    if (driver.kind === 'node') {
+      const db = new driver.DatabaseSync(dbFile);
+      try {
+        const cols = db.prepare("PRAGMA table_info('session')").all();
+        if (!cols.some((c) => c.name === 'title_source')) return { written: false, skipped: 'no-title-source' };
+        db.exec(`PRAGMA busy_timeout = ${BUSY_TIMEOUT_MS}`);
+        db.exec('BEGIN IMMEDIATE');
+        try {
+          const now = Date.now();
+          const r = db.prepare(
+            "UPDATE session SET title = ?, title_source = 'custom', time_title_updated = ?, time_updated = max(time_updated, ?) WHERE id = ?"
+          ).run(title, now, now, sessId);
+          db.exec('COMMIT');
+          return { written: r.changes > 0, skipped: r.changes > 0 ? '' : 'no-session-row' };
+        } catch (err) {
+          try { db.exec('ROLLBACK'); } catch { /* 已回滚/连接失效 */ }
+          throw err;
+        }
+      } finally {
+        db.close();
+      }
+    }
+    const esc = (v) => "'" + String(v).replace(/'/g, "''") + "'";
+    const cols = runCli(dbFile, "PRAGMA table_info('session');").stdout;
+    if (!/title_source/.test(cols)) return { written: false, skipped: 'no-title-source' };
+    const now = Date.now();
+    const r = runCli(dbFile,
+      'BEGIN IMMEDIATE;\n'
+      + `UPDATE session SET title = ${esc(title)}, title_source = 'custom',`
+      + ` time_title_updated = ${now}, time_updated = max(time_updated, ${now})`
+      + ` WHERE id = ${esc(sessId)};\n`
+      + 'SELECT changes();\nCOMMIT;');
+    const changed = Number(r.stdout.trim()) > 0;
+    return { written: changed, skipped: changed ? '' : 'no-session-row' };
+  } catch (err) {
+    if (isBusyError(err)) {
+      const e = new Error('CLI 会话库正被占用（ZCode 可能正在写入）');
+      e.code = 'index-busy';
+      throw e;
+    }
+    const e = new Error('写入 CLI 会话标题失败: ' + (err?.message || err));
+    e.code = 'index-error';
+    throw e;
+  }
+}

package/src/inject/core.js

@@ -67,12 +67,16 @@ const zh = {
   proxyScopeSyncDesc: 'WebDAV 上传与下载走代理。默认关闭：坚果云等国内网盘直连即可，代理停了同步会跟着失败。',
   tabSync: '同步',
   tabDebug: '调试',
-  syncDesc: '手动把 ZCode Pro 设置与模型设置备份到 WebDAV，或在新电脑上恢复。两项各自独立成文件，可只上传或只覆盖其中一项；每次上传会额外保留一份带时间戳的历史版本，下载时任选一个版本恢复；仅在点击按钮时传输，不做自动同步。',
+  syncDesc: '手动把 ZCode Pro 设置与模型设置备份到 WebDAV，或在新电脑上恢复。两项各自独立成文件，可只上传或只覆盖其中一项；每次上传会额外保留一份带时间戳的历史版本（保留多少个见“历史版本”一行，上传后自动删除超出的最旧版本），下载时任选一个版本恢复；仅在点击按钮时传输，不做自动同步。',
   syncUrlPlaceholder: 'https://dav.jianguoyun.com/dav/',
   syncDir: '上传目录',
   syncDirPlaceholder: 'zcode-pro',
   syncLogin: '登录',
   syncPassword: '密码',
+  syncHistoryLimit: '历史版本',
+  syncHistoryLimitUnit: '个',
+  syncHistoryLimitHint: '云端最多保留最近几次上传留下的历史版本，上传成功后自动删除更早的；固定名最新版不受影响；0 = 不保留历史版本',
+  syncPruned: '已清理 {n} 个更早的历史版本',
   syncSave: '保存',
   syncSaved: '同步配置已保存',
   syncFormHint: '同步文件存到“上传目录”（默认 zcode-pro，可多级，自动创建）：zcodepro.json 与 model.json 始终是最新一版，旁边另保留带时间戳的历史版本。',
@@ -93,8 +97,8 @@ const zh = {
   syncConfirmTitle: '从云端下载',
   syncConfirmDesc: '将用所选文件覆盖本机对应的一项（覆盖前会在原文件旁留下 .zcodepro-backup 备份）；本机的同步配置与登录凭据不受影响。模型设置恢复后建议重启 ZCode 生效。确认导入？',
   syncConfirmGo: '确认导入',
-  syncPickDesc: '固定名文件始终是最新一版，带时间戳的是每次上传留下的历史版本；「导入」用所选文件覆盖本机对应的一项。',
-  syncVerDeleteLatestNote: '注意：这是“最新”文件，旧版 zcode-pro 的「从云端下载」依赖它，删除后旧版机器将无法下载；带时间戳的历史版本不受影响。',
+  syncPickDesc: '固定名文件始终是最新一版，带时间戳的是每次上传留下的历史版本；“导入”用所选文件覆盖本机对应的一项。',
+  syncVerDeleteLatestNote: '注意：这是“最新”文件，旧版 zcode-pro 的“从云端下载”依赖它，删除后旧版机器将无法下载；带时间戳的历史版本不受影响。',
   syncHint: '同步登录凭据仅保存在本机 zcodepro.json；模型设置包含自定义供应商的 API Key，只会上传到你自己的 WebDAV。',
   syncTest: '测试',
   syncTesting: '测试中…',
@@ -118,8 +122,8 @@ const zh = {
   syncVerDeleted: '已删除云端备份',
   syncVerSaved: '已保存到',
   devMode: '开发模式',
-  devModeRowDesc: '开启后出现「重载 ZCode Pro」按钮；也可给启动器设环境变量 ZCODEPRO_DEV=1 启用。此标签页仅在开发模式生效时显示。',
-  devModeDesc: '开发调试用：改完 zcode-pro 代码后不必重启 ZCode，点「重载 ZCode Pro」即可加载新代码。流程为自动构建（需在源码目录运行）→ 以新进程重启 ZCode Pro（本地助手与注入脚本都换新）→ 所有 ZCode 窗口自动刷新并重新注入；ZCode 本体与已打开的会话不受影响。',
+  devModeRowDesc: '开启后出现“重载 ZCode Pro”按钮；也可给启动器设环境变量 ZCODEPRO_DEV=1 启用。此标签页仅在开发模式生效时显示。',
+  devModeDesc: '开发调试用：改完 zcode-pro 代码后不必重启 ZCode，点“重载 ZCode Pro”即可加载新代码。流程为自动构建（需在源码目录运行）→ 以新进程重启 ZCode Pro（本地助手与注入脚本都换新）→ 所有 ZCode 窗口自动刷新并重新注入；ZCode 本体与已打开的会话不受影响。',
   devReload: '重载 ZCode Pro',
   devReloading: '重载中…',
   devReloadDesc: '点击后约 2-3 秒内所有 ZCode 窗口自动刷新一次并加载新脚本。',
@@ -140,7 +144,7 @@ const zh = {
   lineHeightName: '回答行高',
   lineHeightDesc: '回答正文的行高（倍数）。',
   thinkingLineHeightName: '思考行高',
-  thinkingLineHeightDesc: '「已工作/工作中」过程记录（读取/编辑/查阅/终端条目与思考内容）的行高（倍数）。',
+  thinkingLineHeightDesc: '“已工作/工作中”过程记录（读取/编辑/查阅/终端条目与思考内容）的行高（倍数）。',
   userLineHeightName: '提问行高',
   userLineHeightDesc: '提问内容的行高（倍数）。',
   contentWidthName: '内容宽度',
@@ -429,12 +433,16 @@ const en = {
   proxyScopeSyncDesc: 'WebDAV upload and download go through the proxy. Off by default: domestic WebDAV providers work fine direct, and a stopped proxy breaks sync.',
   tabSync: 'Sync',
   tabDebug: 'Debug',
-  syncDesc: 'Manually back up ZCode Pro settings and model settings to WebDAV, or restore them on a new computer. The two items are stored as separate files, so you can upload or overwrite either one alone; every upload also keeps a timestamped history version and download lets you pick any of them. Data moves only when you click, never automatically.',
+  syncDesc: 'Manually back up ZCode Pro settings and model settings to WebDAV, or restore them on a new computer. The two items are stored as separate files, so you can upload or overwrite either one alone; every upload also keeps a timestamped history version (how many to keep is set in the "History" row; older ones are removed automatically after upload) and download lets you pick any of them. Data moves only when you click, never automatically.',
   syncUrlPlaceholder: 'https://dav.example.com/dav/',
-  syncDir: '上传目录',
+  syncDir: 'Folder',
   syncDirPlaceholder: 'zcode-pro',
   syncLogin: 'Login',
   syncPassword: 'Password',
+  syncHistoryLimit: 'History',
+  syncHistoryLimitUnit: 'versions',
+  syncHistoryLimitHint: 'How many recent uploads keep their history versions on the server; older ones are removed automatically after a successful upload. The fixed-name latest file is never removed. 0 = keep no history versions.',
+  syncPruned: 'removed {n} older history versions',
   syncSave: 'Save',
   syncSaved: 'Sync settings saved.',
   syncFormHint: 'Sync files go inside the folder (default zcode-pro, multi-level allowed, created automatically): zcodepro.json and model.json are always the latest version; timestamped history versions are kept alongside.',
@@ -895,7 +903,7 @@ export function observeRadixPopups(onPopup) {
     }
     // 兜底：直接观察 role=menu 的 content。延迟一帧再回调——Radix 偶尔分两帧渲染
     // （先挂 menu 容器、下一帧才填菜单项），立即回调时菜单项为空，调用方找不到
-    // 锚点项就永远漏注入（菜单项填入不会再产生 role=menu 节点添加事件）
+    // 参照的菜单项就永远漏注入（菜单项填入不会再产生 role=menu 节点添加事件）
     if (node.getAttribute && node.getAttribute('role') === 'menu' && !seen.has(node)) {
       seen.add(node);
       requestAnimationFrame(() => {