视频源码协作指南

用现有 MotionGit 账号，从完整的视频工程开始协作。模板中心负责效果、授权和下载；源码站负责源码、Fork、改进提案和评审。

01 · 先找到允许协作的作品

从模板中心打开作品，先看效果与使用授权，再进入“源码协作”。公开仓库不自动等于已经上架的模板，个人 Fork 也不自动获得市场发布状态。

已关联的仓库顶部提供“预览与下载”和“发布来源”。这里展示的是模板中心版本，可能与当前分支、当前提交不同；Fork 中的入口会明确标注“上游”。

02 · 在自己的 Fork 里修改

  1. 主站与模板Git 共享同一账号，进入仓库即可继续协作。
  2. 阅读 README、guide.json、参数约定和 licenses/。确认源码及素材允许修改、派生与重新分发。
  3. 点击仓库的 Fork，在自己的版本中创建分支，修改内容、参数或编舞，再提交改动。

公开仓库可以匿名 clone；push 需要按源码站账号设置配置 Git 访问凭据。浏览器登录和命令行 Git 认证是两个使用场景，不要把邮箱验证码当作 Git 密码。

Git 导入必须使用注入个人 Key 前的原始源码。不要提交 motiongit.key.json、凭据、私人口播、字幕、成片、node_modules 或其他依赖缓存。

03 · 用改进提案（PR）评审下一版

  1. 打开上游仓库的“改进提案（PR）”，新建提案并选择自己的分支与上游目标分支。
  2. 说明改了什么、解决什么问题、如何验证，以及素材或许可是否变化。不要把私密素材上传为评审附件。
  3. 维护者查看源码差异、静态检查结果和评审意见，再决定是否合并。未通过的检查或权限限制仍由原生系统执行。

改进提案就是 Git 的 Pull Request（合并请求）。当前可评审源码差异；视频同步对比、帧级来源与帧级评审尚未开放。

04 · 合并后，单独构建并提交发布

  1. 维护者选择已进入默认分支的固定提交，由已验证的构建工具生成 .motion 与来源凭证。
  2. 检查工程，分别核对 commit SHA、原始包 SHA256 和 integrity 指纹，再进入主站现有发布流程。
  3. 只有通过检查和发布审核的版本，才进入模板中心供预览和下载。

PR 合并 ≠ 模板发布。Git 版本 / Tags 也不等于模板市场版本。源码站不会自动执行工程或提供一键云端渲染。

查看主站发布入口 → · 阅读 .motion 规范 →

05 · 状态异常时，仍有清楚的去处

  • 模板关联摘要暂时无法加载时，源码浏览和原生 Fork / PR 仍按原有方式使用；不要根据缺少关联入口判断作品是否已发布。
  • 同步更新或重试提示表示摘要可能有延迟，发布来源以主站记录为准。
  • Git 服务暂时不可用时，可继续在模板中心浏览和下载已发布版本。

Git 的分支、合并策略与账号设置等进阶用法，可查阅 Gitea 官方文档。