";
        print_r($responseData);
        echo "
";die;
        // 检查API是否返回了错误信息
        if (isset($responseData['error'])) {
            $errorMessage = isset($responseData['error']['message']) ? $responseData['error']['message'] : 'API请求失败';
            return json([
                'code' => 1,
                'msg' => '视频生成请求失败',
                'data' => [
                    'error_type' => isset($responseData['error']['type']) ? $responseData['error']['type'] : 'unknown',
                    'error_code' => isset($responseData['error']['code']) ? $responseData['error']['code'] : 'unknown',
                    'error_message' => $errorMessage
                ]
            ]);
        }

        // 检查是否有自定义错误格式
        if (isset($responseData['code']) && $responseData['code'] === 'fail_to_fetch_task' && isset($responseData['message'])) {
            return json([
                'code' => 1,
                'msg' => '视频生成请求失败',
                'data' => [
                    'error_code' => $responseData['code'],
                    'error_message' => $responseData['message']
                ]
            ]);
        }

        // 检查是否存在id字段
        if (!isset($responseData['id'])) {
            return json([
                'code' => 1,
                'msg' => '无法获取视频ID',
                'data' => [
                    'response_data' => $responseData,
                    'http_code' => $httpCode
                ]
            ]);
        }

        $videoData = [
            'video_id' => $responseData['id'],
            'prompt' => $postData['prompt'],
            'model' => $postData['model'],
            'seconds' => $postData['seconds'],
            'size' => $postData['size'],
            'sys_rq' => date("Y-m-d H:i:s")
        ];
     
        // 尝试插入数据
        try {
            $res = Db::name('video')->insert($videoData);
            return json([
                'code' => 0,
                'msg' => '视频正在生成中',
                'data ' => [
                    'video_id' => $responseData['id'],
                    'insert_result' => $res
                ]
            ]);
        } catch (Exception $e) {
            return json([
                'code' => 1,
                'msg' => '数据库操作失败',
                'data' => [
                    'error_message' => $e->getMessage()
                ]
            ]);
        }
    }

    /**
     * 获取视频内容
     * 下载已完成的视频内容
     */
    public function videoContent(){
        // 从请求参数获取video_id，如果没有则使用默认值
        $video_id = input('get.video_id');

        $apiKey = '';
        // 1. 先检查视频状态
        $statusUrl = 'https://chatapi.onechats.ai/v1/videos/' . $video_id;
        $statusData = $this->fetchVideoStatus($statusUrl, $apiKey);

        // 检查视频状态
        if ($statusData['status'] !== 'completed') {
            return json([
                'code' => 202,
                'msg' => '视频尚未生成完成',
                'data' => [
                    'video_id' => $video_id,
                    'status' => $statusData['status'],
                    'progress' => $statusData['progress'],
                    'created_at' => $statusData['created_at'],
                    'message' => '请稍后再试，视频仍在' . ($statusData['status'] === 'queued' ? '排队中' : '处理中')
                ]
            ]);
        }

        // 2. 视频生成完成，准备下载
        $apiUrl = 'https://chatapi.onechats.ai/v1/videos/' . $video_id . '/content';

        // 获取可选的variant参数
        $variant = $this->request->get('variant', '');
        if (!empty($variant)) {
            $apiUrl .= '?variant=' . urlencode($variant);
        }

        // 创建保存目录
        $saveDir = ROOT_PATH . 'public' . DS . 'uploads' . DS . 'videos' . DS . date('Ymd');
        if (!is_dir($saveDir)) {
            mkdir($saveDir, 0755, true);
        }

        // 生成唯一文件名
        $filename = $video_id . '.mp4';
        $localPath = DS . 'uploads' . DS . 'videos' . DS . date('Ymd') . DS . $filename;
        $fullPath = $saveDir . DS . $filename;

        // 3. 下载视频
        $videoData = $this->downloadVideo($apiUrl, $apiKey);

        // 4. 保存视频文件
        if (file_put_contents($fullPath, $videoData) === false) {
            throw new Exception('视频保存失败');
        }

        // 确保路径使用正斜杠，并只保存相对路径部分
        $localPath = str_replace('\\', '/', $localPath);
        // 移除开头的斜杠，确保路径格式为uploads/videos/...
        $savePath = ltrim($localPath, '/');

        // 将正确格式的文件路径存入数据库
        Db::name('video')->where('video_id', $video_id)->update([
            'web_url' => $savePath
        ]);

        // 返回成功响应
        return json([
            'code' => 0,
            'msg' => '视频下载成功',
            'data' => [
                'video_id' => $video_id,
                'local_path' => $localPath,
                'web_url' => $savePath,
                'file_size' => filesize($fullPath)
            ]
        ]);
    }


    /**
     * 获取视频状态
     */
    private function fetchVideoStatus($url, $apiKey) {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPGET, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Authorization: Bearer ' . $apiKey,
            'Accept: application/json'
        ]);
        curl_setopt($ch, CURLOPT_TIMEOUT, 30);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $error = curl_error($ch);
        curl_close($ch);

        if ($error) {
            throw new Exception('获取视频状态失败: ' . $error);
        }

        if ($httpCode < 200 || $httpCode >= 300) {
            throw new Exception('获取视频状态失败，HTTP状态码: ' . $httpCode);
        }

        $data = json_decode($response, true);
        if (!is_array($data)) {
            throw new Exception('视频状态数据格式错误');
        }

        return $data;
    }

    /**
     * 下载视频文件
     */
    private function downloadVideo($url, $apiKey) {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPGET, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Authorization: Bearer ' . $apiKey
        ]);
        curl_setopt($ch, CURLOPT_TIMEOUT, 300);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $error = curl_error($ch);
        curl_close($ch);

        if ($error) {
            throw new Exception('视频下载失败: ' . $error);
        }

        if ($httpCode < 200 || $httpCode >= 300) {
            throw new Exception('视频下载失败，HTTP状态码: ' . $httpCode);
        }

        return $response;
    }



    private function sendPostRequest($url, $data, $apiKey)
    {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Authorization: Bearer ' . $apiKey,
            'Accept: application/json',
            'Content-Type: application/json'
        ]);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
        curl_setopt($ch, CURLOPT_TIMEOUT, 60); // 延长超时时间
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $error = curl_error($ch);
        curl_close($ch);
        return [
            'response' => $response,
            'http_code' => $httpCode,
            'error' => $error
        ];
    }


    /**
     * 查询模版
     */
    public function product_template()
    {
        $params = $this->request->param();
        if (!$this->request->isGet()) {
            $this->error('请求方法错误');
        }
        $page = isset($params['page']) ? (int)$params['page'] : 1;
        $limit = isset($params['limit']) ? (int)$params['limit'] : 30;

        $where = [];
        if (!empty($params['search'])) {
            $where['id|chinese_description|template_name|style'] = ['like', '%' . $params['search'] . '%'];
        }

        // toexamine / release：用 isset + 非空串，避免 empty(0) 导致「未发布」无法筛选；release 建议库中为 0/1
        if (isset($params['toexamine']) && $params['toexamine'] !== '') {
            $where['toexamine'] = $params['toexamine'];
        }
        if (isset($params['release']) && $params['release'] !== '') {
            $where['release'] = is_numeric($params['release']) ? (int) $params['release'] : $params['release'];
        }

        $isSuperAdmin = false;
        if (!empty($params['sys_id']) && $params['sys_id'] == '超级管理员') {
            $isSuperAdmin = true;
        }

        if (!$isSuperAdmin && !empty($params['sys_id'])) {
            $where['sys_id'] = ['like', '%' . $params['sys_id'] . '%'];
            $products = Db::name('product_template')->order('id desc')->where($where)
                ->whereNull('mod_rq')
                ->limit(($page - 1) * $limit, $limit)
                ->select();
        }else{
            $products = Db::name('product_template')->order('id desc')->where($where)
                ->whereNull('mod_rq')
                ->limit(($page - 1) * $limit, $limit)
                ->select();
        }
        $total = Db::name('product_template')->where($where)
            ->whereNull('mod_rq')
            ->count();

        foreach ($products as &$item) {
            if (!empty($item['template_image_url'])) {
                $item['template_image_url'] = Common::ossFullUrl((string)$item['template_image_url']);
            }
            if (!empty($item['thumbnail_image'])) {
                $item['thumbnail_image'] = Common::ossFullUrl((string)$item['thumbnail_image']);
            }
        }
        unset($item);

        return json([
            'code' => 0,
            'msg' => '请求成功',
            'count' => $total,
            'data' => $products
        ]);
    }


    /**
     * 获取 AI 模型配置
     * status 1 = 启用 0 = 禁用（同一模型内的优先级，数值越小越优先）
     * model_type 支持多能力逗号间隔（如 文生图,图生图），传参精确匹配某一能力
     * 可选参数：manage=1 时返回全部（含禁用），用于管理端
     */
    public function GetAIModel(){
        $params = $this->request->param();
        $query = Db::name('ai_model');
        if (empty($params['manage'])) {
            $query->where('status', '1');
        }
        if (!empty($params['model_type'])) {
            $query->whereRaw('FIND_IN_SET(:mt, model_type) > 0', ['mt' => trim($params['model_type'])]);
        }
        if (!empty($params['supplier'])) {
            $query->where('supplier', 'like', '%' . $params['supplier'] . '%');
        }
        if (!empty($params['model_name'])) {
            $query->where('model_name|model_alias', 'like', '%' . $params['model_name'] . '%');
        }
        $list  = $query
            ->field('id,model_alias,model_group,model_name,model_type,sort,status,supplier')
            ->order('sort ASC, id ASC')->select();
        return json([
            'code' => 0,
            'msg' => '成功',
            'data' => $list
        ]);
    }

    /**
     * 新增 AI 模型配置
     * POST: status, supplier, api_key, api_url, model_group, model_name, model_alias, model_type, sort
     * model_type 多能力用逗号间隔，如：文生图,图生图
     */
    public function AddAIModel(){
        $params = $this->request->param();
        $required = ['api_url', 'api_key', 'model_name', 'model_type'];
        foreach ($required as $k) {
            if (empty(trim($params[$k] ?? ''))) {
                return json(['code' => 1, 'msg' => $k . ' 不能为空']);
            }
        }
        $insert = [
            'status'      => $params['status'],
            'supplier'    => trim($params['supplier']),
            'api_key'     => trim($params['api_key']),
            'api_url'     => trim($params['api_url']),
            'model_group' => trim($params['model_group']),
            'model_name'  => trim($params['model_name']),
            'model_alias' => trim($params['model_alias']),
            'model_type'  => trim($params['model_type']),
            'sort'        => isset($params['sort']) ? intval($params['sort']) : 0,
        ];
        try {
            Db::name('ai_model')->insert($insert);
            return json(['code' => 0, 'msg' => '新增成功']);
        } catch (\Exception $e) {
            return json(['code' => 1, 'msg' => '新增失败: ' . $e->getMessage()]);
        }
    }

    /**
     * 修改 AI 模型配置
     * POST: id(必填), 其余字段同新增
     */
    public function UpdateAIModel(){
        $params = $this->request->param();
        if (empty($params['id'])) {
            return json(['code' => 1, 'msg' => 'id 不能为空']);
        }
        $id = intval($params['id']);
        $exists = Db::name('ai_model')->where('id', $id)->find();
        if (!$exists) {
            return json(['code' => 1, 'msg' => '记录不存在']);
        }
        $update = [];
        $fields = ['status', 'supplier', 'api_key', 'api_url', 'model_group', 'model_name', 'model_alias', 'model_type', 'sort'];
        foreach ($fields as $f) {
            if (array_key_exists($f, $params)) {
                $update[$f] = $f === 'sort' ? intval($params[$f]) : trim($params[$f] ?? '');
            }
        }
        if (empty($update)) {
            return json(['code' => 1, 'msg' => '无有效修改字段']);
        }
        try {
            Db::name('ai_model')->where('id', $id)->update($update);
            return json(['code' => 0, 'msg' => '修改成功']);
        } catch (\Exception $e) {
            return json(['code' => 1, 'msg' => '修改失败: ' . $e->getMessage()]);
        }
    }

    /**
     * 用于获取所有产品记录
     **/
    public function GetProductList(){
        $params = $this->request->param();
        $page = max(1, intval($params['page'] ?? 1));
        $pageSize = min(100, max(1, intval($params['limit'] ?? 30)));

        // 构建查询条件
        $where = [];
        if (!empty($params['search'])) {
            $where['prompt|model'] = ['like', '%' . $params['search'] . '%'];
        }
        if (!empty($params['sys_id'])) {
            $where['sys_id'] = ['like', '%' . $params['sys_id'] . '%'];
        }

        $prompt = Db::name('product_image_generate')->field('prompt')->where($where)->group('prompt')->order('id desc')->select();
        $data = Db::name('product_image_generate')->where($where)->order('id desc')->page($page, $pageSize)->select();

        $count = Db::name('product_image_generate')->field('prompt')->where($where)->order('id desc')->count();
        foreach ($data as &$item) {
            if (!empty($item['generated_image']) || !empty($item['product_img']) || !empty($item['reference_image'])) {
                $item['generated_image'] = Common::ossFullUrl((string)$item['generated_image']);
                $item['product_img'] = Common::ossFullUrl((string)$item['product_img']);
                $item['reference_image'] = Common::ossFullUrl((string)$item['reference_image']);
            }
        }
        unset($item);

        return json([
            'code' => 0,
            'msg' => '成功',
            'count' => $count,
            'prompt' => $prompt,
            'data' => $data
        ]);
    }

    /**
     * 查询队列列表
     * 统计文件对应的队列情况
     */
    public function get_queue_logs()
    {
        $params = $this->request->param('old_image_file', '');
        $queue_logs = Db::name('queue_logs')
            ->where('old_image_file', $params)
            ->order('id desc')
            ->select();

        $result = [];  //初始化变量，避免未定义错误

        foreach ($queue_logs as &$log) {
            $taskId = $log['id'];
            $statusCount = Db::name('image_task_log')
                ->field('status, COUNT(*) as count')
                ->where('task_id', $taskId)
                ->where('mod_rq', null)
                ->group('status')
                ->select();

            $log['已完成数量'] = 0;
            $log['处理中数量'] = 0;
            $log['排队中的数量'] = 0;
            $log['失败数量'] = 0;

            foreach ($statusCount as $item) {
                switch ($item['status']) {
                    case 0:
                        $log['排队中的数量'] = $item['count'];
                        break;
                    case 1:
                        $log['处理中数量'] = $item['count'];
                        break;
                    case 2:
                        $log['已完成数量'] = $item['count'];
                        break;
                    case -1:
                        $log['失败数量'] = $item['count'];
                        break;
                }
            }

            // if ($log['排队中的数量'] >$log['已完成数量']) {
            //     $result[] = $log;
            // }

            if ($log['排队中的数量']) {
                $result[] = $log;
            }

            // if ($log['处理中数量'] >= 0) {
            //     $result[] = $log;
            // }
        }

        return json([
            'code' => 0,
            'msg'  => '查询成功',
            'data' => $result,
            'count' => count($result)
        ]);
    }

    /**
     * 查询总队列状态(统计当前处理的数据量)
     */
    public function queueStats()
    {
        $statusList = Db::name('image_task_log')
            ->field('status, COUNT(*) as total')
            ->where('mod_rq', null)
            ->where('create_time', '>=', date('Y-m-d 00:00:00'))
            ->group('status')
            ->select();


        $statusCount = [];
        foreach ($statusList as $item) {
            $statusCount[$item['status']] = $item['total'];
        }
        // 总数为所有状态和
        $total = array_sum($statusCount);
        //获取队列当前状态
        $statusText = Db::name('queue_logs')->order('id desc')->value('status');
        return json([
            'code' => 0,
            'msg' => '获取成功',
            'data' => [
                '总任务数'     => $total,
                '待处理'   => $statusCount[0]  ?? 0,
                '处理中'   => $statusCount[1]  ?? 0,
                '成功'   => $statusCount[2]  ?? 0,
                '失败'     => $statusCount[-1] ?? 0,
                '当前状态' => $statusText
            ]
        ]);
    }

    /**
     * 获取 Redis 连接实例
     * @return \Redis|null Redis 实例或 null（如果连接失败）
     */
    private function getRedisConnection()
    {
        if (!class_exists('\Redis')) {
            return null;
        }
        return getTaskRedis();
    }

    /**
     * 显示当前运行中的队列监听进程
     */
    public function viewQueueStatus()
    {
        $redis = $this->getRedisConnection();
        if (!$redis) {
            return json([
                'code' => 1,
                'msg' => 'Redis扩展未安装或未启用',
                'data' => null
            ]);
        }

        $key = 'queues:imgtotxt';

        // 判断 key 是否存在，避免报错
        if (!$redis->exists($key)) {
            return json([
                'code' => 0,
                'msg'  => '查询成功，队列为空',
                'count' => 0,
                'tasks_preview' => []
            ]);
        }

        $count = $redis->lLen($key);
        $list = $redis->lRange($key, 0, 9);

        // 解码 JSON 内容，确保每一项都有效
        $parsed = array_filter(array_map(function ($item) {
            return json_decode($item, true);
        }, $list), function ($item) {
            return !is_null($item);
        });

        return json([
            'code' => 0,
            'msg'  => '查询成功',
            'count' => $count,
            'tasks_preview' => $parsed
        ]);
    }

    /**
     * 清空队列并删除队列日志记录
     */
    public function stopQueueProcesses()
    {
        Db::name('image_task_log')
            ->where('log', '队列中')
            ->whereOr('status', 1)
            ->where('create_time', '>=', date('Y-m-d 00:00:00'))
            ->update([
                'status' => "-1",
                'log' => '清空取消队列',
                'mod_rq' => date('Y-m-d H:i:s')
            ]);

        Db::name('image_task_log')
            ->whereLike('log', '%处理中%')
            ->where('create_time', '>=', date('Y-m-d 00:00:00'))
            ->update([
                'status' => "-1",
                'log' => '清空取消队列',
                'mod_rq' => date('Y-m-d H:i:s')
            ]);

        $redis = $this->getRedisConnection();
        if (!$redis) {
            return json([
                'code' => 1,
                'msg' => 'Redis扩展未安装或未启用',
                'data' => null
            ]);
        }

        $key_txttoimg = 'queues:txttoimg:reserved';
        $key_txttotxt = 'queues:txttotxt:reserved';
        $key_imgtotxt = 'queues:imgtotxt:reserved';
        $key_imgtoimg = 'queues:imgtoimg:reserved';


        // 清空 Redis 队列
        $redis->del($key_txttoimg);
        $redis->del($key_txttotxt);
        $redis->del($key_imgtotxt);
        $redis->del($key_imgtoimg);

        $count = $redis->lLen($key_txttoimg) + $redis->lLen($key_txttotxt) + $redis->lLen($key_imgtotxt) + $redis->lLen($key_imgtoimg);

        return json([
            'code' => 0,
            'msg'  => '成功停止队列任务'
        ]);
    }

    /**
     *获取服务器URL地址和端口 IP地址:端口
     * 用于获取图片路径拼接时
     **/
    public function GetHttpUrl(){
        $data = Db::name('http_url')->find();
        $fullUrl = "http://" . $data['baseUrl'] . ":" . $data['port'];
        $res = [
            'code' => 0,
            'msg' => '成功',
            'data' => [
                'id' => $data['id'],
                'full_url' => $fullUrl,
                'baseUrl' => $data['baseUrl'],
                'port' => $data['port']
            ]
        ];
        return json($res);
    }



    /**
     * 构建图生视频 content：单帧无 role，双帧带 first_frame / last_frame
     */
    private function buildImgToVideoContent(string $prompt, string $firstImageUrl, string $lastImageUrl): array
    {
        $content = [
            ['type' => 'text', 'text' => $prompt],
        ];

        if ($lastImageUrl !== '') {
            $content[] = [
                'type' => 'image_url',
                'image_url' => ['url' => $firstImageUrl],
                'role' => 'first_frame',
            ];
            $content[] = [
                'type' => 'image_url',
                'image_url' => ['url' => $lastImageUrl],
                'role' => 'last_frame',
            ];
            return $content;
        }

        $content[] = [
            'type' => 'image_url',
            'image_url' => ['url' => $firstImageUrl],
        ];
        return $content;
    }

    /** 图生视频创建前，帧图暂存 OSS 子目录（AI 返回 id 后会迁移到正式目录） */
    private const FRAME_OSS_STAGING_ID = '_staging';

    /**
     * 任务 id 用于路径的安全片段
     */
    private function sanitizeTaskIdSegment(string $taskId): string
    {
        $segment = preg_replace('/[\\\\\/:*?"<>|]/u', '_', trim($taskId));
        return $segment !== '' ? $segment : '_unknown';
    }

    /**
     * 图生视频任务媒体本地目录：public/uploads/videos/{日期}/{taskId}/
     */
    private function buildTaskMediaLocalDir(string $taskId): string
    {
        return str_replace('\\', '/', ROOT_PATH . 'public/uploads/videos/' . date('Ymd') . '/' . $this->sanitizeTaskIdSegment($taskId) . '/');
    }

    /**
     * 图生视频任务媒体 OSS 对象键：uploads/videos/{日期}/{taskId}/{文件名}（帧图与生成视频同目录）
     */
    private function buildTaskMediaObjectKey(string $taskId, string $fileName): string
    {
        return 'uploads/videos/' . date('Ymd') . '/' . $this->sanitizeTaskIdSegment($taskId) . '/' . ltrim($fileName, '/');
    }

    /**
     * 解析帧图片（含本地路径与暂存 OSS 信息，供创建任务后按 AI id 归档）
     * @return array{type:string,api_url:string,local_path:string,staging_object_key:string}
     */
    private function resolveFrameImagePayload(array $params, string $role, string &$error = ''): array
    {
        $empty = ['type' => 'empty', 'api_url' => '', 'local_path' => '', 'staging_object_key' => ''];
        $prefix = $role === 'last' ? 'last' : 'first';
        $error = '';
        $taskId = trim((string)($params['task_id'] ?? $params['video_id'] ?? ''));
        $ossTaskId = $taskId !== '' ? $taskId : self::FRAME_OSS_STAGING_ID;

        $uploadedFile = $this->request->file("{$prefix}_image");
        if (!empty($uploadedFile)) {
            $fileList = is_array($uploadedFile) ? $uploadedFile : [$uploadedFile];
            foreach ($fileList as $file) {
                if (!$file) {
                    continue;
                }
                $fileError = '';
                $result = $this->uploadFrameFileToOss($file, $prefix, $fileError, $ossTaskId);
                if (($result['url'] ?? '') !== '') {
                    return [
                        'type' => 'local',
                        'api_url' => $result['url'],
                        'local_path' => $result['local_path'] ?? '',
                        'staging_object_key' => $result['object_key'] ?? '',
                    ];
                }
                if ($fileError !== '') {
                    $error = $fileError;
                }
            }
        }

        $base64Keys = ["{$prefix}_image", "{$prefix}_image_base64"];
        foreach ($base64Keys as $key) {
            if (empty($params[$key]) || !is_string($params[$key])) {
                continue;
            }
            $raw = trim($params[$key]);
            if ($raw === '' || strlen($raw) < 50) {
                continue;
            }
            $result = $this->uploadBase64ImageToOss($raw, $prefix, $ossTaskId);
            if (($result['url'] ?? '') !== '') {
                return [
                    'type' => 'local',
                    'api_url' => $result['url'],
                    'local_path' => $result['local_path'] ?? '',
                    'staging_object_key' => $result['object_key'] ?? '',
                ];
            }
        }

        $urlKey = "{$prefix}_image_url";
        if (!empty($params[$urlKey])) {
            $url = trim((string)$params[$urlKey]);
            if (stripos($url, 'http://') === 0 || stripos($url, 'https://') === 0) {
                return ['type' => 'external', 'api_url' => $url, 'local_path' => '', 'staging_object_key' => ''];
            }
        }

        return $empty;
    }

    /**
     * AI 返回任务 id 后，将本地帧图上传到 uploads/videos/{日期}/{taskId}/（与生成视频同目录）
     */
    private function finalizeFrameImageToOss(array $payload, string $taskId): string
    {
        if (($payload['type'] ?? '') === 'external') {
            return (string)($payload['api_url'] ?? '');
        }
        if (($payload['type'] ?? '') !== 'local') {
            return '';
        }

        $localPath = (string)($payload['local_path'] ?? '');
        if ($localPath === '' || !is_file($localPath)) {
            return (string)($payload['api_url'] ?? '');
        }

        $objectKey = $this->buildTaskMediaObjectKey($taskId, basename($localPath));
        $stagingKey = (string)($payload['staging_object_key'] ?? '');
        if ($stagingKey !== '' && $stagingKey === $objectKey) {
            return (string)($payload['api_url'] ?? '') ?: Common::ossFullUrl($objectKey);
        }
        $upload = $this->uploadToOSS($localPath, $objectKey);
        if (!$upload['success']) {
            Log::write('[finalizeFrameImageToOss] OSS上传失败: ' . $objectKey, 'error');
            return (string)($payload['api_url'] ?? '');
        }

        if ($stagingKey !== '' && $stagingKey !== $objectKey) {
            Common::deleteOssObject($stagingKey);
        }

        return $upload['url'] !== '' ? $upload['url'] : Common::ossFullUrl($objectKey);
    }

    /**
     * 解析帧图片：form-data 文件 > base64 > http(s) URL
     */
    private function resolveFrameImageUrl(array $params, string $role, string &$error = ''): string
    {
        $payload = $this->resolveFrameImagePayload($params, $role, $error);
        return (string)($payload['api_url'] ?? '');
    }

    /**
     * form-data 上传的图片落盘并同步 OSS
     * @return array{url:string,local_path:string,object_key:string}
     */
    private function uploadFrameFileToOss($file, string $roleLabel, string &$error = '', string $taskId = ''): array
    {
        $empty = ['url' => '', 'local_path' => '', 'object_key' => ''];
        if ($taskId === '') {
            $taskId = self::FRAME_OSS_STAGING_ID;
        }
        $error = '';
        $ext = $this->resolveUploadedImageExt($file);
        if ($ext === '') {
            $error = '不支持的图片格式';
            Log::write('[uploadFrameFileToOss] ' . $error, 'error');
            return $empty;
        }

        $uploadInfo = $file->getInfo();
        $tmpPath = isset($uploadInfo['tmp_name']) ? (string)$uploadInfo['tmp_name'] : '';
        if ($tmpPath === '' || !is_file($tmpPath)) {
            $tmpPath = (string)($file->getRealPath() ?: '');
        }
        if ($tmpPath === '' || !is_file($tmpPath)) {
            $uploadErr = $uploadInfo['error'] ?? UPLOAD_ERR_NO_FILE;
            $error = '未接收到上传文件(错误码' . $uploadErr . ')';
            Log::write('[uploadFrameFileToOss] ' . $error, 'error');
            return $empty;
        }

        $saveDir = $this->buildTaskMediaLocalDir($taskId);
        if (!is_dir($saveDir)) {
            mkdir($saveDir, 0755, true);
        }

        $saveFileName = $roleLabel . '_' . str_replace('.', '', uniqid('', true)) . '.' . $ext;
        $localFullPath = $saveDir . $saveFileName;
        $saved = false;

        if (method_exists($file, 'isValid') && $file->isValid()) {
            $info = $file->move($saveDir, $saveFileName);
            if ($info) {
                $localFullPath = $saveDir . $info->getFilename();
                $saved = true;
            }
        }
        if (!$saved && !@copy($tmpPath, $localFullPath)) {
            $moveErr = method_exists($file, 'getError') ? (string)$file->getError() : 'copy失败';
            $error = '图片保存失败: ' . $moveErr;
            Log::write('[uploadFrameFileToOss] ' . $error, 'error');
            return $empty;
        }

        $objectKey = $this->buildTaskMediaObjectKey($taskId, basename($localFullPath));
        $upload = $this->uploadToOSS($localFullPath, $objectKey);
        if (!$upload['success']) {
            $error = 'OSS上传失败';
            Log::write('[uploadFrameFileToOss] ' . $error . ' | ' . $objectKey, 'error');
            return $empty;
        }

        $url = $upload['url'] !== '' ? $upload['url'] : Common::ossFullUrl($objectKey);
        return [
            'url' => $url,
            'local_path' => $localFullPath,
            'object_key' => $upload['object_key'] ?? $objectKey,
        ];
    }

    /**
     * 解析上传图片扩展名
     */
    private function resolveUploadedImageExt($file): string
    {
        $name = $file->getInfo('name') ?? '';
        $ext = strtolower(pathinfo($name, PATHINFO_EXTENSION));
        if ($ext === 'jpeg') {
            $ext = 'jpg';
        }
        $allowed = ['jpg', 'png', 'gif', 'webp', 'bmp'];
        if ($ext && in_array($ext, $allowed, true)) {
            return $ext;
        }
        $mime = method_exists($file, 'getMime') ? strtolower((string)$file->getMime()) : '';
        $map = [
            'image/jpeg' => 'jpg',
            'image/png' => 'png',
            'image/gif' => 'gif',
            'image/webp' => 'webp',
            'image/bmp' => 'bmp',
        ];
        return $map[$mime] ?? '';
    }

    /**
     * base64 图片落盘并上传 OSS
     * @return array{url:string,local_path:string,object_key:string}
     */
    private function uploadBase64ImageToOss(string $base64Input, string $roleLabel, string $taskId = ''): array
    {
        $empty = ['url' => '', 'local_path' => '', 'object_key' => ''];
        if ($taskId === '') {
            $taskId = self::FRAME_OSS_STAGING_ID;
        }
        $parsed = $this->parseBase64Image($base64Input);
        if ($parsed === null) {
            return $empty;
        }

        [$ext, $imageData] = $parsed;
        $saveDir = $this->buildTaskMediaLocalDir($taskId);
        if (!is_dir($saveDir)) {
            mkdir($saveDir, 0755, true);
        }

        $fileName = $roleLabel . '_' . str_replace('.', '', uniqid('', true)) . '.' . $ext;
        $localFullPath = $saveDir . $fileName;
        if (file_put_contents($localFullPath, $imageData) === false) {
            Log::write('[uploadBase64ImageToOss] 本地保存失败: ' . $localFullPath, 'error');
            return $empty;
        }

        $objectKey = $this->buildTaskMediaObjectKey($taskId, $fileName);
        $upload = $this->uploadToOSS($localFullPath, $objectKey);
        if (!$upload['success']) {
            Log::write('[uploadBase64ImageToOss] OSS上传失败: ' . $objectKey, 'error');
            return $empty;
        }

        $url = $upload['url'] !== '' ? $upload['url'] : Common::ossFullUrl($objectKey);
        return [
            'url' => $url,
            'local_path' => $localFullPath,
            'object_key' => $upload['object_key'] ?? $objectKey,
        ];
    }

    /**
     * 解析 base64 图片（支持 data URI 与纯 base64）
     * @return array{0:string,1:string}|null [扩展名, 二进制内容]
     */
    private function parseBase64Image(string $base64Input): ?array
    {
        $base64Input = trim($base64Input);
        if ($base64Input === '') {
            return null;
        }

        if (preg_match('/^data:image\/(png|jpe?g|webp);base64,(.+)$/is', $base64Input, $m)) {
            $ext = strtolower($m[1]) === 'jpeg' ? 'jpg' : strtolower($m[1]);
            $raw = preg_replace('/\s+/', '', $m[2]);
            $imageData = base64_decode($raw, true);
        } else {
            $raw = preg_replace('/\s+/', '', $base64Input);
            $imageData = base64_decode($raw, true);
            $ext = $imageData !== false ? $this->detectImageExtension($imageData) : '';
        }

        if ($imageData === false || strlen($imageData) < 100 || $ext === '') {
            return null;
        }

        return [$ext, $imageData];
    }

    private function detectImageExtension(string $imageData): string
    {
        if (strncmp($imageData, "\x89PNG\r\n\x1a\n", 8) === 0) {
            return 'png';
        }
        if (strncmp($imageData, "\xFF\xD8\xFF", 3) === 0) {
            return 'jpg';
        }
        if (strlen($imageData) >= 12 && substr($imageData, 0, 4) === 'RIFF' && substr($imageData, 8, 4) === 'WEBP') {
            return 'webp';
        }
        return 'jpg';
    }

    /**
     * 将本地文件上传到阿里云 OSS
     *
     * @param string $file 本地完整路径，或 public 下相对路径（如 uploads/videos/20260604/xxx.mp4）
     * @param string $objectKey OSS 对象键；传 uploads/ 开头或带扩展名则视为完整键，否则作为子目录标识（如 task_id）
     * @return array{success:bool,object_key:string,url:string}
     */
    private function uploadToOSS(string $file, string $objectKey = ''): array
    {
        $localFullPath = $this->resolvePublicLocalPath($file);
        if ($localFullPath === '') {
            Log::write('[uploadToOSS] 本地文件不存在: ' . $file, 'error');
            return ['success' => false, 'object_key' => '', 'url' => ''];
        }

        $fileName = basename($localFullPath);
        if ($objectKey !== '' && (strpos($objectKey, 'uploads/') === 0 || preg_match('/\.[a-z0-9]{1,8}$/i', $objectKey))) {
            $ossObjectKey = Common::normalizeOssObjectKey($objectKey);
        } else {
            $segments = ['uploads', 'videos', date('Ymd')];
            if ($objectKey !== '') {
                $segments[] = preg_replace('/[\\\\\/:*?"<>|]/u', '_', $objectKey);
            }
            $segments[] = $fileName;
            $ossObjectKey = implode('/', $segments);
        }

        $success = $this->uploadLocalFileToAliyunOss($localFullPath, $ossObjectKey);
        return [
            'success' => $success,
            'object_key' => $ossObjectKey,
            'url' => $success ? Common::ossFullUrl($ossObjectKey) : '',
        ];
    }

    /**
     * 上传本地文件到阿里云 OSS（仅 WorkOrder 内实现，不修改 Common）
     */
    private function uploadLocalFileToAliyunOss(string $localFullPath, string $objectKey): bool
    {
        if (!Common::isOssEnabled() || !is_file($localFullPath)) {
            return false;
        }
        $objectKey = Common::normalizeOssObjectKey($objectKey);
        if ($objectKey === '') {
            return false;
        }

        if (class_exists(\OSS\OssClient::class, true)) {
            try {
                $config = Common::getOssConfig();
                $client = new \OSS\OssClient(
                    $config['accessKeyId'],
                    $config['accessKeySecret'],
                    $config['endpoint']
                );
                $client->uploadFile($config['bucket'], $objectKey, $localFullPath);
                return true;
            } catch (\Throwable $e) {
                Log::write('[uploadLocalFileToAliyunOss SDK] ' . $e->getMessage() . ' | ' . $objectKey, 'error');
            }
        }

        return $this->putLocalFileToAliyunOssByCurl($localFullPath, $objectKey);
    }

    /**
     * 无 OSS SDK 时通过 REST PUT 上传
     */
    private function putLocalFileToAliyunOssByCurl(string $localFullPath, string $objectKey): bool
    {
        $config = Common::getOssConfig();
        $content = file_get_contents($localFullPath);
        if ($content === false) {
            return false;
        }

        $mime = function_exists('mime_content_type') ? (mime_content_type($localFullPath) ?: '') : '';
        if ($mime === '') {
            $ext = strtolower(pathinfo($localFullPath, PATHINFO_EXTENSION));
            $mimeMap = [
                'jpg' => 'image/jpeg', 'jpeg' => 'image/jpeg', 'png' => 'image/png',
                'gif' => 'image/gif', 'webp' => 'image/webp', 'mp4' => 'video/mp4',
            ];
            $mime = $mimeMap[$ext] ?? 'application/octet-stream';
        }

        $date = gmdate('D, d M Y H:i:s \G\M\T');
        $bucket = $config['bucket'];
        $endpoint = ltrim((string)$config['endpoint'], 'https://');
        $endpoint = ltrim($endpoint, 'http://');
        $canonicalizedResource = '/' . $bucket . '/' . $objectKey;
        $stringToSign = "PUT\n\n{$mime}\n{$date}\n{$canonicalizedResource}";
        $signature = base64_encode(hash_hmac('sha1', $stringToSign, $config['accessKeySecret'], true));
        $urlPath = implode('/', array_map('rawurlencode', explode('/', $objectKey)));
        $url = 'https://' . $bucket . '.' . $endpoint . '/' . $urlPath;

        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
        curl_setopt($ch, CURLOPT_POSTFIELDS, $content);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Date: ' . $date,
            'Content-Type: ' . $mime,
            'Authorization: OSS ' . $config['accessKeyId'] . ':' . $signature,
        ]);
        curl_setopt($ch, CURLOPT_TIMEOUT, 300);
        $response = curl_exec($ch);
        $httpCode = (int)curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $curlError = curl_error($ch);
        curl_close($ch);

        if ($httpCode >= 200 && $httpCode < 300) {
            return true;
        }

        Log::write(
            '[putLocalFileToAliyunOssByCurl] http=' . $httpCode
            . ' err=' . $curlError
            . ' resp=' . substr((string)$response, 0, 500)
            . ' | objectKey=' . $objectKey,
            'error'
        );
        return false;
    }

    /**
     * 解析为 public 目录下的本地绝对路径
     */
    private function resolvePublicLocalPath(string $file): string
    {
        $file = str_replace('\\', '/', trim($file));
        if ($file === '') {
            return '';
        }
        if (is_file($file)) {
            return $file;
        }
        $publicPath = str_replace('\\', '/', ROOT_PATH . 'public/' . ltrim($file, '/'));
        return is_file($publicPath) ? $publicPath : '';
    }
}