@qqq123456789/codex-doctor 0.7.0 → 0.9.0

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

@@ -32,6 +32,8 @@ node codex-troubleshooting/tool/cli.mjs --help
 | `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 |
 | `sessions [-n 10] [--dir keyword]` | Browse past sessions: time, workdir, source, first-prompt preview; `--dir` filters by directory — find "that conversation" | read-only |
+| `sessions --search keyword [--deep]` | Search sessions by keyword (first 256KB of each file by default, `--deep` scans fully) | read-only |
+| `sessions --show [--search keyword] [--pick N] [--full]` | Print a session's full transcript (latest by default; messages truncated to 400 chars unless `--full`) | read-only |
 | `update` | Check the latest npm version and how to update | read-only |
 
 ## Design principles

package/docs/13-codex-doctor.md

@@ -32,6 +32,8 @@ node codex-troubleshooting/tool/cli.mjs --help
 | `archive delete <名称\|--all>` | 删除归档（默认需交互确认，`--yes` 跳过） | 中（删除，需确认） |
 | `versions [-n 10]` | 查看 openai/codex 最近 N 个版本（含预发布标记） | 只读 |
 | `sessions [-n 10] [--dir 关键字]` | 浏览历史会话：时间、工作目录、来源、首条提问预览；`--dir` 按目录过滤，找回「上次那个对话」 | 只读 |
+| `sessions --search 关键词 [--deep]` | 按关键词搜索会话（默认搜每个文件开头 256KB，`--deep` 全文扫描） | 只读 |
+| `sessions --show [--search 关键词] [--pick N] [--full]` | 查看会话完整对话（默认最近一次；默认单条截断 400 字） | 只读 |
 | `update` | 查询 npm 上工具的最新版本与更新方式 | 只读 |
 
 ## 设计原则

package/package.json

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

package/tool/cli.mjs

@@ -3,11 +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, searchSessions } from './sessions.mjs';
+import { listSessions, searchSessions, readTranscript, exportTranscriptMarkdown } from './sessions.mjs';
 import { CODEX_DIR } from './util.mjs';
 import path from 'node:path';
 
-const VERSION = '0.7.0';
+const VERSION = '0.9.0';
 
 const HELP = `codex-doctor v${VERSION} — Codex CLI 维护与排障工具（零依赖）
 
@@ -29,6 +29,7 @@ const HELP = `codex-doctor v${VERSION} — Codex CLI 维护与排障工具（零
   versions [-n N]               查看 openai/codex 最近 N 个版本（默认 10）
   sessions [-n N] [--dir 关键字] 浏览历史会话：时间、目录、来源、首条提问预览
              [--search 关键词] [--deep] 按关键词搜索会话（--deep 全文扫描）
+             --show [--search 关键词] [--pick N] [--full] 查看会话完整对话
   update                        查询 npm 最新版本与更新方式
   help                          显示本帮助
 
@@ -48,6 +49,9 @@ function parseFlags(args) {
     else if (a === '--dir') flags.dir = args[++i];
     else if (a === '--search') flags.search = args[++i];
     else if (a === '--deep') flags.deep = true;
+    else if (a === '--show') flags.show = true;
+    else if (a === '--pick') flags.pick = Number(args[++i]);
+    else if (a === '--full') flags.full = true;
     else if (a === '--out') flags.out = args[++i];
     else rest.push(a);
   }
@@ -134,6 +138,41 @@ async function main() {
       break;
     }
     case 'sessions': {
+      if (flags.show) {
+        // 展示会话完整对话：默认最近一次；--search 按关键词定位；--pick N 选第 N 个命中
+        const items = flags.search
+          ? searchSessions({ keyword: flags.search, limit: 20, deep: true })
+          : listSessions({ limit: 20 });
+        if (items.length === 0) {
+          console.log(flags.search ? `没有找到包含「${flags.search}」的会话` : '~/.codex/sessions 里没有会话记录');
+          break;
+        }
+        const pick = Math.min(Math.max(Number(flags.pick) || 1, 1), items.length);
+        const item = items[pick - 1];
+        console.log(`== 会话 ${item.date} @ ${item.dirName} ==`);
+        console.log(`文件: ${item.file}\n`);
+        if (flags.out) {
+          // 导出为 Markdown 文件
+          const r = exportTranscriptMarkdown(item.file, flags.out, { maxLen: flags.full ? Infinity : 400 });
+          if (!r) {
+            console.log('（该会话没有可导出的对话消息）');
+            break;
+          }
+          console.log(`已导出 ${r.count} 条消息 → ${r.outFile}`);
+          break;
+        }
+        const transcript = readTranscript(item.file, { maxLen: flags.full ? Infinity : 400 });
+        if (!transcript || transcript.length === 0) {
+          console.log('（该会话没有可展示的对话消息）');
+          break;
+        }
+        for (const msg of transcript) {
+          const who = msg.role === 'user' ? '[用户]' : '[Codex]';
+          console.log(`${who} ${msg.text}\n`);
+        }
+        console.log(`（共 ${transcript.length} 条消息${flags.full ? '' : '，单条超 400 字已截断，--full 查看全文'}）`);
+        break;
+      }
       if (flags.search) {
         const items = searchSessions({
           keyword: flags.search,

package/tool/sessions.mjs

@@ -1,7 +1,7 @@
 // sessions：浏览 ~/.codex/sessions 下的历史会话（只读）
 import fs from 'node:fs';
 import path from 'node:path';
-import { CODEX_DIR, exists, walkFiles } from './util.mjs';
+import { CODEX_DIR, exists, walkFiles, ensureDir } from './util.mjs';
 
 // 只读每个文件头部 64KB：meta 在第 1 行，真实提问通常也在最前面
 function readHead(file, bytes = 65536) {
@@ -61,6 +61,7 @@ export function listSessions({ limit = 10, cwdFilter = null } = {}) {
       const { meta, preview } = extract(readHead(f));
       if (!meta) continue;
       items.push({
+        file: f,
         date: meta.date || st.mtime.toISOString().slice(0, 16).replace('T', ' '),
         dirName: meta.cwd ? path.basename(meta.cwd) : '?',
         cwd: meta.cwd,
@@ -117,6 +118,7 @@ export function searchSessions({ keyword, limit = 10, deep = false } = {}) {
 
     const { meta } = extract(content);
     results.push({
+      file: f,
       date: (meta?.date) || new Date(mtimeMs).toISOString().slice(0, 16).replace('T', ' '),
       dirName: meta?.cwd ? path.basename(meta.cwd) : '?',
       snippet: snippet || '(匹配在元数据中)',
@@ -126,3 +128,55 @@ export function searchSessions({ keyword, limit = 10, deep = false } = {}) {
   }
   return results;
 }
+
+// 读取单个会话的完整对话（user / assistant 消息，跳过环境包装与工具输出）
+export function readTranscript(file, { maxLen = 400 } = {}) {
+  if (!exists(file)) return null;
+  const content = fs.readFileSync(file, 'utf8');
+  const out = [];
+  for (const line of content.split('\n')) {
+    if (!line.trim()) continue;
+    let j;
+    try {
+      j = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (j.type !== 'response_item' || j.payload?.type !== 'message') continue;
+    const role = j.payload.role;
+    if (role !== 'user' && role !== 'assistant') continue;
+    let text = (j.payload.content || []).map((c) => c.text || '').filter(Boolean).join('\n');
+    if (!text) continue;
+    if (role === 'user' && (text.startsWith('<environment_context>') || text.startsWith('<user_instructions>'))) continue;
+    if (role === 'user' && text.startsWith('<permissions')) continue;
+    if (text.length > maxLen) text = text.slice(0, maxLen) + '…';
+    out.push({ role, text });
+  }
+  return out;
+}
+
+// 把会话导出为 Markdown 文件（找回的对话可存档分享）
+export function exportTranscriptMarkdown(file, outFile, { maxLen = 400 } = {}) {
+  if (!exists(file)) return null;
+  const content = fs.readFileSync(file, 'utf8');
+  const { meta } = extract(content);
+  const transcript = readTranscript(file, { maxLen });
+  if (!transcript || transcript.length === 0) return null;
+
+  const lines = ['# Codex 会话记录', ''];
+  lines.push(`- 时间：${meta?.date || '?'}`);
+  lines.push(`- 工作目录：${meta?.cwd || '?'}`);
+  lines.push(`- 来源：${meta?.originator || '?'}`);
+  lines.push(`- 导出自：${file}`);
+  lines.push('');
+  for (const msg of transcript) {
+    lines.push(`## ${msg.role === 'user' ? '用户' : 'Codex'}`);
+    lines.push('');
+    lines.push(msg.text);
+    lines.push('');
+  }
+  const dest = path.resolve(outFile);
+  ensureDir(path.dirname(dest));
+  fs.writeFileSync(dest, lines.join('\n'), 'utf8');
+  return { outFile: dest, count: transcript.length };
+}