@plolink/sdk 0.0.5 → 0.0.8

package/dist/modules/video-psych-analysis/index.d.cts

@@ -1,4 +1,4 @@
-import { P as PlolinkClient } from '../../client-CAjIQKPm.cjs';
+import { P as PlolinkClient } from '../../client-l6cekf09.cjs';
 import { P as Poller } from '../../poller-BlIRbwL4.cjs';
 import '../../core-77EbLgbp.cjs';
 import 'axios';
@@ -20,11 +20,13 @@ interface CreateVideoPsychAnalysisParams {
     videoFileIds: string[];
     /** 人物参考图文件ID */
     referenceImageFileId: string;
-    /** 用户Prompt（如：心理分析专家的专业风格） */
+    /** 人物背景与分析目标（如：视频是华为CEO任正非的公开演讲，请分析他对某话题的真实态度） */
     prompt: string;
+    /** 人物背景信息（Markdown格式，可选） */
+    familyBackground?: string;
     /** 切帧FPS（1-30，默认3） */
     frameFps?: number;
-    /** 分析语言（默认zh） */
+    /** 分析语言（默认zh-CN） */
     language?: string;
 }
 /**
@@ -49,6 +51,8 @@ interface VideoInfo {
     video_bitrate: number;
     /** 音频比特率 */
     audio_bitrate: number | null;
+    /** 首帧图URL */
+    first_frame_url?: string | null;
 }
 /**
  * 进度信息
@@ -61,6 +65,21 @@ interface AnalysisProgress {
     /** 当前阶段 */
     stage: string;
 }
+/**
+ * 文件信息
+ */
+interface FileInfo {
+    /** 文件ID */
+    id: string;
+    /** 文件访问URL */
+    url: string;
+    /** 文件名 */
+    name: string;
+    /** 文件大小（字节） */
+    size: number;
+    /** MIME类型 */
+    mimeType: string;
+}
 /**
  * 创建分析任务响应
  */
@@ -96,6 +115,18 @@ interface VideoPsychAnalysisDetail {
     createdAt: string;
     /** 更新时间 */
     updatedAt: string;
+    /** 用户Prompt（人物背景与分析目标） */
+    prompt: string;
+    /** 人物背景信息（Markdown格式，可选） */
+    familyBackground?: string;
+    /** 视频文件信息列表 */
+    videoFiles: FileInfo[];
+    /** 参考图文件信息 */
+    referenceImage: FileInfo;
+    /** 切帧FPS */
+    frameFps: number;
+    /** 分析语言 */
+    language: string;
 }
 /**
  * 同步任务状态响应
@@ -108,6 +139,38 @@ interface SyncStatusResponse {
     /** 提示消息 */
     message: string;
 }
+/**
+ * 表情动作项
+ */
+interface ExpActItem {
+    /** 帧ID */
+    id: string;
+    /** 帧图片路径 */
+    path: string;
+    /** 时间戳（秒） */
+    sec: number;
+    /** 小时 */
+    h: number;
+    /** 分钟 */
+    m: number;
+    /** 秒 */
+    s: number;
+    /** 毫秒 */
+    ms: number;
+    /** 表情参数（已解码的对象） */
+    exp_params: Record<string, unknown> | null;
+    /** 动作分析描述 */
+    act_params: string;
+}
+/**
+ * 声纹信息
+ */
+interface WaveInfo {
+    /** 对象类型 */
+    object: string;
+    /** 声纹参数 */
+    wave_params: Record<string, unknown>;
+}
 /**
  * 文本维度分析项
  */
@@ -116,21 +179,18 @@ interface TextAnalysisItem {
     id: string;
     /** 文本内容 */
     text: string;
-    /** 开始时间（秒） */
-    start_time: number;
-    /** 结束时间（秒） */
-    end_time: number;
-    /** NLP分析结果 */
-    nlp_result?: {
-        /** 说话人情绪 */
-        speaker_emotion?: string;
-        /** 真实态度 */
-        real_attitude?: string;
-        /** 其他NLP字段 */
-        [key: string]: unknown;
-    };
-    /** 其他字段 */
-    [key: string]: unknown;
+    /** 开始时间（毫秒） */
+    start_ms: number;
+    /** 结束时间（毫秒） */
+    end_ms: number;
+    /** 所属段落ID */
+    group_id: string;
+    /** 说话人编号 */
+    speaker: number;
+    /** 声纹信息 */
+    wave_info?: WaveInfo;
+    /** 表情动作列表 */
+    exp_act_list?: ExpActItem[];
 }
 /**
  * 文本维度结果
@@ -145,23 +205,16 @@ interface TextsData {
  * 帧维度分析项
  */
 interface FrameAnalysisItem {
-    /** 帧ID */
-    id: string;
-    /** 帧图片URL */
-    image_url: string;
-    /** 时间戳（秒） */
-    timestamp: number;
-    /** 视觉分析结果 */
-    vision_result?: {
-        /** 表情 */
-        expression?: string;
-        /** 动作 */
-        action?: string;
-        /** 其他视觉字段 */
-        [key: string]: unknown;
-    };
-    /** 其他字段 */
-    [key: string]: unknown;
+    /** 帧ID（格式：HH-MM-SS-mmm） */
+    frame_id: string;
+    /** 时间戳（毫秒） */
+    time_ms: number;
+    /** 帧图片路径 */
+    frame_path: string;
+    /** 表情参数（已解码的对象，包含详细的FACS分析等） */
+    exp_params: Record<string, unknown> | null;
+    /** 动作分析描述 */
+    act_params: string;
 }
 /**
  * 帧维度结果
@@ -177,26 +230,32 @@ interface FramesData {
  */
 interface ParagraphAnalysisItem {
     /** 段落ID */
-    id: string;
+    group_id: string;
     /** 段落文本 */
     text: string;
     /** 段落摘要 */
     summary: string;
-    /** 开始时间（秒） */
-    start_time: number;
-    /** 结束时间（秒） */
-    end_time: number;
+    /** 开始时间（毫秒） */
+    start_ms: number;
+    /** 结束时间（毫秒） */
+    end_ms: number;
+    /** 声纹信息 */
+    wave_info?: WaveInfo;
+    /** 微表情描述 */
+    micro_expression_desc?: string;
+    /** 动作描述 */
+    action_desc?: string;
     /** NLP分析结果 */
     nlp_result?: {
+        /** 行为一致性（0-1） */
+        behavior_consistency?: number;
         /** 说话人情绪 */
         speaker_emotion?: string;
+        /** 情绪强度（0-1） */
+        speaker_emotion_intensity?: number;
         /** 真实态度 */
         real_attitude?: string;
-        /** 其他NLP字段 */
-        [key: string]: unknown;
     };
-    /** 其他字段 */
-    [key: string]: unknown;
 }
 /**
  * 段落结果
@@ -240,6 +299,12 @@ interface VideoPsychAnalysisSummary {
     errorMessage: string;
     /** 报告生成时间 */
     reportGeneratedAt: string | null;
+    /** 视频元信息（任务提交后更新） */
+    videoInfo: VideoInfo | null;
+    /** 视频文件信息列表 */
+    videoFiles: FileInfo[];
+    /** 参考图文件信息 */
+    referenceImage: FileInfo;
     /** 创建时间 */
     createdAt: string;
     /** 更新时间 */
@@ -258,14 +323,34 @@ interface ListVideoPsychAnalysesResponse {
     /** 每页数量 */
     pageSize: number;
 }
+/**
+ * 语言选项
+ */
+interface LanguageOption {
+    /** 语言标签 */
+    label: string;
+    /** 语言代码 */
+    value: string;
+}
+/**
+ * 视频心理分析配置
+ */
+interface VideoPsychAnalysisConfig {
+    /** 语言选项列表 */
+    languageOptions: LanguageOption[];
+    /** 默认语言 */
+    defaultLanguage: string;
+}
 /**
  * 更新分析任务参数
  */
 interface UpdateVideoPsychAnalysisParams {
     /** 任务名称 */
     name?: string;
-    /** 用户Prompt */
+    /** 人物背景与分析目标 */
     prompt?: string;
+    /** 人物背景信息（Markdown格式） */
+    familyBackground?: string;
 }
 /**
  * 更新分析任务响应
@@ -277,65 +362,33 @@ interface UpdateVideoPsychAnalysisResponse {
     name: string;
     /** 用户Prompt */
     prompt: string;
+    /** 人物背景信息 */
+    familyBackground: string;
     /** 当前状态 */
     status: VideoPsychAnalysisStatus;
     /** 更新时间 */
     updatedAt: string;
 }
 
-/**
- * 视频人物心理分析模块
- *
- * @description
- * 提供视频人物心理分析相关功能，包括：
- * - 创建分析任务
- * - 查询任务详情和状态
- * - 同步任务状态（轮询）
- * - 获取分析结果（文本/帧/段落维度）
- * - 生成心理分析报告
- *
- * @example
- * ```typescript
- * import { PlolinkClient } from '@plolink/sdk';
- * import { VideoPsychAnalysis } from '@plolink/sdk/video-psych-analysis';
- *
- * const client = new PlolinkClient({
- *   mode: 'apiKey',
- *   apiKey: 'your-api-key'
- * });
- *
- * const videoPsych = new VideoPsychAnalysis(client);
- *
- * // 创建分析任务
- * const result = await videoPsych.create({
- *   name: '候选人A面试分析',
- *   videoFileIds: ['file1', 'file2'],
- *   referenceImageFileId: 'refImage1',
- *   prompt: '请以专业心理分析师的视角进行分析',
- *   frameFps: 3,
- *   language: 'zh'
- * });
- * console.log(`任务已创建: ${result.id}`);
- *
- * // 轮询任务状态
- * const poller = videoPsych.watchAnalysisStatus(result.id, (detail) => {
- *   console.log(`分析进度: ${detail.progress.done}/${detail.progress.total}`);
- *   if (detail.status === 'COMPLETED') {
- *     console.log('分析完成，报告已生成！');
- *     console.log(detail.reportContent);
- *   }
- * });
- * ```
- *
- * @module video-psych-analysis
- */
-
 /**
  * 视频人物心理分析模块
  */
 declare class VideoPsychAnalysis {
     private client;
     constructor(client: PlolinkClient);
+    /**
+     * 获取视频心理分析配置
+     *
+     * @returns 配置信息（包括语言选项等）
+     *
+     * @example
+     * ```typescript
+     * const config = await videoPsych.getConfig();
+     * console.log('语言选项:', config.languageOptions);
+     * console.log('默认语言:', config.defaultLanguage);
+     * ```
+     */
+    getConfig(): Promise<VideoPsychAnalysisConfig>;
     /**
      * 查询分析任务列表
      *
@@ -399,6 +452,54 @@ declare class VideoPsychAnalysis {
      * ```
      */
     getDetail(id: string): Promise<VideoPsychAnalysisDetail>;
+    /**
+     * 获取视频元数据信息
+     *
+     * @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');
+     * ```
+     */
+    getVideoInfo(id: string): Promise<VideoInfo | null>;
     /**
      * 更新分析任务
      *
@@ -438,6 +539,43 @@ declare class VideoPsychAnalysis {
     delete(id: string): Promise<{
         message: string;
     }>;
+    /**
+     * 重试失败的分析任务
+     *
+     * @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();
+     * ```
+     */
+    retry(id: string): Promise<VideoPsychAnalysisDetail>;
     /**
      * 同步任务状态
      *
@@ -559,4 +697,4 @@ declare class VideoPsychAnalysis {
     getParagraphs(id: string): Promise<ParagraphsData>;
 }
 
-export { type AnalysisProgress, type CreateVideoPsychAnalysisParams, type CreateVideoPsychAnalysisResponse, type FrameAnalysisItem, type FramesData, type ListVideoPsychAnalysesParams, type ListVideoPsychAnalysesResponse, type ParagraphAnalysisItem, type ParagraphsData, type SyncStatusResponse, type TextAnalysisItem, type TextsData, type UpdateVideoPsychAnalysisParams, type UpdateVideoPsychAnalysisResponse, type VideoInfo, VideoPsychAnalysis, type VideoPsychAnalysisDetail, type VideoPsychAnalysisStatus, type VideoPsychAnalysisSummary };
+export { type AnalysisProgress, type CreateVideoPsychAnalysisParams, type CreateVideoPsychAnalysisResponse, type FileInfo, type FrameAnalysisItem, type FramesData, type LanguageOption, type ListVideoPsychAnalysesParams, type ListVideoPsychAnalysesResponse, type ParagraphAnalysisItem, type ParagraphsData, type SyncStatusResponse, type TextAnalysisItem, type TextsData, type UpdateVideoPsychAnalysisParams, type UpdateVideoPsychAnalysisResponse, type VideoInfo, VideoPsychAnalysis, type VideoPsychAnalysisConfig, type VideoPsychAnalysisDetail, type VideoPsychAnalysisStatus, type VideoPsychAnalysisSummary };