team-guide/使用指南.md

团队 Gitea 使用指南

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

另外两份文档：AI 工具说明 ｜ 协作规范

1. 第一次登录

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

2. 改名字和头像

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

3. 新建仓库（项目）

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

4. 在网页上传 / 修改文件

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

5. 用电脑克隆 / 推送（HTTPS，推荐新手）

仓库页面右侧复制 HTTPS 地址，格式：

https://git.yjsnpitext1145141.top/你的用户名/仓库名.git

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	代码审查机器人「审查」