# 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 或热切换，而不是直接重启当前活跃实例。