README.md

---
title: Video Quality User Study
emoji: 🎬
colorFrom: green
colorTo: indigo
sdk: gradio
sdk_version: 6.3.0
app_file: app.py
pinned: false
---

# 🎬 视频生成质量用户研究 / Video Generation Quality User Study

这是一个用于收集视频生成质量评分的 Gradio 应用。

## 功能特点

- ✅ 用户友好的问卷界面
- ✅ 支持多个场景和方法的视频评分
- ✅ 密码保护的管理员界面
- ✅ 自动统计分析
- ✅ 导出 CSV 和 JSON 格式数据

## 🔐 管理员设置（重要！）

### 设置密码

1. 访问你的 Space：`https://huggingface.co/spaces/WenjiaWang/userstudy`
2. 点击 **Settings** (设置)
3. 找到 **Repository secrets** 部分
4. 点击 **New secret**
5. 添加密钥：
   - **Name**: `ADMIN_PASSWORD`
   - **Value**: 你的密码（例如：`MySecurePassword123!`）
6. 点击 **Add secret**
7. 重启 Space

### 查看结果

1. 切换到"🔐 管理员 / Admin"标签
2. 输入密码
3. 查看统计数据和下载 CSV 文件

## 本地运行

```bash
# 安装依赖
pip install -r requirements.txt

# 设置密码
export ADMIN_PASSWORD="your_password_here"

# 运行应用
python app.py
```

## 数据文件

- `ratings_data.json` - 原始评分数据
- `ratings_summary.csv` - 汇总统计（平均分）
- `ratings_detail.csv` - 详细数据（所有记录）

## 安全性

- ✅ 管理员密码存储在环境变量中
- ✅ 代码中不包含明文密码
- ✅ 只有 Space 所有者可以访问 Secrets