From 84828646bf8c25b4faffb5bf9745fb28ec7e504d Mon Sep 17 00:00:00 2001
From: vibe-code <root@vibe-code.228998.xyz>
Date: Tue, 18 Aug 2026 11:01:48 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=B9=82=E7=AD=89=E6=A3=80=E6=9F=A5?=
 =?UTF-8?q?=E6=B3=A8=E9=87=8A=E6=A0=87=E6=B3=A8=20data=20=E5=BC=95?=
 =?UTF-8?q?=E7=94=A8=E5=81=87=E8=AE=BE=E4=B8=8E=E5=A4=B1=E6=95=88=E6=9D=A1?=
 =?UTF-8?q?=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 volc_limit_sync.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/volc_limit_sync.py b/volc_limit_sync.py
index 556c7aa..7c83aab 100644
--- a/volc_limit_sync.py
+++ b/volc_limit_sync.py
@@ -1192,6 +1192,11 @@ class DailyLimitHandler(CustomLogger):
         # 幂等防重：litellm 对同一请求可能调用两次 async_pre_call_hook
         # （proxy 级 + deployment 级），第二次预扣会重复占 inflight 且
         # 结算只释放一次 → 残留累积。已有 reserve 标记时跳过预扣直接放行。
+        # 假设：deployment-level hook 收到的是同一 data dict 引用（litellm
+        # pre_call_hook 循环体 data=result 赋值，就地修改会带过去）。若
+        # litellm 升级为深拷贝 data 传给第二次 hook，此检查失效，需改用
+        # 请求级唯一 ID（如 litellm_call_id）做去重。部署后留意日志确认
+        # 第二次 pre-hook 是否被跳过（Pre-reserve 只应打印一次）。
         try:
             _existing_meta = data.get("metadata") or {}
             if isinstance(_existing_meta, dict) and PREBLOCK_RESERVE_META_KEY in _existing_meta: