pikasTech-unidesk/.agents/skills/unidesk-sub2api/references/local-codex-consumer.md

配置 master Codex 消费端

bun scripts/cli.ts platform-infra sub2api codex-pool configure-local
bun scripts/cli.ts platform-infra sub2api codex-pool configure-local --confirm

configure-local --confirm 会：

• 从 platform-infra/<apiKeySecretName>.<apiKeySecretKey> 读取统一 API key。
• 把当前 ~/.codex/config.toml 和 ~/.codex/auth.json 备份为 .<backupSuffix>，默认 .pre-sub2api。
• 重写默认 ~/.codex 消费端，固定指向 https://sub2api.74-48-78-17.nip.io/，provider 名称和 wire API 来自 localCodex。
• 按 localCodex.modelContextWindow / localCodex.modelAutoCompactTokenLimit 写入 model_context_window / model_auto_compact_token_limit，用于统一控制 Codex auto compact 触发窗口，避免 GPT-5.5 消费端生成过大的 /responses/compact 长请求。
• 按 localCodex 写入 Codex transport 标记：supports_websockets 与 [features] responses_websockets_v2 必须同开同关。只有至少一个上游通过 direct Codex WSv2 probe 时才启用；否则保持 HTTP Responses，避免每次原入口先经历无效 WS reconnect。
• 用统一 key 做一次 gateway 验证。

防递归规则：默认 config.toml / auth.json 是 Sub2API consumer，不得作为上游账号导回 pool；上游账号必须使用带后缀 profile 文件，并通过 config/platform-infra/sub2api-codex-pool.yaml 的 profiles.entries 增删。