回声工坊完全指南：从零开始用文本创作跑团Replay视频

你是否曾想将跑团的精彩瞬间转化为生动视频，却被复杂的剪辑软件吓退？回声工坊（TRPG-Replay-Generator）正是为解决这一难题而生的开源工具，它让视频制作像编写文档一样简单。本文将带你探索这个工具的核心价值，通过实际场景应用掌握使用技巧，并深入高级功能，让你从零基础成长为跑团视频创作高手。

一、核心价值：为什么选择回声工坊？

1.1 文本驱动的创作革命

传统视频制作需要在时间线上手动调整每个元素，而回声工坊采用文本标记系统，让你用类似剧本的格式定义视频内容。只需专注于故事叙述，无需关心复杂的技术细节。

1.2 一站式创作体验

从海豹骰日志导入到语音合成，从场景布置到视频渲染，回声工坊整合了跑团视频制作的全流程，告别多工具切换的繁琐。

回声工坊的工作流程展示了从媒体定义到最终渲染的完整过程，所有环节无缝衔接

1.3 模板化设计理念

内置多种风格模板，一次配置即可重复使用，让你的视频保持统一风格的同时，大幅减少重复劳动。

自测题：以下哪项不是回声工坊的核心优势？
A. 文本驱动的创作方式
B. 专业的视频特效编辑
C. 一站式全流程解决方案
D. 可复用的模板系统

二、场景应用：3分钟上手的实际案例

2.1 如何快速制作第一个对话场景视频？

问题引入：刚结束一场精彩的跑团，想立即将关键对话制作成视频分享，该从何入手？

功能演示：使用基础剧本格式快速创建视频：

# 场景设置
[场景]
背景: assets/welcome/circle.png  # 设置背景图片
音乐: assets/beats/da.wav        # 添加背景音乐

# 角色定义
[角色]
小明: 阿里云-情感男声            # 角色名:语音引擎-语音类型
小红: 阿里云-情感女声

# 对话内容
[对话]
小明: 我们终于找到宝藏了！        # 角色名:对话内容
小红: 小心，这里可能有陷阱！      # 系统自动生成对话气泡

执行效果：运行以下命令，系统会自动生成包含角色对话、背景和音乐的视频文件。

python main.py --input 我的剧本.rgl --output 跑团视频.mp4

红色对话气泡模板示例，可直接应用于对话场景

新手误区	进阶技巧
在[角色]区块内直接写角色定义，没有换行	使用Tab键缩进组织角色属性，如设置头像大小和位置
对话内容过长导致气泡显示异常	使用\n手动换行，控制每行字数在15字以内

动手实践：尝试修改剧本中的背景图片路径，使用assets/toy/media/bg1.jpg创建不同风格的场景。

2.2 怎样自定义角色位置和气泡样式？

问题引入：默认的角色头像位置不符合预期，如何调整才能让视频布局更合理？

功能演示：创建布局配置文件来自定义界面元素：

{
  "布局": {
    "对话框": {
      "位置": [100, 500],  // X,Y坐标（左上角为原点）
      "大小": [600, 200],   // 宽度和高度
      "背景图": "assets/toy/media/bubble.png"
    },
    "角色头像": {
      "位置": [50, 100],    // 左侧中间位置
      "大小": [150, 150],   // 正方形头像
      "边框": 5             // 边框宽度
    }
  }
}

执行效果：将配置文件保存为custom_layout.json，在生成视频时引用：

python main.py --input 剧本.rgl --layout custom_layout.json --output 自定义视频.mp4

扩展思考：如何让不同角色使用不同样式的对话框？尝试在角色定义中添加气泡样式属性。

三、深度探索：从入门到精通的进阶之路

3.1 如何导入海豹骰日志并自动生成剧本？

问题引入：手动转录跑团记录太耗时，有没有办法直接导入现成的日志文件？

功能演示：使用海豹骰日志导入功能：

1. 在海豹骰中导出.log格式日志文件
2. 使用以下命令导入并生成剧本：

python main.py --import-sealdice 海豹骰日志.log --output 自动剧本.rgl

执行效果：系统会自动识别角色对话和骰子结果，生成带格式的剧本文件，包含角色、对话和技能检定结果。

常见问题：

Q: 导入日志后角色名称识别错误怎么办？
A: 编辑生成的剧本文件，手动修正角色名称后重新生成视频。

3.2 怎样使用语音合成让角色"开口说话"？

问题引入：视频中的对话需要配音，如何让回声工坊自动生成语音？

功能演示：配置语音服务并在剧本中指定：

1. 注册阿里云或Azure语音服务，获取API密钥
2. 创建voice_config.json文件，保存密钥信息
3. 在剧本中指定角色语音：

[角色]
旁白: 阿里云-新闻播报员
战士: Azure-zh-CN-YunxiNeural

执行效果：生成视频时添加--voice参数，系统会自动为对话生成语音：

python main.py --input 剧本.rgl --voice voice_config.json --output 带语音视频.mp4

进阶技巧：调整语音语速和情感，在角色定义中添加参数：战士: Azure-zh-CN-YunxiNeural,语速=1.2,情感=喜悦

3.3 如何使用高级编辑界面精细化调整视频？

问题引入：文本配置不够直观，有没有可视化界面可以精确调整元素位置？

功能演示：使用回声工坊的XML项目编辑界面：

python main.py --edit 剧本.rgl

XML项目编辑界面展示了可视化的时间线编辑和预览窗口

界面功能说明：

• 左侧：实时预览窗口，显示当前视频效果
• 右侧：时间线编辑区域，可精确调整每个元素的出现时间
• 底部：播放控制和时间定位工具

实践任务：使用编辑界面调整一段对话的显示时间，使对话与背景音乐节奏匹配。

四、资源与支持

4.1 学习资源

• 模板库：项目intel/目录下提供多种风格模板，如basic_template和film_memory
• 示例项目：toy/目录包含完整的示例剧本和媒体文件，可直接运行体验
• 文档：项目根目录下的README.md提供详细功能说明

4.2 获取帮助

• 社区讨论：加入项目QQ交流群获取实时帮助
• 问题反馈：通过项目Issue系统提交bug报告和功能建议
• 贡献代码：fork项目并提交PR，参与功能开发

通过本指南，你已经掌握了回声工坊的核心功能和使用技巧。从简单的剧本编写到复杂的视频定制，回声工坊让跑团Replay视频创作变得简单而高效。现在就动手尝试，将你的跑团故事以生动的视频形式分享给更多人吧！