git-push

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

推送到 ryf1123/seamless-interaction

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

通道	身份	能做什么
SSH（~/.ssh 默认 key）	ryf1123	对 [e-mail]:ryf1123/*.git 读写 ✅
HTTPS 匿名	—	只能读公开仓库；写会报 403 ❌
gh CLI（细粒度 PAT）	ryf1123	只能读元数据，不能建仓库 ❌

结论：所有 git 写操作走 SSH。

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

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

标准流程

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

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

规则

• 远端固定 [e-mail]:ryf1123/seamless-interaction.git，主分支 main，不要改 https。
• 只有用户要求时才提交/推送。
• 推送前确认 .gitignore 排除了 .venv/、data/、runs/。
• docs/figs/*.png 和 *.gif 要进 git（文档要用）。
• videos/*.mp4 也要进 git：教学视频都压在 600 KB 以内，进了 git 才能从 GitHub 直接看。渲染中间产物（_atlas_*、*.wav）不进。