71 行
3.0 KiB
Markdown
71 行
3.0 KiB
Markdown
# 团队 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 | 代码审查机器人「审查」 |
|