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