diff --git a/ai_knowledge_base_v2/apps/backend/.env.example b/ai_knowledge_base_v2/apps/backend/.env.example
index 0dfe10d..5978034 100644
--- a/ai_knowledge_base_v2/apps/backend/.env.example
+++ b/ai_knowledge_base_v2/apps/backend/.env.example
@@ -17,6 +17,8 @@ MOCK_RAG_ENABLED=false
 MOCK_MODEL_ENABLED=true
 FEISHU_MOCK_ENABLED=false
 FEISHU_SEARCH_URL=
+FEISHU_APP_ID=
+FEISHU_APP_SECRET=
 FEISHU_TIMEOUT_SECONDS=20
 FEISHU_RETRY_COUNT=2
 
diff --git a/ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md b/ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md
index 6776c38..1725b02 100644
--- a/ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md
+++ b/ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md
@@ -28,6 +28,16 @@ cd ai_knowledge_base_v2
 docker compose -f docker-compose.dev.yml up --build
 ```
 
+如果用户端问答需要直读飞书知识库，需要在启动前配置后端运行环境变量：
+
+```bash
+export FEISHU_APP_ID=你的飞书应用AppID
+export FEISHU_APP_SECRET=你的飞书应用AppSecret
+docker compose -f docker-compose.dev.yml up -d --build backend user-client admin-web
+```
+
+也可以在 `ai_knowledge_base_v2/.env` 中配置 `FEISHU_APP_ID`、`FEISHU_APP_SECRET` 和 `FEISHU_SEARCH_URL`。后台“知识库管理”只维护 SpaceID、NodeID 和启用状态；飞书应用凭证不存放在知识库记录中。若使用独立飞书检索适配服务，则在后台“系统配置”填写飞书检索服务地址，后端会优先调用该地址。
+
 默认地址：
 
 - 用户端 H5：`http://127.0.0.1:5173/`