chore: GitHub Pages optimization & workflow standardization

Author: shijiashuai

.github/workflows/pages.yml

@@ -6,7 +6,9 @@ on:
     paths:
       - '*.md'
       - 'docs/**'
+      - 'changelog/**'
       - '_config.yml'
+      - '404.md'
       - '.github/workflows/pages.yml'
   workflow_dispatch:
 
@@ -17,7 +19,7 @@ permissions:
 
 concurrency:
   group: pages
-  cancel-in-progress: false
+  cancel-in-progress: true
 
 jobs:
   build:
@@ -30,6 +32,7 @@ jobs:
           sparse-checkout: |
             *.md
             _config.yml
+            404.md
             docs
             changelog
             LICENSE

.gitignore

@@ -36,6 +36,11 @@ Thumbs.db
 # Docker
 docker-compose.override.yml
 
+# Jekyll
+_site/
+.jekyll-cache/
+.jekyll-metadata
+
 # Environment & secrets
 .env
 .env.*

CHANGELOG.md

@@ -12,6 +12,7 @@ description: WebRTC 项目各版本变更记录
 
 | 日期 | 摘要 |
 |:-----|:-----|
+| [2026-03-10](changelog/2026-03-10_pages-optimization.md) | Pages 工作流优化、CI badge 修正、_config.yml 清理、Pages 徽章 |
 | [2026-03-09](changelog/2026-03-09_pages-and-quality.md) | GitHub Pages 全面优化、golangci-lint、测试覆盖率增强、文档同步 |
 | [2026-03-09](changelog/2026-03-09_stability-and-security.md) | writePump 协程泄露修复、房间/人数上限、WebSocket 自动重连 |
 | [2026-02-13](changelog/2026-02-13.md) | 全面优化与重构（后端提取 broadcastMembers、前端重构、CI 增强、Docker） |

README.md

@@ -1,6 +1,7 @@
 # WebRTC
 
-[![Go CI](https://github.com/LessUp/webrtc/actions/workflows/go.yml/badge.svg)](https://github.com/LessUp/webrtc/actions/workflows/go.yml)
+[![Go CI](https://github.com/LessUp/webrtc/actions/workflows/ci.yml/badge.svg)](https://github.com/LessUp/webrtc/actions/workflows/ci.yml)
+[![Pages](https://github.com/LessUp/webrtc/actions/workflows/pages.yml/badge.svg)](https://lessup.github.io/webrtc/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 ![Go](https://img.shields.io/badge/Go-1.22+-00ADD8?logo=go&logoColor=white)
 ![WebRTC](https://img.shields.io/badge/WebRTC-Enabled-333333?logo=webrtc&logoColor=white)
@@ -93,7 +94,7 @@ webrtc/
 │   ├── guide.md         # Architecture, frontend, media, recording
 │   └── signaling.md     # Signaling protocol deep dive
 ├── .github/workflows/   # CI/CD
-│   ├── go.yml           # Go build + test + lint
+│   ├── ci.yml           # Go build + test + lint
 │   └── pages.yml        # GitHub Pages deployment
 ├── changelog/           # Change logs
 ├── Dockerfile           # Multi-stage build

README.zh-CN.md

@@ -2,7 +2,8 @@
 
 [English](README.md) | 简体中文 | [📖 在线文档](https://lessup.github.io/webrtc/)
 
-[![Go CI](https://github.com/LessUp/webrtc/actions/workflows/go.yml/badge.svg)](https://github.com/LessUp/webrtc/actions/workflows/go.yml)
+[![Go CI](https://github.com/LessUp/webrtc/actions/workflows/ci.yml/badge.svg)](https://github.com/LessUp/webrtc/actions/workflows/ci.yml)
+[![Pages](https://github.com/LessUp/webrtc/actions/workflows/pages.yml/badge.svg)](https://lessup.github.io/webrtc/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 ![Go](https://img.shields.io/badge/Go-1.22+-00ADD8?logo=go&logoColor=white)
 ![WebRTC](https://img.shields.io/badge/WebRTC-Enabled-333333?logo=webrtc&logoColor=white)
@@ -121,7 +122,7 @@ webrtc/
 │   ├── guide.md         # 项目技术说明（架构、前端、媒体、录制）
 │   └── signaling.md     # 信令协议与房间管理详解
 ├── .github/workflows/   # CI/CD
-│   ├── go.yml           # Go 构建 + 测试 + lint
+│   ├── ci.yml           # Go 构建 + 测试 + lint
 │   └── pages.yml        # GitHub Pages 部署
 ├── changelog/           # 变更日志
 ├── Dockerfile           # 多阶段构建

_config.yml

@@ -16,7 +16,6 @@ show_downloads: false
 # SEO & social
 author: LessUp
 lang: zh-CN
-logo: /webrtc/assets/og-banner.png
 
 # Markdown rendering
 markdown: kramdown
@@ -36,6 +35,10 @@ exclude:
   - .editorconfig
   - .gitattributes
   - .golangci.yml
+  - .vscode/
+  - .github/
   - vendor/
   - bin/
+  - _site/
+  - .jekyll-cache/
   - "*.exe"

changelog/2026-03-10_pages-optimization.md

@@ -0,0 +1,16 @@
+# 2026-03-10 GitHub Pages 优化
+
+## 修复
+
+1. **CI badge URL 修正** — `README.md`、`README.zh-CN.md`、`index.md` 中 badge 链接从不存在的 `go.yml` 修正为实际的 `ci.yml`
+2. **项目结构描述修正** — 三处项目结构树中 `go.yml` → `ci.yml`
+3. **`_config.yml` 移除不存在的 logo** — `assets/og-banner.png` 文件不存在，移除引用避免 SEO 元数据指向 404
+4. **`.gitignore` 补充 Jekyll 产物** — 添加 `_site/`、`.jekyll-cache/`、`.jekyll-metadata`
+
+## 优化
+
+5. **`pages.yml` cancel-in-progress** — `false` → `true`，避免过时提交的部署阻塞新提交
+6. **`pages.yml` paths 触发补全** — 添加 `changelog/**`、`404.md` 路径触发，确保子页面变更也触发部署
+7. **`pages.yml` sparse-checkout 补全** — 添加 `404.md`，确保 404 页面正确部署
+8. **`_config.yml` exclude 补全** — 添加 `.vscode/`、`.github/`、`_site/`、`.jekyll-cache/`，减少 Jekyll 构建范围
+9. **添加 Pages badge** — `README.md`、`README.zh-CN.md`、`index.md` 添加 GitHub Pages 部署状态徽章

changelog/2026-03-10_workflow-deep-standardization.md

@@ -0,0 +1,14 @@
+# Workflow 深度标准化
+
+日期：2026-03-10
+
+## 变更内容
+
+- CI workflow 重命名：`go.yml` → `ci.yml`
+- CI workflow 统一 `permissions: contents: read` 与 `concurrency` 配置
+- Pages workflow 补充 `actions/configure-pages@v5` 步骤
+- Pages workflow 添加 `paths` 触发过滤，减少无效构建
+
+## 背景
+
+全仓库第二轮 GitHub Actions 深度标准化：统一命名、权限、并发、路径过滤与缓存策略。

index.md

@@ -15,7 +15,8 @@ description: 基于 Go + WebRTC 的实时音视频示例项目，覆盖信令、
 </p>
 
 <p>
-<a href="https://github.com/LessUp/webrtc/actions/workflows/go.yml"><img src="https://github.com/LessUp/webrtc/actions/workflows/go.yml/badge.svg" alt="Go CI"></a>
+<a href="https://github.com/LessUp/webrtc/actions/workflows/ci.yml"><img src="https://github.com/LessUp/webrtc/actions/workflows/ci.yml/badge.svg" alt="Go CI"></a>
+<a href="https://github.com/LessUp/webrtc/actions/workflows/pages.yml"><img src="https://github.com/LessUp/webrtc/actions/workflows/pages.yml/badge.svg" alt="Pages"></a>
 <a href="https://github.com/LessUp/webrtc/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
 <img src="https://img.shields.io/badge/Go-1.22+-00ADD8?logo=go&logoColor=white" alt="Go">
 <img src="https://img.shields.io/badge/WebRTC-Enabled-333333?logo=webrtc&logoColor=white" alt="WebRTC">
@@ -156,7 +157,7 @@ webrtc/
 │   ├── guide.md         # 项目技术说明（架构、前端、媒体、录制）
 │   └── signaling.md     # 信令协议与房间管理详解
 ├── .github/workflows/   # CI/CD
-│   ├── go.yml           # Go 构建 + 测试 + 静态分析
+│   ├── ci.yml           # Go 构建 + 测试 + 静态分析
 │   └── pages.yml        # GitHub Pages 部署
 ├── changelog/           # 变更日志
 ├── Dockerfile           # 多阶段构建