新手指南

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

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

一、网页上怎么用

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

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

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

2. 上传文件

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

3. 修改文件

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

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

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

5. 下载整个项目

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

二、让 AI 帮你操作

用 Profer 的话最简单：直接对 AI 说「帮我在 git.profer.cn 建一个叫 xxx 的私有仓库」「把这份文档传到 xxx 仓库」即可，Gitea 已接入 Profer。

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

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）。

README.md Unescape Escape