┌─────────────────────────────────────┐
│   🎨 表现层：WordPress 前端界面      │
│   用户看到的输入框、按钮、进度提示    │
├─────────────────────────────────────┤
│   ⚙️ 业务层：WordPress 插件 (PHP)    │
│   请求验证、流程编排、结果处理        │
├─────────────────────────────────────┤
│   🔧 服务层：Python API (Flask)      │
│   YouTube 数据抓取、字幕解析          │
└─────────────────────────────────────┘

pip install --upgrade yt-dlp
# 或者使用 yt-dlp 的自更新功能 yt-dlp -U

# 策略列表：模拟不同的客户端身份 strategies = [
    # 策略1: 模拟 Android 客户端     {
        'extractor_args': {
            'youtube': {
                'player_client': ['android'],
                'player_skip': ['webpage'],
            }
        }
    },
    # 策略2: 模拟电视嵌入式客户端     {
        'extractor_args': {
            'youtube': {
                'player_client': ['tv_embedded'],
                'player_skip': ['webpage', 'configs'],
            }
        }
    },
    # 策略3: 标准 Web 客户端（作为兜底）     {
        'extractor_args': {
            'youtube': {
                'player_client': ['web'],
                'player_skip': ['configs'],
            }
        }
    }
]

用户选择"中文"     ↓
优先查找简体中文 (zh, zh-Hans, zh-CN)
    ↓ 没找到？
降级到繁体中文 (zh-Hant, zh-TW, zh-HK)
    ↓ 还没有？
降级到英文 (en, en-US, en-GB)
    ↓ 都没有
返回任意可用语言

1 00:00:01,000 --> 00:00:04,000 今天我们来聊一聊

2 00:00:04,500 --> 00:00:07,000 关于<font color="#FFFF00">人工智能</font>的话题

def clean_srt_content(self, srt_content):     """清理 SRT 内容，只保留纯文本"""     lines = srt_content.split('\n')
    text_lines = []
    
    for line in lines:
        line = line.strip()
        # 跳过序号行         if line.isdigit():
            continue         # 跳过时间戳行         if '-->' in line:
            continue         # 移除 HTML 标签         line = re.sub(r'<[^>]+>', '', line)
        if line:
            text_lines.append(line)
    
    return '\n'.join(text_lines)

# 使用官方 Python 镜像（slim 版本更轻量） FROM python:3.12-slim

# 设置工作目录 WORKDIR /app 
# 安装系统依赖（FFmpeg 用于音频处理） RUN apt-get update && apt-get install -y \
    ffmpeg \
    && rm -rf /var/lib/apt/lists/* 
# 复制依赖文件并安装 COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt 
# 复制应用代码 COPY app.py . 
# 暴露服务端口 EXPOSE 5000 
# 启动命令 CMD ["python", "app.py"] 

version: '3.8'

services:
  youtube-api:
    build: .
    ports:
      - "5000:5000"
    restart: unless-stopped
    environment:
      - FLASK_ENV=production
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:5000/"]
      interval: 30s
      timeout: 10s
      retries: 3

docker-compose up -d

docker-compose ps

docker-compose logs -f youtube-api

📁 youtube-transcriber/
├── 📄 youtube-transcriber.php    # 主入口文件
├── 📁 includes/
│   ├── 📄 class-api-handler.php  # API 通信类
│   ├── 📄 class-ajax-handler.php # AJAX 处理类
│   ├── 📄 class-processor.php    # 业务逻辑类
│   ├── 📄 class-frontend.php     # 前端渲染类
│   └── 📄 class-settings.php     # 设置管理类
└── 📁 assets/
    ├── 📄 frontend.js            # 前端交互脚本
    └── 📄 frontend.css           # 样式文件

前端 JavaScript
    ↓ 发送 AJAX 请求到 admin-ajax.php
WordPress 核心
    ↓ 根据 action 参数分发请求
插件的 AJAX 处理函数
    ↓ 处理业务逻辑
返回 JSON 响应

1. 页面加载时，服务器生成一个临时 token
2. 前端请求时，必须携带这个 token
3. 服务器验证 token 是否有效
4. 无效 token → 拒绝请求

// PHP 端：生成 nonce wp_nonce_field('youtube_transcriber_nonce', 'nonce');

// PHP 端：验证 nonce if (!wp_verify_nonce($_POST['nonce'], 'youtube_transcriber_nonce')) {
    wp_die('安全验证失败');
}

// JavaScript 端：发送请求时携带 nonce jQuery.ajax({
    url: ajaxurl,
    type: 'POST',
    data: {
        action: 'youtube_transcribe',
        nonce: youtube_transcriber.nonce,
        url: videoUrl
    }
});

class API_Handler {
    
    private $api_base_url;
    
    public function __construct() {
        // 从设置中获取 Python 服务地址         $this->api_base_url = get_option('youtube_api_url', 'http://localhost:5000');
    }
    
    /**
     * 调用字幕提取 API
     */     public function get_subtitles($video_url, $language = 'zh') {
        $response = wp_remote_post(
            $this->api_base_url . '/api/subtitles',
            array(
                'timeout' => 60,  // 超时时间设长一些                 'body' => json_encode(array(
                    'url' => $video_url,
                    'language' => $language                 )),
                'headers' => array(
                    'Content-Type' => 'application/json'                 )
            )
        );
        
        // 错误处理         if (is_wp_error($response)) {
            return array(
                'success' => false,
                'error' => $response->get_error_message()
            );
        }
        
        return json_decode(wp_remote_retrieve_body($response), true);
    }
}

const StatusManager = {
    states: {
        IDLE: '等待输入',
        FETCHING: '正在获取视频信息...',
        EXTRACTING: '正在提取字幕...',
        PROCESSING: '正在处理内容...',
        COMPLETE: '完成！',
        ERROR: '出错了'     },
    
    update: function(state, detail = '') {
        const statusEl = document.getElementById('status');
        const spinner = document.getElementById('spinner');
        
        statusEl.textContent = this.states[state] + (detail ? ` ${detail}` : '');
        
        // 根据状态显示/隐藏加载动画         if (state === 'IDLE' || state === 'COMPLETE' || state === 'ERROR') {
            spinner.style.display = 'none';
        } else {
            spinner.style.display = 'inline-block';
        }
    }
};

❌ Error: Connection refused [errno 111] at socket.connect()

function handleError(errorCode) {
    const messages = {
        'CONNECTION_REFUSED': '无法连接到转录服务，请稍后再试',
        'VIDEO_PRIVATE': '这是一个私有视频，无法获取字幕',
        'NO_SUBTITLES': '该视频没有可用的字幕',
        'TIMEOUT': '请求超时，视频可能过长，请尝试较短的视频',
        'UNKNOWN': '发生未知错误，请刷新页面重试'     };
    
    return messages[errorCode] || messages['UNKNOWN'];
}

┌────────────────────────────────────────────────────────────────┐
│                        用户浏览器                               │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐     │
│  │ 输入 URL     │ → │ 点击转录按钮  │ → │ 显示进度动画  │     │
│  └──────────────┘    └──────────────┘    └──────────────┘     │
└───────────────────────────┬───────────────────────────────────┘
                            │ AJAX + Nonce
                            ▼
┌────────────────────────────────────────────────────────────────┐
│                    WordPress (PHP)                              │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐     │
│  │ 验证 Nonce   │ → │ 验证 URL 格式 │ → │ 调用 API     │     │
│  └──────────────┘    └──────────────┘    └──────────────┘     │
└───────────────────────────┬────────────────────────────────────┘
                            │ HTTP POST
                            ▼
┌────────────────────────────────────────────────────────────────┐
│                  Python 服务 (Flask + yt-dlp)                   │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐     │
│  │ 解析视频 ID  │ → │ 多策略获取   │ → │ 清洗字幕内容  │     │
│  └──────────────┘    └──────────────┘    └──────────────┘     │
│         │                  │                    │              │
│         ▼                  ▼                    ▼              │
│  ┌──────────────────────────────────────────────────────┐     │
│  │ 策略1: Android  →  策略2: TV  →  策略3: Web         │     │
│  │        失败？         失败？        成功！           │     │
│  └──────────────────────────────────────────────────────┘     │
└───────────────────────────┬────────────────────────────────────┘
                            │ JSON 响应
                            ▼
┌────────────────────────────────────────────────────────────────┐
│                    返回路径                                     │
│  Python → WordPress → JavaScript → 用户界面                    │
│                                     ┌──────────────┐           │
│                                     │ 显示转录结果 │           │
│                                     └──────────────┘           │
└────────────────────────────────────────────────────────────────┘

# 克隆代码 git clone your-repo-url
cd youtube-api

# 启动 Docker 服务 docker-compose up -d

# 验证服务正常运行 curl http://localhost:5000/api/test 

1. 将插件目录上传到 wp-content/plugins/
2. 在 WordPress 后台激活插件
3. 进入设置页面，填写 Python 服务地址