SuperAPI AI 工具集

codex-tracker-suite

编程与开发

查看项目

更新于 10-27 12:06

技能介绍

Codex Tracker Suite 通过随附的封装脚本访问与当前 Codex 版本匹配的 codex app-server 协议,使 Codex 保持为会话数据的唯一来源,避免直接读取 Codex 私有的 SQLite 数据库或 rollout 文件。

用途:该技能面向 Codex 本地会话的查找与查看,例如按主题或对话文本查找会话、在某个会话中定位全部可见匹配、浏览近期工作记录、查看会话元数据或可见对话、查看共享托管运行时中已加载的会话,以及生成用于继续工作的 shell 安全命令。

主要能力与命令入口:封装脚本提供 search QUERY(按主题或对话文本查找会话)、occurrences SESSION_ID QUERY(在单个会话内定位所有可见匹配)、recent(浏览近期工作)、show SESSION_ID(查看元数据或可见对话)、alive(查看共享托管运行时中已加载的会话)、resume SESSION_ID(输出用于继续工作的 shell 安全命令)。所有命令均可加 --help 查看过滤条件与 JSON 输出说明。可使用 --include-non-interactive 纳入 codex exec 与 App Server 会话,或使用 --all-sources 纳入子代理。普通搜索默认只覆盖交互式 CLI 与 IDE 会话,与 Codex 原生行为一致。

使用方式与输出:当另一个程序或智能体需要消费结果时,建议使用 --json。返回结果在可用时包含匹配的会话 ID、标题、工作目录、片段与恢复命令。查找类操作保持只读;resume 只打印命令,不会启动交互式进程。原生对话全文搜索为实验性功能,在较大历史记录上可能需要一到两分钟,封装脚本在等待时会打印进度,并使用可配置的超时。

限制与注意事项:如果原生全文搜索不可用,应报告兼容性错误并建议 codex resume --all,而不是静默抓取私有数据库。App Server 在读取过程中可能更新其自身的状态元数据;在受限的 Codex 沙箱中,应为封装脚本命令申请审批,而不是绕过沙箱。除非用户另行要求,否则不要归档、删除、重命名或以其他方式改动会话;该封装脚本有意不提供破坏性命令。alive 是托管守护进程视角的视图,若没有共享 App Server 守护进程,应改用 Codex 自身的会话界面或进程级诊断。关于协议选择、兼容行为与对等边界,仅在维护或扩展封装脚本时阅读 references/architecture.md。