🚨 重复问题追踪 - 必须根治

问题1: GitHub Pages 部署不同步

发生次数

• 2026-03-11: 首次记录，花费2天调试
• 2026-03-16: 再次发生（今天）

根本原因

每次更新 docs/ 后，忘记同步到根目录。

为什么反复发生？

1. 没有强制检查流程
2. 踩坑记录存在但不被主动查阅
3. 没有自动化脚本

根治方案

方案A: 自动化脚本（推荐）

创建 deploy.sh：

#!/bin/bash
# 部署脚本 - 必须通过这个脚本部署

echo "🚀 开始部署..."

# 1. 同步 docs 到根目录
cp -r docs/* .
echo "✅ 已同步 docs/ 到根目录"

# 2. 检查关键文件
if [ ! -f "index.html" ]; then
    echo "❌ 错误: 根目录缺少 index.html"
    exit 1
fi

if [ ! -f "CNAME" ]; then
    echo "❌ 错误: 根目录缺少 CNAME"
    exit 1
fi

echo "✅ 关键文件检查通过"

# 3. Git 操作
git add -A
git commit -m "Deploy: $(date '+%Y-%m-%d %H:%M')"
git push origin master

echo "✅ 部署完成！等待2-5分钟后刷新网站"
echo "验证命令: curl -sH 'Cache-Control: no-cache' https://chinahospitalsguide.com/ | grep '<title>'"

方案B: GitHub Actions 自动同步

创建 .github/workflows/sync-docs.yml：

name: Sync docs to root
on:
  push:
    paths:
      - 'docs/**'
jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: cp -r docs/* .
      - run: git add -A && git commit -m "Auto-sync docs to root" && git push

立即执行

• [ ] 创建 deploy.sh 脚本
• [ ] 以后只通过脚本部署
• [ ] 考虑配置 GitHub Actions 自动同步

教训

"记录不等于记住，记住不等于执行"

需要把检查清单固化到：

1. 自动化脚本（减少人为失误）
2. 强制流程（每次部署前必须执行检查）
3. 定期回顾（每周检查重复问题）

记录日期: 2026-03-16 问题状态: 已临时解决，待根治