From d870168ca32bb90f87d901f3c56c79e6bb7ce3d2 Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 12 Sep 2026 11:48:57 +0800 Subject: [PATCH] =?UTF-8?q?docs(CLAUDE):=20=E7=A1=AC=E8=A7=84=E7=9F=A9?= =?UTF-8?q?=E8=A1=A5=E3=80=8C=E5=86=99=E5=85=B1=E4=BA=AB=E5=86=85=E5=AD=98?= =?UTF-8?q?=E5=A4=B1=E8=B4=A5=E5=BF=85=E9=A1=BB=E5=87=BA=E5=A3=B0=E3=80=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 3 +++ 1 file changed, 3 insertions(+) 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** 完成;