乐于分享
好东西不私藏

这个 Codex 插件只读本地日志:看清工具调用、子代理和 Token 用量,又不暴露原始细节

这个 Codex 插件只读本地日志:看清工具调用、子代理和 Token 用量,又不暴露原始细节
摘要:Codex Trajectory 把本地任务日志变成事件账本和交互式时间轴,能查看工具调用、子代理、Token 用量、失败记录与上下文压缩。默认安全摘要隐藏原始细节,完整详情需要用户明确开启。

Codex 任务跑完后,最终答案只能告诉你“做成了什么”,很难回答“时间花在哪里、哪次工具调用失败、子代理做了什么、Token 为什么突然变多”。Codex Trajectory 就是为这类复盘准备的。它读取本地任务日志,把执行过程整理成事件账本和时间轴。下面会说清它能看到什么、默认隐藏什么,以及哪些任务值得装上它再跑一遍。

最终答案之外,它把执行过程摊开给你看

Codex Trajectory 是一个 Codex 插件。它读取 CODEX_HOME/sessions 下的本地 JSONL 任务日志;需要查看归档任务时,也可以读取指定的 CODEX_HOME/archived_sessions。原始日志不会被修改,也不会再保存一份副本。

插件把日志里的轮次、近似模型步骤、推理摘要、助手消息、工具耗时、子代理、上下文压缩、Token 用量和失败信息整理到同一个界面里。你可以沿时间轴看任务怎样推进,也可以按事件类型筛选,定位某次异常发生前后到底做了什么。

这对长任务尤其有用。任务慢,不一定是模型一直在“思考”,也可能是某个工具调用等待很久;Token 突然增多,也可能和上下文压缩、继承历史或子代理活动有关。把这些记录放到同一条轨迹上,排查时就不用只凭最终回复猜过程。

官方中文界面会把安全摘要、轮次、记录、工具数量、失败次数、总时长和 Token 拆分放在一页里。Token 详情还能区分缓存读取、非缓存输入、可见输出和推理输出,避免把这些子项重复加到总量上。

默认先给安全摘要,完整详情要自己打开

本地日志很敏感。工具输入里可能有命令和文件内容,输出里可能有路径、报错、Git 远端或项目细节。Codex Trajectory 默认不会把这些原始内容直接返回。

安全摘要模式保留事件名称、时间、状态、Token 用量和有长度限制的摘要,同时隐藏工具输入输出、原始记录元数据、绝对日志路径、Git 远程地址、基础指令和加密推理。想看更完整的记录,需要显式传入 detailLevel: "full",或者在界面里亲自确认。即便开启完整详情,基础指令和加密推理仍不会返回。

项目的 Python 运行时没有遥测。默认情况下,它也不会主动发起应用网络请求。这里有两个边界要单独记住:uv 可能按你自己的配置下载兼容 Python;可选的 CDP 内置浏览器入口默认关闭,开启后只应连接用户选择的本机回环调试端口。CDP 端口能控制应用页面,不该暴露到隧道或非本机地址。

三类任务最值得用它复盘

第一类是跑得久、工具调用多的任务。比如跨文件重构、批量修测试、资料抓取和多阶段发布。时间轴能直接显示每次工具调用的状态与耗时,失败记录也不会混在长对话里难以寻找。

第二类是使用子代理或多轮上下文的任务。插件会显示子代理活动、上下文压缩和分页历史,并排除子代理继承自父任务但不属于自身活动的那段上下文。复盘时看到的是这个子代理真正执行过的轨迹。

第三类是需要盯 Token 和账户额度的长任务。当前 v0.3.1 会在日志存在官方限额窗口时显示剩余百分比和重置时间,还增加了一键停止与默认关闭的额度阈值保护。查看流程仍然只读日志;停止按钮属于用户授权的控制动作,会暂停活跃 Goal 或中断当前回合,但不会删除 worktree,也不会修改任务文件。

这部分不能只看“有停止按钮”几个字。标准 Apps 界面的停止请求可能经过宿主后续消息桥接,从而调用模型并消耗额度;配置好的内置浏览器路径则直接调用本地 App Server 的停止能力。是否开启 CDP、是否启用自动停止,都应该由用户自己决定。

安装不复杂,适合经常让 Codex 跑长任务的人

前置条件是已经安装 Codex 和 uv。官方给出的安装命令只有两行:

codex plugin marketplace add icesixgod/codex-trajectory
codex plugin add codex-trajectory@icesixgod

安装后要新开一个 Codex 任务,让插件工具和 Skill 生效。最简单的测试方式,是输入“显示这个 Codex 任务的安全轨迹摘要”。

它提供三个主要工具:list_codex_sessions 用来列出最近任务元数据;get_codex_trajectory 返回适合分析的结构化轨迹;show_codex_trajectory 会打开交互式 MCP Apps 界面。后两个工具支持分页、归档任务和 summary / full 两种详情级别。

如果你偶尔只让 Codex 改一两个小文件,直接看对话记录往往够用。Codex Trajectory 更适合长任务、多工具调用、子代理协作和 Token 异常排查。它给你的不是另一份聊天记录,而是一条能按事件和时间复盘的执行轨迹;看得见过程以后,下一次该缩短提示、调整工具、拆分任务还是直接停止,就有了更具体的依据。