# 团队 Gitea 使用指南

地址：**https://git.yjsnpitext1145141.top/**　管理员：**milo（马铭喆）**

> 另外两份文档：[AI 工具说明](AI工具说明.md) ｜ [协作规范](协作规范.md)

## 1. 第一次登录
1. 打开上面的地址，点右上角「登录」。
2. 输入管理员发给你的用户名和初始密码。
3. 系统会要求你**设置新密码**，设一个自己记得住的，别告诉别人。

## 2. 改名字和头像
右上角头像 → 「设置」→「个人信息」：改「全名」后点「更新个人信息」。头像在「头像」里上传图片。

## 3. 新建仓库（项目）
1. 右上角「＋」→「新建仓库」。
2. 填仓库名称（英文小写，如 `my-first-app`）。
3. **勾选「私有」**（默认都建私有）。
4. 勾上「初始化仓库」，点「创建仓库」。
5. 建好后按 [协作规范](协作规范.md) 添加 `reviewer`、`teacher1`、`teacher2` 为协作者。

## 4. 在网页上传 / 修改文件
- 上传：进仓库 →「添加文件」→「上传文件」→ 拖进去 → 写一句说明 →「提交变更」。
- 修改：点开文件 → 右上角铅笔图标 → 改完 → 写说明 →「提交变更」。

## 5. 用电脑克隆 / 推送（HTTPS，推荐新手）
仓库页面右侧复制 HTTPS 地址，格式：
```
https://git.yjsnpitext1145141.top/你的用户名/仓库名.git
```
```bash
git clone https://git.yjsnpitext1145141.top/你的用户名/仓库名.git
cd 仓库名
# 改代码后
git add .
git commit -m "新增登录页面"
git push
```
推送时问用户名和密码：用户名填你的用户名，密码填你的登录密码或**访问令牌（推荐）**。

### 创建访问令牌（token）
1. 头像 →「设置」→「应用」。
2. 「管理访问令牌」处填个名字（如 `my-laptop`）。
3. 权限里把 **repository** 选为「读写」，user 选「读」。
4. 点「生成令牌」，**马上复制保存**（只显示一次）。
5. 以后 git 或 AI 工具要密码时，粘贴这个令牌。

（会用 SSH 的同学：SSH 端口是 **2222**，地址 `ssh://git@git.yjsnpitext1145141.top:2222/用户名/仓库名.git`，先在「设置 → SSH/GPG 密钥」添加公钥。）

## 6. 忘记密码
直接找管理员 **milo（马铭喆）** 重置。

## 常见问题
- **看不到别人的仓库？** 私有仓库要对方把你加为协作者。
- **push 被拒绝 / 403？** 检查令牌权限是否勾了 repository 读写；或你没有该仓库写权限。
- **一直弹密码框？** 密码要填令牌，不是邮箱；输错可在系统「凭据管理器/钥匙串」里删掉旧的再试。
- **界面是英文？** 页面底部语言选「简体中文」。
- **不小心传了密码/密钥？** 立刻告诉 milo，并把那个密码改掉。

## 团队成员
| 用户名 | 姓名 |
|---|---|
| milo | 马铭喆（管理员） |
| xuzhaojia | 许兆嘉 |
| lijiatong | 李嘉桐 |
| weiheting | 魏赫廷 |
| gaozihan | 高子涵 |
| teacher1 | 指导老师1 |
| teacher2 | 指导老师2 |
| reviewer | 代码审查机器人「审查」 |