zcode-pro 0.19.0 → 0.20.0

package/src/host/helper.mjs

@@ -4,19 +4,19 @@
 
 import { createServer } from 'node:http';
 import { execFile, spawn, spawnSync } from 'node:child_process';
-import { chmodSync, copyFileSync, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, readlinkSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { appendFileSync, chmodSync, copyFileSync, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, readlinkSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
 import { mkdtemp } from 'node:fs/promises'; // 注意：fs 的 mkdtemp 是回调版，await 它会把 undefined 当回调
 import { basename, delimiter, dirname, isAbsolute, join, resolve, sep } from 'node:path';
 import { homedir, tmpdir } from 'node:os';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { readSettings, writeSettingsAtomic, remapSettingsPaths, isProjectOpenInTabs } from './settings.mjs';
-import { taskIndexPath, probeTaskIndexWritable, remapTaskIndexPaths, taskIndexDriverAvailable, listOverriddenTitles, listTaskWorkspaceMap, setTaskTitleIfNotOverridden, getTaskProviderModel } from './taskIndex.mjs';
+import { taskIndexPath, probeTaskIndexWritable, remapTaskIndexPaths, taskIndexDriverAvailable, listOverriddenTitles, listTaskWorkspaceMap, setTaskTitleIfNotOverridden, setCustomSessionTitle, isTaskTitleOverridden, reconcileCustomTitles, getTaskProviderModel } from './taskIndex.mjs';
 import { pickFolderSystem } from './pickFolder.mjs';
 import { reorderWorkspaceTasks, reorderGroupMembers } from './taskOrder.mjs';
 import { webdavRequest, webdavPutWithMkcol, webdavHttpText, parseWebdavListing, findCurl } from './webdav.mjs';
 import { resolveZcodeExecutable } from './paths.mjs';
 
-const VERSION = '0.19.0';
+const VERSION = '0.20.0';
 
 // 全局提示词固定在用户主目录：官方加载器按 HOME/USERPROFILE 拼 .zcode/AGENTS.md，
 // 不读 ZCODE_DATA_BASE_DIR（数据根迁走时全局指令仍在原位）。
@@ -104,6 +104,7 @@ export function defaultConfig() {
     //（用会话当前模型）；prompt 留空 = 内置默认提示词
     titleGen: {
       enabled: false,
+      customWritten: {},
       provider: 'session',
       model: 'glm-5.3-flash',
       prompt: '',
@@ -118,14 +119,16 @@ export function defaultConfig() {
     // 软件（headroom 与 rtk）的安装、检查更新与升级；sync = WebDAV 同步。同步默认
     // 关闭——坚果云等国内网盘通常直连即可，代理停了同步会跟着失败
     proxyScopes: { plugins: true, deps: true, sync: false },
-    // 开发模式（设置弹窗“调试”标签页）：开启后出现「重载」按钮，可在不重启
+    // 开发模式（设置弹窗“调试”标签页）：开启后出现“重载”按钮，可在不重启
     // ZCode 的情况下加载新代码（构建 → 换新启动器进程 → 各窗口自动刷新重注入）
     devMode: false,
     // 设置同步（设置弹窗“同步”标签页，交互参考 Tampermonkey 的手动同步）：
     // 仅 WebDAV、仅在点击按钮时传输（type 字段预留多后端扩展，当前恒为 webdav）。
     // url 为 WebDAV 服务器地址；dir 为其下的上传目录（默认 zcode-pro，避免直接
     // 写进网盘根目录）；include 选择同步内容；凭据只存本机、不同步出去；
-    // lastPushAt/lastPullAt 只记录本机操作时间。
+    // lastPushAt/lastPullAt 只记录本机操作时间；historyLimit 为云端历史版本保留
+    // 个数（同一次上传的各组文件算一个，上传成功后自动删除更早的；0 = 不留历史，
+    // 只有固定名最新版）。
     sync: {
       type: 'webdav',
       url: '',
@@ -133,6 +136,7 @@ export function defaultConfig() {
       login: '',
       password: '',
       include: { zcodepro: true, model: true },
+      historyLimit: 10,
       lastPushAt: null,
       lastPullAt: null,
     },
@@ -246,6 +250,20 @@ function proxyUrlFor(scope) {
   return activeProxyScopes[scope] ? activeProxyUrl : '';
 }
 
+// 智能起名诊断日志：追加到 <dataRoot>/zcodepro.log（与启动诊断同文件），超 512KB
+// 轮转 .old。起名过程注入侧静默（失败不打扰用户），出问题时靠这里回查
+let titleGenLogRotated = false;
+function titleGenLog(dataRoot, line) {
+  try {
+    const file = join(dataRoot, 'zcodepro.log');
+    if (!titleGenLogRotated && existsSync(file) && statSync(file).size > 512 * 1024) {
+      renameSync(file, file + '.old');
+      titleGenLogRotated = true;
+    }
+    appendFileSync(file, `[${new Date().toISOString()}] title-gen ${line}\n`);
+  } catch { /* 日志失败不影响功能 */ }
+}
+
 export function startHelper({ port, token, dataRoot, state, agentsFile = defaultAgentsFile() }) {
   const configFile = join(dataRoot, 'zcodepro.json');
   const settingsFile = join(dataRoot, 'v2', 'setting.json');
@@ -418,6 +436,13 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
       // 注入侧据此把被自动标题覆盖的侧栏行钉回重命名值；响应带开关，
       // 注入侧按需拉取这一个端点即可（无轮询）
       if (req.method === 'GET' && url.pathname === '/pinned-titles') {
+        // 先自动校正：桌面端打开会话时会把运行时缓存的旧标题写回任务索引（实测），
+        // 对我们写过且 CLI custom 仍是所写标题的会话，把索引改回来再下发
+        const config0 = loadConfig(configFile);
+        if (config0.titleGen.customWritten && Object.keys(config0.titleGen.customWritten).length) {
+          const repaired = await reconcileCustomTitles(dataRoot, config0.titleGen.customWritten);
+          if (repaired.length) titleGenLog(dataRoot, `reconciled sess=${repaired.map((s) => s.slice(5, 13)).join(',')}`);
+        }
         const r = await listOverriddenTitles(dataRoot);
         if (r.error) {
           json(res, 500, { ok: false, code: r.code, error: r.error });
@@ -488,9 +513,43 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
           return;
         }
         const sessId = typeof body?.sessId === 'string' && /^sess_[A-Za-z0-9._-]+$/.test(body.sessId) ? body.sessId : '';
-        const title = await generateTitleWith(cfg, text, dataRoot, sessId);
+        let title;
+        try {
+          title = await generateTitleWith(cfg, text, dataRoot, sessId);
+        } catch (err) {
+          titleGenLog(dataRoot, `generate-failed sess=${sessId.slice(0, 13)} err=${err?.message || err}`);
+          throw err; // 交给外层统一 500
+        }
         let written = false;
+        let store = ''; // CLI 会话库写入结果：'' 成功 | skipped 原因 | 'error'
         if (sessId && body.test !== true) {
+          // 已被手动重命名（或前次起名已写过）就整体跳过——手动重命名永远优先，
+          // 也避免起名晚到的 CLI 写入盖掉用户的 custom 标题
+          if (await isTaskTitleOverridden(dataRoot, sessId)) {
+            json(res, 200, { ok: true, title, written: false, store: 'skipped: overridden' });
+            return;
+          }
+          // 双写，顺序不能反：先写 CLI 会话库（title_source=custom，权威层——
+          // 官方自动起名看到 custom 会放弃，桌面同步器会把 custom 标题带着
+          // overridden=1 送回任务索引），再写任务索引（展示层，立即上屏）。
+          // 只写任务索引时，官方运行时排队的自动标题会在几秒后把它覆盖（实测）。
+          // CLI 库不可写（旧版无 title_source 列 / 无该会话行）不阻断：退回
+          // 单写任务索引的旧行为；任务索引随后失败也不回滚 CLI——同步器会补
+          for (let attempt = 0; ; attempt++) {
+            try {
+              const r = await setCustomSessionTitle(dataRoot, sessId, title);
+              store = r.written ? '' : (r.skipped || 'skipped');
+              break;
+            } catch (err) {
+              if (err.code === 'index-busy' && attempt < 2) {
+                await new Promise((r) => setTimeout(r, 1200));
+                continue;
+              }
+              store = 'error: ' + (err?.message || err);
+              titleGenLog(dataRoot, `cli-store-error sess=${sessId.slice(0, 13)} err=${err?.message || err}`);
+              break;
+            }
+          }
           // 写库撞上宿主写入时稍候重试（起名不急这几秒）
           for (let attempt = 0; ; attempt++) {
             try {
@@ -502,12 +561,19 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
                 await new Promise((r) => setTimeout(r, 1200));
                 continue;
               }
+              titleGenLog(dataRoot, `index-error sess=${sessId.slice(0, 13)} err=${err?.message || err}`);
               json(res, 500, { ok: false, code: err.code || 'index-error', error: err.message });
               return;
             }
           }
         }
-        json(res, 200, { ok: true, title, written });
+        // CLI 库写成功了才登记回查记录（reconcileCustomTitles 只认这些记录校正）
+        if (sessId && store === '') {
+          const c = loadConfig(configFile);
+          c.titleGen.customWritten = { ...(c.titleGen.customWritten || {}), [sessId]: { title, at: Date.now() } };
+          saveConfig(configFile, c);
+        }
+        json(res, 200, { ok: true, title, written, store });
         return;
       }
       // —— zcode-vision 插件（图片视觉代理）：设置弹窗“视觉代理”标签页读写 ————
@@ -910,7 +976,7 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
           json(res, r.status || 500, { ok: false, code: r.code || 'sync-run', error: r.error });
           return;
         }
-        json(res, 200, { ok: true, direction, applied: r.applied, sync: loadConfig(configFile).sync });
+        json(res, 200, { ok: true, direction, applied: r.applied, ...(typeof r.pruned === 'number' ? { pruned: r.pruned } : {}), sync: loadConfig(configFile).sync });
         return;
       }
       // —— 同步连通性测试（“测试”按钮）：用表单当前值逐步验证（可先测再存），不写入配置文件 ——
@@ -1076,7 +1142,7 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
               if (r.ok) updated += 1;
             } else if (!p.installed && only) {
               // 安装只走单插件入口（name 指定＝各面板的安装卡）：
-              // 全量「检查并更新」/启动自动更新只升级已装插件——卸载必须被尊重，
+              // 全量“检查并更新”/启动自动更新只升级已装插件——卸载必须被尊重，
               // 未装插件一律由用户在各 tab 显式点安装
               const r = await runZcodeCli(['plugins', 'install', `${p.name}@${ZCODE_PLUGINS_MARKETPLACE}`], 120000);
               steps.push({ step: `install ${p.name}`, ok: r.ok, output: r.output });
@@ -1143,6 +1209,18 @@ function mergeTitleGenConfig(saved) {
   // 旧版配置的 'cli'（登录账号单独成模式）统一迁移为 'session'：
   // 登录账号的套餐已在供应商列表里，跟随会话即覆盖原语义
   const provider = typeof s.provider === 'string' ? s.provider.trim().slice(0, 200) : d.provider;
+  // customWritten：起名功能写过的 { sessId → { title, at } }，自动校正只认这些
+  // 记录（见 reconcileCustomTitles）。只收合法会话 id 与短字符串，超 7 天/500 条的丢弃
+  const written = {};
+  const cutoff = Date.now() - 7 * 24 * 3600 * 1000;
+  let kept = 0;
+  for (const [k, v] of Object.entries((s.customWritten && typeof s.customWritten === 'object' && !Array.isArray(s.customWritten)) ? s.customWritten : {})) {
+    if (kept >= 500 || !/^sess_[A-Za-z0-9._-]+$/.test(k)) continue;
+    if (!v || typeof v !== 'object' || typeof v.title !== 'string' || v.title.length > 200) continue;
+    if (!Number.isFinite(v.at) || v.at < cutoff) continue;
+    written[k] = { title: v.title, at: v.at };
+    kept++;
+  }
   return {
     enabled: s.enabled === true,
     provider: provider === 'cli' ? 'session' : provider,
@@ -1151,6 +1229,7 @@ function mergeTitleGenConfig(saved) {
     baseUrl: typeof s.baseUrl === 'string' ? s.baseUrl.trim().slice(0, 500) : d.baseUrl,
     apiKey: typeof s.apiKey === 'string' ? s.apiKey.trim().slice(0, 500) : d.apiKey,
     format: s.format === 'openai' ? 'openai' : s.format === 'anthropic' ? 'anthropic' : '',
+    customWritten: written,
   };
 }
 
@@ -1179,13 +1258,16 @@ function mergeSyncConfig(saved) {
     login: typeof saved.login === 'string' ? saved.login.slice(0, 300) : '',
     password: typeof saved.password === 'string' ? saved.password.slice(0, 300) : '',
     include: { zcodepro: inc.zcodepro !== false, model: inc.model !== false },
+    historyLimit: Number.isInteger(saved.historyLimit) && saved.historyLimit >= 0 && saved.historyLimit <= 100
+      ? saved.historyLimit : d.historyLimit,
     lastPushAt: Number.isFinite(saved.lastPushAt) ? saved.lastPushAt : null,
     lastPullAt: Number.isFinite(saved.lastPullAt) ? saved.lastPullAt : null,
   };
 }
 
 // POST /sync 表单校验：url/login/password/dir 全量替换（dir 缺省时不动已有值）。
-// URL 必填，指向 WebDAV 服务器（可含路径前缀）；dir 为其下的上传目录，可多级
+// URL 必填，指向 WebDAV 服务器（可含路径前缀）；dir 为其下的上传目录，可多级；
+// historyLimit 可选（缺省时不动已有值），0–100 的整数
 function validateSyncForm(raw) {
   const url = typeof raw.url === 'string' ? raw.url.trim() : '';
   const login = typeof raw.login === 'string' ? raw.login.trim() : '';
@@ -1206,6 +1288,12 @@ function validateSyncForm(raw) {
     }
     out.dir = dir;
   }
+  if (raw.historyLimit !== undefined && raw.historyLimit !== null) {
+    if (!Number.isInteger(raw.historyLimit) || raw.historyLimit < 0 || raw.historyLimit > 100) {
+      return { error: '历史版本保留个数需为 0–100 的整数' };
+    }
+    out.historyLimit = raw.historyLimit;
+  }
   return { sync: out };
 }
 
@@ -1299,8 +1387,10 @@ async function runSettingsSync({ direction, dataRoot, configFile, config, proxyU
 // 上传：每组独立一个云端文件（zcodepro.json / model.json，始终最新一版），勾选几组
 // 写几个；写前预读云端内容，别名与本机的合并后再写（合并规则见 mergeAliases），
 // 其余内容整份覆盖。同一份内容再写一个带时间戳的历史版本文件，供下载时任选版本
-// 恢复（旧版 zcode-pro 仍读固定名）
+// 恢复（旧版 zcode-pro 仍读固定名）；历史版本最多保留 historyLimit 个（同一时间戳
+// 的各组文件算一个），上传成功后自动删除更早的
 async function runSyncPush({ dataRoot, configFile, config, sync, proxyUrl }) {
+  const keep = Number.isInteger(sync.historyLimit) ? sync.historyLimit : defaultConfig().sync.historyLimit;
   const docs = {};
   if (sync.include.zcodepro) {
     // sync（本机的同步配置与凭据）与 version（本机 helper 版本）不外发
@@ -1345,10 +1435,13 @@ async function runSyncPush({ dataRoot, configFile, config, sync, proxyUrl }) {
       if (put.httpCode < 200 || put.httpCode >= 300) {
         return { code: 'sync-request', status: 502, error: webdavHttpText(put.httpCode) };
       }
-      const putVersion = await putUrl(syncVersionName(kind, stamp));
-      if (!putVersion.ok) return { code: 'sync-request', status: 502, error: putVersion.error };
-      if (putVersion.httpCode < 200 || putVersion.httpCode >= 300) {
-        return { code: 'sync-request', status: 502, error: webdavHttpText(putVersion.httpCode) };
+      // 历史版本只在保留个数 > 0 时写（0 = 只留固定名最新版，由上传后清理收尾）
+      if (keep > 0) {
+        const putVersion = await putUrl(syncVersionName(kind, stamp));
+        if (!putVersion.ok) return { code: 'sync-request', status: 502, error: putVersion.error };
+        if (putVersion.httpCode < 200 || putVersion.httpCode >= 300) {
+          return { code: 'sync-request', status: 502, error: webdavHttpText(putVersion.httpCode) };
+        }
       }
       pushed.push(kind);
     }
@@ -1357,7 +1450,9 @@ async function runSyncPush({ dataRoot, configFile, config, sync, proxyUrl }) {
   }
   sync.lastPushAt = Date.now();
   saveConfig(configFile, config);
-  return { applied: pushed };
+  // 上传成功后清理超出保留个数的旧历史版本（best-effort，失败不影响上传结果）
+  const pruned = await pruneSyncHistory(sync, proxyUrl, keep);
+  return { applied: pushed, pruned };
 }
 
 // 下载：把云端所选组应用到本机（各组独立文件，勾选几组读几组，可只覆盖模型设置）。
@@ -1500,6 +1595,39 @@ async function listSyncVersions(sync, proxyUrl) {
   return { files };
 }
 
+// 从云端文件名列表选出待删除的历史版本（导出以便测试脚本直接驱动）：带时间戳的
+// 文件按时间戳段分组——同一次上传的各组文件共用一个时间戳，算“一个”；时间戳
+// 段定宽零填充，字典序即时间序。保留最近 keep 个，返回更早的各组文件名；
+// 固定名（zcodepro.json / model.json）和不相干的文件名不会出现在结果里
+export function syncHistoryStaleNames(names, keep) {
+  const groups = new Map();
+  for (const name of names) {
+    const ts = (String(name).match(/^(?:zcodepro|model)(-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z)\.json$/) || [])[1];
+    if (!ts) continue;
+    if (!groups.has(ts)) groups.set(ts, []);
+    groups.get(ts).push(name);
+  }
+  // 时间戳段按新 → 旧排，slice(keep) 剩下的即超出保留个数的更早各组
+  return [...groups.keys()].sort((a, b) => b.localeCompare(a)).slice(Math.max(0, keep)).flatMap((ts) => groups.get(ts));
+}
+
+// 上传后清理云端目录里超出保留个数的历史版本：列出文件，删掉 syncHistoryStaleNames
+// 归出的旧文件。best-effort——列目录或单个删除失败只跳过（下次上传再清），不抛错；
+// 返回本次删掉的文件数
+async function pruneSyncHistory(sync, proxyUrl, keep) {
+  const list = await listSyncVersions(sync, proxyUrl);
+  if (list.error) return 0;
+  const stale = syncHistoryStaleNames(list.files.map((f) => f.name), keep);
+  let removed = 0;
+  for (const name of stale) {
+    const r = await webdavRequest({ method: 'DELETE', url: syncFileUrlByName(sync, name), login: sync.login, password: sync.password, proxyUrl, timeoutMs: 30000 });
+    if (!r.ok) continue; // 网络失败：跳过该文件
+    if (r.httpCode !== 404 && (r.httpCode < 200 || r.httpCode >= 300)) continue; // 404 = 已不在，视为已清
+    removed++;
+  }
+  return removed;
+}
+
 // 别名表清洗（同步下载用）：只收 路径字符串 → 短字符串 的条目，数量限幅
 function sanitizeAliases(raw) {
   if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return null;
@@ -1607,7 +1735,7 @@ export async function scanIdleBusy(paths, dataRoot) {
   return SCAN_OFF;
 }
 
-// Linux：/proc 直读（comm 定位 CLI、cwd 定位项目、task/<pid>/children 拿子进程）
+// Linux：直接读取 /proc（comm 定位 CLI、cwd 定位项目、task/<pid>/children 拿子进程）
 function scanIdleBusyLinux(paths) {
   let pids;
   try { pids = readdirSync('/proc').filter((d) => /^\d+$/.test(d)); }
@@ -1794,7 +1922,7 @@ function sanitizeFontStack(v) {
   return s;
 }
 
-// 视觉代理「跟随供应商」下拉取数：与智能起名共用同一套供应商列表和过滤规则
+// 视觉代理“跟随供应商”下拉取数：与智能起名共用同一套供应商列表和过滤规则
 //（见 listTitleGenProviders），只回 id/名称/别名，不含密钥。
 // 导出以便测试脚本直接驱动。
 export function listVisionProviders() {
@@ -1853,7 +1981,7 @@ const TITLE_GEN_TIMEOUT_MS = 60000; // 单次模型调用超时（与官方起
 //（coding-plan 与 start-plan 都叫 "Coding Plan"），界面里按套餐类型显示。
 // coding-plan 的个人/团队是动态的：从桌面设置（v2/setting.json 的
 // providerFamilyConnectionSelections）读当前登录的连接方式（kind 含
-// individual → 个人、team → 团队），读不到时退回「个人/团队」
+// individual → 个人、team → 团队），读不到时退回“个人/团队”
 function codingPlanKindByFamily() {
   const s = readJsonFile(join(homedir(), '.zcode', 'v2', 'setting.json'));
   const sel = (s && s.providerFamilyConnectionSelections && typeof s.providerFamilyConnectionSelections === 'object')
@@ -1962,7 +2090,7 @@ async function callAnthropicText(baseUrl, apiKey, model, content) {
       body: JSON.stringify({ model, max_tokens: 2048, messages: [{ role: 'user', content }] }),
     });
     const body = await resp.text();
-    if (!resp.ok) throw new Error(`HTTP ${resp.status}: ${body.slice(0, 300)}`);
+    if (!resp.ok) throw new Error(`HTTP ${resp.status} [model=${model}]: ${body.slice(0, 300)}`);
     const doc = JSON.parse(body);
     const text = Array.isArray(doc.content)
       ? doc.content.filter((b) => b && b.type === 'text').map((b) => b.text || '').join('') : '';
@@ -1988,7 +2116,7 @@ async function callOpenAiText(baseUrl, apiKey, model, content) {
       body: JSON.stringify({ model, max_tokens: 2048, messages: [{ role: 'user', content }] }),
     });
     const body = await resp.text();
-    if (!resp.ok) throw new Error(`HTTP ${resp.status}: ${body.slice(0, 300)}`);
+    if (!resp.ok) throw new Error(`HTTP ${resp.status} [model=${model}]: ${body.slice(0, 300)}`);
     const doc = JSON.parse(body);
     const text = doc.choices?.[0]?.message?.content || '';
     if (typeof text !== 'string' || !text.trim()) throw new Error('响应中没有文本内容');
@@ -2008,7 +2136,12 @@ async function callOpenAiText(baseUrl, apiKey, model, content) {
 export async function generateTitleWith(cfg, rawText, dataRoot = '', sessId = '') {
   const text = String(rawText || '').trim().replace(/\s+/g, ' ').slice(0, TITLE_GEN_MAX_TEXT);
   const prompt = (cfg.prompt && cfg.prompt.trim()) || titleGenDefaultPrompt();
-  const userContent = `${prompt}\n\n会话的用户消息：\n${text}`;
+  // 注入当前日期（上海时区）：起名模型是无状态的，自定义提示词里要求
+  // “MMDD 取对话创建日期”时它无从得知，只能留字面量 MMDD
+  const now = new Date(Date.now() + 8 * 3600 * 1000);
+  const pad = (n) => String(n).padStart(2, '0');
+  const dateLine = `当前日期（Asia/Shanghai）：${now.getUTCFullYear()}-${pad(now.getUTCMonth() + 1)}-${pad(now.getUTCDate())}（MMDD 即 ${pad(now.getUTCMonth() + 1)}${pad(now.getUTCDate())}）`;
+  const userContent = `${prompt}\n\n${dateLine}\n\n会话的用户消息：\n${text}`;
   const providerId = (cfg.provider || '').trim();
   const model = (cfg.model || '').trim();
   const conn = await resolveTitleGenConnection(cfg, providerId, model, dataRoot, sessId);
@@ -2056,12 +2189,19 @@ async function resolveTitleGenConnection(cfg, providerId, model, dataRoot, sessI
 }
 
 // 清洗模型输出：去思考块/代码围栏/首尾引号/序号/末尾标点，取首个非空行并限长。
-// 模型可能沿用官方起名的习惯回 JSON 对象，此时取其 title 字段。导出以便测试
+// 模型可能沿用官方起名的习惯回 JSON 对象，此时取其 title 字段。自定义提示词常让
+// 模型“先说明再给标题”（如“无法直接修改会话标题……建议手动设置：”后另起一行
+// 【MMDD|类型|主题】），此时首个非空行是说明而非标题——优先取独立成行的
+// 【】/[] 包裹标题行（允许行首 markdown 标题符）。导出以便测试
 export function cleanGeneratedTitle(text) {
   let t = String(text || '').replace(/<think>[\s\S]*?<\/think>/gi, '').trim();
-  // 整段包在代码围栏里时先去掉围栏标记（先取行会把「```json」当成标题内容）
+  // 整段包在代码围栏里时先去掉围栏标记（先取行会把“```json”当成标题内容）
   t = t.replace(/^```[a-zA-Z]*\s*\n?/, '').replace(/\n?```\s*$/, '').trim();
-  let line = t.split(/\r?\n/).map((s) => s.trim()).find(Boolean) || '';
+  const lines = t.split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
+  // 标题行判定前剥掉 markdown 外壳（## 标题符、**加粗**、*斜体*、_下划线_、~~删除线~~）
+  const unwrap = (s) => s.replace(/^#{1,4}\s*/, '').replace(/^[*_~]+/, '').replace(/[*_~]+$/, '').trim();
+  const bracketed = lines.find((s) => /^(?:【[^】]{1,60}】|\[[^\]\n]{1,60}\])$/.test(unwrap(s)));
+  let line = bracketed ? unwrap(bracketed) : (lines[0] || '');
   line = line.replace(/^```[a-zA-Z]*\s*/, '').replace(/```\s*$/, '');
   try {
     const doc = JSON.parse(line);
@@ -2411,7 +2551,7 @@ async function ensureUserPathEntry(dir) {
 }
 
 // 在插件缓存里找市场插件的钩子脚本：只认 installed_plugins.json 登记的 installPath。
-// 不能按目录扫描：卸载只删「当前指向」的版本目录，缓存里的历史版本目录会残留
+// 不能按目录扫描：卸载只删“当前指向”的版本目录，缓存里的历史版本目录会残留
 // （升级留旧版、GitHub/本地源先后装过等），扫目录会把已卸载的插件误判为已装，
 // 面板就不显示安装卡了。本地开发流（install-plugin-local.sh）同样会更新安装记录，兼容。
 // 注意只认正式市场 duanluan-zcode-plugins：本地临时市场（如 duanluan-local）装的副本不在查找范围，
@@ -2430,7 +2570,7 @@ function findVisionHook() {
   return findMarketplaceHook('zcode-vision', join('hooks', 'vision-hook.mjs'));
 }
 
-// 读市场插件在 installed_plugins.json 里登记的版本（面板信息卡显示「插件 x.y.z」用）
+// 读市场插件在 installed_plugins.json 里登记的版本（面板信息卡显示“插件 x.y.z”用）
 function installedPluginVersion(pluginName) {
   const installedRaw = readJsonFile(join(cliPluginsDir(), 'installed_plugins.json'));
   const rec = (installedRaw?.plugins || []).find((p) => p?.name === pluginName && p?.marketplace === ZCODE_PLUGINS_MARKETPLACE);

package/src/host/main.mjs

@@ -17,11 +17,15 @@ import { runSetup } from './setup.mjs';
 const here = dirname(fileURLToPath(import.meta.url));
 const INJECT_BUNDLE = resolve(here, '..', '..', 'dist', 'inject.js');
 
-// Windows 控制台中文乱码适配：输出为 UTF-8 字节，旧版 conhost/PowerShell 的默认
-// 代码页（936/GBK）按 GBK 解码会显示乱码。检测到真实控制台且非 UTF-8 代码页时
-// 切到 65001——只影响当前控制台会话（重开终端即恢复），重定向/非交互不干预。
+// Windows 控制台中文乱码适配：输出为 UTF-8 字节，旧版 conhost/cmd 的默认代码页
+//（936/GBK）按 GBK 解码会显示乱码。检测到非 UTF-8 代码页时切到 65001——只影响
+// 当前控制台会话（重开终端即恢复）。不能用 stdout.isTTY 单独作前提：npm 全局
+// 入口（bin/zcode-pro.mjs）spawn ZCode 运行时跑 cli.mjs，子进程 stdout 经
+// stdio:'inherit' 是管道（isTTY=false），但控制台乱码照样发生（0.18/0.19 用户
+// 实拍）；此时 stdin 仍连着终端，故用 stdout 或 stdin 任一 isTTY 判定。真正的
+// 重定向场景（stdout 与 stdin 都不是 TTY）不干预。
 // 放在模块顶层：cli.mjs 经 import main.mjs 进入，setup 等子命令的输出同样受益。
-if (process.platform === 'win32' && process.stdout.isTTY) {
+if (process.platform === 'win32' && (process.stdout.isTTY || process.stdin.isTTY)) {
   try {
     const cp = execSync('chcp.com', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true }).match(/(\d+)/)?.[1];
     if (cp && cp !== '65001') execSync('chcp.com 65001', { stdio: 'ignore', windowsHide: true });