# 新手指南

欢迎使用私有 Git：**https://git.profer.cn**

这份指南只讲「怎么用」，不需要懂命令行。

---

## 一、网页上怎么用

### 1. 新建一个仓库（项目）

右上角 `+` → **新建仓库** → 填仓库名（建议英文，如 `my-notes`）→ 选择「私有」或「公开」→ 点创建。

> 私人资料建议选「私有」，只有你自己能看到。

### 2. 上传文件

进入仓库 → 点 **上传文件** → 把文件或整个文件夹拖进去 → 下方填一句说明（如「第一次上传」）→ 点 **提交更改**。

### 3. 修改文件

点开文件名 → 右上角铅笔图标 → 改完 → 提交。

### 4. 查看历史、找回旧版本

仓库页 → **提交** 列表 → 点某次提交看改了什么；需要旧版本时，点文件 → **历史** → 下载当时的版本。

### 5. 下载整个项目

仓库页 → 绿色 **克隆** 按钮 → **下载 ZIP**。

---

## 二、让 AI 帮你操作

把下面这段发给 AI（Profer / Claude / ChatGPT 都可以），它就能直接帮你建仓库、传文件、改内容、查历史：

```text
Git 服务器：https://git.profer.cn
API 地址：https://git.profer.cn/api/v1
我的账号：yuan
访问令牌（Token）：<在这里粘贴你的 Token>

请用这个 Token 通过 Gitea REST API 帮我操作仓库。
请求头统一加：Authorization: token <TOKEN>

常用操作：
- 列出我的仓库：GET /user/repos
- 新建仓库：POST /user/repos  body: {"name":"xxx","private":true,"auto_init":true}
- 读文件：GET /repos/yuan/{repo}/contents/{path}
- 上传/更新文件：PUT /repos/yuan/{repo}/contents/{path}
  body: {"content":"<文件内容的 base64>","message":"说明","branch":"main"}
- 查看提交历史：GET /repos/yuan/{repo}/commits
- 新建分支：POST /repos/yuan/{repo}/branches
- 发起合并请求：POST /repos/yuan/{repo}/pulls
```

> Token 等于密码，只贴给你信任的 AI，不要发到公开群或公开仓库。

---

## 三、几条实用建议

- **一个项目一个仓库**，不要把不相关的东西堆在一起。
- 仓库名用英文小写 + 短横线，如 `family-photos`、`work-notes`。
- 重要资料建「私有」仓库。
- 服务器每天凌晨自动备份，保留 14 天，误删可恢复。
- 忘记密码或需要加人，找管理员（yuan）。