mcpField
V
visual-mode

visual-mode

github.com/remotion-dev开发68.6k812 次安装今天更新
代码仓库

关于 visual-mode

介绍 Remotion Studio Visual Mode 中 Sequence 的身份与跟踪机制，并提醒在新增 Studio API 路由时维护 Browser Studio 路由对照清单。

主要功能

  1. 01Sequence 身份字段说明
  2. 02热重载跟踪行为
  3. 03节点路径与调用栈映射指南
  4. 04Browser Studio 路由清单提醒

适用场景

  1. 01分析热重载期间的 Sequence 状态
  2. 02将 Sequence 节点路径映射到标识符
  3. 03新增 Browser Studio API 路由

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/remotion-dev/remotion --skill visual-mode

安装后在 Claude Code 中输入/visual-mode确认已加载。

详细介绍

Visual Mode 是 Remotion Studio 中的一项功能，可用于以可视化方式编辑 Sequences。

我有以下观察：

字段

  • overrideId -> 即使文件／行／列发生变化，也会保持 Sequence 的标识不变
  • Sequence stack -> 热重载时会变化。多个具有不同 overrideId 的 Sequence 可能共用同一个 stack
  • Sequence 文件、行、列（符号化堆栈）-> 不会变化，但需要异步计算
  • nodePath -> 即使行、堆栈和 overrideId 发生变化，标识也相同。异步

nodePath + 索引是跟踪展开状态的理想方式。这就是最终目标。

nodePath 一旦映射到 overrideId，之后就不会变化；否则组件会重新挂载，且 overrideId 会发生变化。

如果发现另一个 Sequence 已经使用相同的 stack，我们会复用其 overrideId。

理论上，nodePath 到符号化堆栈的映射可能在每次文件变更时发生变化。但多个 Sequence 可以共用同一个堆栈，因此它们都会拥有相同的 nodePath。

我们应该只为每个堆栈获取一次 nodepath

由于快速刷新，不同的非符号化堆栈可能对应相同的符号化堆栈

非符号化堆栈到符号化堆栈的映射不会变化，因为如果发生变化，那就是快速刷新导致的不同堆栈

Browser Studio 路由跟踪

每当新增 Studio API 路由时，也要将其添加到 issue #9807 中的 Browser Studio 兼容性检查清单。请在同一次更改中完成，即使该路由有意设为仅服务端使用；将其列入必需的 Browser Studio 操作或明确不支持的路由。

评论

支持 Markdown