🔥 Firefly 更新逻辑设计

1
interface UpdateStatus {
2
  hasContentUpdate: boolean;      // 是否有写作内容更新
3
  hasFrontendUpdate: boolean;     // 是否有前端代码更新
4
  hasBackendUpdate: boolean;      // 是否有后端代码更新
5
  lastChecked: Date;              // 最后检测时间
6
  latestCommit: string;           // 远程最新 commit SHA
7
  currentCommit: string;          // 本地当前 commit SHA
8
  contentChanges: string[];       // content 变更文件列表
9
  frontendChanges: string[];      // 前端变更文件列表
10
  backendChanges: string[];       // 后端变更文件列表
11
}

1
// 检测 content 目录是否有变更
2
const hasContentUpdate = diffFiles.some(file =>
3
  file.startsWith('src/content/')
4
);
5

6
// 获取 content 变更详情
7
const contentChanges = diffFiles.filter(file =>
8
  file.startsWith('src/content/')
9
);

1
GitHub 推送
2
    ↓
3
Webhook 触发 / 定时检测
4
    ↓
5
检测到 content 目录有更新
6
    ↓
7
自动执行：git pull → pnpm build → 部署前端
8
    ↓
9
用户访问博客即可看到新文章

1
// 检测前端代码是否有变更（排除 content）
2
const hasFrontendUpdate = diffFiles.some(file =>
3
  file.startsWith('src/') &&
4
  !file.startsWith('src/content/')
5
);
6

7
// 获取前端变更详情
8
const frontendChanges = diffFiles.filter(file =>
9
  file.startsWith('src/') &&
10
  !file.startsWith('src/content/')
11
);

1
检测到前端代码有更新
2
    ↓
3
后台显示醒目提示："发现前端更新，是否立即更新？"
4
    ↓
5
用户点击"更新"按钮
6
    ↓
7
执行：git pull → pnpm build → 部署前端
8
    ↓
9
更新完成提示

1
┌─────────────────────────────────────────────┐
2
│  ⚠️ 发现前端更新！                           │
3
│                                             │
4
│  更新内容：                                  │
5
│  • 修改了导航栏样式                          │
6
│  • 新增了深色模式支持                        │
7
│  • 修复了移动端布局问题                      │
8
│                                             │
9
│  更新时间：2024-01-01 12:00                 │
10
│                                             │
11
│  [立即更新]  [稍后提醒]                      │
12
└─────────────────────────────────────────────┘

1
// 检测 admin 目录是否有变更
2
const hasBackendUpdate = diffFiles.some(file =>
3
  file.startsWith('admin/')
4
);
5

6
// 获取后端变更详情
7
const backendChanges = diffFiles.filter(file =>
8
  file.startsWith('admin/')
9
);

1
检测到后端代码有更新
2
    ↓
3
后台显示醒目提示："发现后端更新，是否立即更新？"
4
    ↓
5
用户点击"更新"按钮
6
    ↓
7
执行：git stash（保存本地配置）
8
    ↓
9
执行：git pull → 更新依赖 → 构建后端 → PM2 重启
10
    ↓
11
执行：git stash pop（恢复本地配置）
12
    ↓
13
更新完成提示

1
let isUpdating = false;
2

3
async function performUpdate(type: 'content' | 'frontend' | 'backend') {
4
  if (isUpdating) {
5
    throw new Error('正在执行其他更新，请稍后重试');
6
  }
7

8
  try {
9
    isUpdating = true;
10
    // 执行更新逻辑
11
  } finally {
12
    isUpdating = false;
13
  }
14
}

1
后台编辑文章
2
    ↓
3
保存到本地文件
4
    ↓
5
本地推送文章到 GitHub
6
    ↓
7
服务器检测到冲突
8
    ↓
9
提示用户："检测到冲突，请手动解决"
10
    ↓
11
用户选择：保留服务器版本 / 保留 GitHub 版本 / 手动合并

1
本地开发完成
2
    ↓
3
git commit + push
4
    ↓
5
服务器检测到更新
6
    ↓
7
根据更新类型执行对应操作：
8
    ├── 内容更新 → 自动构建前端 → 部署到 Nginx
9
    ├── 前端更新 → 用户确认 → 构建前端 → 部署到 Nginx
10
    └── 后端更新 → 用户确认 → 构建后端 → PM2 重启

1
GET /api/system/check-update

1
POST /api/system/update-content

1
{
2
  "code": 200,
3
  "message": "内容更新完成",
4
  "data": {
5
    "updatedFiles": ["src/content/posts/new-article.md"],
6
    "buildTime": "3.5s"
7
  }
8
}

1
POST /api/system/update-frontend

1
{
2
  "code": 200,
3
  "message": "前端更新完成",
4
  "data": {
5
    "updatedFiles": ["src/components/Navbar.astro"],
6
    "buildTime": "15.2s"
7
  }
8
}

1
POST /api/system/update-backend

1
{
2
  "code": 200,
3
  "message": "后端更新完成",
4
  "data": {
5
    "updatedFiles": ["admin/controllers/postsController.ts"],
6
    "restartTime": "2.1s"
7
  }
8
}

1
┌─────────────────────────────────────────────┐
2
│  更新历史                                   │
3
│                                             │
4
│  [内容] 2024-01-01 12:00  自动更新成功       │
5
│    • 新增文章：《我的第一篇博客》             │
6
│                                             │
7
│  [前端] 2024-01-01 10:30  用户确认更新       │
8
│    • 更新导航栏组件                          │
9
│                                             │
10
│  [后端] 2024-01-01 09:00  用户确认更新       │
11
│    • 修复文章加密问题                        │
12
└─────────────────────────────────────────────┘