72 行
2.5 KiB
Markdown
72 行
2.5 KiB
Markdown
# 新手指南
|
||
|
||
欢迎使用私有 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 等），把下面这段发给它，它就能直接帮你建仓库、传文件、改内容、查历史：
|
||
|
||
```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）。
|