zen-gitsync 2.16.14 → 2.16.15

package/src/ui/server/routes/fileOpen.js

@@ -18,6 +18,105 @@ import path from 'path';
 import open from 'open';
 import { spawn, spawnSync } from 'child_process';
 
+const TOOL_INSTALL_PACKAGES = Object.freeze({
+  claude: '@anthropic-ai/claude-code',
+  codex: '@openai/codex',
+  opencode: 'opencode-ai',
+});
+
+const TOOL_DOCS_URLS = Object.freeze({
+  vscode: 'https://code.visualstudio.com/download',
+  claude: 'https://docs.anthropic.com/en/docs/claude-code/getting-started',
+  codex: 'https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started',
+  opencode: 'https://opencode.ai/docs',
+});
+
+function commandExists(command, platform = process.platform) {
+  const checker = platform === 'win32' ? 'where.exe' : 'which';
+  const result = spawnSync(checker, [command], {
+    stdio: 'ignore',
+    windowsHide: true,
+  });
+  return result.status === 0;
+}
+
+/**
+ * 返回当前平台可展示、可执行的安装方案。
+ * executable/args 只在服务端使用；前端只能提交固定 tool id，不能提交命令。
+ */
+export function getToolInstallers(platform = process.platform, hasCommand = commandExists) {
+  const npmExecutable = platform === 'win32' ? 'npm.cmd' : 'npm';
+  const npmAvailable = hasCommand('npm', platform);
+  const installers = {};
+
+  for (const [tool, packageName] of Object.entries(TOOL_INSTALL_PACKAGES)) {
+    installers[tool] = {
+      supported: npmAvailable,
+      command: `npm install -g ${packageName}`,
+      packageManager: 'npm',
+      docsUrl: TOOL_DOCS_URLS[tool],
+      note: npmAvailable
+        ? '将在新终端中执行全局安装。安装过程中可能需要登录或确认权限。'
+        : '未检测到 npm，请先安装 Node.js/npm，或按照官方文档手动安装。',
+      executable: npmExecutable,
+      args: ['install', '-g', packageName],
+    };
+  }
+
+  if (platform === 'win32') {
+    const wingetAvailable = hasCommand('winget', platform);
+    installers.vscode = {
+      supported: wingetAvailable,
+      command: 'winget install --id Microsoft.VisualStudioCode -e --accept-package-agreements --accept-source-agreements',
+      packageManager: 'winget',
+      docsUrl: TOOL_DOCS_URLS.vscode,
+      note: wingetAvailable
+        ? '将在新终端中通过 winget 安装 Visual Studio Code。'
+        : '未检测到 winget，请使用 VS Code 官方安装程序。',
+      executable: 'winget',
+      args: ['install', '--id', 'Microsoft.VisualStudioCode', '-e', '--accept-package-agreements', '--accept-source-agreements'],
+    };
+  } else if (platform === 'darwin') {
+    const brewAvailable = hasCommand('brew', platform);
+    installers.vscode = {
+      supported: brewAvailable,
+      command: 'brew install --cask visual-studio-code',
+      packageManager: 'Homebrew',
+      docsUrl: TOOL_DOCS_URLS.vscode,
+      note: brewAvailable
+        ? '将在新终端中通过 Homebrew 安装 Visual Studio Code。'
+        : '未检测到 Homebrew，请使用 VS Code 官方安装程序。',
+      executable: 'brew',
+      args: ['install', '--cask', 'visual-studio-code'],
+    };
+  } else {
+    const snapAvailable = hasCommand('snap', platform);
+    installers.vscode = {
+      supported: snapAvailable,
+      command: 'sudo snap install code --classic',
+      packageManager: 'snap',
+      docsUrl: TOOL_DOCS_URLS.vscode,
+      note: snapAvailable
+        ? '将在新终端中通过 snap 安装 Visual Studio Code，可能需要输入系统密码。'
+        : '当前 Linux 环境未检测到 snap，请按照发行版对应的官方说明安装。',
+      executable: 'sudo',
+      args: ['snap', 'install', 'code', '--classic'],
+    };
+  }
+
+  return installers;
+}
+
+function publicInstallerInfo(installers) {
+  return Object.fromEntries(Object.entries(installers).map(([tool, installer]) => [tool, {
+    supported: installer.supported,
+    command: installer.command,
+    packageManager: installer.packageManager,
+    docsUrl: installer.docsUrl,
+    note: installer.note,
+  }]));
+}
+
 function spawnDetached(command, args, options = {}) {
   return new Promise((resolve, reject) => {
     const child = spawn(command, args, {
@@ -125,6 +224,18 @@ async function launchOpenCode(dirPath) {
   return launchInTerminal(dirPath, 'opencode');
 }
 
+async function launchToolInstaller(installer, dirPath = process.cwd()) {
+  if (process.platform === 'win32') {
+    // 安装命令完全来自服务端白名单。使用可见 cmd 窗口，让用户看到进度和错误。
+    const commandLine = [installer.executable, ...installer.args].join(' ');
+    return spawnDetached('cmd.exe', ['/c', 'start', '', 'cmd.exe', '/k', commandLine], {
+      cwd: dirPath,
+    });
+  }
+
+  return launchInTerminal(dirPath, installer.executable, installer.args);
+}
+
 export function registerFileOpenRoutes({
   app
 }) {
@@ -405,6 +516,26 @@ export function registerFileOpenRoutes({
       }
     }));
 
+  // 安装本地工具：前端只能传固定 tool id，实际命令由服务端按平台从白名单选择。
+  app.post('/api/install-tool', asyncRoute(async (req, res) => {
+      const { tool } = req.body || {};
+      const installers = getToolInstallers();
+      const installer = installers[tool];
+
+      if (!installer) {
+        throw new HttpError(400, '不支持的工具');
+      }
+      if (!installer.supported) {
+        throw new HttpError(400, installer.note || '当前系统不支持一键安装，请按照官方文档手动安装');
+      }
+
+      await launchToolInstaller(installer);
+      res.json({
+        success: true,
+        message: '安装命令已在新终端中启动',
+      });
+    }));
+
   // 检测本地工具是否已安装(供前端根据结果决定是否显示对应按钮)
   // 检测方式: spawn 'tool --version',exit 0 即视为已安装
   // 超时 15s:Claude CLI / opencode 等 Node 包装的工具首次冷启动
@@ -435,6 +566,15 @@ export function registerFileOpenRoutes({
         checkCmd('opencode'),
       ]);
 
-      res.json({ success: true, vscode, claude, codex, opencode });
+      const installers = getToolInstallers();
+      res.json({
+        success: true,
+        platform: process.platform,
+        installers: publicInstallerInfo(installers),
+        vscode,
+        claude,
+        codex,
+        opencode,
+      });
     }));
-}
+}

package/src/ui/server/routes/workbench/agentRoutes.js

@@ -1,218 +1,218 @@
-// 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.
-//
-// 智能体路由入口。
-//
-// 路由清单:
-//   GET    /api/agent/sessions           — 列出所有会话(仅 metadata)
-//   GET    /api/agent/sessions/:id       — 获取会话详情(含完整消息)
-//   DELETE /api/agent/sessions/:id       — 删除会话
-//   PUT    /api/agent/sessions/:id       — 重命名会话
-//   POST   /api/agent/chat               — SSE 流式聊天(含工具调用)
-
-import { asyncRoute, HttpError } from '../../utils/asyncRoute.js';
-import { agentSessionStore } from './agentSessionStore.js';
-import { runAgentTurn } from './agentChat.js';
-import { nowIso } from './shared.js';
-
-const { genSessionId, autoTitle, read: readSession, write: writeSession, delete: deleteSession, listMeta: listSessionsMeta, enforceRetention, rename: renameSession } = agentSessionStore;
-
-/**
- * 注册智能体路由。
- * @param {Object} deps
- * @param {import('express').Express} deps.app
- * @param {() => string} deps.getCurrentProjectPath
- * @param {Object} deps.configManager
- */
-export function registerAgentRoutes({ app, getCurrentProjectPath, configManager }) {
-
-  // ════════════════════════════════════════════════════════════════════════
-  // §1. 会话列表
-  // ════════════════════════════════════════════════════════════════════════
-  app.get('/api/agent/sessions', asyncRoute(async (_req, res) => {
-    const sessions = await listSessionsMeta();
-    res.json({ success: true, sessions });
-  }));
-
-  // ════════════════════════════════════════════════════════════════════════
-  // §2. 会话详情
-  // ════════════════════════════════════════════════════════════════════════
-  app.get('/api/agent/sessions/:sessionId', asyncRoute(async (req, res) => {
-    const session = await readSession(req.params.sessionId);
-    res.json({ success: true, session });
-  }));
-
-  // ════════════════════════════════════════════════════════════════════════
-  // §3. 删除会话
-  // ════════════════════════════════════════════════════════════════════════
-  app.delete('/api/agent/sessions/:sessionId', asyncRoute(async (req, res) => {
-    await deleteSession(req.params.sessionId);
-    res.json({ success: true });
-  }));
-
-  // ════════════════════════════════════════════════════════════════════════
-  // §4. 重命名会话
-  // ════════════════════════════════════════════════════════════════════════
-  app.put('/api/agent/sessions/:sessionId', asyncRoute(async (req, res) => {
-    const title = String(req.body?.title || '').trim();
-    if (!title) throw new HttpError(400, '标题不能为空');
-    const session = await renameSession(req.params.sessionId, title);
-    res.json({ success: true, session });
-  }));
-
-  // ════════════════════════════════════════════════════════════════════════
-  // §5. SSE 流式聊天（含工具调用循环）
-  // ════════════════════════════════════════════════════════════════════════
-  app.post('/api/agent/chat', async (req, res) => {
-    const userMessage = String(req.body?.userMessage || '').trim();
-    const sessionIdInput = String(req.body?.sessionId || '').trim();
-    const locale = String(req.body?.locale || req.headers['accept-language'] || 'zh').startsWith('en') ? 'en' : 'zh';
-
-    // 图片附件（base64 dataURL 数组）：前端已限制只能选图片，这里再做一层白名单校验
-    const images = (Array.isArray(req.body?.images) ? req.body.images : [])
-      .filter(u => typeof u === 'string' && /^data:image\/[\w.+-]+;base64,/.test(u))
-      .slice(0, 10);
-
-    if (!userMessage && images.length === 0) {
-      return res.status(400).json({ success: false, error: '消息内容不能为空' });
-    }
-
-    // SSE 头
-    res.set({
-      'Content-Type': 'text/event-stream',
-      'Cache-Control': 'no-cache, no-transform',
-      'Connection': 'keep-alive',
-      'X-Accel-Buffering': 'no'
-    });
-    res.flushHeaders?.();
-    const send = (obj) => {
-      try { res.write(`data: ${JSON.stringify(obj)}\n\n`); } catch {}
-    };
-
-    const abortController = new AbortController();
-    let finished = false;
-    let activeChild = null;
-
-    // 客户端断开
-    if (req.socket) {
-      req.socket.once('close', () => {
-        if (!finished) {
-          abortController.abort();
-          if (activeChild) {
-            try { activeChild.kill('SIGTERM'); } catch {}
-          }
-        }
-      });
-    }
-
-    try {
-      // 加载或新建 session
-      let session;
-      let isNew = false;
-
-      if (sessionIdInput) {
-        try {
-          session = await readSession(sessionIdInput);
-        } catch (err) {
-          if (err.statusCode === 404) {
-            send({ type: 'error', error: '会话不存在' });
-            finished = true;
-            return res.end();
-          }
-          throw err;
-        }
-      } else {
-        session = {
-          version: 1,
-          sessionId: genSessionId(),
-          title: '(新会话)',
-          source: 'web',
-          cwd: typeof getCurrentProjectPath === 'function' ? getCurrentProjectPath() : process.cwd(),
-          model: '',
-          createdAt: nowIso(),
-          updatedAt: nowIso(),
-          messages: []
-        };
-        isNew = true;
-      }
-
-      // 获取模型配置
-      let model;
-      try {
-        if (!configManager) throw new Error('configManager 不可用');
-        const rawConfig = await configManager.readRawConfigFile();
-        const models = Array.isArray(rawConfig.models) ? rawConfig.models : [];
-        model = models.find(m => m.isDefault) || models[0];
-      } catch (err) {
-        send({ type: 'error', error: '读取 AI 配置失败: ' + err.message });
-        finished = true;
-        return res.end();
-      }
-      if (!model) {
-        send({ type: 'error', error: '未配置 AI 模型，请先在通用设置中添加模型' });
-        finished = true;
-        return res.end();
-      }
-
-      // 更新 session 的 model 信息
-      session.model = `${model.model || ''} (${model.name || ''})`;
-
-      // 工作目录
-      const cwd = session.cwd || (typeof getCurrentProjectPath === 'function' ? getCurrentProjectPath() : process.cwd());
-
-      // 推 meta
-      send({
-        type: 'meta',
-        sessionId: session.sessionId,
-        isNew,
-        title: isNew ? autoTitle([{ role: 'user', content: userMessage }]) : session.title
-      });
-
-      // 运行 agent 循环
-      const { aborted } = await runAgentTurn({
-        session,
-        model,
-        userMessage,
-        images,
-        cwd,
-        locale,
-        signal: abortController.signal,
-        send,
-        onChild: (child) => { activeChild = child; }
-      });
-
-      if (aborted) {
-        finished = true;
-        return res.end();
-      }
-
-      // 更新标题(新会话从第一条 user 消息自动生成)
-      if (isNew) {
-        session.title = autoTitle(session.messages);
-      }
-
-      // 持久化
-      session.updatedAt = nowIso();
-      await writeSession(session.sessionId, session);
-      enforceRetention().catch(() => {});
-
-      finished = true;
-      res.end();
-    } catch (err) {
-      send({ type: 'error', error: '智能体对话失败: ' + (err?.message || String(err)) });
-      finished = true;
-      res.end();
-    }
-  });
-}
+// 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.
+//
+// 智能体路由入口。
+//
+// 路由清单:
+//   GET    /api/agent/sessions           — 列出所有会话(仅 metadata)
+//   GET    /api/agent/sessions/:id       — 获取会话详情(含完整消息)
+//   DELETE /api/agent/sessions/:id       — 删除会话
+//   PUT    /api/agent/sessions/:id       — 重命名会话
+//   POST   /api/agent/chat               — SSE 流式聊天(含工具调用)
+
+import { asyncRoute, HttpError } from '../../utils/asyncRoute.js';
+import { agentSessionStore } from './agentSessionStore.js';
+import { runAgentTurn } from './agentChat.js';
+import { nowIso } from './shared.js';
+
+const { genSessionId, autoTitle, read: readSession, write: writeSession, delete: deleteSession, listMeta: listSessionsMeta, enforceRetention, rename: renameSession } = agentSessionStore;
+
+/**
+ * 注册智能体路由。
+ * @param {Object} deps
+ * @param {import('express').Express} deps.app
+ * @param {() => string} deps.getCurrentProjectPath
+ * @param {Object} deps.configManager
+ */
+export function registerAgentRoutes({ app, getCurrentProjectPath, configManager }) {
+
+  // ════════════════════════════════════════════════════════════════════════
+  // §1. 会话列表
+  // ════════════════════════════════════════════════════════════════════════
+  app.get('/api/agent/sessions', asyncRoute(async (_req, res) => {
+    const sessions = await listSessionsMeta();
+    res.json({ success: true, sessions });
+  }));
+
+  // ════════════════════════════════════════════════════════════════════════
+  // §2. 会话详情
+  // ════════════════════════════════════════════════════════════════════════
+  app.get('/api/agent/sessions/:sessionId', asyncRoute(async (req, res) => {
+    const session = await readSession(req.params.sessionId);
+    res.json({ success: true, session });
+  }));
+
+  // ════════════════════════════════════════════════════════════════════════
+  // §3. 删除会话
+  // ════════════════════════════════════════════════════════════════════════
+  app.delete('/api/agent/sessions/:sessionId', asyncRoute(async (req, res) => {
+    await deleteSession(req.params.sessionId);
+    res.json({ success: true });
+  }));
+
+  // ════════════════════════════════════════════════════════════════════════
+  // §4. 重命名会话
+  // ════════════════════════════════════════════════════════════════════════
+  app.put('/api/agent/sessions/:sessionId', asyncRoute(async (req, res) => {
+    const title = String(req.body?.title || '').trim();
+    if (!title) throw new HttpError(400, '标题不能为空');
+    const session = await renameSession(req.params.sessionId, title);
+    res.json({ success: true, session });
+  }));
+
+  // ════════════════════════════════════════════════════════════════════════
+  // §5. SSE 流式聊天（含工具调用循环）
+  // ════════════════════════════════════════════════════════════════════════
+  app.post('/api/agent/chat', async (req, res) => {
+    const userMessage = String(req.body?.userMessage || '').trim();
+    const sessionIdInput = String(req.body?.sessionId || '').trim();
+    const locale = String(req.body?.locale || req.headers['accept-language'] || 'zh').startsWith('en') ? 'en' : 'zh';
+
+    // 图片附件（base64 dataURL 数组）：前端已限制只能选图片，这里再做一层白名单校验
+    const images = (Array.isArray(req.body?.images) ? req.body.images : [])
+      .filter(u => typeof u === 'string' && /^data:image\/[\w.+-]+;base64,/.test(u))
+      .slice(0, 10);
+
+    if (!userMessage && images.length === 0) {
+      return res.status(400).json({ success: false, error: '消息内容不能为空' });
+    }
+
+    // SSE 头
+    res.set({
+      'Content-Type': 'text/event-stream',
+      'Cache-Control': 'no-cache, no-transform',
+      'Connection': 'keep-alive',
+      'X-Accel-Buffering': 'no'
+    });
+    res.flushHeaders?.();
+    const send = (obj) => {
+      try { res.write(`data: ${JSON.stringify(obj)}\n\n`); } catch {}
+    };
+
+    const abortController = new AbortController();
+    let finished = false;
+    let activeChild = null;
+
+    // 客户端断开
+    if (req.socket) {
+      req.socket.once('close', () => {
+        if (!finished) {
+          abortController.abort();
+          if (activeChild) {
+            try { activeChild.kill('SIGTERM'); } catch {}
+          }
+        }
+      });
+    }
+
+    try {
+      // 加载或新建 session
+      let session;
+      let isNew = false;
+
+      if (sessionIdInput) {
+        try {
+          session = await readSession(sessionIdInput);
+        } catch (err) {
+          if (err.statusCode === 404) {
+            send({ type: 'error', error: '会话不存在' });
+            finished = true;
+            return res.end();
+          }
+          throw err;
+        }
+      } else {
+        session = {
+          version: 1,
+          sessionId: genSessionId(),
+          title: '(新会话)',
+          source: 'web',
+          cwd: typeof getCurrentProjectPath === 'function' ? getCurrentProjectPath() : process.cwd(),
+          model: '',
+          createdAt: nowIso(),
+          updatedAt: nowIso(),
+          messages: []
+        };
+        isNew = true;
+      }
+
+      // 获取模型配置
+      let model;
+      try {
+        if (!configManager) throw new Error('configManager 不可用');
+        const rawConfig = await configManager.readRawConfigFile();
+        const models = Array.isArray(rawConfig.models) ? rawConfig.models : [];
+        model = models.find(m => m.isDefault) || models[0];
+      } catch (err) {
+        send({ type: 'error', error: '读取 AI 配置失败: ' + err.message });
+        finished = true;
+        return res.end();
+      }
+      if (!model) {
+        send({ type: 'error', error: '未配置 AI 模型，请先在通用设置中添加模型' });
+        finished = true;
+        return res.end();
+      }
+
+      // 更新 session 的 model 信息
+      session.model = `${model.model || ''} (${model.name || ''})`;
+
+      // 工作目录
+      const cwd = session.cwd || (typeof getCurrentProjectPath === 'function' ? getCurrentProjectPath() : process.cwd());
+
+      // 推 meta
+      send({
+        type: 'meta',
+        sessionId: session.sessionId,
+        isNew,
+        title: isNew ? autoTitle([{ role: 'user', content: userMessage }]) : session.title
+      });
+
+      // 运行 agent 循环
+      const { aborted } = await runAgentTurn({
+        session,
+        model,
+        userMessage,
+        images,
+        cwd,
+        locale,
+        signal: abortController.signal,
+        send,
+        onChild: (child) => { activeChild = child; }
+      });
+
+      if (aborted) {
+        finished = true;
+        return res.end();
+      }
+
+      // 更新标题(新会话从第一条 user 消息自动生成)
+      if (isNew) {
+        session.title = autoTitle(session.messages);
+      }
+
+      // 持久化
+      session.updatedAt = nowIso();
+      await writeSession(session.sessionId, session);
+      enforceRetention().catch(() => {});
+
+      finished = true;
+      res.end();
+    } catch (err) {
+      send({ type: 'error', error: '智能体对话失败: ' + (err?.message || String(err)) });
+      finished = true;
+      res.end();
+    }
+  });
+}