分组文案时间轴合并代码|按组统一结束时间调整句首时间

// 定义异步主函数main，接收参数对象{params}，返回Promise包裹的输出结果
async function main({ params }: Args): Promise<Output> {
    // 从参数中提取分组文案数组wenan_group和时间轴数组timeline
    const { wenan_group, timeline } = params;
  
    // 初始化结果数组（存分组文案时间轴）、跟踪时间轴当前索引的变量
    const wenan_group_timeline = [];
    let currentIndex = 0;  // 记录当前用到timeline的第几项
  
    // 遍历wenan_group中的每个分组（group）
    for (const group of wenan_group) {
      // 获取当前组内文案的行数（句子数）
      const groupLen = group.wenan.length;
  
      // 计算当前组统一的结束时间：取组内最后一句在timeline中的end（当前索引+组内行数-1）
      const unifiedEnd = timeline[currentIndex + groupLen - 1].end;
  
      // 遍历组内每句文案（i是组内句子索引）
      for (let i = 0; i < groupLen; i++) {
        // 当前句文案：去首尾空格（避免空格干扰）
        const content = group.wenan[i].trim();
  
        let start: number;  // 声明当前句的开始时间变量
  
        if (i === 0) {
          // 组内第一句：用timeline中当前索引对应项的原始start
          start = timeline[currentIndex + i].start;
        } else {
          // 组内后续句：start=前一句的end - 0.3秒（300000微秒），且不能小于0
          const prevEnd = timeline[currentIndex + i - 1].end;  // 前一句的end
          start = Math.max(0, prevEnd - 300000);  // 减0.3秒（单位微秒），取≥0的值
        }
  
        // 将当前句的时间信息（start/end/content）加入结果数组
        wenan_group_timeline.push({
          start,
          end: unifiedEnd,  // 统一用组内最后句end作为结束时间
          content
        });
      }
  
      // 时间轴索引累加：跳过当前组已用的groupLen个时间轴项
      currentIndex += groupLen;
    }
  
    // 返回分组文案时间轴结果
    return { wenan_group_timeline };
}