zen-gitsync 2.17.16 → 2.17.18

package/src/ui/server/routes/aiContext/render.test.js

@@ -0,0 +1,255 @@
+// aiContext/render.js 单元测试（纯函数）。
+//
+// 钉住两条核心契约：
+//   1. 注入给模型的块里**只有摘要，板块正文一行都不能进** —— 破了不会报错，
+//      只会静默烧 token 并把用户真正要办的那句话淹掉（envContext.js 头注释记的是同一个坑）。
+//   2. **不论快照有没有生成，块里都必须有"七个板块各自怎么查实时值"** ——
+//      快照天生会旧，"实时"这件事最终靠这句话兜底，所以它不许被截断、不许为空。
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import {
+  AI_CONTEXT_SECTIONS,
+  MAX_CONTEXT_BLOCK_CHARS,
+  MAX_SUMMARY_CHARS,
+  buildContextBlock,
+  formatStamp,
+  joinSnapshotPath,
+  oneLine,
+  renderIndexFile,
+  renderSectionFile,
+  sectionForceTtl,
+  sectionQueryHint,
+  sectionTtl,
+  truncate,
+} from './render.js';
+
+const okResult = (over = {}) => ({
+  id: 'git',
+  title: '当前项目 Git 状态',
+  file: 'git-current.md',
+  ok: true,
+  summary: '分支 main，工作区干净',
+  lines: ['- 分支: main'],
+  error: '',
+  collectedAt: '2026-09-28 10:15:32',
+  ...over,
+});
+
+test('板块清单:文件带 .md 后缀且 id 唯一（文件名就是模型要读的路径）', () => {
+  const ids = AI_CONTEXT_SECTIONS.map(s => s.id);
+  assert.equal(new Set(ids).size, ids.length, 'id 必须唯一');
+  for (const s of AI_CONTEXT_SECTIONS) {
+    assert.match(s.file, /^[a-z0-9-]+\.md$/, `${s.id} 的文件名形状不对`);
+    assert.ok(s.title, `${s.id} 缺标题`);
+    assert.ok(s.queryHint && s.queryHint.length > 20, `${s.id} 缺"实时怎么查"的提示`);
+    assert.ok(Number.isFinite(s.ttlMs) && s.ttlMs > 0, `${s.id} 缺 ttlMs`);
+    assert.ok(Number.isFinite(s.forceTtlMs) && s.forceTtlMs >= 0, `${s.id} 缺 forceTtlMs`);
+  }
+});
+
+test('板块时间参数:联网板块（github/gitee）必须留强制刷新地板，本地板块不必', () => {
+  // 联网板块被前端"切面板就刷"打到会疯狂拉网络，必须有地板
+  assert.ok(sectionForceTtl('github') >= 30_000, 'github 要有 force 地板');
+  assert.ok(sectionForceTtl('gitee') >= 30_000, 'gitee 要有 force 地板');
+  // 本地板块刷一次是毫秒级，不留地板
+  for (const id of ['git', 'commands', 'tasks', 'system', 'mindmap']) {
+    assert.equal(sectionForceTtl(id), 0, `${id} 不该有地板`);
+  }
+  // 软 TTL:git 必须比仓库列表短（本地状态变化快、取数便宜）
+  assert.ok(sectionTtl('git') < sectionTtl('github'), 'git 的 TTL 该比仓库列表短');
+  // 未知 id 的回落行为
+  assert.equal(sectionForceTtl('nope'), 0);
+  assert.ok(sectionTtl('nope') > 0);
+  assert.equal(sectionQueryHint('nope'), '');
+});
+
+test('oneLine / truncate:压成单行并截断，摘要里绝不能出换行', () => {
+  assert.equal(oneLine('  a\n\n b  '), 'a b');
+  assert.equal(oneLine(null), '');
+  const long = 'x'.repeat(MAX_SUMMARY_CHARS + 50);
+  const cut = truncate(long);
+  assert.equal(cut.length, MAX_SUMMARY_CHARS);
+  assert.ok(cut.endsWith('…'));
+  assert.equal(truncate('短'), '短');
+});
+
+test('renderSectionFile:文件头必须写采集时间、"这是快照"、以及该块怎么查实时值', () => {
+  const text = renderSectionFile({
+    id: 'git',
+    title: '当前项目 Git 状态',
+    generatedAt: '2026-09-28 10:15:32',
+    scope: '当前项目 D:/ws/x',
+    lines: ['- 分支: main'],
+  });
+  assert.match(text, /^# 当前项目 Git 状态/);
+  assert.match(text, /采集时间: 2026-09-28 10:15:32/);
+  assert.match(text, /快照/);
+  assert.match(text, /要实时值: .*git status --porcelain/);
+  assert.match(text, /- 分支: main/);
+  assert.match(text, /覆盖范围: 当前项目 D:\/ws\/x/);
+});
+
+test('renderSectionFile:取数失败也要落盘并写明原因，不能只留一片空白', () => {
+  const text = renderSectionFile({
+    id: 'github',
+    title: 'GitHub 仓库',
+    generatedAt: '2026-09-28 10:15:32',
+    error: 'gh CLI 未安装',
+  });
+  assert.match(text, /取数失败: gh CLI 未安装/);
+  assert.match(text, /不要据此推断/);
+});
+
+test('buildContextBlock:摘要内联、正文不进 —— 这是整个设计最关键的一条', () => {
+  const block = buildContextBlock({
+    generatedAt: '2026-09-28 10:15:32',
+    dirPath: 'C:/Users/x/.zen-gitsync/ai-context',
+    results: [
+      okResult({ lines: ['- BODY_MARKER_SHOULD_NOT_APPEAR'] }),
+      okResult({ id: 'system', title: '系统状态', file: 'system.md', summary: 'CPU 7.7% · 内存 62.3%', lines: ['- BODY_MARKER_SHOULD_NOT_APPEAR'] }),
+    ],
+  });
+  assert.ok(block.includes('分支 main，工作区干净'), '摘要必须在');
+  assert.ok(block.includes('git-current.md'), '文件名必须在（模型据此去读）');
+  assert.ok(block.includes('C:/Users/x/.zen-gitsync/ai-context'), '目录必须在');
+  assert.ok(!block.includes('BODY_MARKER_SHOULD_NOT_APPEAR'), '正文一行都不许进来');
+  assert.match(block, /不要回答"我看不到/);
+});
+
+test('buildContextBlock:每个板块带各自的采集时间（各块独立刷新，共用一个时间就是撒谎）', () => {
+  const block = buildContextBlock({
+    generatedAt: '2026-09-28 10:15:32',
+    dirPath: '/tmp/x',
+    results: [
+      okResult({ collectedAt: '2026-09-28 10:15:30' }),
+      okResult({ id: 'github', title: 'GitHub 仓库', file: 'remote-github.md', summary: '65 个仓库', collectedAt: '2026-09-28 10:05:00' }),
+    ],
+  });
+  assert.match(block, /采集于 2026-09-28 10:15:30/);
+  assert.match(block, /采集于 2026-09-28 10:05:00/);
+});
+
+test('joinSnapshotPath:按目录自身的分隔符风格拼接（单测跨平台稳定）', () => {
+  assert.equal(joinSnapshotPath('C:\\Users\\x\\ai-context', 'git-current.md'), 'C:\\Users\\x\\ai-context\\git-current.md');
+  assert.equal(joinSnapshotPath('/home/x/ai-context', 'git-current.md'), '/home/x/ai-context/git-current.md');
+  assert.equal(joinSnapshotPath('/home/x/ai-context/', 'git-current.md'), '/home/x/ai-context/git-current.md', '尾部斜杠不许重复');
+  assert.equal(joinSnapshotPath('', 'git-current.md'), 'git-current.md', '没目录时退化成裸文件名');
+});
+
+test('buildContextBlock:表头要给出"目录 + 文件名"的绝对路径示例', () => {
+  // 为什么钉这条:摘要行里只有裸文件名,模型要自己拼目录。它有一半概率拿 cwd 当基准
+  // 拼成 <项目目录>/git-current.md,读不到,然后回一句"我看不到" —— 而这正是整个块
+  // 结尾反复叮嘱不要出现的结果。给全示例就没有这层推断。
+  const block = buildContextBlock({
+    generatedAt: 'x',
+    dirPath: 'C:\\Users\\x\\.zen-gitsync\\ai-context',
+    results: [okResult()],
+  });
+  assert.match(block, /完整路径例：C:\\Users\\x\\.zen-gitsync\\ai-context\\git-current\.md/);
+});
+
+test('buildContextBlock:冷启动没有摘要行时不该出现半截的表头', () => {
+  const block = buildContextBlock({ dirPath: '/tmp/x', results: [] });
+  assert.ok(!block.includes('完整路径例'), '没有摘要就不该留下孤零零的路径示例');
+});
+
+test('buildContextBlock:冷启动（一份快照都没有）时仍要给出实时查询方法', () => {
+  const block = buildContextBlock({
+    dirPath: 'C:/Users/x/.zen-gitsync/ai-context',
+    results: [],
+  });
+  assert.ok(block.length > 0, '空快照不等于空块 —— 实时查询方法必须还在');
+  assert.match(block, /要查实时值就照下面来/);
+  assert.match(block, /gh repo list/);
+  assert.match(block, /gitee auth status --json/);
+  assert.match(block, /git status --porcelain/);
+  assert.match(block, /本轮快照还没生成好/);
+  assert.match(block, /C:\/Users\/x\/\.zen-gitsync\/ai-context/);
+});
+
+test('buildContextBlock:摘要再长也不许把实时查询方法挤掉', () => {
+  const results = Array.from({ length: 40 }, (_, i) => okResult({
+    id: `s${i}`, title: `板块${i}`, file: `s${i}.md`, summary: '很长的摘要'.repeat(80),
+  }));
+  const block = buildContextBlock({ generatedAt: 'x', dirPath: '/tmp', results });
+  assert.ok(block.length <= MAX_CONTEXT_BLOCK_CHARS, `块长 ${block.length} 超过上限`);
+  assert.match(block, /要查实时值就照下面来/, '查询方法那一段永远不能被切掉');
+  assert.match(block, /gh repo list/);
+  assert.match(block, /不要回答"我看不到/, '收尾的约束也不能被切掉');
+});
+
+test('buildContextBlock:真相源文件路径要报给模型', () => {
+  const block = buildContextBlock({
+    generatedAt: 'x',
+    dirPath: '/tmp/x',
+    results: [okResult()],
+    truthFiles: {
+      tasksFile: 'C:/u/.zen-gitsync/tasks.json',
+      jobsFile: 'C:/u/.zen-gitsync/jobs.json',
+      // 编排台指令流水：与 envContext（派发任务时的运行环境块）报同一份清单。
+      // 两个页面各自承认哪些文件存在不该有差别，所以这里也钉一条。
+      orchestratorFile: 'C:/u/.zen-gitsync/orchestrator.json',
+      configFile: 'C:/u/.zen-gitsync/config.json',
+    },
+  });
+  assert.match(block, /tasks\.json/);
+  assert.match(block, /jobs\.json/);
+  assert.match(block, /orchestrator\.json/);
+  assert.match(block, /config\.json/);
+  assert.match(block, /真相源文件/);
+});
+
+test('buildContextBlock:truthFiles 缺哪条就少哪行（不写空路径）', () => {
+  const block = buildContextBlock({
+    generatedAt: 'x',
+    dirPath: '/tmp/x',
+    results: [okResult()],
+    truthFiles: { tasksFile: 'C:/u/.zen-gitsync/tasks.json', orchestratorFile: '', configFile: '' },
+  });
+  assert.match(block, /tasks\.json/);
+  assert.doesNotMatch(block, /- C:\/u\/\.zen-gitsync\/ ——/);
+  assert.doesNotMatch(block, /undefined/);
+});
+
+test('buildContextBlock:失败的板块要写成"暂时取不到"而不是留空', () => {
+  const block = buildContextBlock({
+    generatedAt: '2026-09-28 10:15:32',
+    dirPath: '/tmp/x',
+    results: [okResult({ id: 'gitee', title: 'Gitee 仓库', file: 'remote-gitee.md', ok: false, error: '未检测到 gitee CLI' })],
+  });
+  assert.match(block, /暂时取不到: 未检测到 gitee CLI/);
+});
+
+test('buildContextBlock:英文 locale 用英文说明（文件正文仍为中文）', () => {
+  const block = buildContextBlock({
+    generatedAt: '2026-09-28 10:15:32',
+    dirPath: '/tmp/x',
+    locale: 'en',
+    results: [okResult()],
+  });
+  assert.match(block, /Workspace state/);
+  assert.match(block, /How to get LIVE values/);
+  assert.match(block, /SNAPSHOT, not live/);
+  assert.match(block, /Section summaries/);
+});
+
+test('renderIndexFile:列出每个板块并标明采集时间与失败项', () => {
+  const text = renderIndexFile({
+    generatedAt: '2026-09-28 10:20:00',
+    results: [
+      okResult(),
+      okResult({ id: 'gitee', title: 'Gitee 仓库', file: 'remote-gitee.md', ok: false, error: '未登录', collectedAt: '2026-09-28 10:05:00' }),
+    ],
+  });
+  assert.match(text, /- \[2026-09-28 10:15:32\] 当前项目 Git 状态（git-current.md）: 分支 main/);
+  assert.match(text, /- \[2026-09-28 10:05:00\] Gitee 仓库（remote-gitee.md）: 取数失败: 未登录/);
+  // 实时查询方法一节只列**这份 INDEX 里实际有的**板块（这里只有 git / gitee）
+  assert.match(text, /## 实时查询方法/);
+  assert.match(text, /git status --porcelain/);
+  assert.match(text, /gitee auth status --json/);
+  assert.ok(!text.includes('gh repo list'), '没采集到的板块不该出现在 INDEX 里');
+});
+
+test('formatStamp:补零到秒，模型靠它判断新旧', () => {
+  assert.equal(formatStamp(new Date(2026, 8, 28, 9, 5, 3)), '2026-09-28 09:05:03');
+});

package/src/ui/server/routes/aiContext/wiring.js

@@ -0,0 +1,80 @@
+// 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.
+//
+// 生产环境的接线:把真实的取数实现装配进 createAiContextSnapshotter。
+//
+// 单独一个文件的原因(与 collectors.js 的分层对应):index.js 与 collectors.js
+// 保持"零重量级 import",单测只碰纯函数;**只有这里**才 import 那些带着副作用或
+// 拉子进程的模块。这样"这个快照会不会在 import 时就写用户数据"这个问题,看一个
+// 文件就能回答。
+//
+// 两个刻意的取舍:
+//
+// 1) 所有取数都**复用已有实现**,不新写第二份:
+//    · git 状态 → directoryGitState.probeDirectoryGitState(自带 15s TTL 缓存)
+//    · 远程仓库 → remoteRepos.loadRemoteReposState(与界面同一份装了/登录了判断)
+//    · 系统状态 → monitor.getSystemOverview / listPorts(与监控页同源)
+//    · 思维导图 → mindmap.listMindmapFiles(与列表页同源)
+//    否则快照里的数字和界面上的对不上,用户第一个就会问为什么。
+//
+// 2) jobStore **动态 import**,不放在顶层:
+//    jobStore.js 在模块加载时就会 hydrateJobs() 并回写 ~/.zen-gitsync/jobs.json
+//    (见 promptParts.js 头注释对这件事的处理)。顶层 import 会让"谁 import 了
+//    aiContext 就在加载期写盘"变成隐性副作用;放到真正要读执行记录的那一刻,
+//    副作用就落在"确实有一轮对话在跑"这个前提下,边界清楚。
+
+import { createAiContextSnapshotter } from './index.js';
+import { readJson, TASKS_FILE, TRUTH_FILES } from '../workbench/shared.js';
+import { probeDirectoryGitState } from '../../utils/directoryGitState.js';
+import { loadRemoteReposState } from '../remoteRepos.js';
+import { getSystemOverview, listPorts } from '../monitor.js';
+import { listMindmapFiles } from '../mindmap.js';
+
+/** tasks.json 里的任务数组(容错:文件损坏/不存在时回空数组,由 collector 的计数体现) */
+async function readTasks() {
+  const data = await readJson(TASKS_FILE, { tasks: [] });
+  return Array.isArray(data?.tasks) ? data.tasks : [];
+}
+
+/** 执行记录:先刷一遍磁盘,避免 Agent 看到的是本进程启动那一刻的旧状态 */
+async function readJobs() {
+  const { refreshJobsFromDisk, snapshotJobs } = await import('../workbench/jobStore.js');
+  await refreshJobsFromDisk();
+  return snapshotJobs();
+}
+
+/**
+ * 建一个面向生产的快照生成器。
+ * @param {object} deps
+ * @param {object} deps.configManager
+ * @param {Function} deps.getCurrentProjectPath
+ */
+export function createWorkspaceSnapshotter({ configManager, getCurrentProjectPath } = {}) {
+  return createAiContextSnapshotter({
+    configManager,
+    getCurrentProjectPath,
+    readTasks,
+    readJobs,
+    probeGit: (dir) => probeDirectoryGitState(dir),
+    loadRemoteReposState: (provider) => loadRemoteReposState(provider),
+    getMonitorOverview: () => getSystemOverview(),
+    // 只取监听端口:快照里列全量 ESTABLISHED 连接会把文件撑爆且毫无信息量
+    listPorts: () => listPorts({ all: false }),
+    listMindmapFiles: (dir) => listMindmapFiles(dir),
+    // 真相源路径:注入块里直接报给模型,它就能自己 read_file 拿全文,
+    // 不必再多一轮"我看看有哪些文件"。清单只有一份 —— 见 workbench/shared.js
+    // 的 TRUTH_FILES:envContext（编排台视角）用的是同一个常量,不会再加一处漏一处。
+    truthFiles: TRUTH_FILES,
+  });
+}

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

@@ -996,4 +996,47 @@ export function registerFsRoutes({
       res.status(status).json({ success: false, error: error.message });
     }
   });
+
+  // ── 编辑器：用系统浏览器打开文件(HTML)──────────────────────
+  // 和上面的 VSCode 路线分工不同:HTML 的诉求是"看渲染结果",必须落到浏览器。
+  // 不能图省事用 open(resolved) 走系统默认程序 —— .html 的默认关联完全可能
+  // 是编辑器(装过 VSCode / 各种 IDE 后很常见),那样右键"用浏览器打开"就名不
+  // 副实,还难排查。
+  //
+  // open 的 app: 'browser' 会先用 default-browser 解析系统默认浏览器(Windows
+  // 读注册表 UserChoice、macOS 走 LaunchServices、Linux 走 xdg),再用它打开:
+  //   - 命中 chrome / edge / firefox / brave 之一 → 直接在默认浏览器里开
+  //   - 默认浏览器不在 open 的已知清单里        → open 抛错,退化为系统默认程序,
+  //     至少不会静默失败(比"报错但什么都没发生"体验好)
+  // 传文件路径而不是 http URL:file:// 下同目录的相对资源(样式 / 图片)能正常解析,
+  // 不需要把整个工作目录再挂一个静态服务出去。
+  app.post('/api/editor/open-in-browser', express.json(), async (req, res) => {
+    try {
+      const targetPath = req.body?.path;
+      if (!targetPath) throw new HttpError(400, '缺少 path 参数');
+
+      const safe = await safePathInProject(targetPath);
+      if (!safe) throw new HttpError(403, '禁止访问工作目录以外的内容');
+      const resolved = safe.safePath;
+
+      try {
+        await fs.access(resolved);
+      } catch {
+        throw new HttpError(404, '目标不存在');
+      }
+      const stat = await fs.stat(resolved);
+      if (stat.isDirectory()) throw new HttpError(400, '只能对文件用浏览器打开');
+
+      try {
+        await open(resolved, { app: 'browser', wait: false });
+      } catch {
+        await open(resolved, { wait: false });
+      }
+
+      res.json({ success: true });
+    } catch (error) {
+      const status = error?.status || 500;
+      res.status(status).json({ success: false, error: error.message });
+    }
+  });
 }

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

@@ -96,6 +96,41 @@ function isInside(childResolved, dirResolved) {
   return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel)
 }
 
+/**
+ * 列出某个目录下的思维导图文件（按修改时间倒序）。
+ *
+ * 抽成导出函数是为了给 aiContext 的「思维导图」快照复用 —— 快照里数出来的文件
+ * 必须和界面列表是同一批、同一排序，所以两边共用这一份实现，不做第二遍 readdir。
+ * 校验 / 抛错（目录不存在、不是目录）仍留在路由层，这里只做"已知是个目录"之后的活。
+ */
+export async function listMindmapFiles(dir) {
+  const entries = await fs.readdir(dir, { withFileTypes: true })
+  const files = []
+  for (const e of entries) {
+    // 只收 .mindmap.json 文件，跳过目录/隐藏文件
+    if (!e.isFile()) continue
+    if (e.name.startsWith('.')) continue
+    if (!e.name.toLowerCase().endsWith(MINDMAP_EXT)) continue
+    const fullPath = path.join(dir, e.name)
+    try {
+      const st = await fs.stat(fullPath)
+      files.push({
+        name: e.name,
+        path: fullPath,
+        size: st.size,
+        mtime: st.mtimeMs,
+        // 展示用名（去掉扩展名）
+        title: e.name.slice(0, -MINDMAP_EXT.length)
+      })
+    } catch {
+      // stat 失败的条目跳过，不阻塞整个列表
+    }
+  }
+  // 按修改时间倒序（最新在上）
+  files.sort((a, b) => b.mtime - a.mtime)
+  return files
+}
+
 export function registerMindmapRoutes({ app }) {
   // ── 列出目录下的思维导图文件 ──────────────────────────────────────
   app.get(
@@ -113,30 +148,7 @@ export function registerMindmapRoutes({ app }) {
       }
       if (!stat.isDirectory()) throw new HttpError(400, '目标不是目录')
 
-      const entries = await fs.readdir(dir, { withFileTypes: true })
-      const files = []
-      for (const e of entries) {
-        // 只收 .mindmap.json 文件，跳过目录/隐藏文件
-        if (!e.isFile()) continue
-        if (e.name.startsWith('.')) continue
-        if (!e.name.toLowerCase().endsWith(MINDMAP_EXT)) continue
-        const fullPath = path.join(dir, e.name)
-        try {
-          const st = await fs.stat(fullPath)
-          files.push({
-            name: e.name,
-            path: fullPath,
-            size: st.size,
-            mtime: st.mtimeMs,
-            // 展示用名（去掉扩展名）
-            title: e.name.slice(0, -MINDMAP_EXT.length)
-          })
-        } catch {
-          // stat 失败的条目跳过，不阻塞整个列表
-        }
-      }
-      // 按修改时间倒序（最新在上）
-      files.sort((a, b) => b.mtime - a.mtime)
+      const files = await listMindmapFiles(dir)
       res.json({ success: true, dir, files })
     })
   )

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

@@ -46,7 +46,9 @@ function sampleCpu() {
   return { total, idle }
 }
 
-async function getCpuUsage(sampleDelayMs = 100) {
+// 导出给 aiContext 的「系统状态」快照复用 —— 快照里的 CPU/内存/磁盘/端口
+// 必须与监控页看到的是同一份实现,否则两处数字对不上,用户第一个就会问为什么。
+export async function getCpuUsage(sampleDelayMs = 100) {
   const a = sampleCpu()
   await new Promise((r) => setTimeout(r, sampleDelayMs))
   const b = sampleCpu()
@@ -122,7 +124,7 @@ async function getDiskUsageUnix() {
   ]
 }
 
-async function getDiskUsage() {
+export async function getDiskUsage() {
   const now = Date.now()
   if (_diskCache && now - _diskCacheTime < DISK_CACHE_TTL_MS) {
     return _diskCache
@@ -144,8 +146,46 @@ async function getDiskUsage() {
   return result
 }
 
+/**
+ * 系统概览的完整组装（CPU + 内存 + 磁盘 + 系统信息）。
+ *
+ * 抽成导出函数是为了让 aiContext 的「系统状态」快照复用同一份 —— 快照里的数字
+ * 必须和监控页一致，两处各拼一遍迟早一个改了另一个没改。
+ * 磁盘查询失败降级为 disks: null，不拖垮整个概览。
+ */
+export async function getSystemOverview() {
+  const cpu = await getCpuUsage(100)
+  const totalMem = os.totalmem()
+  const freeMem = os.freemem()
+  const usedMem = totalMem - freeMem
+  let disks = null
+  try {
+    disks = await getDiskUsage()
+  } catch (e) {
+    logger.warn(`[monitor] 获取磁盘占用失败: ${e?.message || e}`)
+  }
+  return {
+    cpu,
+    memory: {
+      total: totalMem,
+      free: freeMem,
+      used: usedMem,
+      usagePercent: totalMem > 0 ? (usedMem / totalMem) * 100 : 0
+    },
+    disks,
+    system: {
+      platform: process.platform,
+      arch: process.arch,
+      hostname: os.hostname(),
+      uptime: os.uptime(),
+      nodeVersion: process.version
+    },
+    timestamp: Date.now()
+  }
+}
+
 // ── 端口列表 ────────────────────────────────────────────────────────────
-async function listPorts({ all = false } = {}) {
+export async function listPorts({ all = false } = {}) {
   if (process.platform === 'win32') {
     return listPortsWindows({ all })
   }
@@ -372,38 +412,7 @@ export function registerMonitorRoutes({ app }) {
   app.get(
     '/api/monitor/system',
     asyncRoute(async (req, res) => {
-      const cpu = await getCpuUsage(100)
-      const totalMem = os.totalmem()
-      const freeMem = os.freemem()
-      const usedMem = totalMem - freeMem
-      // 磁盘查询失败不应拖垮整个概览接口，降级为 disks: null
-      let disks = null
-      try {
-        disks = await getDiskUsage()
-      } catch (e) {
-        logger.warn(`[monitor] 获取磁盘占用失败: ${e?.message || e}`)
-      }
-      res.json({
-        success: true,
-        data: {
-          cpu,
-          memory: {
-            total: totalMem,
-            free: freeMem,
-            used: usedMem,
-            usagePercent: totalMem > 0 ? (usedMem / totalMem) * 100 : 0
-          },
-          disks,
-          system: {
-            platform: process.platform,
-            arch: process.arch,
-            hostname: os.hostname(),
-            uptime: os.uptime(),
-            nodeVersion: process.version
-          },
-          timestamp: Date.now()
-        }
-      })
+      res.json({ success: true, data: await getSystemOverview() })
     })
   )
 

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

@@ -557,6 +557,58 @@ async function listRepos(provider, executable) {
   return { repos: all, error: null, truncated };
 }
 
+/**
+ * 完整探测一个平台的状态:装没装 → 登没登录 → 拉仓库列表。
+ *
+ * 抽成导出函数,让**两条链路共用同一份判断**:HTTP 路由(界面)与
+ * aiContext 的「GitHub / Gitee 仓库」快照(喂给模型)。这份判断里全是踩过的坑
+ * (gitee 未登录退出码仍是 0、CLI 可能不在 PATH、超时只回空列表不抛),抄成第二份
+ * 迟早分叉 —— 而分叉的表现是"界面说未登录、模型说你有 65 个仓库"。
+ *
+ * 永远不抛:四种状态(未装 / 未登录 / 已登录 / 拉取失败)都是**正常状态**,
+ * 由调用方决定怎么呈现。
+ *
+ * @param {'github'|'gitee'} provider
+ * @param {object} [impls] 只为测试留的注入口
+ * @returns {Promise<{installed:boolean, version:string|null, authenticated:boolean, user:string|null,
+ *                    repos:object[], truncated:boolean, error:string|null}>}
+ */
+export async function loadRemoteReposState(provider, {
+  resolveCliImpl = resolveCli,
+  detectCliImpl = detectCli,
+  listReposImpl = listRepos,
+} = {}) {
+  const cli = PROVIDERS[provider]?.cli || provider;
+
+  const resolved = await resolveCliImpl(provider);
+  if (!resolved) {
+    return { installed: false, version: null, authenticated: false, user: null, repos: [], truncated: false, error: null };
+  }
+
+  let detected;
+  try {
+    detected = await detectCliImpl(provider, resolved.executable, resolved.version);
+  } catch (error) {
+    logger.info(`[remote-repos] ${provider} 检测失败: ${error.message}`);
+    return {
+      installed: true,
+      version: resolved.version,
+      authenticated: false,
+      user: null,
+      repos: [],
+      truncated: false,
+      error: `检测 ${cli} 状态失败: ${error.message}`,
+    };
+  }
+
+  if (!detected.authenticated) {
+    return { ...detected, repos: [], truncated: false, error: null };
+  }
+
+  const { repos, error, truncated } = await listReposImpl(provider, resolved.executable);
+  return { ...detected, repos, truncated: !!truncated, error: error || null };
+}
+
 // ── 路由 ────────────────────────────────────────────────────────────────────
 
 /**
@@ -603,55 +655,12 @@ export function registerRemoteReposRoutes({
       installer: installer ? publicInstallerInfo({ [config.toolId]: installer })[config.toolId] : null,
     };
 
-    const resolved = await resolveCliImpl(provider);
-    if (!resolved) {
-      return res.json({
-        ...base,
-        installed: false,
-        version: null,
-        authenticated: false,
-        user: null,
-        repos: [],
-        truncated: false,
-        error: null,
-      });
-    }
-
-    let detected;
-    try {
-      detected = await detectCliImpl(provider, resolved.executable, resolved.version);
-    } catch (error) {
-      logger.info(`[remote-repos] ${provider} 检测失败: ${error.message}`);
-      return res.json({
-        ...base,
-        installed: true,
-        version: resolved.version,
-        authenticated: false,
-        user: null,
-        repos: [],
-        truncated: false,
-        error: `检测 ${config.cli} 状态失败: ${error.message}`,
-      });
-    }
-
-    if (!detected.authenticated) {
-      return res.json({
-        ...base,
-        ...detected,
-        repos: [],
-        truncated: false,
-        error: null,
-      });
-    }
-
-    const { repos, error, truncated } = await listReposImpl(provider, resolved.executable);
-    res.json({
-      ...base,
-      ...detected,
-      repos,
-      truncated: !!truncated,
-      error: error || null,
+    const state = await loadRemoteReposState(provider, {
+      resolveCliImpl,
+      detectCliImpl,
+      listReposImpl,
     });
+    res.json({ ...base, ...state });
   }));
 
   /**