# 团队手册：在 git.yami.ink 上传、下载、改代码（零基础版）

> 网址：**https://git.yami.ink** ｜ 账号由管理员统一创建（平台已关闭自助注册，看到「注册已禁用」是正常的）
> 适用对象：会写代码、但**完全没用过 Git** 的同学。
> 一句话：这份手册里九成的操作，**在网页上点几下就完成，电脑上不用装任何东西**。

---

## 〇、先记住三句话

1. **要传文件**：进仓库（仓库 = 一个项目的文件夹，能存文件、看历史、多人一起改）→ 点绿色「上传文件」→ 把文件拖进去 → 底部写一句说明 → 提交。
2. **要拿文件**：进仓库 → 点绿色「代码」按钮 →「下载 ZIP」，解压就是完整项目。
3. **要改代码**：在 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 文件）。全程在浏览器里完成。

1. 打开 **https://git.yami.ink**，用管理员给你的用户名和密码登录。
2. 点进要放文件的**仓库**（例如 `Shixunzhou/handbook`）。
3. 在仓库的文件列表页，点右上方绿色的 **「上传文件」** 按钮。
   - 没看到的话：先点旁边的 **「添加文件」**，下拉菜单里就有「上传文件」（不同版本按钮摆放略有差异，功能一样）。
4. 进入上传页后，把文件从电脑文件夹**直接拖进中间的虚线框**；不想拖就点虚线框，在弹出的窗口里选文件。
   - 可以一次拖多个文件。
   - 单个文件别超过 **100MB**（服务器限制），太大的先压缩或分卷再传。
5. 往下拉到页面最底，在提交说明里写一句人话，例如：`添加迎新活动照片（10 张）`。
6. 点绿色的 **「提交变更」** 按钮。出现文件列表且能看到你刚传的文件，就是成功了。

传完想确认：刷新仓库页，文件列表里有它，且右侧能看到「x 分钟前 · 你的名字」。

**几个常见疑问**

| 疑问                 | 回答                                                                                     |
| -------------------- | ---------------------------------------------------------------------------------------- |
| 传错文件了怎么办？   | 进那个文件页面，点右侧的删除按钮（垃圾桶图标），提交一次删除即可。历史记录还在，不用怕。 |
| 想传整个文件夹？     | 网页上传建议一次少量文件；整个项目文件夹请用第 3 节 A（让 AI 推）或第 4 节。             |
| 传上去别人能看到吗？ | 看仓库设置：公开仓库谁都能看，私有仓库只有被授权的人能看。不确定就问管理员。             |
| 传完还要不要点别的？ | 不用，不需要 push、不需要命令行，网页上这一步就是最终提交。                              |

---

## 二、【我要下载】两种下载方式

### A. 下载整个项目（最常用）

1. 打开仓库首页。
2. 点绿色的 **「代码」** 按钮。
3. 在弹层里选 **「下载 ZIP」**。
4. 浏览器会下载一个 `.zip`，解压就是完整的项目文件夹（不需要 Git，也不能用来提交，纯查看/备份用）。

### B. 只下载一个文件

1. 点开那个文件，进入文件内容页面。
2. 页面右上角有一个**向下的箭头图标**（鼠标悬停显示「下载文件」），点它就把这个文件原样存到电脑。
3. 想直接看纯文本内容（方便复制）：点旁边的 **「原始文件」**，打开后可以右键另存。

---

## 三、【我要改代码】两条路，先看走哪条

| 你的情况                             | 走哪条                        | 要装 Git 吗               |
| ------------------------------------ | ----------------------------- | ------------------------- |
| 改的是项目里的代码、要让全组拿到     | **A. 让 AI 帮你提交**（推荐） | 不用你操心，AI 会执行命令 |
| 只改一个文档 / 笔记 / 配置这类小文件 | **B. 网页上直接改**           | 不用                      |

### A. 推荐：让 AI 帮你提交（Trae / Cursor）

1. 在 Trae 里打开这个项目的文件夹（如果是第一次，先找 AI 要「clone 命令」，见第 4 节第 1 步）。
2. 正常让 AI 帮你改代码。
3. 改完，直接对 AI 说一句（照抄即可）：

   > **先 pull 一下，然后把我这次的改动提交并推送到 git，提交说明写：修复登录按钮不响应**

   为什么要先说「先 pull」：队友可能在你干活的时候推了新代码，先把最新的拿下来，才不会打架。

4. 如果弹出登录框：用户名填 git.yami.ink 的**用户名**（不是邮箱），密码填你的登录密码。Windows 会记住，以后不用再输。
5. 完成标准：刷新 git.yami.ink 的仓库页面，能看到你这次的提交记录，作者是你的名字。

> 已经被 AI 一路带到这一步的同学，可以顺手把这三句话存进备忘录，下次直接复制给 AI：
>
> 1. 先 pull 2) 提交并推送 3) 提交说明写「……」。

### B. 小文件直接改（README、笔记、配置）

1. 打开仓库 → 点开要改的文件（例如 `README.md`）。
2. 点右上角的**铅笔图标「编辑」**。
3. 直接改内容（支持 Markdown，也能即时预览）。
4. 拉到页面最底部，填一句改动说明，例如：`补充周三例会记录`。
5. 点 **「提交变更」**。完成，队友刷新就能看到。

> 适合改文本类小文件（`.md` / `.txt` / `.json` / `.py` 单文件的小改）。
> 要传图片、压缩包、二进制文件，走第 1 节；要改多个文件、要跑本地项目，走 A。

---

## 四、【进阶：手动 Git 四步】（全组一起开发时才需要）

每台电脑**只做一次**准备：

1. 装 Git：https://git-scm.com/download/win ，安装时一路「Next」。
2. 告诉 Git 你是谁（在 Trae 的终端里粘贴运行，引号里换成你自己的）：

```bash
git config --global user.name "你的名字（拼音或网名）"
git config --global user.email "你在第 5 节设置的邮箱"
```

3. 把项目拿下来（clone）：在网页仓库页点绿色「代码」，复制里面的 **HTTPS 地址**，形如 `https://git.yami.ink/组织名/仓库名.git`；然后在电脑上选一个放代码的文件夹，在该文件夹打开终端执行：

```bash
git clone 刚才复制的地址
```

4. 日常四步（每天都一样，背下来就不会出错）：

```bash
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             |

---

## 七、【三条纪律 + 万能兜底】

1. **开工先 pull**（第 4 节第 4 步），再动手改。
2. **尽量各改各的文件**；非改同一个文件不可时，先在群里喊一声。
3. **push 被拒就先 pull 再 push**；两边改了同一处，找 AI 合并，别手工硬删。
4. **万能兜底**：把**整屏报错**复制下来，加上一句「我刚才在做：……」发给 AI（Trae / Claude / ChatGPT），照着它说的做。还搞不定，找管理员。

### 给 AI 的一句话模板（复制粘贴即用）

```text
我在 git.yami.ink 的【项目名】里改了代码。请先 pull，然后把这次的改动提交并推送。
提交说明写：……
```

```text
我执行 git push（或：在网页上传文件）时报了下面的错。我刚才在做：……
请告诉我具体该点哪里 / 输什么命令，一步一步来。

【把整屏报错原样粘在这里】
```

---

> 本手册的网页版在 https://git.yami.ink/Shixunzhou/handbook （团队手册仓库的 README）。
> 页面顶部蓝色横幅、右上角「新手手册」入口，都能一键跳到这里。