diff --git a/packages/tool-bailian-kb/README.md b/packages/tool-bailian-kb/README.md
index 700ca19..00caa1e 100644
--- a/packages/tool-bailian-kb/README.md
+++ b/packages/tool-bailian-kb/README.md
@@ -24,7 +24,7 @@
 
 ## 错误语义
 
-- 4xx（除 401/403）：错误信息**附当前服务清单**，模型可一步纠正无效 `agent_id`；
+- HTTP 错误（除 401/403 鉴权类）：错误信息**附当前服务清单**，模型可一步纠正无效 `agent_id`（5xx 也附，但通常代表服务端异常）；
 - 凭证缺失：指向 `~/.dsh/.env` / `.credentials.yaml` 配置方式与控制台取 key 页面；
 - chat 超时：说明服务端多轮检索特性，建议重试或改用 `kb_search`；
 - 服务端错误体截断至 500 字符进入错误信息（优先 `code: message`）。