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