@plolink/sdk 0.0.4 → 0.0.6

package/dist/modules/video-psych-analysis/index.cjs

@@ -0,0 +1,436 @@
+'use strict';
+
+var chunkY3UJVC2L_cjs = require('../../chunk-Y3UJVC2L.cjs');
+var chunkJR4HYYQI_cjs = require('../../chunk-JR4HYYQI.cjs');
+
+// src/modules/video-psych-analysis/index.ts
+var VideoPsychAnalysis = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 获取视频心理分析配置
+   * 
+   * @returns 配置信息（包括语言选项等）
+   * 
+   * @example
+   * ```typescript
+   * const config = await videoPsych.getConfig();
+   * console.log('语言选项:', config.languageOptions);
+   * console.log('默认语言:', config.defaultLanguage);
+   * ```
+   */
+  async getConfig() {
+    return this.client.axiosInstance.get("/api/v1/video-psych-analysis/config");
+  }
+  /**
+   * 查询分析任务列表
+   * 
+   * @param params - 查询参数（可选）
+   * @returns 任务列表
+   * @throws {PlolinkError} 当查询失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 查询所有已完成的任务
+   * const result = await videoPsych.list({
+   *   status: 'COMPLETED',
+   *   page: 1,
+   *   pageSize: 20
+   * });
+   * console.log(`共 ${result.total} 个任务`);
+   * result.list.forEach(item => {
+   *   console.log(`${item.name}: ${item.status}`);
+   * });
+   * ```
+   */
+  async list(params) {
+    return this.client.axiosInstance.get("/api/v1/video-psych-analysis", { params });
+  }
+  /**
+   * 创建视频心理分析任务
+   * 
+   * @param params - 创建参数
+   * @returns 创建结果，包含任务ID和初始状态
+   * @throws {PlolinkError} 当参数验证失败或创建失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await videoPsych.create({
+   *   name: '候选人A面试分析',
+   *   videoFileIds: ['file1', 'file2', 'file3'],
+   *   referenceImageFileId: 'refImage1',
+   *   prompt: '请以专业心理分析师的视角，分析候选人的情绪、态度和心理状态',
+   *   frameFps: 3,
+   *   language: 'zh'
+   * });
+   * console.log(`任务ID: ${result.id}, 状态: ${result.status}`);
+   * ```
+   */
+  async create(params) {
+    const { videoFileIds, referenceImageFileId, prompt, familyBackground, frameFps, language, name } = params;
+    if (!videoFileIds || videoFileIds.length === 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("videoFileIds is required and must not be empty", "INVALID_PARAMS");
+    }
+    if (!referenceImageFileId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("referenceImageFileId is required", "INVALID_PARAMS");
+    }
+    if (!prompt) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("prompt is required", "INVALID_PARAMS");
+    }
+    if (frameFps !== void 0 && (frameFps < 1 || frameFps > 30)) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("frameFps must be between 1 and 30", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.post("/api/v1/video-psych-analysis", {
+      name,
+      videoFileIds,
+      referenceImageFileId,
+      prompt,
+      familyBackground,
+      frameFps,
+      language
+    });
+  }
+  /**
+   * 获取分析任务详情
+   * 
+   * @param id - 任务ID
+   * @returns 任务详情信息
+   * @throws {PlolinkError} 当任务不存在或无权访问时抛出
+   * 
+   * @example
+   * ```typescript
+   * const detail = await videoPsych.getDetail('analysis_123');
+   * console.log(`任务: ${detail.name}`);
+   * console.log(`状态: ${detail.status}`);
+   * console.log(`进度: ${detail.progress.done}/${detail.progress.total}`);
+   * 
+   * if (detail.reportContent) {
+   *   console.log('报告已生成');
+   * }
+   * ```
+   */
+  async getDetail(id) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}`);
+  }
+  /**
+   * 获取视频元数据信息
+   * 
+   * @description
+   * 获取任务的视频元数据信息（videoInfo）。在异步模式下，任务创建时 videoInfo 为空，
+   * 需要等待任务进入 PROCESSING 状态后由定时任务自动同步。
+   * 
+   * **使用场景**：
+   * - 获取视频的宽高、时长、编码等信息用于界面展示
+   * - 在任务创建后轮询此接口直到获取到 videoInfo
+   * 
+   * **注意**：
+   * - 如果视频信息尚未生成，返回 null
+   * - 建议配合任务状态查询使用，等待状态变为 PROCESSING 后再查询
+   * 
+   * @param id - 任务ID
+   * @returns 视频元数据信息，如果尚未生成则返回 null
+   * @throws {PlolinkError} 当任务不存在时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 轮询获取 videoInfo
+   * const checkVideoInfo = async (analysisId: string) => {
+   *   const maxAttempts = 60;
+   *   let attempt = 0;
+   *   
+   *   while (attempt < maxAttempts) {
+   *     const videoInfo = await videoPsych.getVideoInfo(analysisId);
+   *     
+   *     if (videoInfo) {
+   *       console.log(`视频信息: ${videoInfo.width}x${videoInfo.height}`);
+   *       console.log(`时长: ${videoInfo.duration}s`);
+   *       console.log(`文件大小: ${(videoInfo.file_size / 1024 / 1024).toFixed(2)}MB`);
+   *       return videoInfo;
+   *     }
+   *     
+   *     console.log('视频信息还在处理中...');
+   *     await new Promise(resolve => setTimeout(resolve, 5000)); // 等待5秒
+   *     attempt++;
+   *   }
+   *   
+   *   throw new Error('获取视频信息超时');
+   * };
+   * 
+   * const info = await checkVideoInfo('analysis_123');
+   * ```
+   */
+  async getVideoInfo(id) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    try {
+      const response = await this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/video-info`);
+      return response.videoInfo || null;
+    } catch (error) {
+      if (error instanceof chunkY3UJVC2L_cjs.PlolinkError && error.code === 404) {
+        return null;
+      }
+      throw error;
+    }
+  }
+  /**
+   * 更新分析任务
+   * 
+   * @description
+   * 更新分析任务的基本信息（仅限 PENDING 和 FAILED 状态的任务）。
+   * 
+   * @param id - 任务ID
+   * @param params - 更新参数
+   * @returns 更新后的任务信息
+   * @throws {PlolinkError} 当任务不存在、状态不允许更新或更新失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const updated = await videoPsych.update('analysis_123', {
+   *   name: '李四的心理分析',
+   *   prompt: '请以临床心理学专家的视角进行分析'
+   * });
+   * console.log(`已更新: ${updated.name}`);
+   * ```
+   */
+  async update(id, params) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    if (!params.name && !params.prompt && !params.familyBackground) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("At least one field (name, prompt, or familyBackground) must be provided", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.patch(`/api/v1/video-psych-analysis/${id}`, params);
+  }
+  /**
+   * 删除分析任务
+   * 
+   * @description
+   * 删除分析任务（软删除）。
+   * 
+   * @param id - 任务ID
+   * @throws {PlolinkError} 当任务不存在或删除失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * await videoPsych.delete('analysis_123');
+   * console.log('任务已删除');
+   * ```
+   */
+  async delete(id) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.delete(`/api/v1/video-psych-analysis/${id}`);
+  }
+  /**
+   * 重试失败的分析任务
+   * 
+   * @description
+   * 对失败(FAILED)状态的任务进行重试，使用原有参数重新提交到AI引擎进行分析。
+   * 重试会清空之前的错误信息和分析结果，重新开始完整的分析流程。
+   * 
+   * **注意**：
+   * - 只能重试状态为 FAILED 的任务
+   * - 重试后任务状态会重置为 PENDING
+   * - 会清空之前的分析结果和报告内容
+   * - 建议配合 `watchAnalysisStatus()` 方法监听重试后的任务状态
+   * 
+   * @param id - 任务ID
+   * @returns 更新后的任务信息
+   * @throws {PlolinkError} 当任务不存在、状态不是FAILED或重试失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 重试失败的任务
+   * const result = await videoPsych.retry('analysis_123');
+   * console.log(`任务已重新提交: ${result.id}`);
+   * console.log(`当前状态: ${result.status}`);
+   * 
+   * // 监听重试后的任务状态
+   * const poller = videoPsych.watchAnalysisStatus(result.id, (detail) => {
+   *   console.log(`重试进度: ${detail.progress.done}/${detail.progress.total}`);
+   *   if (detail.status === 'COMPLETED') {
+   *     console.log('重试成功，分析完成！');
+   *   } else if (detail.status === 'FAILED') {
+   *     console.error('重试后仍失败');
+   *   }
+   * });
+   * poller.start();
+   * ```
+   */
+  async retry(id) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.post(`/api/v1/video-psych-analysis/${id}/retry`);
+  }
+  /**
+   * 同步任务状态
+   * 
+   * @description
+   * 主动触发后端从 AI TOOLS API 同步最新状态和中间结果。
+   * 
+   * **注意**：通常不需要手动调用此方法，系统会每30秒自动轮询同步所有非完成态的任务。
+   * 
+   * @param id - 任务ID
+   * @returns 同步后的状态信息
+   * @throws {PlolinkError} 当任务不存在或同步失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const status = await videoPsych.syncStatus('analysis_123');
+   * console.log(`当前状态: ${status.status}`);
+   * console.log(`进度: ${status.progress.done}/${status.progress.total}`);
+   * ```
+   */
+  async syncStatus(id) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/status`);
+  }
+  /**
+   * 轮询分析任务状态
+   * 
+   * @description
+   * 创建一个轮询器持续监听任务状态变化，直到任务达到终态（COMPLETED/FAILED）。
+   * 使用指数退避策略，初始间隔5秒，最大间隔30秒。
+   * 
+   * @param id - 任务ID
+   * @param onStatusChange - 状态变化回调函数
+   * @returns Poller实例，可用于手动停止轮询
+   * 
+   * @example
+   * ```typescript
+   * const poller = videoPsych.watchAnalysisStatus('analysis_123', (detail) => {
+   *   console.log(`状态: ${detail.status}`);
+   *   console.log(`进度: ${detail.progress.done}/${detail.progress.total} (${detail.progress.stage})`);
+   *   
+   *   if (detail.status === 'COMPLETED') {
+   *     console.log('分析完成，报告已生成！');
+   *     console.log(detail.reportContent);
+   *   } else if (detail.status === 'FAILED') {
+   *     console.error(`分析失败: ${detail.errorMessage}`);
+   *   }
+   * });
+   * 
+   * // 开始轮询
+   * poller.start();
+   * 
+   * // 需要时可以手动停止
+   * // poller.stop();
+   * ```
+   */
+  watchAnalysisStatus(id, onStatusChange) {
+    const poller = new chunkJR4HYYQI_cjs.Poller({
+      task: async () => {
+        await this.syncStatus(id);
+        return this.getDetail(id);
+      },
+      onResult: onStatusChange,
+      shouldStop: (detail) => {
+        return ["COMPLETED", "FAILED"].includes(detail.status);
+      },
+      initialInterval: 5e3,
+      // 5秒
+      maxInterval: 3e4,
+      // 30秒
+      backoffFactor: 1.5,
+      onError: (error) => {
+        this.client.logger.error("Analysis polling error", { error, id });
+      }
+    });
+    void poller.start();
+    return poller;
+  }
+  /**
+   * 获取文本维度分析结果
+   * 
+   * @param id - 任务ID
+   * @returns 文本维度分析数据
+   * @throws {PlolinkError} 当任务不存在或分析未完成时抛出
+   * 
+   * @example
+   * ```typescript
+   * const texts = await videoPsych.getTexts('analysis_123');
+   * console.log(`共 ${texts.total} 条文本`);
+   * texts.items.forEach(item => {
+   *   console.log(`${item.start_time}s: ${item.text}`);
+   *   if (item.nlp_result) {
+   *     console.log(`  情绪: ${item.nlp_result.speaker_emotion}`);
+   *     console.log(`  态度: ${item.nlp_result.real_attitude}`);
+   *   }
+   * });
+   * ```
+   */
+  async getTexts(id) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/texts`);
+  }
+  /**
+   * 获取帧维度分析结果
+   * 
+   * @param id - 任务ID
+   * @returns 帧维度分析数据
+   * @throws {PlolinkError} 当任务不存在或分析未完成时抛出
+   * 
+   * @example
+   * ```typescript
+   * const frames = await videoPsych.getFrames('analysis_123');
+   * console.log(`共 ${frames.total} 帧`);
+   * frames.items.forEach(item => {
+   *   console.log(`${item.timestamp}s: ${item.image_url}`);
+   *   if (item.vision_result) {
+   *     console.log(`  表情: ${item.vision_result.expression}`);
+   *     console.log(`  动作: ${item.vision_result.action}`);
+   *   }
+   * });
+   * ```
+   */
+  async getFrames(id) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/frames`);
+  }
+  /**
+   * 获取段落分析结果
+   * 
+   * @param id - 任务ID
+   * @returns 段落分析数据
+   * @throws {PlolinkError} 当任务不存在或分析未完成时抛出
+   * 
+   * @example
+   * ```typescript
+   * const paragraphs = await videoPsych.getParagraphs('analysis_123');
+   * console.log(`共 ${paragraphs.total} 段`);
+   * paragraphs.items.forEach(item => {
+   *   console.log(`段落 ${item.id}:`);
+   *   console.log(`  时间: ${item.start_time}s - ${item.end_time}s`);
+   *   console.log(`  内容: ${item.text}`);
+   *   console.log(`  摘要: ${item.summary}`);
+   *   if (item.nlp_result) {
+   *     console.log(`  情绪: ${item.nlp_result.speaker_emotion}`);
+   *     console.log(`  态度: ${item.nlp_result.real_attitude}`);
+   *   }
+   * });
+   * ```
+   */
+  async getParagraphs(id) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/paragraphs`);
+  }
+};
+
+exports.VideoPsychAnalysis = VideoPsychAnalysis;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/modules/video-psych-analysis/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/video-psych-analysis/index.ts"],"names":["PlolinkError","Poller"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * 视频人物心理分析模块\n * \n * @description\n * 提供视频人物心理分析相关功能，包括：\n * - 创建分析任务\n * - 查询任务详情和状态\n * - 同步任务状态（轮询）\n * - 获取分析结果（文本/帧/段落维度）\n * - 生成心理分析报告\n * \n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { VideoPsychAnalysis } from '@plolink/sdk/video-psych-analysis';\n * \n * const client = new PlolinkClient({\n *   mode: 'apiKey',\n *   apiKey: 'your-api-key'\n * });\n * \n * const videoPsych = new VideoPsychAnalysis(client);\n * \n * // 创建分析任务\n * const result = await videoPsych.create({\n *   name: '候选人A面试分析',\n *   videoFileIds: ['file1', 'file2'],\n *   referenceImageFileId: 'refImage1',\n *   prompt: '视频是某公司 CEO 的公开演讲，请分析他对某话题的真实态度',\n *   frameFps: 3,\n *   language: 'zh-CN'\n * });\n * console.log(`任务已创建: ${result.id}`);\n * \n * // 轮询任务状态\n * const poller = videoPsych.watchAnalysisStatus(result.id, (detail) => {\n *   console.log(`分析进度: ${detail.progress.done}/${detail.progress.total}`);\n *   if (detail.status === 'COMPLETED') {\n *     console.log('分析完成，报告已生成！');\n *     console.log(detail.reportContent);\n *   }\n * });\n * ```\n * \n * @module video-psych-analysis\n */\n\nimport { PlolinkClient } from '../../core/client';\nimport { Poller } from '../../common/poller';\nimport { PlolinkError } from '../../core/error';\nimport type {\n  CreateVideoPsychAnalysisParams,\n  CreateVideoPsychAnalysisResponse,\n  VideoPsychAnalysisDetail,\n  SyncStatusResponse,\n  TextsData,\n  FramesData,\n  ParagraphsData,\n  ListVideoPsychAnalysesParams,\n  ListVideoPsychAnalysesResponse,\n  UpdateVideoPsychAnalysisParams,\n  UpdateVideoPsychAnalysisResponse,\n  VideoPsychAnalysisConfig,\n} from '../../types/video-psych-analysis';\n\nexport type {\n  VideoPsychAnalysisStatus,\n  CreateVideoPsychAnalysisParams,\n  VideoInfo,\n  AnalysisProgress,\n  FileInfo,\n  CreateVideoPsychAnalysisResponse,\n  VideoPsychAnalysisDetail,\n  SyncStatusResponse,\n  TextAnalysisItem,\n  TextsData,\n  FrameAnalysisItem,\n  FramesData,\n  ParagraphAnalysisItem,\n  ParagraphsData,\n  ListVideoPsychAnalysesParams,\n  VideoPsychAnalysisSummary,\n  ListVideoPsychAnalysesResponse,\n  UpdateVideoPsychAnalysisParams,\n  UpdateVideoPsychAnalysisResponse,\n  LanguageOption,\n  VideoPsychAnalysisConfig,\n} from '../../types/video-psych-analysis';\n\n/**\n * 视频人物心理分析模块\n */\nexport class VideoPsychAnalysis {\n  private client: PlolinkClient;\n\n  constructor(client: PlolinkClient) {\n    this.client = client;\n  }\n\n  /**\n   * 获取视频心理分析配置\n   * \n   * @returns 配置信息（包括语言选项等）\n   * \n   * @example\n   * ```typescript\n   * const config = await videoPsych.getConfig();\n   * console.log('语言选项:', config.languageOptions);\n   * console.log('默认语言:', config.defaultLanguage);\n   * ```\n   */\n  public async getConfig(): Promise<VideoPsychAnalysisConfig> {\n    return this.client.axiosInstance.get('/api/v1/video-psych-analysis/config');\n  }\n\n  /**\n   * 查询分析任务列表\n   * \n   * @param params - 查询参数（可选）\n   * @returns 任务列表\n   * @throws {PlolinkError} 当查询失败时抛出\n   * \n   * @example\n   * ```typescript\n   * // 查询所有已完成的任务\n   * const result = await videoPsych.list({\n   *   status: 'COMPLETED',\n   *   page: 1,\n   *   pageSize: 20\n   * });\n   * console.log(`共 ${result.total} 个任务`);\n   * result.list.forEach(item => {\n   *   console.log(`${item.name}: ${item.status}`);\n   * });\n   * ```\n   */\n  public async list(params?: ListVideoPsychAnalysesParams): Promise<ListVideoPsychAnalysesResponse> {\n    return this.client.axiosInstance.get('/api/v1/video-psych-analysis', { params });\n  }\n\n  /**\n   * 创建视频心理分析任务\n   * \n   * @param params - 创建参数\n   * @returns 创建结果，包含任务ID和初始状态\n   * @throws {PlolinkError} 当参数验证失败或创建失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const result = await videoPsych.create({\n   *   name: '候选人A面试分析',\n   *   videoFileIds: ['file1', 'file2', 'file3'],\n   *   referenceImageFileId: 'refImage1',\n   *   prompt: '请以专业心理分析师的视角，分析候选人的情绪、态度和心理状态',\n   *   frameFps: 3,\n   *   language: 'zh'\n   * });\n   * console.log(`任务ID: ${result.id}, 状态: ${result.status}`);\n   * ```\n   */\n  public async create(params: CreateVideoPsychAnalysisParams): Promise<CreateVideoPsychAnalysisResponse> {\n    const { videoFileIds, referenceImageFileId, prompt, familyBackground, frameFps, language, name } = params;\n\n    // 参数验证\n    if (!videoFileIds || videoFileIds.length === 0) {\n      throw new PlolinkError('videoFileIds is required and must not be empty', 'INVALID_PARAMS');\n    }\n\n    if (!referenceImageFileId) {\n      throw new PlolinkError('referenceImageFileId is required', 'INVALID_PARAMS');\n    }\n\n    if (!prompt) {\n      throw new PlolinkError('prompt is required', 'INVALID_PARAMS');\n    }\n\n    if (frameFps !== undefined && (frameFps < 1 || frameFps > 30)) {\n      throw new PlolinkError('frameFps must be between 1 and 30', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.post('/api/v1/video-psych-analysis', {\n      name,\n      videoFileIds,\n      referenceImageFileId,\n      prompt,\n      familyBackground,\n      frameFps,\n      language,\n    });\n  }\n\n  /**\n   * 获取分析任务详情\n   * \n   * @param id - 任务ID\n   * @returns 任务详情信息\n   * @throws {PlolinkError} 当任务不存在或无权访问时抛出\n   * \n   * @example\n   * ```typescript\n   * const detail = await videoPsych.getDetail('analysis_123');\n   * console.log(`任务: ${detail.name}`);\n   * console.log(`状态: ${detail.status}`);\n   * console.log(`进度: ${detail.progress.done}/${detail.progress.total}`);\n   * \n   * if (detail.reportContent) {\n   *   console.log('报告已生成');\n   * }\n   * ```\n   */\n  public async getDetail(id: string): Promise<VideoPsychAnalysisDetail> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}`);\n  }\n\n  /**\n   * 获取视频元数据信息\n   * \n   * @description\n   * 获取任务的视频元数据信息（videoInfo）。在异步模式下，任务创建时 videoInfo 为空，\n   * 需要等待任务进入 PROCESSING 状态后由定时任务自动同步。\n   * \n   * **使用场景**：\n   * - 获取视频的宽高、时长、编码等信息用于界面展示\n   * - 在任务创建后轮询此接口直到获取到 videoInfo\n   * \n   * **注意**：\n   * - 如果视频信息尚未生成，返回 null\n   * - 建议配合任务状态查询使用，等待状态变为 PROCESSING 后再查询\n   * \n   * @param id - 任务ID\n   * @returns 视频元数据信息，如果尚未生成则返回 null\n   * @throws {PlolinkError} 当任务不存在时抛出\n   * \n   * @example\n   * ```typescript\n   * // 轮询获取 videoInfo\n   * const checkVideoInfo = async (analysisId: string) => {\n   *   const maxAttempts = 60;\n   *   let attempt = 0;\n   *   \n   *   while (attempt < maxAttempts) {\n   *     const videoInfo = await videoPsych.getVideoInfo(analysisId);\n   *     \n   *     if (videoInfo) {\n   *       console.log(`视频信息: ${videoInfo.width}x${videoInfo.height}`);\n   *       console.log(`时长: ${videoInfo.duration}s`);\n   *       console.log(`文件大小: ${(videoInfo.file_size / 1024 / 1024).toFixed(2)}MB`);\n   *       return videoInfo;\n   *     }\n   *     \n   *     console.log('视频信息还在处理中...');\n   *     await new Promise(resolve => setTimeout(resolve, 5000)); // 等待5秒\n   *     attempt++;\n   *   }\n   *   \n   *   throw new Error('获取视频信息超时');\n   * };\n   * \n   * const info = await checkVideoInfo('analysis_123');\n   * ```\n   */\n  public async getVideoInfo(id: string): Promise<import('../../types/video-psych-analysis').VideoInfo | null> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    try {\n      const response: { taskId: string; videoInfo: import('../../types/video-psych-analysis').VideoInfo | null } = await this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/video-info`);\n      return response.videoInfo || null;\n    } catch (error: unknown) {\n      // 如果是 PlolinkError 且 HTTP 状态码为 404（视频信息尚未生成），返回 null\n      // 注意：axios interceptor 会将 HTTP 状态码作为 PlolinkError.code\n      if (error instanceof PlolinkError && error.code === 404) {\n        return null;\n      }\n      // 其他错误继续抛出\n      throw error;\n    }\n  }\n\n  /**\n   * 更新分析任务\n   * \n   * @description\n   * 更新分析任务的基本信息（仅限 PENDING 和 FAILED 状态的任务）。\n   * \n   * @param id - 任务ID\n   * @param params - 更新参数\n   * @returns 更新后的任务信息\n   * @throws {PlolinkError} 当任务不存在、状态不允许更新或更新失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const updated = await videoPsych.update('analysis_123', {\n   *   name: '李四的心理分析',\n   *   prompt: '请以临床心理学专家的视角进行分析'\n   * });\n   * console.log(`已更新: ${updated.name}`);\n   * ```\n   */\n  public async update(id: string, params: UpdateVideoPsychAnalysisParams): Promise<UpdateVideoPsychAnalysisResponse> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    if (!params.name && !params.prompt && !params.familyBackground) {\n      throw new PlolinkError('At least one field (name, prompt, or familyBackground) must be provided', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.patch(`/api/v1/video-psych-analysis/${id}`, params);\n  }\n\n  /**\n   * 删除分析任务\n   * \n   * @description\n   * 删除分析任务（软删除）。\n   * \n   * @param id - 任务ID\n   * @throws {PlolinkError} 当任务不存在或删除失败时抛出\n   * \n   * @example\n   * ```typescript\n   * await videoPsych.delete('analysis_123');\n   * console.log('任务已删除');\n   * ```\n   */\n  public async delete(id: string): Promise<{ message: string }> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.delete(`/api/v1/video-psych-analysis/${id}`);\n  }\n\n  /**\n   * 重试失败的分析任务\n   * \n   * @description\n   * 对失败(FAILED)状态的任务进行重试，使用原有参数重新提交到AI引擎进行分析。\n   * 重试会清空之前的错误信息和分析结果，重新开始完整的分析流程。\n   * \n   * **注意**：\n   * - 只能重试状态为 FAILED 的任务\n   * - 重试后任务状态会重置为 PENDING\n   * - 会清空之前的分析结果和报告内容\n   * - 建议配合 `watchAnalysisStatus()` 方法监听重试后的任务状态\n   * \n   * @param id - 任务ID\n   * @returns 更新后的任务信息\n   * @throws {PlolinkError} 当任务不存在、状态不是FAILED或重试失败时抛出\n   * \n   * @example\n   * ```typescript\n   * // 重试失败的任务\n   * const result = await videoPsych.retry('analysis_123');\n   * console.log(`任务已重新提交: ${result.id}`);\n   * console.log(`当前状态: ${result.status}`);\n   * \n   * // 监听重试后的任务状态\n   * const poller = videoPsych.watchAnalysisStatus(result.id, (detail) => {\n   *   console.log(`重试进度: ${detail.progress.done}/${detail.progress.total}`);\n   *   if (detail.status === 'COMPLETED') {\n   *     console.log('重试成功，分析完成！');\n   *   } else if (detail.status === 'FAILED') {\n   *     console.error('重试后仍失败');\n   *   }\n   * });\n   * poller.start();\n   * ```\n   */\n  public async retry(id: string): Promise<VideoPsychAnalysisDetail> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.post(`/api/v1/video-psych-analysis/${id}/retry`);\n  }\n\n  /**\n   * 同步任务状态\n   * \n   * @description\n   * 主动触发后端从 AI TOOLS API 同步最新状态和中间结果。\n   * \n   * **注意**：通常不需要手动调用此方法，系统会每30秒自动轮询同步所有非完成态的任务。\n   * \n   * @param id - 任务ID\n   * @returns 同步后的状态信息\n   * @throws {PlolinkError} 当任务不存在或同步失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const status = await videoPsych.syncStatus('analysis_123');\n   * console.log(`当前状态: ${status.status}`);\n   * console.log(`进度: ${status.progress.done}/${status.progress.total}`);\n   * ```\n   */\n  public async syncStatus(id: string): Promise<SyncStatusResponse> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/status`);\n  }\n\n  /**\n   * 轮询分析任务状态\n   * \n   * @description\n   * 创建一个轮询器持续监听任务状态变化，直到任务达到终态（COMPLETED/FAILED）。\n   * 使用指数退避策略，初始间隔5秒，最大间隔30秒。\n   * \n   * @param id - 任务ID\n   * @param onStatusChange - 状态变化回调函数\n   * @returns Poller实例，可用于手动停止轮询\n   * \n   * @example\n   * ```typescript\n   * const poller = videoPsych.watchAnalysisStatus('analysis_123', (detail) => {\n   *   console.log(`状态: ${detail.status}`);\n   *   console.log(`进度: ${detail.progress.done}/${detail.progress.total} (${detail.progress.stage})`);\n   *   \n   *   if (detail.status === 'COMPLETED') {\n   *     console.log('分析完成，报告已生成！');\n   *     console.log(detail.reportContent);\n   *   } else if (detail.status === 'FAILED') {\n   *     console.error(`分析失败: ${detail.errorMessage}`);\n   *   }\n   * });\n   * \n   * // 开始轮询\n   * poller.start();\n   * \n   * // 需要时可以手动停止\n   * // poller.stop();\n   * ```\n   */\n  public watchAnalysisStatus(\n    id: string,\n    onStatusChange: (detail: VideoPsychAnalysisDetail) => void\n  ): Poller<VideoPsychAnalysisDetail> {\n    const poller = new Poller<VideoPsychAnalysisDetail>({\n      task: async () => {\n        // 先同步状态，再获取详情\n        await this.syncStatus(id);\n        return this.getDetail(id);\n      },\n      onResult: onStatusChange,\n      shouldStop: (detail) => {\n        return ['COMPLETED', 'FAILED'].includes(detail.status);\n      },\n      initialInterval: 5000,   // 5秒\n      maxInterval: 30000,      // 30秒\n      backoffFactor: 1.5,\n      onError: (error) => {\n        this.client.logger.error('Analysis polling error', { error, id });\n      },\n    });\n\n    // 自动启动\n    void poller.start();\n\n    return poller;\n  }\n\n  /**\n   * 获取文本维度分析结果\n   * \n   * @param id - 任务ID\n   * @returns 文本维度分析数据\n   * @throws {PlolinkError} 当任务不存在或分析未完成时抛出\n   * \n   * @example\n   * ```typescript\n   * const texts = await videoPsych.getTexts('analysis_123');\n   * console.log(`共 ${texts.total} 条文本`);\n   * texts.items.forEach(item => {\n   *   console.log(`${item.start_time}s: ${item.text}`);\n   *   if (item.nlp_result) {\n   *     console.log(`  情绪: ${item.nlp_result.speaker_emotion}`);\n   *     console.log(`  态度: ${item.nlp_result.real_attitude}`);\n   *   }\n   * });\n   * ```\n   */\n  public async getTexts(id: string): Promise<TextsData> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/texts`);\n  }\n\n  /**\n   * 获取帧维度分析结果\n   * \n   * @param id - 任务ID\n   * @returns 帧维度分析数据\n   * @throws {PlolinkError} 当任务不存在或分析未完成时抛出\n   * \n   * @example\n   * ```typescript\n   * const frames = await videoPsych.getFrames('analysis_123');\n   * console.log(`共 ${frames.total} 帧`);\n   * frames.items.forEach(item => {\n   *   console.log(`${item.timestamp}s: ${item.image_url}`);\n   *   if (item.vision_result) {\n   *     console.log(`  表情: ${item.vision_result.expression}`);\n   *     console.log(`  动作: ${item.vision_result.action}`);\n   *   }\n   * });\n   * ```\n   */\n  public async getFrames(id: string): Promise<FramesData> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/frames`);\n  }\n\n  /**\n   * 获取段落分析结果\n   * \n   * @param id - 任务ID\n   * @returns 段落分析数据\n   * @throws {PlolinkError} 当任务不存在或分析未完成时抛出\n   * \n   * @example\n   * ```typescript\n   * const paragraphs = await videoPsych.getParagraphs('analysis_123');\n   * console.log(`共 ${paragraphs.total} 段`);\n   * paragraphs.items.forEach(item => {\n   *   console.log(`段落 ${item.id}:`);\n   *   console.log(`  时间: ${item.start_time}s - ${item.end_time}s`);\n   *   console.log(`  内容: ${item.text}`);\n   *   console.log(`  摘要: ${item.summary}`);\n   *   if (item.nlp_result) {\n   *     console.log(`  情绪: ${item.nlp_result.speaker_emotion}`);\n   *     console.log(`  态度: ${item.nlp_result.real_attitude}`);\n   *   }\n   * });\n   * ```\n   */\n  public async getParagraphs(id: string): Promise<ParagraphsData> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.get(`/api/v1/video-psych-analysis/${id}/paragraphs`);\n  }\n}\n"]}