mingdao-harness 0.1.54

package/src/update.js

@@ -0,0 +1,222 @@
+// 自更新模块（零运行时依赖：仅 node:child_process 调用 git）。
+// 安装形态：仓库 + 全局符号链接（mingdao 命令即指向 repo/src/cli.js，仓库更新 = 命令更新）。
+//   mingdao update          拉取最新远端 main → 跑冒烟测试 → 失败自动回滚
+//   mingdao update --check  只 fetch 对比版本，不改动工作区
+//   mingdao rollback        回滚到上次成功 update 之前的提交（~/.mingdao/update-state.json 记录）
+// npm 安装形态（无 .git）给出对应提示。
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { mingdaoHome, ensureHome } from './config.js';
+
+function git(args, cwd) {
+  const r = spawnSync('git', args, { cwd, encoding: 'utf8', timeout: 120000 });
+  return {
+    ok: r.status === 0 && !r.error,
+    out: String(r.stdout || '').trim(),
+    err: String(r.stderr || '').trim(),
+    error: r.error,
+  };
+}
+
+// 定位仓库根：全局安装 = 符号链接到仓库，realpath 拿到真实路径后向上找 .git
+export function findRepoRoot() {
+  try {
+    let dir = path.dirname(fs.realpathSync(process.argv[1] || fileURLToPath(import.meta.url)));
+    for (let i = 0; i < 12; i++) {
+      if (fs.existsSync(path.join(dir, '.git'))) return dir;
+      const parent = path.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+  } catch {}
+  return null;
+}
+
+function resolveRepo(override) {
+  return override || findRepoRoot();
+}
+
+function versionAt(repo, ref = 'HEAD') {
+  const r = git(['show', `${ref}:package.json`], repo);
+  if (!r.ok) return null;
+  try {
+    return JSON.parse(r.out).version || null;
+  } catch {
+    return null;
+  }
+}
+
+function compareVersions(a, b) {
+  const pa = String(a).split('.').map((n) => parseInt(n, 10) || 0);
+  const pb = String(b).split('.').map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    const x = pa[i] || 0;
+    const y = pb[i] || 0;
+    if (x !== y) return x > y ? 1 : -1;
+  }
+  return 0;
+}
+
+function stateFile() {
+  return path.join(mingdaoHome(), 'update-state.json');
+}
+function readState() {
+  try {
+    return JSON.parse(fs.readFileSync(stateFile(), 'utf8'));
+  } catch {
+    return null;
+  }
+}
+function writeState(s) {
+  ensureHome();
+  fs.writeFileSync(stateFile(), JSON.stringify(s, null, 2) + '\n', { mode: 0o600 });
+}
+
+// 直接向远端指定分支要版本（评估 D6）：fetch 到 FETCH_HEAD 再读 package.json，
+// 不依赖本地 refs 落盘——部分 Windows git 环境存在「fetch 成功但 refs 不更新」的异常，
+// 按本地 refs 判断会误报「已是最新」。ls-remote 思路的等价实现。
+function remoteVersion(repo, remote, branch) {
+  const r = git(['fetch', '--quiet', remote, branch], repo);
+  if (!r.ok) return null;
+  return versionAt(repo, 'FETCH_HEAD');
+}
+
+function listRemotes(repo) {
+  const r = git(['remote'], repo);
+  if (!r.ok) return [];
+  return r.out.split('\n').filter(Boolean);
+}
+
+// 各远端（main/master 任一存在）中版本号最大的（多镜像部署：github/gitee/gitcode 谁新跟谁）
+function newestRemote(repo) {
+  let latest = '';
+  let ref = '';
+  for (const remote of listRemotes(repo)) {
+    for (const branch of ['main', 'master']) {
+      const v = remoteVersion(repo, remote, branch);
+      if (v && compareVersions(v, latest) > 0) {
+        latest = v;
+        ref = `${remote}/${branch}`;
+      }
+    }
+  }
+  return { version: latest, ref };
+}
+
+const NPM_HINT =
+  '✖ 未找到 git 仓库（npm 或源码包安装形态）：npm 安装用 `npm update -g mingdao-harness`；' +
+  '源码包安装请重新运行安装脚本（install.sh）；或从任意平台仓库克隆后 `npm link`：' +
+  'https://gitee.com/MingDaoTCM/MingDao-harness · https://gitcode.com/MingDaoTCM/MingDao-Harness · https://github.com/MingDaoTCM/MingDao-Harness';
+
+export async function updateCheck({ repo } = {}) {
+  const lines = [];
+  const root = resolveRepo(repo);
+  if (!root) return { ok: false, lines: [NPM_HINT] };
+  const local = versionAt(root) || '未知';
+  const newest = newestRemote(root);
+  if (!newest.version) {
+    return { ok: false, lines: [`当前版本 v${local}`, '✖ 无法连接远端（git fetch 全部失败），请检查网络。'] };
+  }
+  if (compareVersions(newest.version, local) <= 0) {
+    return { ok: true, behind: false, lines: [`当前已是最新版本 v${local} ✓`, '（如需升级：mingdao update）'] };
+  }
+  return {
+    ok: true,
+    behind: true,
+    lines: [`当前版本 v${local}`, `发现新版本 v${newest.version}（${newest.ref}）`, '执行 mingdao update 一键升级（升级后自动跑冒烟测试，失败自动回滚）。'],
+  };
+}
+
+export async function mingdaoUpdate({ repo } = {}) {
+  const lines = [];
+  const root = resolveRepo(repo);
+  if (!root) return { ok: false, lines: [NPM_HINT] };
+  const local = versionAt(root) || '未知';
+  // 工作区必须干净：升级不动用户未提交的改动（--ff-only 也会因此拒绝）
+  const st = git(['status', '--porcelain'], root);
+  if (!st.ok) return { ok: false, lines: ['✖ git status 失败：' + (st.err || st.error?.message || '未知错误')] };
+  if (st.out) {
+    return {
+      ok: false,
+      lines: ['✖ 仓库有未提交改动，请先提交/暂存后再升级：', ...st.out.split('\n').slice(0, 5).map((l) => '  ' + l)],
+    };
+  }
+  const prev = git(['rev-parse', 'HEAD'], root);
+  if (!prev.ok) return { ok: false, lines: ['✖ 无法读取当前提交（git rev-parse HEAD）'] };
+  const newest = newestRemote(root);
+  if (!newest.version) return { ok: false, lines: ['✖ git fetch 失败：无法连接远端'] };
+  if (compareVersions(newest.version, local) <= 0) {
+    return { ok: true, lines: [`当前已是最新版本 v${local} ✓（远端最新 v${newest.version}）`] };
+  }
+  // 从版本号最新的远端快进拉取（远程名/分支：优先当前分支名，回落 main）
+  const remoteName = newest.ref.split('/')[0];
+  const curBranch = git(['rev-parse', '--abbrev-ref', 'HEAD'], root);
+  const branch = ['main', 'master'].includes(curBranch.out) ? curBranch.out : 'main';
+  const pull = git(['pull', '--ff-only', '--quiet', remoteName, branch], root);
+  if (!pull.ok) {
+    return {
+      ok: false,
+      lines: [`✖ 升级失败（git pull --ff-only ${remoteName} ${branch}）：${pull.err || '本地分支与远端分叉，请先手动处理'}`, '未改动任何文件。'],
+    };
+  }
+  const newVer = versionAt(root) || '未知';
+  // 升级后冒烟验证：失败自动回滚到升级前提交，绝不让坏版本常驻
+  const smoke = spawnSync(process.execPath, [path.join(root, 'test', 'smoke.js')], { cwd: root, encoding: 'utf8', timeout: 300000 });
+  // 审计 P2-9：spawn 失败（脚本缺失/进程崩溃）与测试非零区分——只有测试真实跑完且失败才回滚
+  if (smoke.error) {
+    return {
+      ok: false,
+      lines: [`✖ 升级已完成，但冒烟测试无法运行：${smoke.error?.message || smoke.error}`, `  已保持在 v${newVer}（未回滚，因为不是测试失败）。`],
+    };
+  }
+  if (smoke.status !== 0) {
+    git(['reset', '--hard', prev.out], root);
+    const tail = String(smoke.stdout || smoke.stderr || '')
+      .split('\n')
+      .filter(Boolean)
+      .slice(-3)
+      .join(' | ');
+    return {
+      ok: false,
+      lines: [
+        `✖ 升级后冒烟测试失败，已自动回滚到 ${prev.out.slice(0, 8)}（v${local}）。`,
+        '  失败信息：' + (tail || '（无输出）'),
+        '  当前仍是升级前的可用版本；请反馈该问题。',
+      ],
+    };
+  }
+  writeState({ prevSha: prev.out, prevVersion: local, at: Date.now() });
+  return {
+    ok: true,
+    lines: [`✓ 已从 v${local} 升级到 v${newVer}`, '✓ 冒烟测试通过；如遇问题可 mingdao rollback 回滚到升级前版本。'],
+  };
+}
+
+export function mingdaoRollback({ repo } = {}) {
+  const root = resolveRepo(repo);
+  if (!root) return { ok: false, lines: [NPM_HINT] };
+  const st = readState();
+  if (!st?.prevSha) {
+    return { ok: false, lines: ['✖ 没有可回滚的记录（只有成功 update 后才会写入回滚点）。'] };
+  }
+  const dirty = git(['status', '--porcelain'], root);
+  if (!dirty.ok) return { ok: false, lines: ['✖ git status 失败'] };
+  if (dirty.out) return { ok: false, lines: ['✖ 仓库有未提交改动，请先提交/暂存（回滚会覆盖工作区改动）。'] };
+  const cur = git(['rev-parse', 'HEAD'], root);
+  if (cur.ok && cur.out === st.prevSha) {
+    return { ok: false, lines: ['当前已在回滚目标提交上，无需回滚。'] };
+  }
+  const r = git(['reset', '--hard', st.prevSha], root);
+  if (!r.ok) return { ok: false, lines: ['✖ 回滚失败：' + (r.err || 'git reset --hard 出错')] };
+  const v = versionAt(root) || '未知';
+  try {
+    fs.unlinkSync(stateFile());
+  } catch {}
+  return {
+    ok: true,
+    lines: [`✓ 已回滚到 v${v}（${st.prevSha.slice(0, 8)}，即 v${st.prevVersion || v} 升级前的提交）`],
+  };
+}

package/src/web/attachments.js

@@ -0,0 +1,49 @@
+// 聊天附件构造（纯函数，便于测试）：
+//  - 图片：仅视觉模型支持（内置预设 supportsVision 或自定义模型 vision:true），
+//    转 data:image/...;base64 内联（JPEG/PNG/GIF/WebP，单张 ≤5MB，最多 4 个附件）
+//  - 文本文件：直接拼接进消息文本（≤200KB），并留文件名标注
+//  - 返回 { content（模型消息内容：字符串或图文数组）, persistText（落盘文本）, error }
+
+const MAX_IMAGE_DATAURL = 7 * 1024 * 1024; // base64 膨胀 1.33 倍，对应约 5MB 原图
+const MAX_TEXT = 200 * 1024;
+
+export function buildUserContent(message, attachments, visionSupported) {
+  const text = String(message ?? '').trim();
+  const list = Array.isArray(attachments) ? attachments.slice(0, 4) : [];
+  const imageParts = [];
+  const persistParts = [];
+  let finalText = text;
+  for (const a of list) {
+    if (!a || typeof a !== 'object') continue;
+    if (a.type === 'image') {
+      const dataUrl = String(a.dataUrl || '');
+      if (!/^data:image\/(png|jpeg|gif|webp);base64,/i.test(dataUrl)) {
+        return { error: `图片格式不支持：${a.name || '未命名'}（仅 JPEG/PNG/GIF/WebP）` };
+      }
+      if (dataUrl.length > MAX_IMAGE_DATAURL) {
+        return { error: `图片过大：${a.name || '未命名'}（单张 ≤5MB）` };
+      }
+      if (!visionSupported) {
+        return { error: '当前模型不支持图片输入（请切换到 deepseek-v4-flash-vision-exp 或支持视觉的自定义模型）' };
+      }
+      imageParts.push({ type: 'image_url', image_url: { url: dataUrl } });
+      persistParts.push(`[图片：${a.name || '未命名'}]`);
+    } else if (a.type === 'text') {
+      const content = String(a.content ?? '');
+      if (!content.trim()) continue;
+      if (content.length > MAX_TEXT) {
+        return { error: `文本文件过大：${a.name || '未命名'}（≤200KB）` };
+      }
+      finalText += `${finalText ? '\n\n' : ''}[文件 ${a.name || '未命名'}]\n${content}`;
+      persistParts.push(`[文件：${a.name || '未命名'}]`);
+    }
+  }
+  if (!finalText.trim() && !imageParts.length) {
+    return { error: '消息与附件不能同时为空' };
+  }
+  // 有图片 → 图文数组；纯文本 → 字符串（保持普通路径不变）
+  const content = imageParts.length
+    ? [...(finalText.trim() ? [{ type: 'text', text: finalText }] : []), ...imageParts]
+    : finalText;
+  return { content, persistText: `${finalText.trim()}${persistParts.length ? (finalText.trim() ? '\n' : '') + persistParts.join(' ') : ''}`.trim() };
+}