@qqq123456789/codex-doctor 0.6.0 → 0.7.0

package/README.md

@@ -25,7 +25,13 @@ Codex CLI 迭代很快，社区里反复出现的问题高度集中：**登录
 
 ## 快速开始：先跑一次环境自检
 
-遇到任何异常，先跑自检脚本收集环境信息：
+最简单的方式（工具已发布 npm）：
+
+```bash
+npx -y @qqq123456789/codex-doctor
+```
+
+也可以用脚本方式（无需 Node）：
 
 ```powershell
 # Windows PowerShell

package/docs/13-codex-doctor.md

@@ -31,7 +31,8 @@ node codex-troubleshooting/tool/cli.mjs --help
 | `archive list` | 查看归档目录与体积 | 只读 |
 | `archive delete <名称\|--all>` | 删除归档（默认需交互确认，`--yes` 跳过） | 中（删除，需确认） |
 | `versions [-n 10]` | 查看 openai/codex 最近 N 个版本（含预发布标记） | 只读 |
-| `update` | 查询仓库最新发布与更新方式 | 只读 |
+| `sessions [-n 10] [--dir 关键字]` | 浏览历史会话：时间、工作目录、来源、首条提问预览；`--dir` 按目录过滤，找回「上次那个对话」 | 只读 |
+| `update` | 查询 npm 上工具的最新版本与更新方式 | 只读 |
 
 ## 设计原则
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qqq123456789/codex-doctor",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "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 } from './sessions.mjs';
+import { listSessions, searchSessions } from './sessions.mjs';
 import { CODEX_DIR } from './util.mjs';
 import path from 'node:path';
 
-const VERSION = '0.6.0';
+const VERSION = '0.7.0';
 
 const HELP = `codex-doctor v${VERSION} — Codex CLI 维护与排障工具（零依赖）
 
@@ -28,6 +28,7 @@ const HELP = `codex-doctor v${VERSION} — Codex CLI 维护与排障工具（零
   archive delete <名称|--all>   删除归档（需 --yes 或交互确认）
   versions [-n N]               查看 openai/codex 最近 N 个版本（默认 10）
   sessions [-n N] [--dir 关键字] 浏览历史会话：时间、目录、来源、首条提问预览
+             [--search 关键词] [--deep] 按关键词搜索会话（--deep 全文扫描）
   update                        查询 npm 最新版本与更新方式
   help                          显示本帮助
 
@@ -45,6 +46,8 @@ function parseFlags(args) {
     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 === '--search') flags.search = args[++i];
+    else if (a === '--deep') flags.deep = true;
     else if (a === '--out') flags.out = args[++i];
     else rest.push(a);
   }
@@ -131,6 +134,24 @@ async function main() {
       break;
     }
     case 'sessions': {
+      if (flags.search) {
+        const items = searchSessions({
+          keyword: flags.search,
+          limit: Number.isFinite(flags.limit) ? flags.limit : 10,
+          deep: flags.deep === true,
+        });
+        if (items.length === 0) {
+          console.log(
+            `没有找到包含「${flags.search}」的会话${flags.deep ? '' : '（默认只搜每个文件开头部分，可加 --deep 全文搜索）'}`
+          );
+          break;
+        }
+        console.log('时间                工作目录              匹配片段');
+        for (const it of items) {
+          console.log(`${it.date.padEnd(18)} ${it.dirName.padEnd(20).slice(0, 20)} ${it.snippet}`);
+        }
+        break;
+      }
       const items = listSessions({
         limit: Number.isFinite(flags.limit) ? flags.limit : 10,
         cwdFilter: flags.dir || null,

package/tool/sessions.mjs

@@ -79,3 +79,50 @@ export function listSessions({ limit = 10, cwdFilter = null } = {}) {
     : items;
   return filtered.slice(0, Math.max(Number(limit) || 10, 1));
 }
+
+// 关键词搜索：默认读每个文件前 256KB（浅搜），--deep 全文扫描
+export function searchSessions({ keyword, limit = 10, deep = false } = {}) {
+  const root = path.join(CODEX_DIR, 'sessions');
+  if (!exists(root) || !keyword) return [];
+  const kw = String(keyword).toLowerCase();
+  const files = walkFiles(root)
+    .filter((f) => f.endsWith('.jsonl'))
+    .map((f) => ({ f, mtimeMs: fs.statSync(f).mtimeMs }))
+    .sort((a, b) => b.mtimeMs - a.mtimeMs);
+
+  const results = [];
+  for (const { f, mtimeMs } of files) {
+    let content;
+    try {
+      content = deep ? fs.readFileSync(f, 'utf8') : readHead(f, 262144);
+    } catch {
+      continue;
+    }
+    const at = content.toLowerCase().indexOf(kw);
+    if (at === -1) continue;
+
+    // 定位匹配行，尽量抽出对话文本片段
+    const lineEnd = content.indexOf('\n', at) === -1 ? content.length : content.indexOf('\n', at);
+    const line = content.slice(content.lastIndexOf('\n', at) + 1, lineEnd);
+    let snippet = '';
+    try {
+      const j = JSON.parse(line);
+      const text =
+        (j.payload?.content || []).find((c) => c.text)?.text || j.payload?.text || line;
+      const t = text.toLowerCase().indexOf(kw);
+      snippet = (t >= 0 ? text.slice(Math.max(0, t - 30), t + 70) : text.slice(0, 90)).replace(/\s+/g, ' ').trim();
+    } catch {
+      snippet = line.slice(0, 90).replace(/\s+/g, ' ').trim();
+    }
+
+    const { meta } = extract(content);
+    results.push({
+      date: (meta?.date) || new Date(mtimeMs).toISOString().slice(0, 16).replace('T', ' '),
+      dirName: meta?.cwd ? path.basename(meta.cwd) : '?',
+      snippet: snippet || '(匹配在元数据中)',
+      mtimeMs,
+    });
+    if (results.length >= Math.max(Number(limit) || 10, 1)) break;
+  }
+  return results;
+}