diff --git a/CLAUDE.md b/CLAUDE.md index 8c8f42d..df2fe2c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -325,6 +325,9 @@ carol `llm_rpm=2`、dave `llm_daily=2`(限流断言用)。夹具上游含 ** ③ 涉及域名/Key/上游变更的,**必须调对应的 `sync_shm`**——漏了就等于没生效(无回源兜底)。 鉴权由分发器统一兜底,**不要在单个 handler 里重复实现**。 - **所有写操作必须同时更新 shm 与 JSON 文件**。只写一边会出现「重启后配置回滚」或「改了不生效」。 +- **写共享内存失败必须出声**。`state::put_*` 返回 `false`(zone 满 / 分配失败)时,三处 `sync_shm` + 会 `log_err`(带对象标识与后果),三处 `reload_shm` 会核对「期望条数 vs 实际装载」。**别丢掉返回值**—— + 热路径没有回源兜底,写失败就是「刚建好却调不通,日志里什么都没有」,属于最难查的一类形态。 - **`env ADMIN_INIT_PASSWORD;` 必须在 `conf/nginx.conf` 的 main 上下文**。少了这行 nginx 会剥离环境变量, 模块读到的初始密码恒为空(靠 `INIT_ADMIN_PASSWORD` 播种 admin 的逻辑就依赖它)。 - **新增 location 用 `$proxy_backend_addr` 时**,变量注册已在 `lib.rs` 的 **preconfiguration** 完成;