Add admin tool to adjust user daily quota

Features:
✅ Show user status (calls used/remaining)
✅ Reset user quota (set to 0, give 4 new calls)
✅ Set specific used count
✅ Add extra quota (supports over-quota like 8 calls/day)

Usage:
python admin_adjust_user_quota.py <username> show
python admin_adjust_user_quota.py <username> reset
python admin_adjust_user_quota.py <username> set 2
python admin_adjust_user_quota.py <username> add 4

Benefits:
- Emergency quota reset for users
- VIP users with higher daily limits (e.g. 8 calls/day)
- Easy quota management via CLI
- All operations require confirmation
- Audit trail in 'note' field

Data structure:
call_counts/2026-01-09/username.json
{
"user": "username",
"date": "2026-01-09",
"count": 2,
"note": "Set to 2 by admin"
}

Also improved evaluation storage:
evaluations/{username}/{timestamp}.jsonl
- User-grouped for better privacy
- Faster history queries
- GDPR compliant (easy export/delete)

Documentation: ADMIN_TOOLS.md

ADMIN_TOOLS.md

@@ -0,0 +1,202 @@
+# 🔧 管理员工具
+
+## 用户配额管理
+
+### 📝 脚本: `admin_adjust_user_quota.py`
+
+用于调整用户的每日调用次数配额。
+
+---
+
+## 🚀 使用方法
+
+### 1. 查看用户状态
+
+```bash
+export HF_TOKEN='your_hf_token_here'
+python admin_adjust_user_quota.py <username> show
+```
+
+**示例**:
+```bash
+python admin_adjust_user_quota.py learnmlf show
+```
+
+**输出**:
+```
+============================================================
+📊 用户状态: learnmlf
+============================================================
+日期: 2026-01-09
+已用次数: 3/4
+剩余次数: 1
+状态: ✅ 可用
+============================================================
+```
+
+---
+
+### 2. 重置用户配额（给满4次）
+
+```bash
+python admin_adjust_user_quota.py <username> reset
+```
+
+**作用**: 将用户今天的已用次数设为0，相当于给他4次新配额
+
+**示例**:
+```bash
+python admin_adjust_user_quota.py learnmlf reset
+```
+
+**流程**:
+1. 显示当前状态
+2. 要求确认（输入 `yes`）
+3. 重置为0
+4. 显示更新后的状态
+
+---
+
+### 3. 设置已用次数
+
+```bash
+python admin_adjust_user_quota.py <username> set <count>
+```
+
+**作用**: 直接设置用户今天已用的次数
+
+**示例**:
+```bash
+# 设置为已用2次（剩余2次）
+python admin_adjust_user_quota.py learnmlf set 2
+
+# 设置为已用0次（剩余4次）
+python admin_adjust_user_quota.py learnmlf set 0
+```
+
+---
+
+### 4. 增加额外配额
+
+```bash
+python admin_adjust_user_quota.py <username> add <extra_count>
+```
+
+**作用**: 给用户增加额外的调用次数（超过默认的4次）
+
+**示例**:
+```bash
+# 给用户额外增加2次配额
+python admin_adjust_user_quota.py learnmlf add 2
+
+# 如果用户原本已用3次，增加2次后，变为已用1次（相当于总共6次配额）
+```
+
+**逻辑**:
+- 原理：减少已用次数 = 增加剩余次数
+- 如果用户已用3次，增加2次配额后，已用次数变为1次
+- 用户实际可用：4 - 1 = 3次（比重置多2次）
+
+---
+
+## 📊 使用场景
+
+### 场景1: 用户配额用完了，但需要紧急使用
+
+```bash
+# 快速重置，给他4次新配额
+python admin_adjust_user_quota.py user123 reset
+```
+
+### 场景2: VIP用户，给他每天8次配额
+
+```bash
+# 假设他今天用了2次，给他增加4次额外配额
+python admin_adjust_user_quota.py vip_user add 4
+# 结果：已用次数从2变为-2，相当于还能用6次（总共8次）
+```
+
+### 场景3: 用户误操作浪费了配额
+
+```bash
+# 重置给他4次新配额
+python admin_adjust_user_quota.py user456 reset
+```
+
+### 场景4: 查看用户使用情况
+
+```bash
+# 查看某个用户今天用了多少次
+python admin_adjust_user_quota.py user789 show
+```
+
+---
+
+## 🔐 安全注意事项
+
+1. **HF_TOKEN 权限**: 需要对 Dataset 有写入权限的 Token
+2. **确认操作**: 所有修改操作都需要输入 `yes` 确认
+3. **不可撤销**: 修改后立即生效，无法撤销（但可以再次调整）
+4. **日期隔离**: 每天的配额独立，修改今天的不影响昨天/明天
+
+---
+
+## 📂 数据存储位置
+
+```
+HF Dataset: learnmlf/video-evaluations
+├── call_counts/
+│   └── 2026-01-09/
+│       └── username.json  ← 这个文件被修改
+```
+
+**文件格式**:
+```json
+{
+  "user": "username",
+  "date": "2026-01-09",
+  "count": 2,
+  "last_updated": "2026-01-09T12:34:56",
+  "note": "Set to 2 by admin"
+}
+```
+
+---
+
+## 💡 常见问题
+
+### Q: 增加配额会影响其他天吗？
+A: 不会。每天的配额独立存储，只影响当天。
+
+### Q: 可以给用户设置负数吗？
+A: 可以，使用 `add` 命令增加足够多次数即可。负数意味着用户有"额外"配额。
+
+### Q: 用户看得到管理员的调整吗？
+A: 用户只能看到剩余次数，看不到 `note` 字段的备注。
+
+### Q: 如何批量调整多个用户？
+A: 可以写个 bash 循环：
+```bash
+for user in user1 user2 user3; do
+    python admin_adjust_user_quota.py $user reset
+done
+```
+
+---
+
+## 🔄 与应用的集成
+
+用户在前端看到的次数会**实时更新**：
+- 应用从 `call_counts/{date}/{username}.json` 读取
+- 管理员修改文件后，用户刷新页面即可看到新配额
+- 无需重启应用
+
+---
+
+## 📝 日志
+
+所有修改都会在 `note` 字段留下记录：
+- `"Reset by admin"` - 管理员重置
+- `"Set to X by admin"` - 管理员设置为X
+- `"Added X extra calls by admin (was Y)"` - 管理员增加X次（原来是Y）
+

admin_adjust_user_quota.py

@@ -0,0 +1,255 @@
+#!/usr/bin/env python3
+"""
+管理员工具：调整用户的每日调用次数配额
+
+用法:
+    python admin_adjust_user_quota.py <username> <action>
+
+示例:
+    # 重置用户的今日调用次数为0（相当于给他4次新配额）
+    python admin_adjust_user_quota.py learnmlf reset
+    
+    # 设置用户今日已用次数为1（剩余3次）
+    python admin_adjust_user_quota.py learnmlf set 1
+    
+    # 查看用户当前状态
+    python admin_adjust_user_quota.py learnmlf show
+    
+    # 给用户额外增加2次配额（即今日可用6次）
+    python admin_adjust_user_quota.py learnmlf add 2
+"""
+
+import os
+import sys
+from datetime import datetime
+from app import DatasetManager, MAX_DAILY_CALLS
+
+# 配置
+HF_TOKEN = os.environ.get("HF_TOKEN", "")
+DATASET_REPO_ID = "learnmlf/video-evaluations"
+
+def show_usage():
+    """显示使用说明"""
+    print(__doc__)
+    sys.exit(1)
+
+def show_user_status(dm: DatasetManager, username: str):
+    """显示用户当前状态"""
+    calls_today = dm.get_user_calls_today(username)
+    remaining = max(0, MAX_DAILY_CALLS - calls_today)
+    today = datetime.now().strftime("%Y-%m-%d")
+    
+    print("\n" + "="*60)
+    print(f"📊 用户状态: {username}")
+    print("="*60)
+    print(f"日期: {today}")
+    print(f"已用次数: {calls_today}/{MAX_DAILY_CALLS}")
+    print(f"剩余次数: {remaining}")
+    print(f"状态: {'✅ 可用' if remaining > 0 else '❌ 已用完'}")
+    print("="*60)
+
+def reset_user_quota(dm: DatasetManager, username: str):
+    """重置用户今日配额（设为0）"""
+    today = datetime.now().strftime("%Y-%m-%d")
+    count_file = f"call_counts/{today}/{username}.json"
+    
+    import json
+    import tempfile
+    
+    count_data = {
+        'user': username,
+        'date': today,
+        'count': 0,
+        'last_updated': datetime.now().isoformat(),
+        'note': 'Reset by admin'
+    }
+    
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False, encoding='utf-8') as f:
+        json.dump(count_data, f, ensure_ascii=False, indent=2)
+        temp_path = f.name
+    
+    try:
+        dm.api.upload_file(
+            path_or_fileobj=temp_path,
+            path_in_repo=count_file,
+            repo_id=DATASET_REPO_ID,
+            repo_type="dataset",
+            token=HF_TOKEN
+        )
+        print(f"\n✅ 用户 {username} 的今日调用次数已重置为 0")
+        print(f"   → 剩余次数: {MAX_DAILY_CALLS}")
+    finally:
+        os.unlink(temp_path)
+
+def set_user_quota(dm: DatasetManager, username: str, count: int):
+    """设置用户今日已用次数"""
+    if count < 0:
+        print(f"❌ 错误: 次数不能为负数")
+        sys.exit(1)
+    
+    today = datetime.now().strftime("%Y-%m-%d")
+    count_file = f"call_counts/{today}/{username}.json"
+    
+    import json
+    import tempfile
+    
+    count_data = {
+        'user': username,
+        'date': today,
+        'count': count,
+        'last_updated': datetime.now().isoformat(),
+        'note': f'Set to {count} by admin'
+    }
+    
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False, encoding='utf-8') as f:
+        json.dump(count_data, f, ensure_ascii=False, indent=2)
+        temp_path = f.name
+    
+    try:
+        dm.api.upload_file(
+            path_or_fileobj=temp_path,
+            path_in_repo=count_file,
+            repo_id=DATASET_REPO_ID,
+            repo_type="dataset",
+            token=HF_TOKEN
+        )
+        remaining = max(0, MAX_DAILY_CALLS - count)
+        print(f"\n✅ 用户 {username} 的今日调用次数已设置为 {count}")
+        print(f"   → 剩余次数: {remaining}")
+    finally:
+        os.unlink(temp_path)
+
+def add_user_quota(dm: DatasetManager, username: str, extra: int):
+    """给用户增加额外配额（减少已用次数）"""
+    if extra <= 0:
+        print(f"❌ 错误: 额外次数必须大于0")
+        sys.exit(1)
+    
+    current = dm.get_user_calls_today(username)
+    new_count = current - extra  # 减少已用次数 = 增加剩余次数（允许负数）
+    
+    today = datetime.now().strftime("%Y-%m-%d")
+    count_file = f"call_counts/{today}/{username}.json"
+    
+    import json
+    import tempfile
+    
+    count_data = {
+        'user': username,
+        'date': today,
+        'count': new_count,
+        'last_updated': datetime.now().isoformat(),
+        'note': f'Added {extra} extra calls by admin (was {current})'
+    }
+    
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False, encoding='utf-8') as f:
+        json.dump(count_data, f, ensure_ascii=False, indent=2)
+        temp_path = f.name
+    
+    try:
+        dm.api.upload_file(
+            path_or_fileobj=temp_path,
+            path_in_repo=count_file,
+            repo_id=DATASET_REPO_ID,
+            repo_type="dataset",
+            token=HF_TOKEN
+        )
+        actual_extra = current - new_count
+        new_remaining = MAX_DAILY_CALLS - new_count
+        print(f"\n✅ 已给用户 {username} 增加 {actual_extra} 次额外配额")
+        print(f"   之前: {current}/{MAX_DAILY_CALLS} (剩余 {MAX_DAILY_CALLS - current})")
+        print(f"   现在: {new_count}/{MAX_DAILY_CALLS} (剩余 {new_remaining})")
+        print(f"   → 总配额: {new_remaining} 次")
+    finally:
+        os.unlink(temp_path)
+
+def main():
+    if not HF_TOKEN:
+        print("❌ 错误: 请设置 HF_TOKEN 环境变量")
+        print("   export HF_TOKEN='your_token_here'")
+        sys.exit(1)
+    
+    if len(sys.argv) < 3:
+        show_usage()
+    
+    username = sys.argv[1]
+    action = sys.argv[2].lower()
+    
+    # 初始化 DatasetManager
+    dm = DatasetManager(DATASET_REPO_ID, HF_TOKEN)
+    
+    print(f"\n🔧 管理员工具 - 用户配额管理")
+    print(f"Dataset: {DATASET_REPO_ID}")
+    print(f"日期: {datetime.now().strftime('%Y-%m-%d')}")
+    print(f"标准配额: {MAX_DAILY_CALLS} 次/天")
+    
+    if action == "show":
+        # 查看状态
+        show_user_status(dm, username)
+    
+    elif action == "reset":
+        # 重置为0
+        print(f"\n正在重置用户 {username} 的配额...")
+        show_user_status(dm, username)
+        
+        confirm = input(f"\n确认重置为 0 吗？ (yes/no): ")
+        if confirm.lower() == 'yes':
+            reset_user_quota(dm, username)
+            show_user_status(dm, username)
+        else:
+            print("❌ 操作已取消")
+    
+    elif action == "set":
+        # 设置为指定值
+        if len(sys.argv) < 4:
+            print("❌ 错误: 缺少次数参数")
+            print("   用法: python admin_adjust_user_quota.py <username> set <count>")
+            sys.exit(1)
+        
+        try:
+            count = int(sys.argv[3])
+        except ValueError:
+            print(f"❌ 错误: 无效的数字 '{sys.argv[3]}'")
+            sys.exit(1)
+        
+        print(f"\n正在设置用户 {username} 的已用次数为 {count}...")
+        show_user_status(dm, username)
+        
+        confirm = input(f"\n确认设置为 {count} 吗？ (yes/no): ")
+        if confirm.lower() == 'yes':
+            set_user_quota(dm, username, count)
+            show_user_status(dm, username)
+        else:
+            print("❌ 操作已取消")
+    
+    elif action == "add":
+        # 增加额外配额
+        if len(sys.argv) < 4:
+            print("❌ 错误: 缺少额外次数参数")
+            print("   用法: python admin_adjust_user_quota.py <username> add <extra_count>")
+            sys.exit(1)
+        
+        try:
+            extra = int(sys.argv[3])
+        except ValueError:
+            print(f"❌ 错误: 无效的数字 '{sys.argv[3]}'")
+            sys.exit(1)
+        
+        print(f"\n正在给用户 {username} 增加 {extra} 次额外配额...")
+        show_user_status(dm, username)
+        
+        confirm = input(f"\n确认增加 {extra} 次配额吗？ (yes/no): ")
+        if confirm.lower() == 'yes':
+            add_user_quota(dm, username, extra)
+            show_user_status(dm, username)
+        else:
+            print("❌ 操作已取消")
+    
+    else:
+        print(f"❌ 错误: 未知操作 '{action}'")
+        print("   支持的操作: show, reset, set, add")
+        show_usage()
+
+if __name__ == "__main__":
+    main()
+

app.py

@@ -196,14 +196,16 @@ class DatasetManager:
                 token=self.hf_token
             )
             
-            # 筛选该用户的评分文件
-            user_files = [f for f in files if f.startswith(f"evaluations/") and f.endswith('.json')]
+            # 筛选该用户的评分文件（按用户分组：evaluations/{username}/时间戳.jsonl）
+            user_files = [f for f in files 
+                         if f.startswith(f"evaluations/{username}/") 
+                         and f.endswith('.jsonl')]
             
-            # 按时间倒序排序（文件名包含时间戳）
+            # 按文件名倒序排序（文件名就是时间戳，自然排序）
             user_files.sort(reverse=True)
             
             history = []
-            for file_path in user_files[:limit * 2]:  # 多读一些，因为有些可能不是该用户的
+            for file_path in user_files[:limit]:  # 只读需要的数量
                 try:
                     # 下载文件
                     local_path = self.api.hf_hub_download(
@@ -281,9 +283,9 @@ class DatasetManager:
                 temp_file = f.name
             
             try:
-                # 生成唯一的文件名（基于时间戳）
-                timestamp = datetime.now().strftime("%Y%m%d_%H%M%S_%f")
-                filename = f"evaluations/{username}_{timestamp}.jsonl"
+                # 按用户分组存储（方便查询单个用户的历史记录）
+                timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+                filename = f"evaluations/{username}/{timestamp}.jsonl"
                 
                 # 上传到 Dataset
                 self.api.upload_file(