Skip to content

Repository files navigation

check-fast-mode

用于判断一次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 请求或配置要求fastpriority,但没有完成响应证据。
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 -v

Skill的详细工作流见SKILL.md,证据字段和安全采集方式见references/evidence-map.md

官方参考

About

Codex Skill for verifying whether Fast mode or priority service tier actually served a request

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages