git-push

name	git-push
description	把本项目推送到 GitHub（ryf1123/starvla）的正确方式，以及这台机器上 git/gh 权限的说明。提交、推送、拉取、查看远端状态时使用。

推送到 ryf1123/starvla

权限现状（2026-08-23 验证）

通道	身份	能做什么
SSH（~/.ssh 默认 key）	ryf1123	对 [e-mail]:ryf1123/starvla.git 读写 ✅
gh CLI（细粒度 PAT）	ryf1123	只能读元数据，不能建仓库 ❌

结论：所有 git 操作走 SSH。

已知现象：受限环境下 SSH 出网会失败

git push / fetch / ls-remote 报 ERROR: Repository not found. 时， 先判断是不是执行环境限制了出网（同一条命令在用户终端能跑通就是）。 处理方法：把命令以 bash 代码块交给用户执行。纯本地命令不受影响。

标准流程

git add -A && git commit -m "<one-line English summary>

Co-Authored-By: Claude Fable 5 <[e-mail]>"
git push origin main

规则

• 远端固定 [e-mail]:ryf1123/starvla.git，主分支 main，不要改 https。
• 只有用户要求时才提交/推送。
• 推送前确认 .gitignore 排除了 .venv/、third_party/、data/、runs/、videos/*.mp4。