feat: 添加

This commit is contained in:
sairate 2025-05-30 17:32:56 +08:00
parent 8fefd2a1ba
commit 92cfec0be9
4 changed files with 40 additions and 23 deletions

1
.gitignore vendored
View File

@ -1,2 +1,3 @@
/build/ /build/
/dist/ /dist/
client.spec

View File

@ -1,3 +1,4 @@
当然,帮你润色得更流畅规范一些,同时保持清晰简洁:
--- ---
@ -13,78 +14,93 @@
|- 十秒挑战.png |- 十秒挑战.png
|- 按钮.png |- 按钮.png
``` ```
### 功能简介 ### 功能简介
* 计时开始与停止,计算玩家实际用时。 * 支持计时开始与停止,计算玩家实际用时。
* 显示用时和与10秒的误差。 * 显示用时及与目标10秒的误差。
* 无排行榜保存功能。 * 无排行榜及成绩保存功能。
### 使用说明 ### 使用说明
1. 运行程序。 1. 运行程序。
2. 点击“开始/停止”按钮开始计时,再次点击停止计时。 2. 点击“开始/停止”按钮开始计时,再次点击停止计时。
3. 程序显示你的用时和误差。 3. 程序显示您的用时及误差。
### 适用场景 ### 适用场景
* 练习时间感知,不需要保存成绩 * 适合练习时间感知,无需保存成绩的简单场景
--- ---
## 版本二:本地持久化数据版本 ## 版本二:本地持久化数据版本
```txt ```txt
- base |- app.py
|- base.py |- leaderboard.json
|- 十秒挑战.png
|- 按钮.png
``` ```
### 功能简介 ### 功能简介
* 计时功能与基础版本相同 * 包含基础版本的计时功能
* 输入玩家姓名,保存成绩到本地 `leaderboard.json` 文件。 * 停止计时后,输入玩家姓名,成绩保存至本地 `leaderboard.json` 文件。
* 读取本地文件,显示排行榜,误差越小排名越靠前。 * 读取本地数据文件,显示排行榜,误差越小排名越靠前。
* 排行榜持久化保存在本地 * 本地实现排行榜数据持久化。
### 使用说明 ### 使用说明
1. 运行程序。 1. 运行程序。
2. 点击“开始/停止”按钮计时。 2. 点击“开始/停止”按钮计时。
3. 停止后输入姓名,成绩保存本地。 3. 结束后输入姓名,成绩保存到本地。
4. 排行榜自动更新显示本地最好成绩。 4. 排行榜自动更新并显示本地最佳成绩。
### 适用场景 ### 适用场景
* 单机使用,成绩需要保存但不联网 * 适合单机使用,需保存成绩但无网络依赖的情况
--- ---
## 版本三:云端持久化数据版本 ## 版本三:云端持久化数据版本
```txt
|- yun
|- server.py
|- client.py
|- icon.ico
```
### 功能简介 ### 功能简介
* 计时功能与基础版本相同。 * 保留基础计时功能。
* 输入姓名,成绩通过 HTTP 请求提交到云端 Flask 服务器。 * 停止计时后输入姓名,成绩通过 HTTP 请求提交到云端 Flask 服务器。
* 云端统一存储排行榜数据。 * 云端统一存储和管理排行榜数据。
* 客户端定期从云端加载排行榜,显示最新排名。 * 客户端定期从云端加载排行榜,显示最新排名。
### 使用说明 ### 使用说明
1. 启动云端 Flask 服务器或使用提供的服务器地址。 1. 启动云端 Flask 服务器或使用提供的服务器地址。
2. 运行客户端程序,点击“开始/停止”按钮计时。 2. 运行客户端程序,点击“开始/停止”按钮计时。
3. 停止计时后输入姓名,成绩自动提交到服务器。 3. 结束计时后输入姓名,成绩自动提交服务器。
4. 排行榜从云端获取最新数据并显示。 4. 排行榜实时从云端获取并更新显示。
### 适用场景 ### 适用场景
* 多人在线成绩同步,支持跨设备查看排行榜 * 适合多人在线成绩同步,支持跨设备查看和比较
---
## 打包示例命令
```bash ```bash
pyinstaller -F -w -i icon.ico client.py pyinstaller -F -w -i icon.ico client.py
``` ```
## 生成依赖文件命令
```bash ```bash
pip freeze > requirements.txt pip freeze > requirements.txt
``` ```
```bash
pip install requests -i https://mirrors.aliyun.com/pypi/simple/
```

View File

Before

Width:  |  Height:  |  Size: 8.1 KiB

After

Width:  |  Height:  |  Size: 8.1 KiB

View File

Before

Width:  |  Height:  |  Size: 162 KiB

After

Width:  |  Height:  |  Size: 162 KiB