@qqq123456789/codex-doctor 0.2.0

package/tool/ops.mjs

@@ -0,0 +1,179 @@
+// ops：备份/恢复、auth 重置、版本追踪、归档管理、更新检查
+import fs from 'node:fs';
+import path from 'node:path';
+import { BACKUP_DIR, CODEX_DIR, ensureDir, exists, timestamp, confirm, dirBytes } from './util.mjs';
+
+const CRITICAL_FILES = ['config.toml', 'auth.json'];
+
+export function backupConfig(out) {
+  if (!exists(CODEX_DIR)) return { ok: false, lines: ['~/.codex 不存在，无需备份'] };
+  const dir = out ? path.resolve(out) : path.join(BACKUP_DIR, timestamp());
+  ensureDir(dir);
+  const copied = [];
+  for (const name of CRITICAL_FILES) {
+    const src = path.join(CODEX_DIR, name);
+    if (exists(src)) {
+      fs.copyFileSync(src, path.join(dir, name));
+      copied.push(name);
+    }
+  }
+  const lines = [];
+  if (copied.length === 0) {
+    lines.push('~/.codex 里没有 config.toml / auth.json 可备份');
+    return { ok: false, lines };
+  }
+  lines.push(`已备份 ${copied.join(', ')} → ${dir}`);
+  if (copied.includes('auth.json')) {
+    lines.push('注意：auth.json 等同密码——备份目录请勿提交仓库或上传网盘明文。');
+  }
+  return { ok: true, lines, dir };
+}
+
+export function restoreBackup(dir) {
+  const src = path.resolve(String(dir || ''));
+  if (!exists(src)) return { ok: false, lines: [`备份目录不存在: ${src}`] };
+  const lines = [];
+  const restored = [];
+  for (const name of CRITICAL_FILES) {
+    const from = path.join(src, name);
+    if (exists(from)) {
+      fs.copyFileSync(from, path.join(CODEX_DIR, name));
+      restored.push(name);
+    }
+  }
+  if (restored.length === 0) {
+    return { ok: false, lines: [`目录里没有可恢复的文件（需要 ${CRITICAL_FILES.join(' / ')}）: ${src}`] };
+  }
+  lines.push(`已恢复 ${restored.join(', ')} → ${CODEX_DIR}`);
+  if (restored.includes('auth.json')) {
+    lines.push('若凭据较旧导致 401，重新 codex login 一次即可。');
+  }
+  return { ok: true, lines };
+}
+
+export async function resetAuth(yes) {
+  const auth = path.join(CODEX_DIR, 'auth.json');
+  if (!exists(auth)) {
+    return { lines: ['auth.json 不存在，无需重置——直接运行 codex login 即可'] };
+  }
+  if (!yes) {
+    const go = await confirm('将备份并删除 auth.json（之后需要重新 codex login），继续？');
+    if (!go) return { lines: ['已取消'] };
+  }
+  const dir = path.join(BACKUP_DIR, timestamp());
+  ensureDir(dir);
+  fs.copyFileSync(auth, path.join(dir, 'auth.json'));
+  fs.rmSync(auth);
+  return {
+    lines: [
+      `已备份并删除 auth.json（备份在 ${dir}）`,
+      '下一步：运行 codex login 重新登录（401 排障详见 docs/02-login-auth.md）',
+    ],
+  };
+}
+
+export async function listVersions(limit = 10) {
+  const headers = { Accept: 'application/vnd.github+json', 'User-Agent': 'codex-doctor-cli' };
+  if (process.env.GH_TOKEN) headers.Authorization = `Bearer ${process.env.GH_TOKEN}`;
+  const n = Math.min(Math.max(Number(limit) || 10, 1), 50);
+  const res = await fetch(`https://api.github.com/repos/openai/codex/releases?per_page=${n}`, { headers });
+  if (!res.ok) throw new Error(`GitHub API HTTP ${res.status}`);
+  const releases = (await res.json()).filter((r) => !r.draft);
+  return releases.slice(0, n).map((r) => ({
+    tag: r.tag_name,
+    date: (r.published_at || '').slice(0, 10) || '—',
+    prerelease: r.prerelease === true,
+  }));
+}
+
+// ---------- 归档管理 ----------
+
+const ARCHIVE_ROOT = () => path.join(CODEX_DIR, 'archive');
+
+export function listArchives() {
+  const root = ARCHIVE_ROOT();
+  if (!exists(root)) return { items: [], lines: [`暂无归档目录（${root}）`] };
+  const items = [];
+  for (const name of fs.readdirSync(root)) {
+    const p = path.join(root, name);
+    if (!fs.statSync(p).isDirectory()) continue;
+    let files = 0;
+    (function w(x) {
+      for (const e of fs.readdirSync(x, { withFileTypes: true })) {
+        if (e.isDirectory()) w(path.join(x, e.name));
+        else files++;
+      }
+    })(p);
+    items.push({ name, bytes: dirBytes(p), files });
+  }
+  if (items.length === 0) return { items: [], lines: ['归档目录为空'] };
+  return { items, lines: [] };
+}
+
+export async function deleteArchive(name, { all = false, yes = false } = {}) {
+  const root = path.resolve(ARCHIVE_ROOT());
+  const targets = [];
+  if (all) {
+    if (!exists(root)) return { lines: ['暂无归档可删除'] };
+    for (const n of fs.readdirSync(root)) {
+      const p = path.join(root, n);
+      if (fs.statSync(p).isDirectory()) targets.push({ name: n, p, bytes: dirBytes(p) });
+    }
+  } else {
+    if (!name) return { bad: true, lines: ['用法: codex-doctor archive delete <名称|--all>'] };
+    const p = path.resolve(root, String(name));
+    // 防目录穿越：目标必须仍在 archive 根内
+    if (!p.toLowerCase().startsWith(root.toLowerCase() + path.sep) || !exists(p) || !fs.statSync(p).isDirectory()) {
+      return { bad: true, lines: [`归档不存在: ${name}`] };
+    }
+    targets.push({ name: path.basename(p), p, bytes: dirBytes(p) });
+  }
+  if (targets.length === 0) return { lines: ['归档目录为空，无需删除'] };
+
+  const totalMB = targets.reduce((s, t) => s + t.bytes, 0) / 1024 / 1024;
+  const summary = `将删除 ${targets.length} 个归档目录（共约 ${totalMB.toFixed(1)} MB）：${targets.map((t) => t.name).join(', ')}`;
+  if (!yes) {
+    const go = await confirm(`${summary}，继续？`);
+    if (!go) return { lines: ['已取消'] };
+  }
+  const lines = [];
+  for (const t of targets) {
+    fs.rmSync(t.p, { recursive: true, force: true });
+    lines.push(`已删除 ${t.name}`);
+  }
+  lines.push(`共释放约 ${totalMB.toFixed(1)} MB`);
+  return { lines };
+}
+
+// ---------- 更新检查 ----------
+
+function compareSemver(a, b) {
+  const pa = String(a).split('.').map(Number);
+  const pb = String(b).split('.').map(Number);
+  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;
+}
+
+export async function checkUpdate(currentVersion) {
+  const headers = { Accept: 'application/vnd.github+json', 'User-Agent': 'codex-doctor-cli' };
+  if (process.env.GH_TOKEN) headers.Authorization = `Bearer ${process.env.GH_TOKEN}`;
+  const res = await fetch('https://api.github.com/repos/qlw088697-ui/codex-troubleshooting/releases/latest', { headers });
+  if (!res.ok) throw new Error(`GitHub API HTTP ${res.status}`);
+  const r = await res.json();
+  const tag = r.tag_name || '';
+  const latest = tag.replace(/^v/, '');
+  const newer = latest ? compareSemver(currentVersion, latest) < 0 : false;
+  return {
+    lines: [
+      `当前工具版本: ${currentVersion}`,
+      `仓库最新发布: ${tag}（${(r.published_at || '').slice(0, 10)}）`,
+      newer
+        ? 'npx 直跑始终使用最新代码，无需操作；本地克隆请 git pull 后重跑。'
+        : '已是最新版本。',
+    ],
+  };
+}

package/tool/util.mjs

@@ -0,0 +1,55 @@
+// 共享工具：路径、文件系统辅助、确认交互（零依赖，Node 标准库）
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+export const HOME = os.homedir();
+export const CODEX_DIR = path.join(HOME, '.codex');
+export const BACKUP_DIR = path.join(HOME, '.codex-backups');
+
+export function exists(p) {
+  try {
+    fs.statSync(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function ensureDir(p) {
+  fs.mkdirSync(p, { recursive: true });
+}
+
+export function timestamp() {
+  return new Date().toISOString().replace(/[:T]/g, '-').slice(0, 19);
+}
+
+export function walkFiles(dir) {
+  const out = [];
+  if (!exists(dir)) return out;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, entry.name);
+    if (entry.isDirectory()) out.push(...walkFiles(p));
+    else if (entry.isFile()) out.push(p);
+  }
+  return out;
+}
+
+export function dirBytes(dir) {
+  return walkFiles(dir).reduce((s, f) => s + fs.statSync(f).size, 0);
+}
+
+// 破坏性操作的交互确认；非 TTY（如 CI）一律拒绝，必须显式 --yes
+export async function confirm(question) {
+  if (!process.stdin.isTTY) return false;
+  const rl = (await import('node:readline/promises')).createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  try {
+    const ans = (await rl.question(`${question} [y/N] `)).trim().toLowerCase();
+    return ans === 'y' || ans === 'yes';
+  } finally {
+    rl.close();
+  }
+}