docs(CLAUDE): 硬规矩补「写共享内存失败必须出声」

This commit is contained in:
admin committed 2026-09-12 11:48:57 +08:00
1 parent 12f3fc4ac5
commit d870168ca3
1 file changed
+3
+3
View File
@@ -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** 完成;