@aim-packages/subtitle 0.1.1 → 0.1.2

package/README.md

@@ -1162,6 +1162,100 @@ console.log(assContent);
 // 输出完整的ASS格式字幕文件，包含样式定义和字幕内容
 ```
 
+##### `outputTxt(params: OutputTextParams): string`
+
+生成TXT格式的纯文本文件，支持多种输出模式。
+
+**参数:**
+- `params: OutputTextParams` - 输出参数配置
+  - `useIndex?: boolean` - 是否显示索引编号
+  - `useTimestamp?: boolean` - 是否显示时间戳
+  - `useParagraph?: boolean` - 是否使用段落模式（按发言人分组或按chunkSize分组）
+
+**返回值:**
+- `string` - TXT格式的文本内容
+
+**功能特性:**
+- **段落模式**: 支持按说话人分组或按固定大小分块
+- **行模式**: 每个字幕片段单独一行
+- **多语言支持**: 自动检测中日韩语言，调整文本连接方式
+- **说话人支持**: 支持显示说话人名称和时间戳
+
+**示例:**
+```typescript
+import { tools } from '@aim-packages/subtitle';
+
+const segments1 = [
+  ["00:00:01,000", "00:00:03,000", "Hello world", "speaker1"],
+  ["00:00:03,000", "00:00:05,000", "How are you?", "speaker1"],
+  ["00:00:05,000", "00:00:07,000", "I'm fine, thank you.", "speaker2"]
+];
+
+const segments2 = [
+  ["00:00:01,000", "00:00:03,000", "你好世界", "speaker1"],
+  ["00:00:03,000", "00:00:05,000", "你好吗？", "speaker1"],
+  ["00:00:05,000", "00:00:07,000", "我很好，谢谢。", "speaker2"]
+];
+
+const speakerData = {
+  settings: {
+    speaker1: { spk: "speaker1", name: "张三", color: "#FF0000" },
+    speaker2: { spk: "speaker2", name: "李四", color: "#00FF00" }
+  },
+  speakers: { speaker1: 1, speaker2: 1 },
+  data: []
+};
+
+// 行模式 - 每个字幕片段单独一行
+const txtContent1 = tools.output.outputTxt({
+  segments1,
+  segments2,
+  speakerData,
+  useIndex: true,
+  useTimestamp: true,
+  useParagraph: false
+});
+
+console.log(txtContent1);
+// 输出:
+// 0
+// 00:00:01,000 --> 00:00:03,000
+// 张三: Hello world
+// 你好世界
+// 
+// 1
+// 00:00:03,000 --> 00:00:05,000
+// 张三: How are you?
+// 你好吗？
+// 
+// 2
+// 00:00:05,000 --> 00:00:07,000
+// 李四: I'm fine, thank you.
+// 我很好，谢谢。
+
+// 段落模式 - 按说话人分组
+const txtContent2 = tools.output.outputTxt({
+  segments1,
+  segments2,
+  speakerData,
+  useIndex: true,
+  useTimestamp: true,
+  useParagraph: true
+});
+
+console.log(txtContent2);
+// 输出:
+// 1
+// 张三 - 00:00:01,000 --> 00:00:05,000
+// Hello world How are you?
+// 你好世界 你好吗？
+// 
+// 2
+// 李四 - 00:00:05,000 --> 00:00:07,000
+// I'm fine, thank you.
+// 我很好，谢谢。
+```
+
 #### 完整的字幕处理流程示例
 
 ```typescript