📖 更新使用指南:添加部署流程图和快速回答,明确「合并即部署」

Co-authored-by: qinfendebingshuo <207279273+qinfendebingshuo@users.noreply.github.com>
This commit is contained in:
copilot-swe-agent[bot] 2026-03-07 10:03:12 +00:00
parent 71a7789f06
commit ff9867939a
1 changed files with 38 additions and 1 deletions

View File

@ -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`