自动构建
约 455 字大约 2 分钟
2025-11-20
🎯 问题
启用内容分离后,内容仓库 (Mizuki-Content) 更新不会自动触发代码仓库 (Mizuki) 的重新部署。
✅ 解决方案 (推荐)
使用 Repository Dispatch 让内容更新时自动触发构建,适用于所有部署平台。
📝 5 步快速配置
Step 1: 创建 GitHub Token
访问: https://github.com/settings/tokens
- 点击 Generate new token (classic)
- Note:
Mizuki Content Trigger - Scopes: 勾选 ✅
repo - 点击生成并复制 Token ⚠️ (只显示一次)
Step 2: 添加 Secret
在内容仓库 (Mizuki-Content):
Settings → Secrets and variables → Actions → New repository secret
- Name:
DISPATCH_TOKEN - Secret: 粘贴刚才的 Token
Step 3: 修改触发器配置
编辑内容仓库的 .github/workflows/trigger-build.yml
找到第 27 行,修改为你的代码仓库:
repository: your-username/Mizuki # 改为你的例如: matsuzaka-yuki/Mizuki
Step 4: 更新代码仓库工作流
编辑代码仓库的 .github/workflows/deploy.yml
在 on: 部分添加:
on:
push:
branches:
- main
repository_dispatch: # 👈 添加这个
types:
- content-updated
workflow_dispatch:Step 5: 测试
在内容仓库推送一次:
git add .
git commit -m "test: trigger build"
git push查看:
- 内容仓库 Actions - 确认触发器运行
- 代码仓库 Actions - 确认部署被触发
🔍 故障排查
Token 问题
错误: Bad credentials
解决:
- 确认 Token 复制完整
- 确认 Token 有
repo权限 - 重新生成 Token
仓库名称问题
错误: Not Found
解决:
- 确认格式:
owner/repo(用斜杠分隔) - 确认拼写正确
- 示例:
matsuzaka-yuki/Mizuki
代码仓库未触发
检查:
💡 提示
配置成功后:
- ✅ 内容仓库每次推送都会自动触发部署
- ✅ 可在 Actions 页面查看触发历史
- ✅ 支持手动触发 (workflow_dispatch)
配置时间: 约 5 分钟
一次配置,长期有效 ✨