@qqq123456789/codex-doctor 0.5.0 → 0.6.0

package/docs/13-codex-doctor.en.md

@@ -31,7 +31,8 @@ node codex-troubleshooting/tool/cli.mjs --help
 | `archive list` | List archive folders with sizes | read-only |
 | `archive delete <name\|--all>` | Delete archives (interactive confirm by default, `--yes` to skip) | medium (deletes, requires confirm) |
 | `versions [-n 10]` | List the latest openai/codex releases (prerelease flagged) | read-only |
-| `update` | Check the repo's latest release and how to update | read-only |
+| `sessions [-n 10] [--dir keyword]` | Browse past sessions: time, workdir, source, first-prompt preview; `--dir` filters by directory — find "that conversation" | read-only |
+| `update` | Check the latest npm version and how to update | read-only |
 
 ## Design principles
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qqq123456789/codex-doctor",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Codex CLI 维护与排障工具：环境自检、会话/日志归档、配置与凭据备份恢复、版本追踪（零依赖）",
   "keywords": [
     "codex",

package/tool/cli.mjs

@@ -3,8 +3,11 @@
 import { collectChecks, summarize, renderHuman } from './checks.mjs';
 import { cleanTarget } from './clean.mjs';
 import { backupConfig, restoreBackup, resetAuth, listVersions, listArchives, deleteArchive, checkUpdate } from './ops.mjs';
+import { listSessions } from './sessions.mjs';
+import { CODEX_DIR } from './util.mjs';
+import path from 'node:path';
 
-const VERSION = '0.5.0';
+const VERSION = '0.6.0';
 
 const HELP = `codex-doctor v${VERSION} — Codex CLI 维护与排障工具（零依赖）
 
@@ -24,7 +27,8 @@ const HELP = `codex-doctor v${VERSION} — Codex CLI 维护与排障工具（零
   archive list                  查看归档目录与体积
   archive delete <名称|--all>   删除归档（需 --yes 或交互确认）
   versions [-n N]               查看 openai/codex 最近 N 个版本（默认 10）
-  update                        查询仓库最新发布与更新方式
+  sessions [-n N] [--dir 关键字] 浏览历史会话：时间、目录、来源、首条提问预览
+  update                        查询 npm 最新版本与更新方式
   help                          显示本帮助
 
 全局: --yes 跳过交互确认（非 TTY 环境必须显式提供）。文档: docs/13-codex-doctor.md`;
@@ -40,6 +44,7 @@ function parseFlags(args) {
     else if (a === '--strict') flags.strict = true;
     else if (a === '--days') flags.days = Number(args[++i]);
     else if (a === '-n' || a === '--limit') flags.limit = Number(args[++i]);
+    else if (a === '--dir') flags.dir = args[++i];
     else if (a === '--out') flags.out = args[++i];
     else rest.push(a);
   }
@@ -125,6 +130,25 @@ async function main() {
       process.exitCode = 1;
       break;
     }
+    case 'sessions': {
+      const items = listSessions({
+        limit: Number.isFinite(flags.limit) ? flags.limit : 10,
+        cwdFilter: flags.dir || null,
+      });
+      if (items.length === 0) {
+        console.log(flags.dir ? `没有匹配「${flags.dir}」的会话记录` : '~/.codex/sessions 里没有会话记录');
+        break;
+      }
+      console.log('时间                工作目录              来源              首条提问');
+      for (const it of items) {
+        const origin = (it.originator || '?') + (it.subagent ? '(子代理)' : '');
+        console.log(
+          `${it.date.padEnd(18)} ${it.dirName.padEnd(20).slice(0, 20)} ${origin.padEnd(16).slice(0, 16)} ${it.preview || ''}`
+        );
+      }
+      console.log(`\n会话文件位于 ${path.join(CODEX_DIR, 'sessions')}（-n 条数 / --dir 按目录关键字过滤）`);
+      break;
+    }
     case 'update': {
       const r = await checkUpdate(VERSION);
       print(r.lines);

package/tool/sessions.mjs

@@ -0,0 +1,81 @@
+// sessions：浏览 ~/.codex/sessions 下的历史会话（只读）
+import fs from 'node:fs';
+import path from 'node:path';
+import { CODEX_DIR, exists, walkFiles } from './util.mjs';
+
+// 只读每个文件头部 64KB：meta 在第 1 行，真实提问通常也在最前面
+function readHead(file, bytes = 65536) {
+  const fd = fs.openSync(file, 'r');
+  try {
+    const buf = Buffer.alloc(bytes);
+    const n = fs.readSync(fd, buf, 0, bytes, 0);
+    return buf.subarray(0, n).toString('utf8');
+  } finally {
+    fs.closeSync(fd);
+  }
+}
+
+function extract(head) {
+  let meta = null;
+  let preview = null;
+  for (const line of head.split('\n')) {
+    if (!line.trim()) continue;
+    let j;
+    try {
+      j = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (!meta && j.type === 'session_meta' && j.payload) {
+      meta = {
+        date: (j.payload.timestamp || '').slice(0, 16).replace('T', ' '),
+        cwd: j.payload.cwd || '',
+        originator: j.payload.originator || '',
+        subagent: Boolean(j.payload.source?.subagent),
+      };
+    }
+    if (
+      j.type === 'response_item' &&
+      j.payload?.type === 'message' &&
+      j.payload?.role === 'user'
+    ) {
+      const text = (j.payload.content || []).find((c) => c.text)?.text || '';
+      // 跳过环境上下文/项目指令包装，找真实提问
+      if (!text.startsWith('<environment_context>') && !text.startsWith('<user_instructions>')) {
+        preview = text.replace(/\s+/g, ' ').trim().slice(0, 70);
+        break;
+      }
+    }
+  }
+  return { meta, preview };
+}
+
+export function listSessions({ limit = 10, cwdFilter = null } = {}) {
+  const root = path.join(CODEX_DIR, 'sessions');
+  if (!exists(root)) return [];
+  const items = [];
+  for (const f of walkFiles(root)) {
+    if (!f.endsWith('.jsonl')) continue;
+    try {
+      const st = fs.statSync(f);
+      const { meta, preview } = extract(readHead(f));
+      if (!meta) continue;
+      items.push({
+        date: meta.date || st.mtime.toISOString().slice(0, 16).replace('T', ' '),
+        dirName: meta.cwd ? path.basename(meta.cwd) : '?',
+        cwd: meta.cwd,
+        originator: meta.originator || '',
+        subagent: meta.subagent,
+        preview,
+        mtimeMs: st.mtimeMs,
+      });
+    } catch {
+      /* 单个文件损坏不影响整体列表 */
+    }
+  }
+  items.sort((a, b) => b.mtimeMs - a.mtimeMs);
+  const filtered = cwdFilter
+    ? items.filter((it) => it.cwd.toLowerCase().includes(String(cwdFilter).toLowerCase()))
+    : items;
+  return filtered.slice(0, Math.max(Number(limit) || 10, 1));
+}