用于判断一次Codex或OpenAI API请求是否实际使用了Fast mode或Priority processing,而不是仅根据配置、请求参数或主观速度推测。
这个仓库同时包含:
- 可由Codex直接调用的Skill说明。
- 用于解析JSON、JSONL、SSE、WebSocket、OpenTelemetry日志和TOML式配置的本地诊断脚本。
- OpenAI、Codex及兼容API的证据优先级和判定规则。
完成响应是最高优先级证据:
完成响应或SSE完成事件
> 原始请求
> 生效配置和模型目录
> 延迟与吞吐观察
请求中的service_tier只表示意图。实际完成响应返回的service_tier才说明本次请求使用了哪种处理层级。
| 结果 | 含义 |
|---|---|
enabled |
完成响应报告了当前文档映射的Fast层级,例如OpenAI的priority。 |
disabled |
完成响应报告了已知的非Fast层级,例如default。 |
requested_not_confirmed |
请求或配置要求fast或priority,但没有完成响应证据。 |
mixed |
多个完成响应使用了不同层级。 |
indeterminate |
证据缺失、响应未暴露层级,或第三方层级名称没有可靠映射。 |
Codex当前从用户级$HOME/.agents/skills和仓库级.agents/skills目录加载本地Skill。
在PowerShell 7中运行:
gh repo clone aike123321/check-fast-mode "$HOME\.agents\skills\check-fast-mode"在目标仓库根目录运行:
gh repo clone aike123321/check-fast-mode ".agents\skills\check-fast-mode"Codex通常会自动检测Skill变更。如果没有出现,重启Codex后再试。
显式调用:
$check-fast-mode 检查这份SSE记录是否实际使用了Fast mode。
也可以直接描述问题,例如:
- “我把
service_tier设成fast了,这次请求真的走了Fast吗?” - “切换ChatGPT账号后,帮我确认Codex Fast mode是否生效。”
- “检查这份
response.completed事件,区分请求层级和实际响应层级。” - “这个兼容API返回
turbo,能否证明它是Fast?”
解析文件并输出JSON:
python scripts/inspect_fast_mode.py --provider openai --input .\trace.jsonl输出简短文本:
python scripts/inspect_fast_mode.py --provider codex --input .\codex-otel.log --format text第三方兼容API必须先从该提供商的当前文档确认映射,再显式传入:
python scripts/inspect_fast_mode.py --provider compatible --fast-tier turbo --non-fast-tier standard --input .\trace.json未指定--input时,脚本从标准输入读取。
- 解析器只读取本地输入,不联网,也不会发起API请求。
- 输出仅包含层级、证据角色和来源位置,不回显完整请求内容。
- 不要提交API Key、Authorization标头、Cookie、刷新令牌或未脱敏流量记录。
- 不要仅凭TTFT、吞吐或“感觉更快”判断Fast mode。
- 对第三方兼容API,不要套用OpenAI的
priority映射。
check-fast-mode/
├── SKILL.md
├── agents/openai.yaml
├── references/evidence-map.md
├── scripts/inspect_fast_mode.py
└── tests/
python -m pip install -r requirements-dev.txt
python -m compileall -q scripts tests
python -m unittest discover -s tests -vSkill的详细工作流见SKILL.md,证据字段和安全采集方式见references/evidence-map.md。