From ff9867939ad9405edd5142f5617f99aa8f6f2c8b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 7 Mar 2026 10:03:12 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=96=20=E6=9B=B4=E6=96=B0=E4=BD=BF?=
 =?UTF-8?q?=E7=94=A8=E6=8C=87=E5=8D=97=EF=BC=9A=E6=B7=BB=E5=8A=A0=E9=83=A8?=
 =?UTF-8?q?=E7=BD=B2=E6=B5=81=E7=A8=8B=E5=9B=BE=E5=92=8C=E5=BF=AB=E9=80=9F?=
 =?UTF-8?q?=E5=9B=9E=E7=AD=94=EF=BC=8C=E6=98=8E=E7=A1=AE=E3=80=8C=E5=90=88?=
 =?UTF-8?q?=E5=B9=B6=E5=8D=B3=E9=83=A8=E7=BD=B2=E3=80=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: qinfendebingshuo <207279273+qinfendebingshuo@users.noreply.github.com>
---
 docs/使用指南.md | 39 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/docs/使用指南.md b/docs/使用指南.md
index b69bae76..262c73c8 100644
--- a/docs/使用指南.md
+++ b/docs/使用指南.md
@@ -47,7 +47,33 @@ https://qinfendebingshuo.github.io/guanghulab/
 
 铸渊聊天室网站通过 GitHub Actions 自动部署。**只要代码合并到 `main` 分支，网站就会自动更新**。
 
-### 方法一：合并 PR（推荐）
+> ### 🎯 快速回答：什么时候能看到新版本？需要手动操作什么？
+>
+> **你只需要做一件事：合并 PR。** 其他全部自动完成。
+>
+> ```
+> 合并 PR → GitHub Actions 自动部署（1-3分钟）→ 刷新网页看到新版本
+> ```
+>
+> **完整自动部署流程：**
+> ```
+> 代码推送到功能分支
+>   ↓ 自动触发
+> Staging 预演检查（模块完整性、安全检查）
+>   ↓ 检查通过
+> PR 等待冰朔合并
+>   ↓ 冰朔点击 "Merge pull request"（唯一手动步骤）
+> GitHub Actions 自动触发：
+>   ├── 🌀 GitHub Pages 部署（铸渊聊天室网站）
+>   ├── 🚀 CD 服务器部署（guanghulab.com）
+>   ├── 📚 图书馆目录自动更新
+>   ├── 📋 模块文档自动生成
+>   └── 📡 Notion 部署通知
+>   ↓ 1-3 分钟后
+> 网站自动更新完成 ✅
+> ```
+
+### 方法一：合并 PR（推荐 · 唯一需要手动操作的步骤）
 
 当 Copilot Agent 或开发者在功能分支（如 `copilot/xxx`）上完成修改后：
 
@@ -131,6 +157,17 @@ https://qinfendebingshuo.github.io/guanghulab/
 
 ## 五、常见问题
 
+### Q: 什么时候能看到新模块/新版本上线？
+- **PR 合并到 main 后 1-3 分钟**即可看到新版本
+- 如果代码还在功能分支（PR 未合并），网站不会更新
+- 合并后刷新 `https://qinfendebingshuo.github.io/guanghulab/` 即可
+- 服务器部署（guanghulab.com）同样会在合并后自动触发
+
+### Q: 我还需要手动操作什么吗？
+- **只需要一步：合并 PR**（点击绿色的 "Merge pull request" 按钮）
+- 部署、通知、文档更新全部自动完成，无需其他操作
+- 如果部署后有问题，可以在 Issue 中评论「启动冰朔人格体」进行自动诊断
+
 ### Q: 铸渊聊天室打不开？
 - 确认网址正确：`https://qinfendebingshuo.github.io/guanghulab/`
 - 不要在后面加 `/docs/index.html`