14 KiB
团队手册：在 git.yami.ink 上传、下载、改代码（零基础版）
网址：https://git.yami.ink ｜ 账号由管理员统一创建（平台已关闭自助注册，看到「注册已禁用」是正常的） 适用对象：会写代码、但完全没用过 Git 的同学。 一句话：这份手册里九成的操作，在网页上点几下就完成，电脑上不用装任何东西。
〇、先记住三句话
- 要传文件：进仓库（仓库 = 一个项目的文件夹，能存文件、看历史、多人一起改）→ 点绿色「上传文件」→ 把文件拖进去 → 底部写一句说明 → 提交。
- 要拿文件：进仓库 → 点绿色「代码」按钮 →「下载 ZIP」，解压就是完整项目。
- 要改代码：在 Trae（或 Cursor）里跟 AI 说一句「帮我把改动提交并推送到 git」，让它去敲命令。
不用装任何东西也能用：上面第 1、2 件事，还有「改一个小文件」，都不需要装 Git、不需要命令行、不需要背任何命令，有浏览器就行。 只有「全组一起开发同一个项目（要跑本地、要拉别人的改动）」才需要装 Git，见第 4 节；装和配也可以让 AI 代劳。
先看这张表：你想干的事 ↔ 该用哪种做法
| 你想干的事 | 用哪种做法 | 要装 Git 吗 | 看第几节 |
|---|---|---|---|
| 传几张图 / 一个文档 / 一个压缩包 | 网页「上传文件」，拖进去 | 不用 | 1 |
| 把整个项目下载到电脑 | 网页「代码」→「下载 ZIP」 | 不用 | 2 |
| 只下载某一个文件 | 文件页面的下载按钮 | 不用 | 2 |
| 改 README、改笔记、改配置 | 网页「编辑」→「提交变更」 | 不用 | 3-B |
| 改了代码，要让队友看到 | 让 AI 帮你提交推送 | 不用你操心 | 3-A |
| 全组一起做同一个项目 | clone / pull / push | 要 | 4 |
顶部那条蓝色横幅就是入口：横幅上的《3 分钟上手指南》指向本手册，「团队仓库」直接跳到全组的仓库列表。
一、【我要传文件】网页拖拽上传（不用 Git）
适合：传单个或少量文件（图片、文档、压缩包、一份 .py 文件）。全程在浏览器里完成。
- 打开 https://git.yami.ink，用管理员给你的用户名和密码登录。
- 点进要放文件的仓库（例如
Shixunzhou/handbook）。 - 在仓库的文件列表页，点右上方绿色的 「上传文件」 按钮。
- 没看到的话：先点旁边的 「添加文件」，下拉菜单里就有「上传文件」（不同版本按钮摆放略有差异，功能一样）。
- 进入上传页后，把文件从电脑文件夹直接拖进中间的虚线框；不想拖就点虚线框，在弹出的窗口里选文件。
- 可以一次拖多个文件。
- 单个文件别超过 100MB（服务器限制），太大的先压缩或分卷再传。
- 往下拉到页面最底，在提交说明里写一句人话，例如：
添加迎新活动照片（10 张）。 - 点绿色的 「提交变更」 按钮。出现文件列表且能看到你刚传的文件，就是成功了。
传完想确认：刷新仓库页，文件列表里有它，且右侧能看到「x 分钟前 · 你的名字」。
几个常见疑问
| 疑问 | 回答 |
|---|---|
| 传错文件了怎么办？ | 进那个文件页面，点右侧的删除按钮（垃圾桶图标），提交一次删除即可。历史记录还在，不用怕。 |
| 想传整个文件夹？ | 网页上传建议一次少量文件；整个项目文件夹请用第 3 节 A（让 AI 推）或第 4 节。 |
| 传上去别人能看到吗？ | 看仓库设置：公开仓库谁都能看，私有仓库只有被授权的人能看。不确定就问管理员。 |
| 传完还要不要点别的？ | 不用，不需要 push、不需要命令行，网页上这一步就是最终提交。 |
二、【我要下载】两种下载方式
A. 下载整个项目（最常用）
- 打开仓库首页。
- 点绿色的 「代码」 按钮。
- 在弹层里选 「下载 ZIP」。
- 浏览器会下载一个
.zip，解压就是完整的项目文件夹（不需要 Git，也不能用来提交，纯查看/备份用）。
B. 只下载一个文件
- 点开那个文件，进入文件内容页面。
- 页面右上角有一个向下的箭头图标（鼠标悬停显示「下载文件」），点它就把这个文件原样存到电脑。
- 想直接看纯文本内容（方便复制）：点旁边的 「原始文件」，打开后可以右键另存。
三、【我要改代码】两条路，先看走哪条
| 你的情况 | 走哪条 | 要装 Git 吗 |
|---|---|---|
| 改的是项目里的代码、要让全组拿到 | A. 让 AI 帮你提交（推荐） | 不用你操心，AI 会执行命令 |
| 只改一个文档 / 笔记 / 配置这类小文件 | B. 网页上直接改 | 不用 |
A. 推荐：让 AI 帮你提交（Trae / Cursor）
-
在 Trae 里打开这个项目的文件夹（如果是第一次，先找 AI 要「clone 命令」，见第 4 节第 1 步）。
-
正常让 AI 帮你改代码。
-
改完，直接对 AI 说一句（照抄即可）：
先 pull 一下，然后把我这次的改动提交并推送到 git，提交说明写：修复登录按钮不响应
为什么要先说「先 pull」：队友可能在你干活的时候推了新代码，先把最新的拿下来，才不会打架。
-
如果弹出登录框：用户名填 git.yami.ink 的用户名（不是邮箱），密码填你的登录密码。Windows 会记住，以后不用再输。
-
完成标准：刷新 git.yami.ink 的仓库页面，能看到你这次的提交记录，作者是你的名字。
已经被 AI 一路带到这一步的同学，可以顺手把这三句话存进备忘录，下次直接复制给 AI：
- 先 pull 2) 提交并推送 3) 提交说明写「……」。
B. 小文件直接改（README、笔记、配置）
- 打开仓库 → 点开要改的文件（例如
README.md）。 - 点右上角的铅笔图标「编辑」。
- 直接改内容（支持 Markdown，也能即时预览）。
- 拉到页面最底部，填一句改动说明，例如：
补充周三例会记录。 - 点 「提交变更」。完成，队友刷新就能看到。
适合改文本类小文件（
.md/.txt/.json/.py单文件的小改）。 要传图片、压缩包、二进制文件，走第 1 节；要改多个文件、要跑本地项目，走 A。
四、【进阶：手动 Git 四步】（全组一起开发时才需要）
每台电脑只做一次准备：
- 装 Git：https://git-scm.com/download/win ，安装时一路「Next」。
- 告诉 Git 你是谁（在 Trae 的终端里粘贴运行，引号里换成你自己的）：
git config --global user.name "你的名字（拼音或网名）"
git config --global user.email "你在第 5 节设置的邮箱"
- 把项目拿下来（clone）：在网页仓库页点绿色「代码」，复制里面的 HTTPS 地址，形如
https://git.yami.ink/组织名/仓库名.git；然后在电脑上选一个放代码的文件夹，在该文件夹打开终端执行：
git clone 刚才复制的地址
- 日常四步（每天都一样，背下来就不会出错）：
cd 项目文件夹 # 进入 clone 下来的那个目录
git pull # ① 开工第一步：把队友的最新改动拿下来
# ......正常写你的代码......
git add . # ② 把改动挑出来（add = "这些都要提交"）
git commit -m "一句话说明改了什么，例如：修复登录按钮不响应" # ③ 存成一个带说明的快照
git push # ④ 传上去，队友就能看到
口诀：开工先 pull，改完 add + commit，收工 push。
术语速查：提交（commit）= 给这次改动拍一张带说明的快照；pull= 把服务器上别人的最新内容拿下来；push= 把自己电脑上的提交传上去；分支（branch）= 同一份代码的平行版本线，你们暂时只需要用默认的
main这条主线，不用管分支。
五、【账号设置】（登录后花两分钟做完）
点右上角头像 → 「设置」，都在左侧「账号」这一页：
| 我要做的事 | 点哪里 | 注意 |
|---|---|---|
| 改密码 | 设置 → 账号 → 最上方「修改密码」 | 填旧密码 + 新密码；改完记得同步更新 Windows 记住的密码 |
| 改邮箱 | 设置 → 账号 → 往下找「管理邮箱地址」→ 底部填新邮箱 → 点「添加」 | 不需要收验证邮件，加完立即生效；加完把旧的删掉 |
| 界面切成中文 | 设置 → 「外观」→ Language 选「简体中文」→ 保存 | 平台已把中文设为默认，一般不用改 |
| 忘记密码 | 找管理员重置 | 平台没配邮件服务，网页上的「忘记密码」点不出结果，这是正常的 |
邮箱最好和第 4 节
git config里填的一致，这样你的提交在网页上才会正确显示成你的名字。
六、【常见报错对照表】
看到报错别慌，先在表里找关键词；找不到就把整屏复制给 AI（第 7 节）。
网页上（不用 Git 的那部分）
| 你看到的 | 什么意思 | 怎么办 |
|---|---|---|
| 打不开注册页 / 提示注册已禁用 | 平台是邀请制，账号由管理员建 | 直接找管理员要账号 |
| 登录提示用户名或密码错误 | 账号不对 | 用户名填用户名（不是邮箱）；改过密码就用新密码 |
| 上传时提示文件过大 / 转圈后失败 | 超过服务器 100MB 上限 | 先压缩，或分几次传 |
| 看不到某个仓库 / 打开是 404 | 没登录，或这个仓库没给你权限 | 先确认登录了；仍不行找管理员把你加进组织 |
| 点了「提交变更」没反应 | 多半是没填提交说明，或网络中断 | 填一句说明再提交；刷新页面重试 |
| 编辑页改完不知道点哪 | 按钮在页面最底部 | 拉到最底，点「提交变更」 |
命令行 / AI 帮你跑 git 时
| 报错关键词 | 什么意思（人话） | 怎么办 |
|---|---|---|
Please tell me who you are |
电脑上的 Git 还不知道你是谁 | 做第 4 节的 git config 那两条命令 |
Authentication failed / 一直弹登录框 |
用户名或密码不对 | 用户名填 git.yami.ink 的用户名；密码用新密码 |
! [rejected] ... fetch first / Updates were rejected |
服务器上有你电脑里没有的内容（队友先推了） | 先 git pull，再 git push |
CONFLICT (content) / 提示冲突 |
你和队友改了同一个文件的同一处 | 别硬来，整屏复制给 AI，让它帮你选保留哪一版 |
not a git repository |
当前文件夹不是项目目录 | cd 到 clone 下来的那个文件夹再执行 |
nothing to commit |
没有检测到改动 | 确认文件已保存、且改的是项目目录里的文件 |
fatal: unable to access ... / 一直转圈超时 |
网络问题 | 换手机热点试试；或先用网页上传（第 1 节）应急 |
error: failed to push some refs |
推不上去，多半是落后于服务器 | 先 pull，再 push；还不行复制给 AI |
七、【三条纪律 + 万能兜底】
- 开工先 pull（第 4 节第 4 步），再动手改。
- 尽量各改各的文件；非改同一个文件不可时，先在群里喊一声。
- push 被拒就先 pull 再 push；两边改了同一处，找 AI 合并，别手工硬删。
- 万能兜底：把整屏报错复制下来，加上一句「我刚才在做：……」发给 AI（Trae / Claude / ChatGPT），照着它说的做。还搞不定，找管理员。
给 AI 的一句话模板（复制粘贴即用）
我在 git.yami.ink 的【项目名】里改了代码。请先 pull，然后把这次的改动提交并推送。
提交说明写：……
我执行 git push（或：在网页上传文件）时报了下面的错。我刚才在做：……
请告诉我具体该点哪里 / 输什么命令，一步一步来。
【把整屏报错原样粘在这里】
本手册的网页版在 https://git.yami.ink/Shixunzhou/handbook （团队手册仓库的 README）。 页面顶部蓝色横幅、右上角「新手手册」入口，都能一键跳到这里。