diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e2cae22
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+/build/
+/dist/
diff --git a/README.md b/README.md
index 046708f..5cde463 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,86 @@
+
+---
+
+# 十秒挑战 使用说明文档
+
+---
+
+## 版本一：本地无数据持久化基础版本（无排行榜）
+
+```txt
+- base
+    |- base.py
+    |- 十秒挑战.png
+    |- 按钮.png
+```
+### 功能简介
+
+* 计时开始与停止，计算玩家实际用时。
+* 显示用时和与10秒的误差。
+* 无排行榜保存功能。
+
+### 使用说明
+
+1. 运行程序。
+2. 点击“开始/停止”按钮开始计时，再次点击停止计时。
+3. 程序显示你的用时和误差。
+
+### 适用场景
+
+* 练习时间感知，不需要保存成绩。
+
+---
+
+## 版本二：本地持久化数据版本
+
+```txt
+- base
+    |- base.py
+    |- 十秒挑战.png
+    |- 按钮.png
+```
+
+### 功能简介
+
+* 计时功能与基础版本相同。
+* 输入玩家姓名，保存成绩到本地 `leaderboard.json` 文件。
+* 读取本地文件，显示排行榜，误差越小排名越靠前。
+* 排行榜持久化保存在本地。
+
+### 使用说明
+
+1. 运行程序。
+2. 点击“开始/停止”按钮计时。
+3. 停止后输入姓名，成绩保存本地。
+4. 排行榜自动更新显示本地最好成绩。
+
+### 适用场景
+
+* 单机使用，成绩需要保存但不联网。
+
+---
+
+## 版本三：云端持久化数据版本
+
+### 功能简介
+
+* 计时功能与基础版本相同。
+* 输入姓名，成绩通过 HTTP 请求提交到云端 Flask 服务器。
+* 云端统一存储排行榜数据。
+* 客户端定期从云端加载排行榜，显示最新排名。
+
+### 使用说明
+
+1. 启动云端 Flask 服务器或使用提供的服务器地址。
+2. 运行客户端程序，点击“开始/停止”按钮计时。
+3. 停止计时后输入姓名，成绩自动提交到服务器。
+4. 排行榜从云端获取最新数据并显示。
+
+### 适用场景
+
+* 多人在线成绩同步，支持跨设备查看排行榜。
+
+
 ```bash
 pyinstaller -F -w -i icon.ico client.py
 ```