diff --git a/.github/workflows/deploy-to-server.yml b/.github/workflows/deploy-to-server.yml index 06b50f4e..2ff4efbc 100644 --- a/.github/workflows/deploy-to-server.yml +++ b/.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 diff --git a/docs/使用指南.md b/docs/使用指南.md index 262c73c8..cf95ab1f 100644 --- a/docs/使用指南.md +++ b/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` 强制刷新,清除缓存