# ShortVideoClient

**Repository Path**: liao-junheng/ShortVideoClient

## Basic Information

- **Project Name**: ShortVideoClient
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 107
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 抖音短视频客户端

使用 PyQt6 开发的简易短视频客户端,模仿抖音官网设计风格。

## 功能特性

- ✅ 三栏布局(左侧边栏 + 顶部栏 + 主内容区)
- ✅ 深色主题配色(黑底白字,红色高亮)
- ✅ 响应式视频卡片网格(自动调整列数)
- ✅ 16个视频卡片展示(缩略图、标题、作者、时间)
- ✅ 鼠标悬停交互效果
- ✅ 滚动条支持

## 环境要求

- Python 3.8+
- PyQt6

## 安装依赖

```bash
pip install -r requirements.txt
```

**注意**: 如果遇到 DLL 加载错误,请安装 Microsoft Visual C++ Redistributable:
- 下载地址: https://aka.ms/vs/17/release/vc_redist.x64.exe

或者使用 conda:
```bash
conda install pyqt
```

## 运行程序

在项目根目录执行:

```bash
python src\main.py
```

## 项目结构

```
ShortVideoClient/
├── src/
│   ├── main.py                 # 程序入口
│   ├── widgets/
│   │   ├── __init__.py
│   │   ├── main_window.py      # 主窗口
│   │   ├── sidebar.py          # 左侧边栏
│   │   ├── topbar.py           # 顶部栏
│   │   ├── content_area.py     # 主内容区
│   │   └── video_card.py       # 视频卡片
│   ├── images/                 # 图片资源
│   └── videos/                 # 视频资源
├── requirements.txt            # 依赖列表
├── README.md                   # 说明文档
└── openspec/
    └── changes/
        └── douyin-main-interface/
            ├── proposal.md     # 提案文档
            ├── design.md       # 设计文档
            └── tasks.md        # 任务清单
```

## 技术栈

- **PyQt6**: Python GUI 框架
- **QSS**: Qt Style Sheets (类似 CSS)
- **QGridLayout**: 响应式网格布局

## 开发说明

### 深色主题配色

- 主背景: `#1a1a1a`
- 侧边栏: `#0f0f0f`
- 卡片背景: `#2a2a2a`
- 文字颜色: `#ffffff` (白色)
- 次要文字: `#b0b0b0` (灰色)
- 高亮红色: `#fe2c55` (抖音红)
- 悬停效果: `#3a3a3a`

### 响应式布局

视频卡片会根据窗口宽度自动调整每行显示的数量:
- 宽屏 (>1000px): 4列
- 中屏 (750-1000px): 3列
- 窄屏 (500-750px): 2列
- 超窄 (<500px): 1列

卡片最小尺寸: 250px × 350px  
卡片间距: 15px

## 后续迭代方向

- [ ] 视频播放功能
- [ ] 搜索功能实现
- [ ] 登录/注册系统
- [ ] 页面切换逻辑
- [ ] 真实数据接入
- [ ] 无限滚动加载

## 许可证

本项目用于教学目的。