chore(deploy): add Cloudflare Pages deployment workflow

- Add GitHub Actions workflow for auto-deploy to Cloudflare Pages
- Update astro.config.mjs with production site URL
- Update web/README.md with deployment docs
- Make relatedSessions optional in content schema (default [])
- Fix missing relatedSessions in 3 article files
- Add test to ensure all articles have relatedSessions field

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: OneeMe

.github/workflows/deploy-web.yml

@@ -0,0 +1,43 @@
+name: Deploy Web to Cloudflare Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'web/**'
+      - '.github/workflows/deploy-web.yml'
+  workflow_dispatch:
+
+concurrency:
+  group: deploy-web
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      deployments: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          cache-dependency-path: 'web/package-lock.json'
+
+      - name: Install dependencies
+        working-directory: web
+        run: npm ci
+
+      - name: Build
+        working-directory: web
+        run: npm run build
+
+      - name: Deploy to Cloudflare Pages
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy web/dist --project-name=wwdc-quick-look

test/wwdc-quick-look/article-related-sessions-field.test.mjs

@@ -0,0 +1,46 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import path from 'node:path';
+import { describe, it } from 'node:test';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PROJECT_ROOT = path.resolve(__dirname, '../..');
+const ARTICLES_DIR = path.join(PROJECT_ROOT, 'web/src/content/articles');
+
+function hasRelatedSessions(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+
+  const frontMatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!frontMatterMatch) {
+    return { ok: false, reason: 'no-frontmatter' };
+  }
+
+  const frontMatter = frontMatterMatch[1];
+  if (!frontMatter.includes('relatedSessions')) {
+    return { ok: false, reason: 'missing-relatedSessions' };
+  }
+
+  return { ok: true };
+}
+
+describe('article relatedSessions field', () => {
+  const files = fs.readdirSync(ARTICLES_DIR).filter((f) => f.endsWith('.mdx'));
+  const missing = [];
+
+  for (const f of files) {
+    const filePath = path.join(ARTICLES_DIR, f);
+    const result = hasRelatedSessions(filePath);
+    if (!result.ok) {
+      missing.push({ file: f, reason: result.reason });
+    }
+  }
+
+  it('every MDX article has a relatedSessions field in frontmatter', () => {
+    const msg = missing.length > 0
+      ? `${missing.length} file(s) missing relatedSessions field:\n` +
+        missing.map(m => `  - ${m.file} (${m.reason})`).join('\n')
+      : undefined;
+    assert.strictEqual(missing.length, 0, msg);
+  });
+});

web/README.md

@@ -1,43 +1,55 @@
-# Astro Starter Kit: Minimal
+# :globe_with_meridians: wwdc-quick-look Web
 
-```sh
-npm create astro@latest -- --template minimal
+Astro 构建的 wwdc-quick-look 静态站点，部署在 Cloudflare Pages。
+
+## 开发
+
+```bash
+cd web
+npm install
+npm run dev      # localhost:4321
+npm run build    # 输出到 web/dist/
+npm run preview  # 本地预览构建结果
 ```
 
-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+## 部署
 
-## 🚀 Project Structure
+推送至 `main` 分支且变更涉及 `web/**` 路径时，GitHub Actions 会自动构建并部署到 Cloudflare Pages。
 
-Inside of your Astro project, you'll see the following folders and files:
+也可手动触发：在 GitHub 仓库 → Actions → "Deploy Web to Cloudflare Pages" → Run workflow。
 
-```text
-/
-├── public/
-├── src/
-│   └── pages/
-│       └── index.astro
-└── package.json
-```
+### 必需的 Secrets
 
-Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
+在仓库 Settings → Secrets and variables → Actions 中配置：
 
-There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
+| Secret | 说明 |
+|--------|------|
+| `CLOUDFLARE_API_TOKEN` | Cloudflare API Token（需包含 `Cloudflare Pages:Edit` 权限） |
+| `CLOUDFLARE_ACCOUNT_ID` | Cloudflare Account ID |
 
-Any static assets, like images, can be placed in the `public/` directory.
+获取方式：
+- **API Token**: Cloudflare Dashboard → My Profile → API Tokens → Create Token → 使用 "Custom token" 模板，权限添加 `Zone:Read` 和 `Cloudflare Pages:Edit`
+- **Account ID**: Cloudflare Dashboard 右侧边栏可见
 
-## 🧞 Commands
+### 首次创建 Pages 项目
 
-All commands are run from the root of the project, from a terminal:
+若 Cloudflare Pages 上尚未创建 `wwdc-quick-look` 项目，可通过 Wrangler CLI 创建：
 
-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npm run build`           | Build your production site to `./dist/`          |
-| `npm run preview`         | Preview your build locally, before deploying     |
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
+```bash
+npx wrangler pages project create wwdc-quick-look --production-branch=main
+```
 
-## 👀 Want to learn more?
+## 项目结构
 
-Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).
+```
+web/
+├── public/          # 静态资源（favicon、图片等）
+├── src/
+│   ├── components/  # Astro 组件
+│   ├── layouts/     # 页面布局
+│   ├── pages/       # 路由页面
+│   ├── content/     # MDX 文章集合
+│   └── i18n/        # 文案配置
+├── astro.config.mjs # Astro 配置
+└── package.json
+```

web/astro.config.mjs

@@ -3,4 +3,5 @@ import mdx from '@astrojs/mdx';
 
 export default defineConfig({
   integrations: [mdx()],
+  site: 'https://wwdc-quick-look.swiftgg.team',
 });

web/src/content.config.ts

@@ -24,7 +24,7 @@ const articles = defineCollection({
         code: z.string(),
         description: z.string(),
       })
-    ),
+    ).optional().default([]),
   }),
 });
 

web/src/content/articles/wwdc2026-111.mdx

@@ -7,6 +7,7 @@ thumbnail: "/images/sessions/2026/111.jpg"
 videoUrl: "https://developer.apple.com/videos/play/wwdc2026/111/"
 sessionId: "wwdc2026-111"
 year: "2026"
+relatedSessions: []
 ---
 
 ## Highlight

web/src/content/articles/wwdc2026-112.mdx

@@ -7,6 +7,7 @@ thumbnail: "/images/sessions/2026/112.jpg"
 videoUrl: "https://developer.apple.com/videos/play/wwdc2026/112/"
 sessionId: "wwdc2026-112"
 year: "2026"
+relatedSessions: []
 ---
 
 ## Highlight

web/src/content/articles/wwdc2026-394.mdx

@@ -7,6 +7,7 @@ thumbnail: "/images/sessions/2026/394.jpg"
 videoUrl: "https://developer.apple.com/videos/play/wwdc2026/394/"
 sessionId: "wwdc2026-394"
 year: "2026"
+relatedSessions: []
 ---
 
 ## Highlight