zen-gitsync 2.16.9 → 2.16.11

package/src/cli/ai/modelSetup.test.js

@@ -409,8 +409,8 @@ function silenceConsole() {
 test('collectModelInput: 预设服务商 + 内置模型 + 测试成功 → 返回收集的字段', async () => {
   const restore = silenceConsole()
   try {
-    // 答案:选 OpenAI(1) → 确认 baseURL(空=默认) → 选第一个模型(1) → apiKey → displayName(空=默认)
-    const rl = createMockRl(['1', '', '1', 'sk-test', ''])
+    // 答案:选 OpenAI(1) → 确认 baseURL(空=默认) → apiKey → 选第一个模型(1) → displayName(空=默认)
+    const rl = createMockRl(['1', '', 'sk-test', '1', ''])
     const result = await collectModelInput({
       locale: 'zh-CN',
       rl,
@@ -429,8 +429,8 @@ test('collectModelInput: 预设服务商 + 内置模型 + 测试成功 → 返
 test('collectModelInput: 自定义服务商 + 手动输入模型名 → 返回收集的字段', async () => {
   const restore = silenceConsole()
   try {
-    // 选自定义(0) → 输入 baseURL → 确认(空=默认) → 手动输入模型名 → apiKey(空) → displayName(空=默认)
-    const rl = createMockRl(['0', 'https://my.custom.api/v1', '', 'my-model', '', ''])
+    // 选自定义(0) → 输入 baseURL → 确认(空=默认) → apiKey(空) → 手动输入模型名 → displayName(空=默认)
+    const rl = createMockRl(['0', 'https://my.custom.api/v1', '', '', 'my-model', ''])
     const result = await collectModelInput({
       locale: 'zh-CN',
       rl,
@@ -449,8 +449,8 @@ test('collectModelInput: 自定义服务商 + 手动输入模型名 → 返回
 test('collectModelInput: 测试失败 + 用户选择不保存 → 返回 null', async () => {
   const restore = silenceConsole()
   try {
-    // 选 DeepSeek(3) → 确认 → 选第一个模型(1) → apiKey → displayName → 测试401失败 → 不保存(n)
-    const rl = createMockRl(['3', '', '1', 'sk-bad', '', 'n'])
+    // 选 DeepSeek(3) → 确认 → apiKey → 选第一个模型(1) → displayName → 测试401失败 → 不保存(n)
+    const rl = createMockRl(['3', '', 'sk-bad', '1', '', 'n'])
     const result = await collectModelInput({
       locale: 'zh-CN',
       rl,
@@ -465,7 +465,7 @@ test('collectModelInput: 测试失败 + 用户选择不保存 → 返回 null',
 test('collectModelInput: 测试失败 + 用户选择继续 → 返回收集的字段', async () => {
   const restore = silenceConsole()
   try {
-    const rl = createMockRl(['3', '', '1', 'sk-bad', '', 'y'])
+    const rl = createMockRl(['3', '', 'sk-bad', '1', '', 'y'])
     const result = await collectModelInput({
       locale: 'zh-CN',
       rl,
@@ -494,3 +494,32 @@ test('collectModelInput: 用户取消(触发 close)→ 返回 null', async () =>
     restore()
   }
 })
+
+test('collectModelInput: API 返回模型列表时优先使用 → 返回收集的字段', async () => {
+  const restore = silenceConsole()
+  try {
+    // mock fetch: /models 返回模型列表, /chat/completions 返回 200
+    const smartFetch = async (url, opts) => {
+      if (url.endsWith('/models')) {
+        return {
+          ok: true,
+          status: 200,
+          json: async () => ({ data: [{ id: 'api-model-1' }, { id: 'api-model-2' }] }),
+        }
+      }
+      return { ok: true, status: 200, json: async () => ({}) }
+    }
+    // 选 OpenAI(1) → 确认 baseURL → apiKey → 选第一个 API 返回的模型(1) → displayName
+    const rl = createMockRl(['1', '', 'sk-test', '1', ''])
+    const result = await collectModelInput({
+      locale: 'zh-CN',
+      rl,
+      fetchFn: smartFetch,
+    })
+    assert.ok(result)
+    assert.equal(result.model, 'api-model-1', '应使用 API 返回的模型而非内置列表')
+    assert.equal(result.apiKey, 'sk-test')
+  } finally {
+    restore()
+  }
+})

package/src/cli/ai/sessionStore.js

@@ -1,97 +1,97 @@
-// Copyright 2026 xz333221
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-//
-// CLI 侧智能体会话持久化。
-//
-// 与 Web 端 (src/ui/server/routes/workbench/agentSessionStore.js) 共享同一数据目录
-// (~/.zen-gitsync/agent-sessions/) 和同一 JSON 格式,这样:
-//   - CLI 对话在 Web UI 的智能体 tab 里可见(带 CLI 标记)
-//   - Web UI 可以读取/继续 CLI 创建的会话
-//
-// 本模块刻意不依赖服务器代码,仅用 node 内置 fs/path/os,保持 CLI 自包含。
-
-import fsp from 'fs/promises';
-import path from 'path';
-import os from 'os';
-
-const SESSIONS_DIR = path.join(os.homedir(), '.zen-gitsync', 'agent-sessions');
-const MAX_SESSIONS = 200;
-const KEEP_SESSIONS = 100;
-
-/**
- * 生成会话 ID: ag-{时间戳base36}-{随机base36}
- */
-export function genSessionId() {
-  return `ag-${Date.now().toString(36).slice(-8)}-${Math.random().toString(36).slice(2, 10)}`;
-}
-
-/**
- * 从第一条 user 消息自动生成标题(取第一行,截断 40 字符)
- */
-export function autoTitle(messages) {
-  for (const m of messages) {
-    if (m.role === 'user') {
-      let text = '';
-      if (typeof m.content === 'string') {
-        text = m.content;
-      } else if (Array.isArray(m.content)) {
-        text = m.content.filter(p => p?.type === 'text').map(p => p.text).join(' ');
-      }
-      text = text.trim();
-      if (text) {
-        const firstLine = text.split('\n')[0].trim();
-        return firstLine.length > 40 ? firstLine.slice(0, 40) + '…' : firstLine;
-      }
-    }
-  }
-  return '(新会话)';
-}
-
-/**
- * 写入会话(原子操作: tmp + rename)
- */
-export async function writeSession(sessionId, data) {
-  await fsp.mkdir(SESSIONS_DIR, { recursive: true });
-  const file = path.join(SESSIONS_DIR, `${sessionId}.json`);
-  const tmp = `${file}.tmp.${process.pid}.${Date.now()}`;
-  await fsp.writeFile(tmp, JSON.stringify(data, null, 2), 'utf-8');
-  await fsp.rename(tmp, file);
-}
-
-/**
- * 读取会话
- */
-export async function readSession(sessionId) {
-  const file = path.join(SESSIONS_DIR, `${sessionId}.json`);
-  return JSON.parse(await fsp.readFile(file, 'utf-8'));
-}
-
-/**
- * 保留策略:超过 MAX_SESSIONS 时删最旧的,保留 KEEP_SESSIONS 个
- */
-export async function enforceRetention() {
-  const files = await fsp.readdir(SESSIONS_DIR).catch(() => []);
-  const jsonFiles = files.filter(f => f.endsWith('.json'));
-  if (jsonFiles.length < MAX_SESSIONS) return;
-  const stats = await Promise.all(jsonFiles.map(async f => {
-    const full = path.join(SESSIONS_DIR, f);
-    const s = await fsp.stat(full);
-    return { file: full, mtime: s.mtimeMs };
-  }));
-  stats.sort((a, b) => b.mtime - a.mtime);
-  const toDelete = stats.slice(KEEP_SESSIONS);
-  await Promise.all(toDelete.map(s => fsp.unlink(s.file).catch(() => {})));
-}
-
-export { SESSIONS_DIR };
+// Copyright 2026 xz333221
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// CLI 侧智能体会话持久化。
+//
+// 与 Web 端 (src/ui/server/routes/workbench/agentSessionStore.js) 共享同一数据目录
+// (~/.zen-gitsync/agent-sessions/) 和同一 JSON 格式,这样:
+//   - CLI 对话在 Web UI 的智能体 tab 里可见(带 CLI 标记)
+//   - Web UI 可以读取/继续 CLI 创建的会话
+//
+// 本模块刻意不依赖服务器代码,仅用 node 内置 fs/path/os,保持 CLI 自包含。
+
+import fsp from 'fs/promises';
+import path from 'path';
+import os from 'os';
+
+const SESSIONS_DIR = path.join(os.homedir(), '.zen-gitsync', 'agent-sessions');
+const MAX_SESSIONS = 200;
+const KEEP_SESSIONS = 100;
+
+/**
+ * 生成会话 ID: ag-{时间戳base36}-{随机base36}
+ */
+export function genSessionId() {
+  return `ag-${Date.now().toString(36).slice(-8)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+
+/**
+ * 从第一条 user 消息自动生成标题(取第一行,截断 40 字符)
+ */
+export function autoTitle(messages) {
+  for (const m of messages) {
+    if (m.role === 'user') {
+      let text = '';
+      if (typeof m.content === 'string') {
+        text = m.content;
+      } else if (Array.isArray(m.content)) {
+        text = m.content.filter(p => p?.type === 'text').map(p => p.text).join(' ');
+      }
+      text = text.trim();
+      if (text) {
+        const firstLine = text.split('\n')[0].trim();
+        return firstLine.length > 40 ? firstLine.slice(0, 40) + '…' : firstLine;
+      }
+    }
+  }
+  return '(新会话)';
+}
+
+/**
+ * 写入会话(原子操作: tmp + rename)
+ */
+export async function writeSession(sessionId, data) {
+  await fsp.mkdir(SESSIONS_DIR, { recursive: true });
+  const file = path.join(SESSIONS_DIR, `${sessionId}.json`);
+  const tmp = `${file}.tmp.${process.pid}.${Date.now()}`;
+  await fsp.writeFile(tmp, JSON.stringify(data, null, 2), 'utf-8');
+  await fsp.rename(tmp, file);
+}
+
+/**
+ * 读取会话
+ */
+export async function readSession(sessionId) {
+  const file = path.join(SESSIONS_DIR, `${sessionId}.json`);
+  return JSON.parse(await fsp.readFile(file, 'utf-8'));
+}
+
+/**
+ * 保留策略:超过 MAX_SESSIONS 时删最旧的,保留 KEEP_SESSIONS 个
+ */
+export async function enforceRetention() {
+  const files = await fsp.readdir(SESSIONS_DIR).catch(() => []);
+  const jsonFiles = files.filter(f => f.endsWith('.json'));
+  if (jsonFiles.length < MAX_SESSIONS) return;
+  const stats = await Promise.all(jsonFiles.map(async f => {
+    const full = path.join(SESSIONS_DIR, f);
+    const s = await fsp.stat(full);
+    return { file: full, mtime: s.mtimeMs };
+  }));
+  stats.sort((a, b) => b.mtime - a.mtime);
+  const toDelete = stats.slice(KEEP_SESSIONS);
+  await Promise.all(toDelete.map(s => fsp.unlink(s.file).catch(() => {})));
+}
+
+export { SESSIONS_DIR };

package/src/cli/ai/termui.js

@@ -140,16 +140,149 @@ export function filterSlashCommands(input, locale) {
 
 /**
  * 生成即时提示面板的 ANSI 字符串(不含定位,由调用方负责保存/恢复光标)。
- * 每行:两空格缩进 + 青色命令名(左对齐补齐)+ 灰色说明。
- * 空数组返回空串。
+ * 每行:两空格缩进 + 蓝色命令名(左对齐补齐 12 字符宽)+ 灰色说明。
+ * 所有行的"视觉起点"一致(均为 2 空格缩进);选中行用整行反白区分(从缩进处
+ * 开始),不另加 ❯ 之类的偏移标记 —— 避免反白块起点与其他行不齐。
+ *   - 越界 selectedIndex(<0 / >=matches.length) 自动回退为 -1(即不高亮)
+ *   - 空数组返回空串
  */
-export function renderSlashHintBody(matches) {
+export function renderSlashHintBody(matches, selectedIndex = -1) {
   if (!Array.isArray(matches) || matches.length === 0) return ''
+  const sel = (Number.isInteger(selectedIndex) && selectedIndex >= 0 && selectedIndex < matches.length)
+    ? selectedIndex
+    : -1
+  // 行宽固定 = 2 空格缩进 + 12 字符命令 + 说明;选中行反白整行(含缩进),
+  // 反白起点与未选中行严格对齐,视觉上选中行不会"偏左"。
+  const rowWidth = (m) => 2 + Math.max(12, String(m.cmd).length) + 1 + String(m.desc).length
   return matches
-    .map((m) => '  ' + chalk.cyan(String(m.cmd).padEnd(12)) + chalk.dim(m.desc))
+    .map((m, i) => {
+      // 用 padEnd 凑满 rowWidth,这样反白背景能延伸到行尾,左右不留缝
+      const raw = '  ' + String(m.cmd).padEnd(12) + ' ' + m.desc
+      // 所有行命令名统一用青色(不带额外前缀),选中行靠反白区分
+      const line = chalk.cyan(String(m.cmd).padEnd(12)) + ' ' + chalk.dim(m.desc)
+      if (i !== sel) return '  ' + line
+      // 选中行:把命令名+说明之外的两空格缩进也纳入反白,这样视觉起点严格对齐
+      return chalk.inverse(raw.padEnd(rowWidth(m)))
+    })
     .join('\n')
 }
 
+/**
+ * 解析 readline keypress 事件,识别"斜杠命令提示"专用快捷键。
+ * 返回动作字符串(消费方据此改 selectedIndex 或补全输入);
+ * 不识别的键返回 null(由 readline 正常处理)。
+ *
+ *   - ↑ / Shift+Tab → 'prev'
+ *   - ↓             → 'next'
+ *   - Tab           → 'complete'(补全选中命令到输入行)
+ *   - Enter         → 'submit'(由 readline 默认提交,本函数仅标记是补全时机)
+ *   - Esc           → 'cancel'
+ *
+ * 注意:readline 默认会把方向键当历史浏览。消费方需要在我们这个 handler
+ * 里"事后回滚":把 rl.line 恢复成 hint 显示时的基线,再 _refreshLine()。
+ * (详见 agent.js 的 keypress 监听与说明)
+ */
+export function parseKeyForSlashHint(key) {
+  if (!key) return null
+  const name = key.name
+  if (name === 'tab') return key.shift ? 'prev' : 'complete'
+  if (name === 'up') return 'prev'
+  if (name === 'down') return 'next'
+  if (name === 'return' || name === 'enter') return 'submit'
+  if (name === 'escape') return 'cancel'
+  return null
+}
+
+// ──────────────────────────────────────────────────
+// 交互式可选列表(供 modelSetup 等一次性向导使用:上下键切换 + Enter 提交)
+// ──────────────────────────────────────────────────
+//
+// 与 renderSlashHintBody 的差异:
+//   - 必须支持 Enter 提交(parseKeyForSlashHint 把它当 'submit',但那个由 readline 默认接管;
+//     可选列表场景下 wizard 自己消费 Enter,不能丢给 readline)
+//   - 多支持直接按数字 1..9/0 跳到指定项(给经常用键盘的用户省一趟 ↑↓)
+//   - Ctrl+C 在可选列表场景下与 Esc 等价(都视作取消)
+//
+// 渲染/解析都做成纯函数,wizard 内部(modelSetup.selectFromList)负责:
+//   - 调用 renderSelectableListBody 把列表写到屏幕
+//   - 在 rl.input 上挂 keypress 监听,把 readline 默认行为(历史浏览)回滚掉
+//   - 每次 selectedIndex 变化时,重绘列表(用 ANSI 把光标上移、清行、再写)
+
+/**
+ * 渲染可选项列表 body(纯函数,便于单测)。
+ *
+ *   - 标准项:`  [k]. label`(未选中)
+ *   - 选中项:`▶ [k]. label`(整行反白,含前缀空格,跟下方其它行起点对齐)
+ *   - 额外项:编号 0,dim 灰;选中时整行反白(与普通选中项视觉一致)
+ *
+ * @param {Array<{label: string, value: any}>} items
+ * @param {number} [selectedIndex=0] - 选中项下标;范围 [0, items.length+extra)
+ *   越界回退为 0(默认选第一项,避免空数组报错)
+ * @param {string|null} [extraOptionLabel=null] - 额外项(如"自定义" / "手动输入")
+ * @returns {string} body 字符串(不含末尾换行 — 由调用方控制)
+ */
+export function renderSelectableListBody(items, selectedIndex = 0, extraOptionLabel = null) {
+  const safeItems = Array.isArray(items) ? items : []
+  const extraActive = !!extraOptionLabel
+  const totalLen = safeItems.length + (extraActive ? 1 : 0)
+  // selectedIndex 越界时静默回退为 0(首次调用时通常如此)
+  if (!Number.isInteger(selectedIndex) || selectedIndex < 0 || selectedIndex >= totalLen) {
+    selectedIndex = 0
+  }
+  const rows = []
+  for (let i = 0; i < safeItems.length; i++) {
+    const num = String(i + 1).padStart(2)
+    const label = safeItems[i].label
+    if (i === selectedIndex) {
+      // 整行反白(含 '  ' 缩进) — 起点与未选中行严格对齐,不留左侧白边
+      rows.push(chalk.inverse(`  ${num}. ${label}`))
+    } else {
+      rows.push(`  ${chalk.cyan(num)}. ${label}`)
+    }
+  }
+  if (extraActive) {
+    const extraIdx = safeItems.length
+    if (extraIdx === selectedIndex) {
+      // extra 选中时也整行反白,这样高亮跨度统一(虽然 label 是 dim,但反白让它可读)
+      rows.push(chalk.inverse(`  ${chalk.dim('0')}. ${extraOptionLabel}`))
+    } else {
+      rows.push(`  ${chalk.dim('0')}. ${chalk.dim(extraOptionLabel)}`)
+    }
+  }
+  return rows.join('\n')
+}
+
+/**
+ * 解析 readline keypress 事件,识别"可选列表"专用键。
+ * 返回动作字符串(消费方据此改 selectedIndex 或提交);
+ * 不识别的键返回 null(让 readline 正常处理 — 但消费方应恢复 line buffer
+ * 防止方向键的历史浏览把当前输入覆盖)。
+ *
+ *   - ↑ / Shift+Tab  → 'prev'
+ *   - ↓              → 'next'
+ *   - Enter          → 'confirm'
+ *   - Esc / Ctrl+C   → 'cancel'
+ *   - 数字 0..9      → 'jump:N'(1-based;0 = extra option,需消费方映射)
+ *
+ * 与 parseKeyForSlashHint 的差别:
+ *   - 这里 Enter 直接是 'confirm'——wizard 不会让 readline 默认提交(否则进 line 事件
+ *     走 REPL 的命令分发,体验错乱);Esc / Ctrl+C 都是 'cancel';不支持 Tab 补全
+ *     (列表项不是命令片段,不需要补全语义)
+ */
+export function parseKeyForSelectableList(key) {
+  if (!key) return null
+  const name = key.name
+  if (name === 'up') return 'prev'
+  if (name === 'tab') return key.shift ? 'prev' : 'next'
+  if (name === 'down') return 'next'
+  if (name === 'return' || name === 'enter') return 'confirm'
+  if (name === 'escape') return 'cancel'
+  if (key.ctrl && name === 'c') return 'cancel'
+  // 数字键 0..9:readline keypress 事件的 key.name 会是该字符
+  if (typeof name === 'string' && /^[0-9]$/.test(name)) return `jump:${name}`
+  return null
+}
+
 /** 盒式帮助面板 */
 export function printHelpPanel(title, lines) {
   const body = [chalk.bold(title), ...lines].join('\n')
@@ -376,6 +509,28 @@ export function createAssistantWriter({
   }
 }
 
+// ──────────────────────────────────────────────────────
+// 耗时格式化
+// ──────────────────────────────────────────────────────
+
+/**
+ * 格式化耗时(毫秒 → 人类可读)。
+ *   < 1s  → "123ms"
+ *   < 60s → "1.2s"
+ *   ≥ 60s → "2m30s"
+ * @param {number} ms
+ * @returns {string}
+ */
+export function formatDuration(ms) {
+  if (!Number.isFinite(ms) || ms < 0) return ''
+  if (ms < 1000) return `${Math.round(ms)}ms`
+  const s = ms / 1000
+  if (s < 60) return `${s.toFixed(1)}s`
+  const m = Math.floor(s / 60)
+  const rem = Math.round(s % 60)
+  return `${m}m${rem}s`
+}
+
 // ──────────────────────────────────────────────
 // 工具调用块(Claude Code 风格)
 // ──────────────────────────────────────────────
@@ -426,8 +581,12 @@ export function printToolHeader(name, summary, write = (s) => process.stdout.wri
  * run_command 的结果里首行是 `$ <command>` 回显——这条信息已经出现在上方的
  * `▶ run_command $ <summary>` 工具头里,这里再印一次就是重复。所以这里把首
  * 行 `$ ...` 剥掉,同时复用它来识别退出码(退出码仍驱动错误着色)。
+ *
+ * @param {string} result - 工具输出文本
+ * @param {(s: string) => void} [write] - 输出函数,默认写 stdout
+ * @param {number} [durationMs] - 执行耗时(毫秒),有值时在结果末尾追加 ⏱ 计时行
  */
-export function printToolResult(result, write = (s) => process.stdout.write(s)) {
+export function printToolResult(result, write = (s) => process.stdout.write(s), durationMs) {
   const text = truncateDisplay(result)
   // 先把 "$ <command>\n" 这一行回显从展示里剥掉(退出码仍在第二行里识别)
   const visible = text.replace(/^\$[^\n]*\n/, '')
@@ -440,7 +599,11 @@ export function printToolResult(result, write = (s) => process.stdout.write(s))
   const colorize = isError ? chalk.hex('#f0a020') : chalk.hex('#94a3b8')
   const lines = visible.split('\n')
   const rendered = lines.map((l) => chalk.dim('  │  ') + colorize(l)).join('\n')
-  write(rendered + '\n')
+  // 有耗时时在结果末尾追加 ⏱ 计时行(与结果块同缩进)
+  const timingLine = (durationMs != null && Number.isFinite(durationMs))
+    ? '\n' + chalk.dim('  │  ⏱ ') + chalk.hex('#7a87a0')(formatDuration(durationMs))
+    : ''
+  write(rendered + timingLine + '\n')
 }
 
 // ──────────────────────────────────────────────
@@ -456,11 +619,15 @@ export default {
   termWidth,
   stripAnsi,
   truncateDisplay,
+  formatDuration,
   printBanner,
   printHelpPanel,
   SLASH_COMMANDS,
   filterSlashCommands,
   renderSlashHintBody,
+  parseKeyForSlashHint,
+  renderSelectableListBody,
+  parseKeyForSelectableList,
   drawInputTop,
   drawInputBottom,
   inputBottomBorder,