SmartMeeting/speakr/docs/user-guide/transcript-templates.md

# 转写模板指南

## 概述

Speakr 中的转写模板允许你自定义下载转写内容时的格式。你可以针对不同的使用场景创建多个模板，而不是使用固定格式——无论你需要字幕的时间戳、采访的说话人导向格式，还是媒体制作的剧本风格格式。

## 访问转写模板

1. 点击右上角的用户名
2. 导航到 **Account Settings**（账户设置）
3. 选择 **Transcript Templates**（转写模板）标签页

## 理解模板变量

模板使用占位符（变量），这些占位符会被实际的转写数据替换：

### 可用变量

- `{{index}}` - 转写片段的序号（1, 2, 3...）
- `{{speaker}}` - 说话人名称（例如 "Speaker 1"、"John" 等）
- `{{text}}` - 实际的语音文本/内容
- `{{start_time}}` - 片段开始时间（格式：HH:MM:SS）
- `{{end_time}}` - 片段结束时间（格式：HH:MM:SS）

### 过滤器

可以通过添加管道符（|）来修改变量：

- `{{speaker|upper}}` - 将说话人名称转换为大写
- `{{text|upper}}` - 将文本转换为大写
- `{{start_time|srt}}` - 将时间格式化为 SRT 字幕格式（HH:MM:SS,mmm）
- `{{end_time|srt}}` - 将时间格式化为 SRT 字幕格式（HH:MM:SS,mmm）

## 创建你的第一个模板

### 第一步：点击"创建模板"
在转写模板部分，点击 **Create Template**（创建模板）按钮。

### 第二步：填写模板详情

**模板名称**：为你的模板取一个描述性名称
- 示例："采访格式"、"SRT 字幕"、"会议纪要"

**描述**（可选）：添加何时使用此模板的简要说明
- 示例："用于客户采访转写"

**模板**：使用变量输入你的格式模式
- 示例：`[{{start_time}}] {{speaker}}: {{text}}`

### 第三步：设为默认（可选）
如果你希望下载转写时预选此模板，请勾选"设为默认模板"。

### 第四步：保存
点击 **Save**（保存）以创建你的模板。

## 常见模板示例

### 1. 简单对话
```
{{speaker}}: {{text}}
```
**输出：**
```
John: Hello, how are you today?
Sarah: I'm doing great, thanks for asking!
```

### 2. 带时间戳格式
```
[{{start_time}} - {{end_time}}] {{speaker}}: {{text}}
```
**输出：**
```
[00:00:01 - 00:00:03] John: Hello, how are you today?
[00:00:04 - 00:00:07] Sarah: I'm doing great, thanks for asking!
```

### 3. 采访/问答格式
```
{{speaker|upper}}:
{{text}}

```
**输出：**
```
INTERVIEWER:
What brought you to this field?

GUEST:
I've always been passionate about technology...
```

### 4. SRT 字幕格式
```
{{index}}
{{start_time|srt}} --> {{end_time|srt}}
{{text}}

```
**输出：**
```
1
00:00:01,000 --> 00:00:03,000
Hello, how are you today?

2
00:00:04,000 --> 00:00:07,000
I'm doing great, thanks for asking!
```

### 5. 会议纪要风格
```
• [{{start_time}}] {{speaker}}: {{text}}
```
**输出：**
```
• [00:00:01] John: Let's begin today's meeting with updates.
• [00:00:05] Sarah: I'll start with the marketing report.
```

### 6. 剧本格式
```
                    {{speaker|upper}}
        {{text}}

```
**输出：**
```
                    JOHN
        Hello, how are you today?

                    SARAH
        I'm doing great, thanks for asking!
```

### 7. 法庭记录风格
```
{{index}}    {{speaker|upper}}: {{text}}
```
**输出：**
```
1    ATTORNEY: Please state your name for the record.
2    WITNESS: My name is John Smith.
```

## 下载时使用模板

### 方法一：从转写视图
1. 打开一个包含转写的录音
2. 点击转写旁边的 **Download**（下载）按钮
3. 在弹出窗口中选择你想要的模板
4. 转写文件将以你选择的格式下载

### 方法二：设置默认模板
1. 编辑模板并勾选"设为默认模板"
2. 下载时将预选此模板
3. 你仍然可以在下载时选择不同的模板

### 方法三：下载原始转写
- 选择"No Template (Raw Export)"（无模板-原始导出）以不带任何格式下载转写
- 当你需要在其他应用程序中处理文本时很有用

## 管理模板

### 编辑模板
1. 点击列表中的任意模板以打开它
2. 修改名称、描述或格式
3. 点击 **Save**（保存）以更新

### 删除模板
1. 打开你想删除的模板
2. 点击 **Delete**（删除）按钮
3. 确认删除

### 创建默认模板
如果你没有任何模板，点击 **Create Default Templates**（创建默认模板）以生成一套全面的初始模板：
- Simple Conversation（简单对话）- 仅包含说话人名称的简洁格式
- Timestamped（带时间戳）- 包含时间范围的基本格式
- Interview Q&A（采访问答）- 专业的采访格式
- Meeting Minutes（会议纪要）- 用于会议记录的列表格式
- Court Transcript（法庭记录）- 带行号的法律笔录风格
- SRT Subtitle（SRT 字幕）- 视频的标准字幕格式
- Screenplay（剧本）- 电影剧本格式

## 高级技巧

### 1. 多行模板
你可以通过添加换行来创建多行模板：
```
=================
Time: {{start_time}}
Speaker: {{speaker}}
Message: {{text}}
=================
```

### 2. 组合使用过滤器
在同一个模板中使用多个过滤器：
```
[{{start_time|srt}}] {{speaker|upper}}: {{text}}
```

### 3. 创建分隔符
在片段之间添加视觉分隔符：
```
{{speaker}}: {{text}}
---
```

### 4. 缩进以提高可读性
使用空格或制表符进行缩进：
```
    {{start_time}} | {{speaker}}
        {{text}}
```

## 使用场景

### 记者
创建一个带有时间戳和说话人标签的"采访格式"模板，以便在撰写文章时方便参考。

### 研究人员
使用带时间戳的编号格式来引用录制采访或焦点小组中的特定时刻。

### 内容创作者
导出为 SRT 格式以便为视频添加字幕，或使用剧本格式编写视频脚本。

### 商务会议
创建一个"会议纪要"模板，清晰显示谁在什么时候说了什么，非常适合行动项和后续跟进。

### 法律专业人士
使用带行号和大写说话人名称的法庭记录风格格式来制作笔录和证词。

### 播客主持人
格式化带时间戳的转写内容用于节目说明，听众可以点击跳转到特定主题。

## 故障排除

### 模板未显示
- 确保你已保存模板
- 必要时刷新页面
- 检查你是否登录了正确的账户

### 变量未替换
- 验证变量名称拼写正确
- 确保使用了双大括号 `{{}}`
- 检查转写是否包含所需数据（说话人、时间戳）

### 下载问题
- 确保录音已完成转写
- 先尝试不使用模板下载以验证转写是否存在
- 检查浏览器的下载设置

## 最佳实践

1. **清晰命名模板**：使用描述性名称来表明用途
2. **测试你的模板**：下载示例转写以验证格式
3. **保留多个模板**：为不同的使用场景创建不同的模板
4. **记录复杂模板**：使用描述字段来解释何时使用每个模板
5. **从简单开始**：从基本模板开始，根据需要增加复杂性

## 需要帮助？

如果你遇到转写模板的问题或有疑问：
1. 查看本指南以获取示例和故障排除信息
2. 尝试使用默认模板作为起点
3. 在 [GitHub Issues](https://github.com/anthropics/claude-code/issues) 上报告问题

---

*最后更新：2024年12月*