zen-gitsync 2.17.8 → 2.17.10

package/src/ui/server/index.js

@@ -41,6 +41,7 @@ import { registerGitRoutes } from './routes/git.js';
 import { registerFsRoutes } from './routes/fs.js';
 import { registerNpmRoutes } from './routes/npm.js';
 import { registerFileOpenRoutes } from './routes/fileOpen.js';
+import { registerRemoteReposRoutes } from './routes/remoteRepos.js';
 import { registerWorkbenchRoutes } from './routes/workbench.js';
 import { registerGitOpsRoutes } from './routes/gitOps.js';
 import { registerCodeRoutes } from './routes/code.js';
@@ -404,6 +405,9 @@ async function startUIServer(noOpen = false, savePort = false) {
     app
   });
 
+  // 远程托管平台仓库列表(GitHub / Gitee 两个 Tab 的数据源)
+  registerRemoteReposRoutes({ app });
+
   registerWorkbenchRoutes({
     app,
     getCurrentProjectPath: () => currentProjectPath,

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

@@ -986,10 +986,10 @@ export function registerConfigRoutes({
     }
   })
 
-  // 保存通用设置（主题、语言、工作台任务执行器）
+  // 保存通用设置（主题、语言、工作台任务执行器、任务完成提示）
   app.post('/api/config/save-general-settings', express.json(), async (req, res) => {
     try {
-      const { theme, locale, taskExecutor } = req.body
+      const { theme, locale, taskExecutor, notifyOnTaskDone } = req.body
 
       // 读取原始配置以保留项目设置
       const rawConfig = await configManager.readRawConfigFile()
@@ -1007,9 +1007,22 @@ export function registerConfigRoutes({
         rawConfig.taskExecutor = normalizedExecutor
       }
 
+      // 任务执行结束提示开关（全局，默认关）。只接受布尔值，其它类型静默忽略，
+      // 避免前端误传字符串 'false' 被当成真值落盘后永久打开。
+      // ⚠️ 规范化函数对非法值返回的是 **null**（与 normalizeTaskExecutor 同语义），
+      // 不是 undefined —— 判 `!== undefined` 会把非法值原样写进去变成 `null`。
+      const normalizedNotify = configManager.normalizeNotifyOnTaskDone(notifyOnTaskDone)
+      if (normalizedNotify !== null) {
+        rawConfig.notifyOnTaskDone = normalizedNotify
+      }
+
       // 直接写入原始配置，避免覆盖项目设置
       await configManager.writeRawConfigFile(rawConfig)
-      res.json({ success: true, taskExecutor: normalizedExecutor || undefined })
+      res.json({
+        success: true,
+        taskExecutor: normalizedExecutor || undefined,
+        notifyOnTaskDone: normalizedNotify ?? undefined
+      })
     } catch (error) {
       res.status(500).json({ success: false, error: error.message })
     }

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

@@ -18,6 +18,7 @@ import iconv from 'iconv-lite';
 import { spawn } from 'child_process';
 import { ensureWithinCwd } from '../utils/pathGuard.js';
 import { asyncRoute, HttpError } from '../utils/asyncRoute.js';
+import { augmentEnvPath } from '../../../utils/shellPath.js';
 
 // ─────────────────────────────────────────────────────────────────────────────
 // 命令 → argv 拆分(SEC-INJ-2 修复)
@@ -92,16 +93,23 @@ function resolveBinAndArgs(command) {
 }
 
 // 通用 env 模板 — 颜色 + 终端兼容性,所有 exec 流式 / 交互式复用
-const CHILD_ENV_TEMPLATE = {
-  ...process.env,
-  GIT_CONFIG_PARAMETERS: "'color.ui=always' 'color.status=always' 'core.quotepath=false'",
-  FORCE_COLOR: '3',
-  NPM_CONFIG_COLOR: 'always',
-  TERM: 'xterm-256color',
-  COLORTERM: 'truecolor',
-  CLICOLOR_FORCE: '1',
-  PYTHONUNBUFFERED: '1',
-};
+//
+// PATH 交给 augmentEnvPath 补一次注册表最新值：服务端进程的环境块是**启动快照**，
+// 用户在这个进程活着期间装的 CLI 不在里面，表现是"GUI 里能探测到、执行却报
+// '不是内部或外部命令'"（2026-09-22 实测 gh）。详见 utils/shellPath.js。
+// 因为要读注册表，这里必须是函数而不能是模块级常量 —— 常量会在 import 时定死。
+async function buildChildEnv() {
+  return augmentEnvPath({
+    ...process.env,
+    GIT_CONFIG_PARAMETERS: "'color.ui=always' 'color.status=always' 'core.quotepath=false'",
+    FORCE_COLOR: '3',
+    NPM_CONFIG_COLOR: 'always',
+    TERM: 'xterm-256color',
+    COLORTERM: 'truecolor',
+    CLICOLOR_FORCE: '1',
+    PYTHONUNBUFFERED: '1',
+  });
+}
 
 function isWindowsBuiltinCommand(command) {
   if (process.platform !== 'win32') return false;
@@ -157,7 +165,7 @@ export function registerExecRoutes({
       // spawn(bin, argv, { shell: false }) — 不走 shell,无注入
       const childProcess = spawn(bin, args, {
         cwd: execDirectory,
-        env: CHILD_ENV_TEMPLATE,
+        env: await buildChildEnv(),
       });
 
       runningProcesses.set(processId, {

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

@@ -20,6 +20,7 @@ import open from 'open';
 import { spawn, spawnSync, execFile } from 'child_process';
 import { fileURLToPath } from 'node:url';
 import { promisify } from 'node:util';
+import { augmentEnvPath, pathValueOf, withPathValue } from '../../../utils/shellPath.js';
 
 const execFileAsync = promisify(execFile);
 
@@ -38,6 +39,10 @@ const TOOL_DOCS_URLS = Object.freeze({
   kimi: 'https://moonshotai.github.io/kimi-code/en/guides/getting-started',
   zcode: 'https://zcode.z.ai/',
   dsh: 'https://github.com/deepseek-ai/deepseek-harness',
+  // 远程仓库列表页(RemoteReposList)用到的两个托管平台 CLI。它们不是"AI 工具",
+  // 不参与 /api/check-tools 的 open-with 菜单,只借这里的白名单走 /api/install-tool。
+  gh: 'https://cli.github.com/',
+  gitee: 'https://gitee.com/oschina/gitee-cli',
 });
 
 function commandExists(command, platform = process.platform) {
@@ -251,10 +256,91 @@ export function getToolInstallers(platform = process.platform, hasCommand = comm
     updatePackageManager: 'ZCode 官方安装包',
     updateNote: 'ZCode 是桌面应用，升级请到官网下载新版安装包覆盖安装。',
   };
+
+  // ── 远程托管平台 CLI(远程仓库列表页用)──────────────────────────────────
+  // 与上面的 AI 工具共用同一份白名单,好处是"前端只能提交 tool id、命令由服务端
+  // 决定"这条安全边界不用再实现一遍。它们不出现在 open-with 菜单里 —— 那个菜单
+  // 是 useDirectoryOpenActions.ts 里的硬编码数组,不看这张表。
+  if (platform === 'win32') {
+    const wingetAvailable = hasCommand('winget', platform);
+    installers.gh = {
+      supported: wingetAvailable,
+      command: 'winget install --id GitHub.cli -e --accept-package-agreements --accept-source-agreements',
+      packageManager: 'winget',
+      docsUrl: TOOL_DOCS_URLS.gh,
+      note: wingetAvailable
+        ? '将在新终端中通过 winget 安装 GitHub CLI；装完请在新终端执行 gh auth login 登录。'
+        : '未检测到 winget，请到 cli.github.com 下载安装包。',
+      executable: 'winget',
+      args: ['install', '--id', 'GitHub.cli', '-e', '--accept-package-agreements', '--accept-source-agreements'],
+      updateCommand: wingetAvailable
+        ? 'winget upgrade --id GitHub.cli -e --accept-package-agreements --accept-source-agreements'
+        : undefined,
+      updatePackageManager: 'winget',
+      updateNote: wingetAvailable ? '将在新终端中通过 winget upgrade 升级 GitHub CLI。' : '未检测到 winget。',
+      updateExecutable: wingetAvailable ? 'winget' : undefined,
+      updateArgs: wingetAvailable
+        ? ['upgrade', '--id', 'GitHub.cli', '-e', '--accept-package-agreements', '--accept-source-agreements']
+        : undefined,
+    };
+  } else if (platform === 'darwin') {
+    const brewAvailable = hasCommand('brew', platform);
+    installers.gh = {
+      supported: brewAvailable,
+      command: 'brew install gh',
+      packageManager: 'Homebrew',
+      docsUrl: TOOL_DOCS_URLS.gh,
+      note: brewAvailable
+        ? '将在新终端中通过 Homebrew 安装 GitHub CLI；装完请执行 gh auth login 登录。'
+        : '未检测到 Homebrew，请到 cli.github.com 下载安装包。',
+      executable: 'brew',
+      args: ['install', 'gh'],
+      updateCommand: brewAvailable ? 'brew upgrade gh' : undefined,
+      updatePackageManager: 'Homebrew',
+      updateNote: brewAvailable ? '将在新终端中通过 brew upgrade 升级 GitHub CLI。' : '未检测到 brew。',
+      updateExecutable: brewAvailable ? 'brew' : undefined,
+      updateArgs: brewAvailable ? ['upgrade', 'gh'] : undefined,
+    };
+  } else {
+    // Debian/Ubuntu 官方源里已有 gh;其它发行版请看 docsUrl(Arch: pacman -S github-cli)
+    const aptAvailable = hasCommand('apt-get', platform);
+    installers.gh = {
+      supported: aptAvailable,
+      command: 'sudo apt-get install -y gh',
+      packageManager: 'apt',
+      docsUrl: TOOL_DOCS_URLS.gh,
+      note: aptAvailable
+        ? '将在新终端中通过 apt 安装 GitHub CLI，可能需要输入系统密码；装完请执行 gh auth login 登录。'
+        : '当前 Linux 环境未检测到 apt-get，请按 docsUrl 里对应发行版的说明安装。',
+      executable: 'sudo',
+      args: ['apt-get', 'install', '-y', 'gh'],
+      // apt 没有"就地升级单个包"的稳定动词,不给一键更新,引导去官方文档
+      updateCommand: undefined,
+      updatePackageManager: 'apt',
+      updateNote: '请按官方文档升级 GitHub CLI。',
+    };
+  }
+  installers.gitee = {
+    supported: npmAvailable,
+    command: 'npm install -g @gitee/gitee-cli',
+    packageManager: 'npm',
+    docsUrl: TOOL_DOCS_URLS.gitee,
+    note: npmAvailable
+      ? '将在新终端中通过 npm 全局安装 Gitee CLI；装完请执行 gitee auth login 粘贴私人令牌。'
+      : '未检测到 npm，请先安装 Node.js/npm，或按官方文档手动安装。',
+    executable: npmExecutable,
+    args: ['install', '-g', '@gitee/gitee-cli'],
+    updateCommand: 'npm install -g @gitee/gitee-cli@latest',
+    updatePackageManager: 'npm',
+    updateNote: '将在新终端中执行 `npm install -g @gitee/gitee-cli@latest`。已是最新时 npm 会跳过。',
+    updateExecutable: npmExecutable,
+    updateArgs: ['install', '-g', '@gitee/gitee-cli@latest'],
+  };
+
   return installers;
 }
 
-function publicInstallerInfo(installers) {
+export function publicInstallerInfo(installers) {
   return Object.fromEntries(Object.entries(installers).map(([tool, installer]) => [tool, {
     supported: installer.supported,
     command: installer.command,
@@ -393,7 +479,13 @@ export async function launchGai(dirPath, {
     '-WorkingDirectory (Get-Location).ProviderPath -WindowStyle Normal',
   ].join(' ');
   return spawnFn('powershell.exe', ['-NoLogo', '-NoProfile', '-NonInteractive', '-EncodedCommand', encode(launcher)], {
-    cwd: dirPath, windowsHide: true, timeout: 10000,
+    cwd: dirPath,
+    windowsHide: true,
+    timeout: 10000,
+    // 这个终端窗口以及里面跑起来的 g ai，会继承下面这份 env；把注册表里新装的 CLI
+    // 目录补进去，否则窗口里 `gh repo list` 照样报"不是内部或外部命令"
+    // （本进程的 PATH 是启动快照）。见 utils/shellPath.js 顶部。
+    env: await augmentEnvPath(process.env),
   });
 }
 
@@ -577,6 +669,54 @@ async function launchToolInstaller(installer, dirPath = process.cwd(), { update
   return launchInTerminal(dirPath, installer[executableField], installer[argsField]);
 }
 
+/**
+ * 在新终端窗口里跑一条**服务端白名单内的**命令，跑完窗口不自动关。
+ *
+ * 与 launchToolInstaller 的区别：那个吃 installer 描述符(executable + args)，
+ * 这个直接吃整条命令串。给「登录」这类**交互式** CLI 用 —— `gh auth login`
+ * 会走一串问答(选 GitHub.com / 协议 / 浏览器还是粘贴 token)，必须在真终端里跑：
+ * 被 spawn 出去又没有 TTY 的话，它直接就失败了，用户屏幕上什么也看不到。
+ *
+ * Windows 用 `cmd /k`：登录完成后窗口留着，用户能看清结果；失败也能看到报错。
+ *
+ * ⚠️ command 必须是服务端自己拼出来的常量。永远不要把它接成请求体里的字符串 ——
+ * 那等于开了一个任意命令执行的口子(和 /api/install-tool 同一条原则)。
+ *
+ * `pathDirs` 是**必须**看的参数(2026-09-22 实测踩到)：
+ *   本进程的 `process.env.PATH` 是"启动那一刻"的快照。用户在界面里刚装好 gh，
+ *   安装器改的是**注册表**里的 PATH，我们这个已经跑着的 node 进程看不见 ——
+ *   于是出现很割裂的一幕：**探测**能找到 gh(它走注册表 + 默认落点)，界面显示
+ *   "gh 2.101.0 已安装"，可 `cmd /k gh auth login` 这个子进程按自己的 PATH 找，
+ *   回一句 `'gh' 不是内部或外部命令`；而用户自己新开一个 cmd 却是好的，
+ *   因为新进程拿到的是最新 PATH。
+ *   解法有两层，缺一不可：
+ *     1. **基线兜底**（`augmentEnvPath`）：把注册表 Machine + User 的 PATH 里本进程
+ *        快照没有的目录补进子进程 —— 语义上等价于"这个进程是现在才启动的"。
+ *        所以**不传 `pathDirs` 也不会踩旧快照**，`launchGai` 这类入口不用各自记得传。
+ *     2. `pathDirs`：调用方**已经知道 CLI 落点**时显式**前置**，抢在别的同名命令之前。
+ *        注意两层语义不同：兜底是追加（不动原有优先级），pathDirs 是前置（要优先）。
+ *   比起"把可执行文件全路径拼进命令行"，前置 PATH 还顺带绕开了 cmd.exe 那套
+ *   "路径带空格时的嵌套引号"地狱(`C:\Program Files\GitHub CLI\gh.exe`)。
+ */
+export async function launchCommandInTerminal(command, { cwd = process.cwd(), pathDirs = [] } = {}) {
+  const dirs = pathDirs.filter(Boolean);
+  const augmented = await augmentEnvPath(process.env);
+  let env;
+  if (dirs.length) {
+    env = withPathValue(augmented, [...dirs, pathValueOf(augmented)].filter(Boolean).join(path.delimiter));
+  } else {
+    // 没有要补的就传 undefined，让子进程原样继承父环境（与改动前行为一致）
+    env = augmented === process.env ? undefined : augmented;
+  }
+
+  if (process.platform === 'win32') {
+    return spawnDetached('cmd.exe', ['/c', 'start', '', 'cmd.exe', '/k', command], { cwd, env });
+  }
+  // posix 侧不额外处理 PATH：那边没有"安装器改注册表"这套机制，
+  // 终端模拟器直接继承图形会话的环境，不会出现上面的错配。
+  return launchInTerminal(cwd, 'bash', ['-lc', command]);
+}
+
 export function registerFileOpenRoutes({
   app,
   launchAi = launchGai,