SuperAPI AI 工具集

codex-1m-context-window-setup

编程与开发

查看项目

更新于 10-15 20:34

技能介绍

用途:为 OpenAI Codex CLI 与 Desktop 配置并验证扩展的、感知模型的上下文窗口。当 Codex 显示约 258K 上下文、希望提升到 500K 或 1M 时使用。脚本读取 Codex 当前模型目录,将请求上限封顶到所选模型声明的最大值,并应用既有的 60% 自动压缩策略。

主要能力:提供 doctor、apply、verify 三个子命令。doctor 为只读,报告 Codex 解析出的所选模型、目录默认值、模型最大值与可用百分比、请求的原始窗口(最高 1,000,000)、可用窗口与 60% 压缩点、当前基础配置值以及是否需要 apply,并给出 $CODEX_HOME/config.toml 目标路径。apply 在 doctor 成功后运行,重新读取实时模型契约,仅修改顶层 model_context_window 与 model_auto_compact_token_limit 两个键,仅在字节变化时创建内容寻址备份,使用同目录原子替换并拒绝覆盖并发修改的配置,运行 Codex 严格配置诊断,失败则恢复原字节,最后回读并报告未来会话将使用的值。verify 在 Codex 升级、默认模型变更或新配置机器后运行,若当前基础配置不再等于模型感知建议值则以非零退出。

使用方式:技能加载时宿主会暴露安装路径,需显式解析该路径,不要在主目录中搜索其他副本;若宿主未暴露安装路径,应停止并提示 installed Skill path not exposed。macOS/Linux 下设置该目录后运行: SKILL_DIR="/absolute/path/from-the-loaded-skill-metadata" uv run --no-project python "$SKILL_DIR/scripts/codex_context_window.py" doctor uv run --no-project python "$SKILL_DIR/scripts/codex_context_window.py" apply uv run --no-project python "$SKILL_DIR/scripts/codex_context_window.py" verify Windows PowerShell 使用同一目录(正斜杠): $SkillDir = "C:/absolute/path/from-the-loaded-skill-metadata" uv run --no-project python "$SkillDir/scripts/codex_context_window.py" doctor uv run --no-project python "$SkillDir/scripts/codex_context_window.py" apply uv run --no-project python "$SkillDir/scripts/codex_context_window.py" verify

适用场景:检查当前限制、解释 258K、预览建议;配置、修复或提高上下文窗口;在更新或切换模型后确认先前设置仍然正确。不要向用户索要原始 token 数字,模型目录是权威来源。

限制:不更改所选模型、推理强度、服务层级、沙箱、审批、插件、MCP 服务器、浏览器/计算机使用设置或 shell 别名;不编辑配置文件中的 profile 专属部分,也不覆盖每条命令的 -c 标志;不声称当前运行线程已被扩展;当所选模型声明的最大值较小时不强制 1M;不回退到过时或猜测的模型元数据。若 Codex 无法返回实时模型目录,应停止,不要用记忆中的模型限制、API 营销数字或内置默认值替代。apply 成功后需告知用户启动新的 CLI 线程或重启/打开新的 Codex Desktop 线程,现有会话不会就地增长。诊断模型上限、95% 可用窗口显示或压缩语义时,可阅读 references/context_window_contract.md。