Files
wr.do/content/docs/developer/sync-zh.mdx
2025-06-30 17:16:38 +08:00

55 lines
1.9 KiB
Plaintext

---
title: 自动同步更新
description: 自动同步上游仓库代码,触发 Vercel 自动部署
---
<DocsLang en="/docs/developer/sync" zh="/docs/developer/sync-zh" />
本项目配置了与上游仓库 [oiov/wr.do](https://github.com/oiov/wr.do) 的同步工作流,支持:
- 🔄 **手动触发同步** - 默认关闭自动同步,完全控制同步时机
- 💬 **同步后自动评论** - 在相关 commit 上添加详细的同步信息
- 🚨 **智能错误处理** - 同步失败时自动创建详细的 Issue
- 🧹 **自动清理通知** - 自动关闭之前的同步失败 Issue
### 如何手动触发同步
#### 方法 1: 通过 GitHub Web 界面
1. 进入仓库的 **Actions** 页面
2. 在左侧选择 **"上游同步 | Upstream Sync"** 工作流
3. 点击 **"Run workflow"** 按钮
4. 选择是否在同步后添加评论(默认开启)
5. 点击 **"Run workflow"** 确认执行
#### 方法 2: 通过 GitHub CLI
```bash
# 安装并登录 GitHub CLI
gh auth login
# 触发同步工作流
gh workflow run "上游同步 | Upstream Sync" --repo your-username/wr.do
# 查看工作流运行状态
gh run list --workflow="上游同步 | Upstream Sync" --repo your-username/wr.do
```
### 同步状态查看
- **工作流历史**: 在 Actions 页面查看 "上游同步 | Upstream Sync" 工作流的运行记录
- **同步评论**: 同步成功后会在最新 commit 上添加包含同步时间、源仓库信息等的评论
- **错误报告**: 同步失败时会自动创建包含详细错误信息和解决方案的 Issue
### 常见问题解决
**合并冲突**: 如遇到合并冲突,需要手动解决:
```bash
git clone https://github.com/your-username/wr.do.git
cd wr.do
git remote add upstream https://github.com/oiov/wr.do.git
git fetch upstream
git merge upstream/main
# 解决冲突后提交并推送
```
**权限问题**: 确保仓库的 Actions 权限已启用,并在设置中允许 GitHub Actions 创建和批准 pull requests。