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`