架构延时影片
延时影片会把你项目的版本历史变成一部短片。影片从最早记录的修订开始，你的架构会在眼前自行搭建起来：元素逐个绘出，关系在画布上描线延伸，更新处闪烁提示，已移除的元素被红线划掉。最后以一段片尾字幕收尾，总结整段历程。
所有内容都由 Archyl 已经自动记录的版本计算得出——无需任何配置，而且影片是只读的：播放或导出都绝不会改动你的模型。
前置条件
延时影片需要项目至少有两个版本，且这两个版本在影片所处的层级上包含可见变更。版本会在你编辑时自动记录，所以通常只要有一点编辑历史就足够了。
如果你看到 "历史记录还不够"，那就继续编辑图表——每一次编辑会话都会被记录为一个新版本。
打开影片
- 打开某个项目的图表视图。
- 点击工具栏（右上角）中的时间旅行。
- 在面板标题栏中点击延时影片。
播放器会全屏打开并自动开始播放。随时按 Esc 即可关闭。
延时影片按钮只有在项目已记录两个或更多版本之后才会出现。
你看到的是什么
影片会自动挑选信息量最大的层级——如果你的项目只有一个系统，就用容器层级，否则用系统上下文层级——并为每一个产生了可见变更的修订播放一个章节。
视觉语言
| 你看到的 | 它的含义 |
|---|---|
| 一张卡片带着光晕淡入 | 本次修订中新增了一个元素 |
| 一条线在两张卡片之间自行画出 | 一条新关系，标签为它的描述或类型 |
| 琥珀色的 更新 闪光 | 某个已有元素被更新了（描述、技术……） |
| 红色删除线、一个已移除印章和一个虚线幽灵 | 该元素被删除了——它会以幽灵形式继续可见，因为删除也是故事的一部分 |
镜头会跟随动作：它会框住每次修订的变更，推近到最重要的那一簇元素上，并始终把一条新关系的两端都保持在画面内。
画面上的信息
- 左上角 —— 项目名称、当前修订号，以及它的日期和作者。
- 字幕 —— 每个章节都会显示该版本的描述，因此影片会用你团队自己的话来讲述自己。没有描述的章节会回退为 "修订 N"。
- 标签 —— 每次修订的摘要：
+N 个元素、+N 条关系、~N 项更新、−N 项移除。 - 右下角 —— 元素总数与关系总数的实时计数器。
- 片尾卡 —— 一条片尾字幕带，包含里程碑刻度条（每个修订一格）、递增计数的统计数据、参与贡献的作者，以及一个
Rev NN — 当前印章。
影片是完全本地化的：字幕、标签、印章和片尾都会跟随你的界面语言。
控制
| 操作 | 控件 |
|---|---|
| 播放 / 暂停 | 播放按钮，或按 Space |
| 跳到某个时刻 | 点击或拖动进度条 |
| 跳到某个修订 | 点击时间轴上的 REV 药丸标记 |
| 关闭播放器 | 关闭按钮，或按 Esc |
时间轴会为每个章节显示一个刻度，因此你可以直接跳到自己关心的那个修订。
选择哪些修订出现在影片里
很长的历史里往往有些修订对故事毫无贡献。点击控制栏中的筛选按钮打开修订列表，然后用眼睛开关隐藏任意修订。
- 被隐藏修订的变更会合并进下一个可见修订——影片绝不会出现空洞。
- 至少要保留两个可见修订；最后两行会自动锁定。
- 显示全部可重置筛选。
- 你的选择会按项目记录在当前浏览器中。
很长的历史
为了让影片保持可看，延时影片只覆盖最近 10 个修订。更早的内容会被折叠进开场章节，由它把你原有的架构作为定场镜头一次性绘出——所以什么都不会消失，只是不再逐个修订地做动画。
导出为 MP4
点击控制栏中的导出为 MP4。影片会在你的浏览器内逐帧渲染，并以 <project-slug>-timelapse.mp4 下载：
- 1920×1080、24 fps、H.264
- 渲染过程会显示实时百分比，并可随时取消
- 不会上传任何内容——你的架构绝不会离开你的机器，也不涉及任何服务端渲染
渲染耗时大约是影片时长的三到四倍——一部 30 秒的影片需要一两分钟。渲染期间请让该标签页保持在前台。
前置条件
MP4 导出使用浏览器的 WebCodecs API，它需要：
- 较新版本的 Chrome、Edge 或 Safari。 不支持 WebCodecs 的浏览器会把按钮显示为禁用状态。
- 安全上下文 —— 页面必须通过 HTTPS（或
localhost）提供。在纯 HTTP 的内网地址上，按钮会保持禁用；把鼠标悬停在按钮上即可看到具体原因。
在纯 HTTP 上自托管 Archyl 是导出按钮被禁用最常见的原因——把应用放到 TLS 之后即可解决。
用在哪些场景
- 新人上手 —— 新工程师用三十秒就能看完两年的架构决策。
- 架构评审与复盘 —— 用影片开场，而不是一张静态的图。
- 发布与里程碑公告 —— 把 MP4 丢进 Slack 或发布说明里。
- 面向干系人的演示 —— 片尾卡会带上你的项目名称、统计数据和贡献者。
故障排除
"历史记录还不够" —— 项目中包含可见变更的版本少于两个，或者修订筛选隐藏了太多内容。打开筛选并选择显示全部，或者继续编辑以积累更多历史。
找不到延时影片按钮 —— 项目已记录的版本少于两个。
导出按钮被禁用 —— 你的浏览器缺少 WebCodecs，或者应用没有通过 HTTPS/localhost 提供。把鼠标悬停在按钮上即可看到具体原因。
导出中途失败 —— 重试一次；如果反复失败，请关闭其他占用较高的标签页，因为编码非常吃内存。
相关功能
- 分享与导出 —— 发布只读链接，或将图表导出为其他格式
- 生产现实（Living Diagram，动态图） —— 让模型与实际运行的系统保持一致