148 lines
4.4 KiB
Markdown
148 lines
4.4 KiB
Markdown
# Temp File Transfer Client - 设计规格
|
||
|
||
## 1. 项目概述
|
||
|
||
- **项目名称**: temp_file_trans_client
|
||
- **类型**: 桌面客户端应用
|
||
- **核心功能**: 通过拖放或点击上传文件到临时文件传输服务器，获取分享链接
|
||
- **目标用户**: 需要快速分享文件给其他人的用户
|
||
|
||
## 2. 技术栈
|
||
|
||
| 组件 | 技术 |
|
||
|------|------|
|
||
| GUI框架 | PySide6 |
|
||
| HTTP客户端 | requests |
|
||
| 打包工具 | PyInstaller |
|
||
| Python版本 | 3.8+ |
|
||
|
||
## 3. 功能列表
|
||
|
||
### 3.1 服务器配置
|
||
- 顶部输入框配置服务器地址
|
||
- 默认值: `http://localhost:5000`
|
||
- 保存到本地配置文件
|
||
|
||
### 3.2 文件上传
|
||
- 拖放文件到拖放区域上传
|
||
- 点击拖放区域选择文件
|
||
- 显示上传进度条
|
||
- 支持过期时间选择: `1h`, `24h`, `7d`
|
||
|
||
### 3.3 结果展示
|
||
- 上传成功后显示分享链接
|
||
- 点击链接复制到剪贴板
|
||
- 显示文件ID和文件名
|
||
|
||
### 3.4 错误处理
|
||
- 网络错误提示
|
||
- 服务器返回错误展示
|
||
- 文件大小超限提示（参考服务器500MB限制）
|
||
|
||
## 4. UI设计
|
||
|
||
### 4.1 窗口布局
|
||
```
|
||
┌──────────────────────────────────────┐
|
||
│ 服务器: [http://localhost:5000] [保存] │ ← 配置栏 (40px)
|
||
├──────────────────────────────────────┤
|
||
│ │
|
||
│ ┌────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 📁 拖放文件到此处 │ │ ← 拖放区域 (flex)
|
||
│ │ 或点击选择文件 │ │
|
||
│ │ │ │
|
||
│ └────────────────────────────────┘ │
|
||
│ │
|
||
│ 过期时间: [24h ▼] [上传文件] │ ← 操作栏 (50px)
|
||
│ │
|
||
│ ════════════════════════════════ │ ← 进度条 (隐藏/显示)
|
||
│ │
|
||
│ ┌────────────────────────────────┐ │
|
||
│ │ https://xxx/file_id │ │ ← 结果区 (隐藏/显示)
|
||
│ │ [复制链接] │ │
|
||
│ └────────────────────────────────┘ │
|
||
│ │
|
||
│ 状态: 就绪 │ ← 状态栏 (30px)
|
||
└──────────────────────────────────────┘
|
||
```
|
||
|
||
### 4.2 窗口规格
|
||
- 默认尺寸: 500 x 450 px
|
||
- 最小尺寸: 400 x 350 px
|
||
- 无边框简约设计（可选）
|
||
- 居中显示
|
||
|
||
### 4.3 拖放区域样式
|
||
- 虚线边框 (#aaa)
|
||
- 圆角 (8px)
|
||
- 悬停时边框变蓝 (#3498db)
|
||
- 拖拽进入时背景变浅蓝 (#ecf0f1)
|
||
|
||
## 5. API交互
|
||
|
||
### 5.1 上传接口
|
||
参考 `upload_client.py`，使用 `requests.post` 上传：
|
||
|
||
```
|
||
POST /api/upload
|
||
Content-Type: multipart/form-data
|
||
|
||
file: <binary>
|
||
expiry: 1h|24h|7d
|
||
```
|
||
|
||
**成功响应 (200)**:
|
||
```json
|
||
{
|
||
"id": "uuid",
|
||
"filename": "example.pdf",
|
||
"filesize": 1234567,
|
||
"expiry_hours": 24,
|
||
"share_url": "http://server/file/<id>"
|
||
}
|
||
```
|
||
|
||
**错误响应 (400/429/500)**:
|
||
```json
|
||
{
|
||
"error": "错误描述"
|
||
}
|
||
```
|
||
|
||
### 5.2 链接格式
|
||
```
|
||
分享链接: {服务器地址}/file/{file_id}
|
||
直接下载: {服务器地址}/download/{file_id}
|
||
```
|
||
|
||
## 6. 文件结构
|
||
|
||
```
|
||
temp_file_trans_client/
|
||
├── main.py # 入口，创建应用和主窗口
|
||
├── ui.py # UI组件和布局
|
||
├── api.py # API调用封装
|
||
├── config.json # 本地配置（服务器地址等）
|
||
├── requirements.txt # 依赖
|
||
├── build.spec # PyInstaller配置
|
||
└── README.md # 使用说明
|
||
```
|
||
|
||
## 7. 打包配置
|
||
|
||
### PyInstaller spec
|
||
- 单文件输出
|
||
- 窗口模式（无控制台）
|
||
- 包含PySide6和requests
|
||
|
||
## 8. 验收标准
|
||
|
||
1. ✅ 拖放文件到拖放区域触发上传
|
||
2. ✅ 点击拖放区域可选择文件
|
||
3. ✅ 显示上传进度
|
||
4. ✅ 上传成功显示分享链接
|
||
5. ✅ 可复制分享链接
|
||
6. ✅ 可配置服务器地址
|
||
7. ✅ 错误情况有友好提示
|
||
8. ✅ 可打包成exe运行 |