🌐 明确 guanghulab.com = GitHub Pages 部署 + 修复远程服务器 rsync 安装

Co-authored-by: qinfendebingshuo <207279273+qinfendebingshuo@users.noreply.github.com>

.github/workflows/deploy-to-server.yml

@@ -89,7 +89,7 @@ jobs:
       - name: 📥 检出代码
         uses: actions/checkout@v4
 
-      - name: 📦 确保 rsync 已安装
+      - name: 📦 确保本地 rsync 已安装
         run: |
           if ! command -v rsync &>/dev/null; then
             sudo apt-get update -qq && sudo apt-get install -y rsync
@@ -103,6 +103,16 @@ jobs:
           chmod 600 ~/.ssh/deploy_key
           ssh-keyscan -H ${{ secrets.DEPLOY_HOST }} >> ~/.ssh/known_hosts 2>/dev/null
 
+      - name: 📦 确保远程服务器 rsync 已安装
+        run: |
+          echo "🔍 检查远程服务器 rsync..."
+          ssh -i ~/.ssh/deploy_key ${{ secrets.DEPLOY_USER }}@${{ secrets.DEPLOY_HOST }} \
+            "command -v rsync || { echo '⚠️ 远程服务器未安装 rsync，尝试安装...' && \
+              (sudo apt-get update -qq && sudo apt-get install -y rsync 2>/dev/null || \
+               sudo yum install -y rsync 2>/dev/null || \
+               echo '❌ 无法自动安装 rsync，请手动在服务器上安装: sudo apt-get install rsync'); }"
+          echo "✅ 远程服务器 rsync 检查完成"
+
       - name: 🔒 部署前安全检查
         run: |
           if [ ! -f "docs/index.html" ]; then

docs/使用指南.md

@@ -4,12 +4,19 @@
 
 ## 一、网址
 
-铸渊聊天室部署在 GitHub Pages 上，**正确网址**：
+铸渊聊天室部署在 GitHub Pages 上，通过自定义域名访问：
 
+```
+https://guanghulab.com/
+```
+
+备用网址（GitHub Pages 默认）：
 ```
 https://qinfendebingshuo.github.io/guanghulab/
 ```
 
+> 💡 两个网址指向同一个网站。`guanghulab.com` 通过 `docs/CNAME` 配置，由 GitHub Pages 提供服务。
+>
 > ⚠️ 旧网址 `…/docs/index.html` 已失效（系统重构后路径变了），请用上面的新网址。
 
 打开后你会看到铸渊助手的登录界面（v5.0），有两种登录方式：
@@ -45,14 +52,14 @@ https://qinfendebingshuo.github.io/guanghulab/
 
 ## 三、如何部署新版本到网站（⭐ 重要）
 
-铸渊聊天室网站通过 GitHub Actions 自动部署。**只要代码合并到 `main` 分支，网站就会自动更新**。
+铸渊聊天室网站通过 GitHub Actions 自动部署。**只要代码合并到 `main` 分支，guanghulab.com 就会自动更新**。
 
-> ### 🎯 快速回答：什么时候能看到新版本？需要手动操作什么？
+> ### 🎯 快速回答：guanghulab.com 合并 PR 就能部署吗？
 >
-> **你只需要做一件事：合并 PR。** 其他全部自动完成。
+> **是的，合并 PR 就行。** guanghulab.com 由 GitHub Pages 提供服务，合并后 1-3 分钟自动更新。
 >
 > ```
-> 合并 PR → GitHub Actions 自动部署（1-3分钟）→ 刷新网页看到新版本
+> 合并 PR → GitHub Actions 自动部署（1-3分钟）→ 刷新 guanghulab.com 看到新版本
 > ```
 >
 > **完整自动部署流程：**
@@ -64,13 +71,13 @@ https://qinfendebingshuo.github.io/guanghulab/
 > PR 等待冰朔合并
 >   ↓ 冰朔点击 "Merge pull request"（唯一手动步骤）
 > GitHub Actions 自动触发：
->   ├── 🌀 GitHub Pages 部署（铸渊聊天室网站）
->   ├── 🚀 CD 服务器部署（guanghulab.com）
+>   ├── 🌀 GitHub Pages 部署 → guanghulab.com 更新
+>   ├── 🚀 CD 服务器部署（状态看板同步）
 >   ├── 📚 图书馆目录自动更新
 >   ├── 📋 模块文档自动生成
 >   └── 📡 Notion 部署通知
 >   ↓ 1-3 分钟后
-> 网站自动更新完成 ✅
+> guanghulab.com 自动更新完成 ✅
 > ```
 
 ### 方法一：合并 PR（推荐 · 唯一需要手动操作的步骤）
@@ -157,11 +164,16 @@ https://qinfendebingshuo.github.io/guanghulab/
 
 ## 五、常见问题
 
+### Q: guanghulab.com 合并 PR 就能自动部署吗？
+- **是的。** `guanghulab.com` 由 GitHub Pages 提供服务（通过 `docs/CNAME` 配置）
+- 合并 PR 到 main 后，`deploy-pages.yml` 自动将 `docs/` 部署到 GitHub Pages
+- GitHub Pages 自动为 `guanghulab.com` 域名提供服务
+- **1-3 分钟后刷新 guanghulab.com 即可看到新版本**
+
 ### Q: 什么时候能看到新模块/新版本上线？
 - **PR 合并到 main 后 1-3 分钟**即可看到新版本
 - 如果代码还在功能分支（PR 未合并），网站不会更新
-- 合并后刷新 `https://qinfendebingshuo.github.io/guanghulab/` 即可
-- 服务器部署（guanghulab.com）同样会在合并后自动触发
+- 合并后刷新 `https://guanghulab.com/` 即可
 
 ### Q: 我还需要手动操作什么吗？
 - **只需要一步：合并 PR**（点击绿色的 "Merge pull request" 按钮）
@@ -169,7 +181,7 @@ https://qinfendebingshuo.github.io/guanghulab/
 - 如果部署后有问题，可以在 Issue 中评论「启动冰朔人格体」进行自动诊断
 
 ### Q: 铸渊聊天室打不开？
-- 确认网址正确：`https://qinfendebingshuo.github.io/guanghulab/`
+- 确认网址正确：`https://guanghulab.com/` 或 `https://qinfendebingshuo.github.io/guanghulab/`
 - 不要在后面加 `/docs/index.html`
 - 等几分钟再刷新（部署有延迟）
 - 按 `Ctrl+Shift+R` 强制刷新，清除缓存