# ShortVideoClient

**Repository Path**: Miao7/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**: 109
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 抖音短视频客户端

一个模仿抖音官网的简易短视频客户端，使用 PyQt6 开发。

## 功能特性

- ✅ 深色主题界面（抖音品牌配色）
- ✅ 三栏布局（左侧边栏 + 顶部栏 + 主内容区）
- ✅ 响应式流式布局（自动换行、自适应窗口大小）
- ✅ 视频卡片展示（缩略图、标题、作者、发布时间）
- ✅ 实时搜索功能（支持标题和作者搜索）
- ✅ 视频播放功能（简单播放器）
- ✅ 页面导航（精选、推荐、搜索）

## 技术栈

- **Python 3.8+**
- **PyQt6 >= 6.4.0**
- **PyQt6-multimedia**（视频播放支持）

## 安装步骤

1. 克隆项目到本地
2. 安装依赖：
   ```bash
   pip install PyQt6
   ```

## 运行方法

```bash
python src/main.py
```

## 项目结构

```
ShortVideoClient/
├── src/
│   ├── main.py                    # 程序入口
│   ├── widgets/                   # UI组件
│   │   ├── sidebar.py             # 左侧边栏
│   │   ├── topbar.py              # 顶部栏
│   │   ├── video_card.py          # 视频卡片
│   │   └── video_player.py        # 视频播放器
│   ├── layouts/                   # 布局管理器
│   │   └── flow_layout.py         # 自定义流式布局
│   ├── data/                      # 数据层
│   │   └── mock_data.py           # 模拟数据
│   ├── styles/                    # 样式配置
│   │   └── theme.py               # 深色主题
│   ├── images/                    # 图片资源
│   └── videos/                    # 视频资源
├── requirements.txt               # 依赖清单
└── README.md                      # 项目说明
```

## 使用说明

### 基本操作

1. **浏览视频**：滚动查看视频卡片
2. **搜索视频**：在顶部搜索框输入关键词
3. **播放视频**：点击任意视频卡片
4. **切换页面**：点击左侧边栏的导航项

### 窗口调整

- 拖动窗口边缘可调整大小
- 视频卡片会自动重新排列
- 最小窗口尺寸：800x600

## 注意事项

⚠️ **DLL 加载错误处理**

如果遇到 `ImportError: DLL load failed` 错误，请：

1. 安装 Microsoft Visual C++ Redistributable
   - 下载地址：https://aka.ms/vs/17/release/vc_redist.x64.exe

2. 或者尝试重新安装 PyQt6：
   ```bash
   pip uninstall PyQt6
   pip install PyQt6
   ```

## 开发说明

本项目采用规范驱动开发（SDD）流程，所有需求、设计和任务清单详见：
- `openspec/changes/douyin-main-interface/proposal.md`
- `openspec/changes/douyin-main-interface/design.md`
- `openspec/changes/douyin-main-interface/tasks.md`

## 许可证

MIT License