From 29076d1759c228b1b31a27cb2b1ac5e3e9c9d0bb Mon Sep 17 00:00:00 2001
From: yuan <yuan@profer.cn>
Date: Mon, 9 Nov 2026 16:00:46 +0800
Subject: [PATCH] add newbie guide

---
 README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 68 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 50e6e36..afff790 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,69 @@
-# start-here
+# 新手指南
 
-新手指南：从这里开始
\ No newline at end of file
+欢迎使用私有 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）。