zcode-pro 0.19.0 → 0.20.1

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

@@ -25,7 +25,7 @@ function makeUpgradeControls({ endpoint, metaRefresh, idleText }) {
   const hasIdle = () => typeof idleText === 'function';
   const setState = (text, kind = '') => {
     const shown = text || (hasIdle() ? (idleText() || '') : '');
-    // 「 · 」前缀：与前面的版本行无缝拼成「插件 x · rtk y · 状态/路径」一行；
+    // “ · ”前缀：与前面的版本行直接拼成“插件 x · rtk y · 状态/路径”一行；
     // 错误信息不加前缀——它是独立提示，拼在版本行后会读成版本的一部分
     state.textContent = shown ? (kind === 'error' ? shown : ` · ${shown}`) : '';
     state.className = 'min-w-0 flex-1 truncate text-left text-ui-xs/relaxed '
@@ -618,7 +618,7 @@ export function openSettingsDialog() {
           agentsSaveBtn.disabled = false;
         }
       };
-      // “行为”标签页：二级标签切换「全局提示词 / 任务名」。全局提示词编辑
+      // “行为”标签页：二级标签切换“全局提示词 / 任务名”。全局提示词编辑
       // ~/.zcode/AGENTS.md；任务名（智能起名）面板复用 paneTitleGen（原本是
       // 一级标签页，收进来后不再单独出现在顶部标签栏）
       const agentsPromptPane = h('div', { class: 'mt-4' });
@@ -681,7 +681,7 @@ export function openSettingsDialog() {
       const proxyTestBtn = btnSmall(L.proxyTest, () => { void runProxyTest(); }, 'shrink-0');
       const runProxyTest = async () => {
         if (proxyTesting) return;
-        // 空地址不发请求（等网络超时才报「检测失败」的体验太差），立即提示
+        // 空地址不发请求（等网络超时才报“检测失败”的体验太差），立即提示
         if (!proxyInput.value.trim()) {
           proxyTestState.className = 'mt-2 text-ui-xs/relaxed text-amber-500';
           proxyTestState.textContent = L.proxyTestEmpty;
@@ -799,19 +799,37 @@ export function openSettingsDialog() {
       // “同步”：把 ZCode Pro 设置与模型设置手动备份到 WebDAV / 从 WebDAV 恢复
       // （交互参考 Tampermonkey：URL/登录/密码 + 手动触发，无自动同步）。仅 WebDAV
       // 一种后端且本就只在点击时传输，不设“类型/禁用”下拉。表单显式保存（旁有
-      // 「测试」用当前表单值验证连通）；同步内容开关即时保存；下载先弹云端版本
+      // “测试”用当前表单值验证连通）；同步内容开关即时保存；下载先弹云端版本
       // 列表（固定名 = 最新 + 带时间戳的历史），任选一个导入，导入会覆盖本机、
       // 先弹二次确认
       const savedSync = (config.sync && typeof config.sync === 'object') ? config.sync
         : { url: '', dir: 'zcode-pro', login: '', password: '', include: { zcodepro: true, model: true }, lastPushAt: null, lastPullAt: null };
-      const syncInputCls = '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';
+      // 宽度分开拼：定宽控件（历史版本数字框）不能带 w-full——与 w-20 同用时
+      // w-full 在样式表里靠后、会胜出，把整行撑爆
+      const syncInputBase = 'h-8 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';
+      const syncInputCls = syncInputBase + ' w-full';
+      const syncLabel = (text) => h('span', { class: 'w-20 shrink-0 text-ui-sm font-medium text-foreground' }, text);
       const syncFormRow = (labelText, node) => h('div', { class: 'flex items-center gap-3 px-2 py-1.5' },
-        h('span', { class: 'w-20 shrink-0 text-ui-sm font-medium text-foreground' }, labelText), node);
+        syncLabel(labelText), node);
       const syncUrlInput = h('input', { type: 'text', value: savedSync.url || '', placeholder: L.syncUrlPlaceholder, spellcheck: 'false', autocomplete: 'off', class: syncInputCls + ' min-w-0 flex-1' });
       // 上传目录：拼在 URL 之后的文件夹（默认 zcode-pro，避免直接写进网盘根目录），可多级
       const syncDirInput = h('input', { type: 'text', value: savedSync.dir || 'zcode-pro', placeholder: L.syncDirPlaceholder, spellcheck: 'false', autocomplete: 'off', class: syncInputCls + ' min-w-0 flex-1' });
       const syncLoginInput = h('input', { type: 'text', value: savedSync.login || '', spellcheck: 'false', autocomplete: 'off', class: syncInputCls + ' min-w-0 flex-1' });
       const syncPasswordInput = h('input', { type: 'password', value: savedSync.password || '', autocomplete: 'new-password', class: syncInputCls + ' min-w-0 flex-1' });
+      // 历史版本保留个数：上传成功后自动删除云端更早的历史版本（固定名最新版不受
+      // 影响）；0 = 不留历史版本。非法输入按默认 10 提交（服务端还会再校验）
+      const syncHistoryInput = h('input', {
+        type: 'number', min: '0', max: '100', step: '1',
+        value: Number.isInteger(savedSync.historyLimit) ? savedSync.historyLimit : 10,
+        title: L.syncHistoryLimitHint, class: syncInputBase + ' w-20 shrink-0 text-center',
+      });
+      const syncHistoryValue = () => {
+        // 清空按默认 10 提交，不当成 0——0 会清掉云端全部历史版，误清空代价太大
+        const s = syncHistoryInput.value.trim();
+        if (!s) return 10;
+        const n = Number(s);
+        return Number.isFinite(n) ? Math.min(100, Math.max(0, Math.round(n))) : 10;
+      };
       let syncFormOriginal = null;
       const syncSaveBtn = btnSmall(L.syncSave, () => { void saveSyncForm(); }, 'shrink-0', 'primary');
       const syncFormValues = () => ({
@@ -819,15 +837,17 @@ export function openSettingsDialog() {
         dir: syncDirInput.value.trim(),
         login: syncLoginInput.value.trim(),
         password: syncPasswordInput.value,
+        historyLimit: syncHistoryValue(),
       });
       const syncCheckDirty = () => {
         const c = syncFormValues();
         syncSaveBtn.disabled = c.url === syncFormOriginal.url && c.dir === syncFormOriginal.dir
-          && c.login === syncFormOriginal.login && c.password === syncFormOriginal.password;
+          && c.login === syncFormOriginal.login && c.password === syncFormOriginal.password
+          && c.historyLimit === syncFormOriginal.historyLimit;
       };
       syncFormOriginal = syncFormValues();
       syncSaveBtn.disabled = true;
-      for (const el of [syncUrlInput, syncDirInput, syncLoginInput, syncPasswordInput]) {
+      for (const el of [syncUrlInput, syncDirInput, syncLoginInput, syncPasswordInput, syncHistoryInput]) {
         el.addEventListener('input', syncCheckDirty);
       }
       const saveSyncForm = async () => {
@@ -838,18 +858,20 @@ export function openSettingsDialog() {
             url: res.sync.url,
             dir: res.sync.dir,
             login: res.sync.login, password: res.sync.password,
+            historyLimit: Number.isInteger(res.sync.historyLimit) ? res.sync.historyLimit : 10,
           };
           syncUrlInput.value = res.sync.url;
           syncDirInput.value = res.sync.dir;
           syncLoginInput.value = res.sync.login;
           syncPasswordInput.value = res.sync.password;
+          syncHistoryInput.value = syncFormOriginal.historyLimit;
           showToast(L.syncSaved);
         } else {
           showToast(L.failed + ': ' + errText(res), 'error');
           syncCheckDirty();
         }
       };
-      // 「测试」：用表单当前值（先测再存）验证 WebDAV：连接与凭据 → 上传目录
+      // “测试”：用表单当前值（先测再存）验证 WebDAV：连接与凭据 → 上传目录
       // （缺则自动建，等同上传时的行为）→ 文件列表；结果仿“代理”标签页的检测，
       // 一行显示各步耗时与云端备份文件数
       const syncTestState = h('p', { class: 'mt-2 text-ui-xs/relaxed text-foreground-subtle' });
@@ -933,7 +955,7 @@ export function openSettingsDialog() {
       renderSyncStatus(savedSync);
       const syncUploadBtn = btnSmall(L.syncUpload, () => { void runSyncPush(); }, 'shrink-0', 'primary');
       const syncDownloadBtn = btnSmall(L.syncDownload, () => { openSyncVersionPicker(); }, 'shrink-0');
-      // 「从云端下载」先弹版本列表（备份管理器的样子）：列出云端目录里的备份文件
+      // “从云端下载”先弹版本列表（备份管理器的样子）：列出云端目录里的备份文件
       // （固定名 = 最新一版 + 带时间戳的历史），每行可导入到本机 / 从云端删除 /
       // 另存到本机磁盘；导入按文件名前缀决定覆盖哪一项，不受“同步内容”勾选影响
       const openSyncVersionPicker = () => {
@@ -1116,16 +1138,21 @@ export function openSettingsDialog() {
           return;
         }
         renderSyncStatus(res.sync || {});
-        showToast(L.syncUploaded, 'success');
+        showToast(res.pruned ? L.syncUploaded + (isZhLocale() ? '；' : '; ') + L.syncPruned.replace('{n}', res.pruned) : L.syncUploaded, 'success');
       };
       paneSync.append(
         h('p', { class: 'text-ui-sm/relaxed text-foreground-subtle' }, L.syncDesc),
         h('div', { class: 'mt-3 rounded-xl border border-border p-1' },
           syncFormRow('URL', syncUrlInput),
-          syncFormRow(L.syncDir, syncDirInput),
-          syncFormRow(L.syncLogin, syncLoginInput),
-          syncFormRow(L.syncPassword, syncPasswordInput),
-          h('div', { class: 'flex items-start justify-between gap-2 px-2 py-1.5' },
+          // 登录与密码一行、上传目录与历史版本一行：短字段成对排，少占纵向空间
+          h('div', { class: 'flex items-center gap-3 px-2 py-1.5' },
+            syncLabel(L.syncLogin), syncLoginInput,
+            syncLabel(L.syncPassword), syncPasswordInput),
+          h('div', { class: 'flex items-center gap-3 px-2 py-1.5' },
+            syncLabel(L.syncDir), syncDirInput,
+            syncLabel(L.syncHistoryLimit), syncHistoryInput,
+            h('span', { class: 'shrink-0 text-ui-xs text-foreground-subtle' }, L.syncHistoryLimitUnit)),
+          h('div', { class: 'flex items-center justify-between gap-2 px-2 py-1.5' },
             h('div', { class: 'min-w-0' },
               h('p', { class: 'text-ui-xs/relaxed text-foreground-subtle' }, L.syncFormHint),
               syncRecLine),
@@ -1183,21 +1210,21 @@ export function openSettingsDialog() {
       // “视觉代理”：编辑 ~/.zcode/zcode-vision.json（zcode-vision 插件与 /vision-* 命令共用同一文件）。
       // 代理列表顺序即执行链；结构性改动（开关/模式/排序/删增）即时保存，文本输入防抖保存。
       // 注意：保存时链按全部代理重建——若用 /vision-chain 配过子集链，会被这里覆盖（两套入口语义如此，面板以列表为准）。
-      // 默认两级链与 zcode-vision 插件 DEFAULT_CONFIG 保持一致：glm-session（跟随会话）→ glm-flash（GLM 订阅直连）。
+      // 默认单级链与 zcode-vision 插件 DEFAULT_CONFIG 保持一致：session（跟随会话供应商、
+      // 模型留空=会话当前模型）。需要兜底级可手动加 GLM 订阅直连。
       // 赠送额度级 trust-build 暂不进默认：ZCode 网关不放行无人值守调用（ADR-0002）。
       const VISION_DEFAULT_PROMPT = '请详细描述这张图片的全部内容。若是界面或图表截图，请先把所有错误、警告、异常状态逐字引用出来（含完整原文），再描述整体布局、文字与关键数据。';
       const VISION_DEFAULT_CFG = {
         enabled: true,
         chainMode: 'fallback',
-        chain: ['glm-session', 'glm-flash'],
+        chain: ['session'],
         proxies: [
-          { name: 'glm-session', useProvider: 'session', model: 'glm-5.3-flash', prompt: VISION_DEFAULT_PROMPT },
-          { name: 'glm-flash', baseUrl: 'https://open.bigmodel.cn/api/anthropic', model: 'glm-5.3-flash', apiKey: '', format: 'anthropic', prompt: VISION_DEFAULT_PROMPT },
+          { name: 'session', useProvider: 'session', model: '', prompt: VISION_DEFAULT_PROMPT },
         ],
         pollMs: 3000,
         apiTimeoutMs: 120000, // 视觉上游冷启动可能近 2 分钟，与插件 DEFAULT_CONFIG 一致
         compressThresholdKB: 1024,
-        skipAfterFailures: 4,
+        skipAfterFailures: 2,
         skipMinutes: 30,
         forceIntercept: true,
       };
@@ -1257,7 +1284,7 @@ export function openSettingsDialog() {
         }
         // 插件未装优先显示安装卡——判断只看钩子（visionRes.hook），与配置文件是否存在无关：
         // 配置是钩子消费的，没钩子就没功能；老用户卸载插件后 ~/.zcode/zcode-vision.json 仍在，
-        // 若按配置存在与否分流会误入完整配置界面而毫无「未安装」提示
+        // 若按配置存在与否分流会误入完整配置界面而毫无“未安装”提示
         if (!visionRes.hook) {
           paneVision.replaceChildren(
             h('p', { class: 'text-ui-sm/relaxed text-foreground-subtle' }, L.visionDesc),
@@ -1316,7 +1343,23 @@ export function openSettingsDialog() {
         };
         // 接口地址 / API Key 是否显示走 provider-fields 的共用规则
         //（isManualConn：不跟随或供应商已删才显示，连接其余由跟随对象负责）
-        const cards = visionCfg.proxies.map((p, i) => h('div', { class: 'mt-2 rounded-xl border border-border p-2' },
+        const cards = visionCfg.proxies.map((p, i) => {
+          // 不跟随（或供应商已删）才显示的手动连接行：接口地址 + API Key + 协议
+          // 三栏一行（与智能起名同款）；协议跟随供应商解析，平时不显示
+          const manualConnCard = isManualConn(p.useProvider, titleGenProviders)
+            ? [h('div', { class: 'mt-2 grid grid-cols-1 gap-2 rounded-xl border border-border p-2 sm:grid-cols-3' },
+              field(L.visionBaseUrl, textIn(p.baseUrl, (v) => { p.baseUrl = v; saveVisionSoon(); })),
+              field(L.visionApiKey, textIn(p.apiKey, (v) => { p.apiKey = v; saveVisionSoon(); }, { type: 'password' })),
+              field(L.titleGenFormat, (() => {
+                const sel = h('select', { class: 'h-8 w-full rounded-lg border border-border bg-input px-2 text-ui-sm text-foreground outline-none' },
+                  h('option', { value: 'anthropic' }, 'anthropic'),
+                  h('option', { value: 'openai' }, 'openai'));
+                sel.value = p.format === 'openai' ? 'openai' : 'anthropic';
+                sel.addEventListener('change', () => { p.format = sel.value; void persistVision(); });
+                return sel;
+              })()))]
+            : [];
+          return h('div', { class: 'mt-2 rounded-xl border border-border p-2' }, [
           h('div', { class: 'flex flex-wrap items-center gap-2' },
             h('span', { class: 'shrink-0 rounded-md bg-surface px-1.5 py-0.5 text-ui-xs tabular-nums text-foreground-subtle' }, String(i + 1)),
             // 名称输入框用 flex-1 占剩余宽度，与序号同行；textIn 的 w-full 会把序号挤成单独一行
@@ -1325,14 +1368,6 @@ export function openSettingsDialog() {
               n.addEventListener('input', () => { p.name = n.value; saveVisionSoon(); });
               return n;
             })(),
-            (() => {
-              const sel = h('select', { class: 'h-7 shrink-0 rounded-lg border border-border bg-input px-1.5 text-ui-xs text-foreground outline-none' },
-                h('option', { value: 'anthropic' }, 'anthropic'),
-                h('option', { value: 'openai' }, 'openai'));
-              sel.value = p.format === 'openai' ? 'openai' : 'anthropic';
-              sel.addEventListener('change', () => { p.format = sel.value; void persistVision(); });
-              return sel;
-            })(),
             smallBtn(L.visionMoveUp, () => {
               if (i <= 0) return;
               visionCfg.proxies.splice(i - 1, 0, visionCfg.proxies.splice(i, 1)[0]);
@@ -1347,18 +1382,18 @@ export function openSettingsDialog() {
           ),
           h('div', { class: 'mt-2 grid grid-cols-1 gap-2 sm:grid-cols-2' },
             // 供应商与模型走 provider-fields 共用逻辑：跟随会话时模型下拉为
-            // 全部供应商模型汇总，具体供应商为其模型列表；已删 id 标注「已删除」
+            // 全部供应商模型汇总，具体供应商为其模型列表；已删 id 标注“已删除”
             field(L.visionUseProvider, comboField(p.useProvider || '',
               providerOptionsOf(titleGenProviders, L),
               (v, src) => {
                 p.useProvider = v;
                 saveVisionSoon();
                 // 下拉切换后重渲染整个面板：模型下拉选项随新供应商变化，接口
-                // 地址/API Key 字段按「不跟随或供应商已删才显示」重新显隐
+                // 地址/API Key 字段按“不跟随或供应商已删才显示”重新显隐
                 if (src === 'select') renderVision();
               },
               { placeholder: L.titleGenProviderSession, staleLabel: L.titleGenProviderDeleted })),
-            // 跟随会话时模型下拉头部有「跟随当前会话当前模型」（值为空，
+            // 跟随会话时模型下拉头部有“跟随当前会话当前模型”（值为空，
             // 插件 ≥1.6.1 在调用时解析为会话当前模型）；具体供应商为其模型列表
             field(L.visionModel, comboField(p.model || '',
               modelOptionsOf(p.useProvider, titleGenProviders, {
@@ -1371,18 +1406,16 @@ export function openSettingsDialog() {
                 emptyLabel: (p.useProvider || '').trim() === 'session'
                   ? L.titleGenModelFollowSession : L.titleGenModelEmpty,
               })),
-            ...(isManualConn(p.useProvider, titleGenProviders) ? [
-              field(L.visionBaseUrl, textIn(p.baseUrl, (v) => { p.baseUrl = v; saveVisionSoon(); })),
-              field(L.visionApiKey + ' · ' + L.visionApiKeyHint, textIn(p.apiKey, (v) => { p.apiKey = v; saveVisionSoon(); }, { type: 'password' })),
-            ] : []),
           ),
+          ...manualConnCard,
           (() => {
             const n = h('textarea', { class: 'zcodepro-textarea zcodepro-textarea-sm', rows: '3', placeholder: L.visionPrompt });
             n.value = p.prompt || '';
             n.addEventListener('input', () => { p.prompt = n.value; saveVisionSoon(); });
             return field(L.visionPrompt, n);
           })(),
-        ));
+          ]);
+        });
         let testBtn;
         testBtn = smallBtn(L.visionTest, async () => {
           testBtn.disabled = true;
@@ -1393,7 +1426,6 @@ export function openSettingsDialog() {
           testBtn.disabled = false;
           testBtn.textContent = L.visionTest;
           visionTestPre.textContent = res.output || res.error || '';
-          if (!res.ok) showToast(L.visionTestFailed + ': ' + errText(res), 'error');
         });
         paneVision.replaceChildren(
           h('p', { class: 'text-ui-sm/relaxed text-foreground-subtle' }, L.visionDesc),
@@ -1434,7 +1466,7 @@ export function openSettingsDialog() {
               return h('label', { class: 'flex shrink-0 items-center gap-1.5', title: L.visionCompressKBHint },
                 h('span', { class: 'text-ui-xs font-medium text-foreground-subtle' }, L.visionCompressKB), n);
             })(),
-            numIn(visionCfg.skipAfterFailures, { min: 0, dflt: 4, title: L.visionSkipAfterFailuresHint, label: L.visionSkipAfterFailures, commit: (v) => { visionCfg.skipAfterFailures = v; } }),
+            numIn(visionCfg.skipAfterFailures, { min: 0, dflt: 2, title: L.visionSkipAfterFailuresHint, label: L.visionSkipAfterFailures, commit: (v) => { visionCfg.skipAfterFailures = v; } }),
             numIn(visionCfg.skipMinutes, { min: 1, dflt: 30, title: L.visionSkipMinutesHint, label: L.visionSkipMinutes, commit: (v) => { visionCfg.skipMinutes = v; } }),
           ),
           ...cards,
@@ -1442,7 +1474,7 @@ export function openSettingsDialog() {
             h('div', { class: 'flex items-center gap-1.5' },
               smallBtn('+ ' + L.visionAddProxy, () => {
                 // 名称留空时 helper 校验会拒绝保存；等用户输入名称后防抖保存
-                visionCfg.proxies.push({ name: '', baseUrl: 'https://open.bigmodel.cn/api/anthropic', model: 'glm-5.3-flash', apiKey: '', format: 'anthropic', prompt: '' });
+                visionCfg.proxies.push({ name: '', baseUrl: 'https://open.bigmodel.cn/api/anthropic', model: 'glm-5.3-flash', apiKey: '', format: 'anthropic', prompt: VISION_DEFAULT_PROMPT });
                 renderVision();
               }),
               smallBtn(L.visionResetChain, () => {
@@ -1452,7 +1484,9 @@ export function openSettingsDialog() {
                 void persistVision();
                 renderVision();
               })),
-            testBtn),
+            h('div', { class: 'flex min-w-0 items-center justify-end gap-2' },
+              h('span', { class: 'min-w-0 text-right text-ui-xs/relaxed text-foreground-subtle' }, L.testNoSessionHint),
+              testBtn)),
           visionTestPre,
         );
       };
@@ -2069,7 +2103,7 @@ export function openSettingsDialog() {
           h('span', { class: 'mb-1 block text-ui-xs font-medium text-foreground-subtle' }, labelText), node);
         // 供应商 / 模型 / 地址密钥共用 provider-fields 的规则（详见该模块说明）。
         // 换供应商后重渲染：模型下拉换成新供应商的模型、地址字段按模式显隐；
-        // 手动输入过的模型保留（不在新列表里时显示为「手动输入」项，是否改选
+        // 手动输入过的模型保留（不在新列表里时显示为“手动输入”项，是否改选
         // 由用户决定）
         const showInlineConn = isManualConn(titleGenCfg.provider, titleGenProviders);
         const providerCombo = comboField(
@@ -2117,7 +2151,7 @@ export function openSettingsDialog() {
           field(L.titleGenBaseUrl, textIn(titleGenCfg.baseUrl, (v) => { titleGenCfg.baseUrl = v; saveTitleGenSoon(); }, { placeholder: 'https://…' })),
           field(L.titleGenApiKey, textIn(titleGenCfg.apiKey, (v) => { titleGenCfg.apiKey = v; saveTitleGenSoon(); }, { type: 'password' })),
           field(L.titleGenFormat, formatSel));
-        // 提示词：留空 = 内置默认；「查看默认提示词」把默认值载入编辑框供修改
+        // 提示词：留空 = 内置默认；“查看默认提示词”把默认值载入编辑框供修改
         const promptArea = h('textarea', {
           class: 'zcodepro-textarea zcodepro-textarea-sm', rows: '8',
           placeholder: L.titleGenPromptPlaceholder,
@@ -2147,11 +2181,9 @@ export function openSettingsDialog() {
           testBtn.textContent = L.titleGenTest;
           if (res && res.ok) {
             testState.textContent = L.titleGenTestOk + res.title;
-            showToast(res.title, 'success');
           } else {
             testState.textContent = (res && errText(res)) || L.titleGenTestFailed;
             testState.className = 'min-w-0 flex-1 truncate text-ui-xs/relaxed text-destructive';
-            showToast(L.titleGenTestFailed + ': ' + (res ? errText(res) : ''), 'error');
           }
         }, 'shrink-0');
         paneTitleGen.replaceChildren(
@@ -2179,9 +2211,13 @@ export function openSettingsDialog() {
                 promptArea.focus();
               })),
             promptArea),
-          // 测试
-          h('div', { class: 'mt-2 flex items-center gap-2 rounded-xl border border-border p-2' },
-            sampleInput, testBtn),
+          // 测试（两行：输入框整行；说明 + 按钮一行。结果只显示在本区下方，
+          // 不弹窗；从没对话过时的引导见 testState 错误文案）
+          h('div', { class: 'mt-2 rounded-xl border border-border p-2' },
+            sampleInput,
+            h('div', { class: 'mt-2 flex items-center justify-between gap-2' },
+              h('span', { class: 'min-w-0 text-ui-xs/relaxed text-foreground-subtle' }, L.testNoSessionHint),
+              testBtn)),
           testState,
         );
       };

package/src/inject/features/styles.js

@@ -140,7 +140,7 @@ function buildCss(styles) {
   }
   const tlh = styles.thinkingLineHeight;
   if (typeof tlh === 'number' && Number.isFinite(tlh) && tlh >= 0.8) {
-    // 「思考行高」管“已工作/工作中 N 秒”过程视图的行距（读取/编辑/查阅/终端等
+    // “思考行高”管“已工作/工作中 N 秒”过程视图的行距（读取/编辑/查阅/终端等
     // 条目行、流式思考预览，默认 1.5）：行高挂在历史内容容器上由各行继承；
     // 过程里的叙述正文走 .space-y-4（回答行高，选择器更具体压过这里的继承）。
     // 单独展开的“思考·持续了 N 秒”块内内容不在此设置范围内

package/src/inject/features/task-order.js

@@ -29,7 +29,7 @@ export function startTaskOrderWatcher() {
     if (!row || row.getAttribute('data-task-item-key') === dragKey) return;
     e.preventDefault();
     if (e.dataTransfer) e.dataTransfer.dropEffect = 'move';
-    // 实时预览：把拖动行移动到目标行前/后（拖动期间 React 不重渲染；落库后刷新重建）
+    // 实时预览：把拖动行移动到目标行前/后（拖动期间 React 不重渲染；写入数据库后刷新重建）
     const rect = row.getBoundingClientRect();
     const before = e.clientY < rect.top + rect.height / 2;
     const src = [...row.parentElement.querySelectorAll('[data-task-item-key]')]

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

@@ -111,7 +111,16 @@ async function onNewTaskRow(key) {
   } finally { convObserver.disconnect(); }
   if (!texts.length) return;
 
-  const res = await rpc('/title-gen/run', { method: 'POST', body: { sessId, text: texts.join('\n') } }).catch(() => null);
+  // 失败静默但重试（模型调用偶发失败不应让本次会话永远失去标题）：5 秒一次
+  // 错开瞬时抖动；20 秒一次兜住“会话刚建的几秒内索引模型信息未写定”
+  //（实测新会话 8 秒时解析到的模型不存在，稍后即正常）
+  const callTitleGen = () => rpc('/title-gen/run', { method: 'POST', body: { sessId, text: texts.join('\n') } }).catch(() => null);
+  let res = await callTitleGen();
+  for (const delay of [5000, 20000]) {
+    if (res && res.ok) break;
+    await sleep(delay);
+    res = await callTitleGen();
+  }
   // written=false 常见于用户已抢先手动重命名——尊重手动命名，不提示
   if (res && res.ok && res.written && res.title) {
     setRowTitle(key, res.title);

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

@@ -11,7 +11,10 @@
 //   用户刚完成的重命名（新名先上屏、写库在毫秒级）此时表已更新成新名，
 //   不会把新名改回旧名；拉表失败则本轮不干预（缓存可能过时）；
 // - 行内有输入框（正在重命名）不干预；回写后再复核一次，纠正数据库写入
-//   导致的误回写。
+//   导致的误回写；
+// - 右键“重命名任务”的弹窗预填应用内部状态里的标题（被自动标题覆盖过的
+//   会话即旧名），在弹窗里直接点确认会把旧名写回成手动重命名、撤销锁定——
+//   点中重命名菜单项后把预填值换成锁定名兜住这个口子（见 prefillRenameDialog）。
 // 扫描事件驱动（任务行相关变动去抖 150ms；characterData 必须订阅——React
 // 改标题文本走 nodeValue，只产生 characterData 变动）+ 低频兜底轮询。
 import { rpc } from '../core.js';
@@ -216,18 +219,73 @@ export function refreshPinnedTitles() {
   return fetchPinned().then((m) => { if (m) scan(); });
 }
 
+// —— 重命名弹窗预填锁定名 ——
+// 官方“重命名任务”弹窗（[role=dialog] 内的输入框）预填应用内部状态里的标题，
+// 被自动标题覆盖过的会话即旧名；用户在弹窗里不做修改直接确认，会把旧名当成
+// 手动重命名写库、悄悄撤销锁定。右键任务行记下会话、点到“重命名”菜单项后才
+// 武装预填（右键菜单里“分组”“反馈问题”等也会弹输入框，只按右键窗口判定会
+// 误写它们）；且只改已有预填值的输入框——官方重命名弹窗必带当前标题，反馈、
+// 新建分组这类空白输入框不碰
+const RENAME_CTX_VALID_MS = 15000; // 点中重命名菜单项到弹窗出现的有效窗口
+let renameCtx = null;              // { key, at, armed } 最近右键的任务行
+const renamePrefilled = new WeakSet(); // 已预填过的输入框，不重复处理、不与输入争抢
+
+// 原位写值并让 React 受控输入接住：直接 el.value = x 不派发事件，框架状态
+// 会把值改回原样；用原型 setter 写入再派发 input 事件（实测有效）
+function setNativeValue(el, text) {
+  if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+    Object.getOwnPropertyDescriptor(el.constructor.prototype, 'value').set.call(el, text);
+  } else {
+    el.textContent = text;
+  }
+  el.dispatchEvent(new Event('input', { bubbles: true }));
+}
+
+function prefillRenameDialog() {
+  if (!renameCtx || !renameCtx.armed || Date.now() - renameCtx.at > RENAME_CTX_VALID_MS) { renameCtx = null; return; }
+  if (!enabled || !pinned) return;
+  const want = pinned.get(sessIdOf(renameCtx.key));
+  if (want === undefined) return; // 该会话没重命名过：弹窗显示的就是官方值，不动
+  for (const el of document.querySelectorAll('[role="dialog"] input, [role="dialog"] textarea, [role="dialog"] [contenteditable="true"]')) {
+    if (renamePrefilled.has(el) || !el.getClientRects().length) continue;
+    if (el.closest(TASK_SEL) || el.closest('.zcodepro-overlay')) continue;
+    const cur = String((el.value ?? el.textContent) ?? '').trim();
+    if (!cur) continue; // 空白输入框不是重命名弹窗（反馈/新建分组等），不碰
+    renamePrefilled.add(el);
+    if (cur !== String(want).trim()) setNativeValue(el, String(want));
+    renameCtx = null; // 一次重命名只预填最先出现的非空输入框
+    return;
+  }
+}
+
 export function startTitleLock() {
   if (installed || typeof document === 'undefined') return;
   installed = true;
   void bootstrap();
 
   new MutationObserver((muts) => {
+    if (renameCtx) prefillRenameDialog();
     if (!taskRowMutations(muts)) return;
     refreshMapSoon();
     scheduleScan();
   })
     .observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['class'], characterData: true });
 
+  // 右键记下目标会话（捕获阶段，菜单未弹出前）；点中“重命名”菜单项才武装预填
+  //（从点菜单项起重新计有效窗口）。右键空白处则清掉，避免误改无关弹窗
+  document.addEventListener('contextmenu', (e) => {
+    const row = e.target instanceof Element && e.target.closest(TASK_SEL);
+    renameCtx = row ? { key: row.getAttribute('data-task-item-key') || '', at: 0, armed: false } : null;
+  }, true);
+  document.addEventListener('click', (e) => {
+    if (!renameCtx || renameCtx.armed) return;
+    const item = e.target instanceof Element && e.target.closest('[role="menuitem"], [data-radix-collection-item]');
+    if (item && /重命名|rename/i.test(item.textContent || '')) {
+      renameCtx.armed = true;
+      renameCtx.at = Date.now();
+    }
+  }, true);
+
   // 启动期取表失败（helper 未就绪/索引暂不可读）时退避重试，成功即停
   scheduleBootRetry();
 

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

@@ -145,7 +145,7 @@ function handleRemovals(muts) {
     })
     .filter(Boolean);
   if (!infos.length) return;
-  // 展开态判定等本批渲染全部落地后再做（aria-expanded 可能与行移除分两次提交）
+  // 展开态判定等本批渲染全部完成后再做（aria-expanded 可能与行移除分两次提交）
   setTimeout(() => {
     for (const info of infos) {
       const row = findWsRow(info.ws);

package/src/inject/provider-fields.js

@@ -2,13 +2,13 @@
 // 设置面板共用，后续其他面板直接复用这里的组件与规则。供应商取值约定：
 // - ''：不跟随（自填接口地址 + API Key + 协议直连）；
 // - 'session'：跟随当前会话（连接由会话侧解析，不存地址密钥）；
-// - 其余：供应商 id；已删的 id 保留为「已删除」选项，调用方靠保存的地址/
+// - 其余：供应商 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 空选项，避免下拉框
 // 假装选中第一项而配置里其实没选