codex-retry-gateway/AGENTS.md

AGENTS

本仓库用于维护 codex-retry-gateway 的本地代理、管理 UI 和 profile 切换能力。

工作规则

• 涉及运行中服务的修改时，优先保证当前会话不断线。
• 在执行会影响当前 gateway 实例的动作前，必须先做本地验证，再部署。
• 本地验证至少包括：
  • 后端改动后运行 npm run check
  • 前端改动后运行 npm run check:ui
  • 需要发布 UI 时运行 npm run build:ui
• 涉及 profile / upstream / model remap / auth 的改动，优先使用不切换当前实例的 probe 接口验证
• 只有在确认测试可行后，才允许影响当前运行实例。
• profile 切换与当前活跃 profile 保存，默认优先使用进程内热切换 / 热应用，不要先走 systemd 重启路径。
• 若目标是验证某个 profile 是否可用，默认先使用 POST /__codex_retry_gateway/api/profiles/probe，不要先切换当前运行实例。
• 若必须切换 profile 或重启服务，完成后要确认：
  • 当前实例已恢复健康
  • 管理 UI 可访问
  • 当前活跃 profile 符合预期

部署偏好

• 优先小步修改、快速验证。
• 优先避免会导致当前 Codex 会话掉线的操作。
• 需要验证删除、切换、重启等行为时，优先使用临时 profile、probe 或热切换，而不是直接重启当前活跃实例。