From 55333445f431193c34254f907163a23c0f4ea5a4 Mon Sep 17 00:00:00 2001
From: Nelson <1475262689@qq.com>
Date: Thu, 9 Jul 2026 16:39:54 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E7=94=9F=E4=BA=A7?=
 =?UTF-8?q?=E7=AE=A1=E7=90=86=E5=91=98=E5=88=9D=E5=A7=8B=E5=8C=96=E9=85=8D?=
 =?UTF-8?q?=E7=BD=AE=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ai_knowledge_base_v2/.env.example                   | 9 +++++++++
 ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md | 6 +++---
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/ai_knowledge_base_v2/.env.example b/ai_knowledge_base_v2/.env.example
index e27f527..7b1fc9e 100644
--- a/ai_knowledge_base_v2/.env.example
+++ b/ai_knowledge_base_v2/.env.example
@@ -5,6 +5,15 @@ FEISHU_APP_ID=
 FEISHU_APP_SECRET=
 FEISHU_SEARCH_URL=
 
+# ============================================
+# 管理后台首个管理员初始化
+# 生产环境必须替换为安全账号密码，不能使用 admin123456
+# ============================================
+APP_ENV=production
+BOOTSTRAP_ADMIN_USERNAME=admin
+BOOTSTRAP_ADMIN_PASSWORD=replace-with-strong-password
+BOOTSTRAP_ADMIN_NAME=系统管理员
+
 # ============================================
 # 内网穿透（frpc sidecar）
 # 启动 docker compose 前，拷贝本文件为 .env 并填写
diff --git a/ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md b/ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md
index 9a64e3a..c573d8f 100644
--- a/ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md
+++ b/ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md
@@ -70,7 +70,7 @@ FRP_LOCAL_PORT=80
 FRP_CUSTOM_DOMAINS=qa.huiyushuyuan.cn
 ```
 
-## 开发阶段默认账号
+## 本地开发初始化账号
 
 用户端：
 
@@ -79,14 +79,14 @@ FRP_CUSTOM_DOMAINS=qa.huiyushuyuan.cn
 验证码：123456
 ```
 
-管理后台：
+管理后台本地开发环境可通过环境变量初始化首个管理员，例如：
 
 ```text
 账号：admin
 密码：admin123456
 ```
 
-生产环境必须修改默认管理员密码。
+生产环境不允许使用上述开发密码。正式部署前必须在 `.env` 或服务器环境变量中配置安全的 `BOOTSTRAP_ADMIN_USERNAME` 和 `BOOTSTRAP_ADMIN_PASSWORD`，并确认管理后台登录页不会预填账号密码。
 
 ## 数据库迁移