📖 更新使用指南:添加部署流程图和快速回答,明确「合并即部署」
Co-authored-by: qinfendebingshuo <207279273+qinfendebingshuo@users.noreply.github.com>
This commit is contained in:
parent
71a7789f06
commit
ff9867939a
39
docs/使用指南.md
39
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`
|
||||
|
|
|
|||
Loading…
Reference in New Issue