SuperAPI AI 工具集

codex-session-finder

智能体与模型

查看项目

更新于 10-16 02:39

技能介绍

用途:定位本地 Codex 会话并返回会话坐标(id、标题、cwd、时间戳、归档状态、分支、提交、令牌数与 rollout 路径)。它只负责找到线程,不默认总结、评判或提取对话重点。

主要能力:接受线程 id、会话标题、仓库或工作区路径、rollout 文件路径或自然语言主题作为输入;输入含糊时先检索元数据并返回候选,而非静默猜测。也支持“活动 worktree 查询”模式:查询未归档会话,按 cwd 过滤,例如 sqlite3 -header -column ~/.codex/state_5.sqlite "select id, title, cwd, datetime(updated_at,'unixepoch') as updated_at, git_branch, git_sha, rollout_path from threads where archived = 0 and cwd like '%/vitehub%' order by updated_at desc;"。

数据来源与顺序:先查 state_5.sqlite(优先 threads 表,精确 id 优先,其次标题、路径、rollout 路径与提示预览),rank 上活跃会话优先于归档会话再按最近更新排序;SQLite 无法解析时查 session_index.jsonl,作为辅助证据;仅在需要识别会话时才搜索 sessions/ 与 archived_sessions/ 下的 rollout 文件。

输出:返回紧凑元数据报告,形态如 Found session: id、title、cwd、created、updated、archived、branch、git sha、tokens used、rollout path。仅在输入模糊、存在多个候选或用了回退来源时附“Match basis”;仅在用户要求查看会话内容或元数据不足以识别时才附最小 Evidence slice。活动 worktree 查询输出 Active sessions 列表,并把活跃会话 worktree 视为只读、禁止后续修改性任务,除非用户明确允许。

可选轮次导出:仅当用户要求检查、审阅、调试或交接会话内容时,在 /tmp 或系统临时目录写逐轮导出(Markdown 或 JSONL),绝不写入目标仓库,并在响应中只给出导出路径。

限制:保持只读,不修改 Codex 状态、rollout 文件、仓库或技能文件;不暴露不必要的私密会话内容;不默认深度分析会话;选择字段前需用 sqlite3 ~/.codex/state_5.sqlite '.schema threads' 检查 schema,当前 schema 用 tokens_used,除非确有 token_count 否则不要选它。