Persona

在 控制面板 左栏的捕捉下方，点击自动化即可进入。一条自动化是一条操作时间线，作用于当前场景，可以由组合键或手柄启动，也可以由场景切换、面部捕捉中断等事件启动，或者手动执行。一次按键就能同时开一个特效、把相机拉回某个位置、隐藏一个图层——也能放一首歌，让特效和运镜按时登场

这里首先列出应用的自动化。场景里有 主模型 时，下面还有一个可折叠的虚拟形象快捷键分区，列出 这个模型自带的快捷键；它默认展开，并会记住你是否把它折叠起来

创建自动化

添加自动化位于清单上方。在它的下拉框里选一种操作，再从旁边的选择器中选择目标。不需要指定目标的操作会显示添加按钮，归在虚拟形象组下的 虚拟形象操作 还要先选作用于哪个虚拟形象。随后会出现一条只含这条操作的新自动化，自动展开，光标落在名称输入框里

每条自动化是一张卡片。卡片顶部是名称和下方的触发条件摘要，右侧依次是绑定的组合键、启用自动化开关和自动化选项菜单；播放期间，前面还会出现暂停自动化和停止自动化按钮。关掉开关就停用了这条自动化：摘要以已暂停开头，所有触发都会被忽略——从 Persona 外部发起的执行也不例外——正在进行的执行也会停止

点击名称可以展开卡片。名称用来改名；留空时，标题由各条操作的名称用 · 连接而成。下方依次是 触发条件、打开 时间线 的时间线编辑器按钮，以及 执行操作

选项菜单里有执行自动化、复制自动化、导出自动化、后台生效（见 后台与聚焦快捷键）和删除自动化。复制自动化会在下方插入一份副本并展开它：副本保留操作及其时间、触发条件、冷却时间和启用状态，名称后面加上「副本」，但不保留组合键。导出自动化把这条自动化存成文件——见 导入与导出

触发条件

触发条件块里列的是启动这条自动化的方式。满足其中任意一条就会执行，也照样可以手动执行；名称下方的摘要列出触发条件的种类，一条都没有时显示仅手动执行

键盘或控制器

键盘或控制器总是排在第一条。展开它，点击设置快捷键…打开录制器，按下组合键，再用保存或 Enter 确认；清除可以解除绑定。规则和 虚拟形象快捷键 一样：含 Ctrl、Alt 或 Cmd 的组合在别的应用位于前台时依然有效，其余的只在 Persona 聚焦时生效。录制器也接受同一只手柄上最多三个控件，手柄组合不需要修饰键就能在后台生效——见 手柄快捷键

组合键不是必需的。没有组合键时，自动化照样可以由其他触发条件启动、手动执行，或者 从 Persona 外部执行

事件触发条件

添加触发条件可以加入下面任意一种。每条都是一行可折叠的条目，标题行概括它的设置——已保存的默认收起，新加的会展开——移除触发条件可以删掉它

参数值和动作播放指定的图层一旦换成别的模型就不再匹配；场景里还没有虚拟形象时，它们在添加触发条件中显示为灰色且不可选，面部捕捉在还没有面部捕捉源时也一样

参数值读取的是图层收到的一路输入——一开始是 MouthOpen，也可以在参数里换成任意面部或手柄输入——而且是在 参数映射 之前读取，所以它跟随的是捕捉信号，而不是模型最终的参数。麦克风音量监听的是 口型同步 里选中的麦克风，沿用它的增益、噪声门和平滑；关掉口型同步也照样工作，只是不会动虚拟形象的嘴

捕捉源报告没有面部，或者 1.5 秒没有任何数据时，面部就算丢失。场景切换触发的操作作用于正在进入的那个场景，选离开时也一样；编辑场景不算进入场景

两种阈值触发条件的规则相同：方向选升至高于或降至低于，信号越过阈值后要保持持续至少后面填的时长（0 – 60 秒）才会触发。想再次触发，信号得先回到重置幅度以外，界面会显示重新触发所需的数值；展开这一行时还有一个仪表，对照阈值显示实时值。麦克风音量的范围是 0 – 1，阈值初始为 0.65；参数则使用对应输入的取值范围

麦克风、参数和面部这几种触发条件不会因开始监听时的状态而触发，只响应后续变化；麦克风或参数信号中断后恢复时，也会这样重新开始。控制面板关着时，所有触发条件照样生效

冷却时间

冷却时间是两次执行之间的最短间隔，0 – 3600 秒，从上一次开始执行时算起。自动化正在执行或处于冷却期间收到的触发会被直接忽略，不会排队；冷却时间也不会拖慢同一次执行里的操作

操作

执行操作区块列出要执行的操作，下方的添加操作提供的种类和添加自动化相同。每条操作都以下面三种方式之一排在自动化的 时间线 上：

准备最先按清单顺序执行，目标场景生效、替换的模型加载完毕之后，时间线才开始计时。准备类的行用虚线框标出，写着播放前准备

单次操作在开始时间执行一次——行里写着类似在第 2 秒执行——它改动的东西会一直保留：停止自动化并不会撤销。开始时间相同的单次操作按清单顺序执行

片段从开始时间持续到结束时间——2–7 秒 · 时长 5 秒——到结束时松开它控制的东西：临时效果回到场景自己的设置，相机运动、音频和动作停止。没有裁剪过的播放相机运动、播放音频和播放动作片段按文件本身的长度播放，写着从第 2 秒开始 · 自动时长。相机、同一个虚拟形象的动作、同一个特效，同一时刻都只能由一个片段控制；音频片段可以随意叠加

每条操作都是一行可折叠的条目，标题行概括它的设置。同一时间只展开一行，在时间线上选中片段也会展开它对应的那一行。拖动行首的把手改变的是清单和时间线轨道的顺序，而不是执行时间。一条自动化至少保留一条操作，所以最后一条删不掉

自动化执行时，每一行的标题旁会显示这条操作的状态——等待执行、正在执行…、已完成、已跳过、失败或已取消，并附上用时；音频和相机运动则显示播放进度。把鼠标移到标题上，可以看到操作失败或被跳过的原因

操作的目标跟随自动化的准备步骤：有切换场景时，选择器列出的是目标场景的图层；有替换模型时，则是那个图层换上的新模型——无论这些行排在清单的什么位置。已经不存在的目标会留在行里，显示为场景不存在、图层已丢失、虚拟形象不存在、模型不存在、表情不存在、动作不存在、音频不存在或相机运动缺失，直到你换一个。执行时，图层已经不在的图层可见性会被跳过，其他不存在的目标则会让 这次执行失败

图层可见性那行带一个图层选择器——任意图层，或者主模型，即执行时的主模型——和切换 / 显示 / 隐藏，直播模式那行则是切换 / 开启 / 关闭；两者一开始都是切换。直播模式是唯一一条写应用设置而不是场景状态的操作，所以它和 舞台 里那个开关一样，切换场景后依然有效。重置相机不保存快照：无论相机此刻被摆到了哪里，它都缓动回场景一开始的取景

应用效果设置

新建的应用效果设置会把这个特效当前的数值复制一次；之后在这里改，只影响这条自动化。这一行带着特效自己的控件，外加触发时启用——执行后特效处于的开关状态。从当前舞台复制用舞台上当前的数值替换保存的那一份，重置为默认值恢复特效的默认值，但保留触发时启用

执行时，数值和颜色会在 0.4 秒内平滑过渡，模式和开关则立即切换

临时效果

临时效果那行的控件和应用效果设置相同，另外多出淡入（秒）和淡出（秒），各自最长 10 秒。新建时时长 5 秒、淡入淡出各 0.4 秒，两段淡变加起来不能超过片段本身。片段期间，保存的数值接管这个特效：从开始处淡入，在结束前淡出；到结束时，特效恢复成场景里原本的样子——原本关着就是关着。这些数值不会写入场景；执行期间你亲手改了这个特效，它就不再受自动化控制，直到这次执行继续或重新开始

切换场景

添加会把当前场景存为目标，再在行里的场景处换成别的。切换时使用目标场景自己的 场景转场。作为准备步骤，它在时间线开始前执行；目标场景生效后时间线才开始，此时转场动画可能尚未结束

选择已经处于激活状态的场景，只会取消还在等待的切换，不会重新加载场景。更新的一次场景切换——另一条切换场景、在控制面板里选场景，或者插件调用 scene.activate——会取消还在等上一次切换的那次执行，不报错。目标场景被删掉后，这一行显示场景不存在，执行会失败

想用按键或手柄切换场景，就建一条带切换场景操作的自动化，再给它绑一个组合键

相机位置

新建的相机位置会保存当前的相机，它那一行可以直接编辑这个机位：

从当前舞台复制用舞台相机当前的视角替换这个机位，可以先在舞台上调整构图，再保存到操作中。预览位置把舞台相机移到保存的机位；改这些数值只会改这条操作

相机还是默认取景时保存的操作显示为默认构图，会一直沿用默认取景，只有视场角可以编辑，直到你点击设置位置

想依次看几个视角，就给几条相机操作设不同的开始时间。场景的 相机 设置里指定了相机运动时，它会覆盖保存的机位，这一行也会提示

播放相机运动

播放相机运动在相机运动处从 素材库 里选一段相机运动，也就是 .vmd 运镜，在片段时长内用它驱动 3D 相机，结束后把视角交还给场景自己的相机；停止相机运动这个单次操作可以提前交还。它会覆盖场景 相机 设置里指定的相机运动，并且跟随自动化的时间，而不是虚拟形象的待机片段，所以暂停或拖动自动化的播放位置时，相机也跟着暂停或跳转。自动化暂停期间在舞台上拖动，相机会从暂停时的视角接着移动；继续播放后，相机又交回给这段运动

播放音频

播放音频播放素材库 音频 分类里的一个文件，在音频文件处选择：

淡入发生在第一次播放的开头，淡出发生在最后一次播放的结尾；循环播放只在停止时淡出。再次触发时决定这条操作在它之前的播放还没结束时再次开始会怎样：从头播放结束之前的播放并从头开始，叠加播放再放一份与之并存，继续播放则让之前的继续放下去。其他操作播放同一个文件不受影响

驱动口型同步让选中的虚拟形象在文件播放期间随它动嘴——见 口型同步。主模型指的是音频开始播放时的主模型

行的标题会显示播放状态——正在加载…、播放中、循环播放中、已暂停、正在停止…、已完成、已停止或失败——以及已播放的时间（重复播放也计算在内），重复时还有第 2/3 次播放。片段结束时声音随之停止，设成循环也一样

控制音频把它的播放控制——暂停、继续或停止，默认是停止——一次作用于音频文件的所有播放，无论是自动化还是素材库开始的。停止会让正在播放的文件先放完它的淡出

虚拟形象操作

切换表情、播放动作、清除所有表情、替换模型和模型位置作用于行里虚拟形象处选定的对象：一个具体的虚拟形象图层——一开始是当前的主模型——或者主模型，即自动化执行时的主模型。表情选择器，以及 Live2D 模型上的动作选择器，读取的是模型自己声明的内容，不需要把模型加载到舞台上。VRM 的动作则通过选择动作…，在打开的 素材库 里挑选：内置的动作包加上你自己的片段，也可以在那里点打开文件…，再导入一个

模型位置会保存虚拟形象当前的位置，并用常规的 2D 或 3D 位置控件编辑；编辑不会移动虚拟形象，从当前舞台复制会重新抓取当前位置，执行这条操作时虚拟形象会平滑移动到保存的位置。替换模型保留图层的位置，作为准备步骤，它会在时间线开始前把新模型加载好。已经不存在的表情、动作或虚拟形象会让这次执行失败

Live2D 模型上的播放动作片段总是从头完整播放：裁剪它或从中途开始都会被拒绝。VRM 的片段可以裁剪和拖动播放位置，但弹簧骨骼不会重演跳转点之前的运动

时间线编辑器

展开的自动化里点击时间线编辑器，会在控制面板底部、两栏下方打开一个停靠面板。去别的行时它仍然跟着这条自动化，选中片段会把它对应的行重新带回视野。关闭时间线编辑器把它收起，拖动它上方的分隔条可以调整高度

顶部的工具栏左边是撤销时间线编辑、重做时间线编辑、在播放头处分割、复制所选动作、删除所选动作和添加标记，右边是播放（播放中变为暂停）、停止和关闭时间线编辑器。下方左侧是操作清单，右侧每条操作一条轨道，上面是显示当前时间和总时长的播放位置滑块

轨道下方的横条用数字编辑选中的操作：开始，片段还有结束和持续时间，音频、动作和相机运动还有源起点，单位都是秒。使用源媒体长度让这类片段恢复文件的完整长度。清单里操作旁的锁定时间让它的片段不能被移动或裁剪；添加标记打的标记只用来吸附和跳转——两者都不影响自动化怎么播放。在清单里拖动操作的把手，和在执行操作区块里一样调整顺序，清单旁的分隔条则调整清单的宽度

各项编辑互不牵连：移动、裁剪或删除一个片段，其他片段都留在原处，空出来的间隔也不会自动合拢。在播放头处分割在播放头处把选中的片段一分为二，但不能切在音频或效果的淡入淡出区间里。控制相机、同一个虚拟形象的动作或同一个特效的片段不能重叠：重叠的会标红，分开之前自动化无法执行。每次编辑是一步撤销——在时间线里操作时也可以用 ⌘ + Z 和 ⌘ + Shift + Z，Windows 和 Linux 上是 Ctrl + Z 和 Ctrl + Y。已经在播放的那次执行仍按它开始时的版本进行

右下角的齿轮图标时间线设置里有：

播放从播放头开始执行自动化——先执行准备步骤——即使自动化已停用或还在冷却中；暂停之后再点，则从停下的地方接着播放。停止结束这次执行，停下它的声音、把正在播的动作淡出，撤掉临时效果，并把播放头拉回 0 秒。移动播放头不会执行单次操作或准备步骤，往回移动也不会撤销它们

执行自动化

除了触发条件，自动化还可以从选项菜单里的执行自动化执行，也可以从 Web 控制台 的自动化页、Stream Deck 的运行自动化按键执行，或者由插件通过 插件 API 调用 automation.run。这些都不需要组合键——想要一整排按键但不想占掉一整排组合键时，就这么用。自动化只能在桌面应用里编辑，暂停的自动化从这些入口都不会执行

一次执行先完成准备步骤，再启动时间线计时：单次操作和片段按各自的时间执行和播放，空白的间隔也照样计时；到时间线结尾，还在播放的一切都会停止。文件在计时开始前就准备好；某个片段到点时文件还没加载完，整条自动化会等它，而不是错开节奏

自动化播放时，标题会随时间线进度从左到右填上一层淡淡的强调色，正在播放音频或相机运动的行也会高亮。执行失败时，整条自动化停在出错的那一刻，错误显示在失败的那一行上；在你停止它之前，它不会再次执行

场景切换会停止其他所有还在播放的自动化，停用或删除一条自动化会停止它自己的执行。打开快捷键录制器会停止正在播放的自动化，录制器打开期间也不会启动任何自动化。自动化可以互相触发——切换场景进入另一条自动化监听的场景，播放动作或替换模型引发动作播放或模型加载完成——但同一条链上每条自动化最多执行一次，所以两个场景不会无休止地来回切换。按键、手动执行、插件调用或传感器触发都会开始一条新的链，在时间线上预览则不会触发任何自动化

导入与导出

清单上方的导入与导出一行有导入自动化和全部导出，卡片选项菜单里的导出自动化则只导出那一条。导出的是一个 JSON 文件，描述这些自动化——操作及其时间、触发条件和冷却时间——并以 ID 指明它们用到的场景、图层、模型和文件，但不包含这些内容本身。文件里带着它的 JSON Schema 链接，VS Code 等编辑器可以边写边校验

导入自动化会先完整检查整个文件，再做任何改动；版本不受支持，或者含有无效的自动化、操作或触发条件的文件会被整个拒绝。导入的自动化加在现有自动化下方，处于停用状态，也没有组合键。这台电脑上没有的场景、模型或文件会显示为不存在，直到你换一个，所以启用之前请逐条检查目标

虚拟形象快捷键

当前 主模型 自带的快捷键接在自动化后面，放在单独的可折叠分区虚拟形象快捷键里。分区里最先是启用虚拟形象快捷键，可整组开关，只在这个形象确实带着快捷键时才出现；接着是添加虚拟形象快捷键和各行快捷键。它们以模型格式的图标标记，鼠标停上去写着随「模型名」一起保存

快捷键属于模型而不是应用。每个模型带着自己的一套，换掉主模型就换掉当前生效的那一套——所以一个模型的绑定会跟着它在不同机器之间、以及在 Persona 和 VTube Studio 之间迁移

清单里只列出主模型的那一套。非主模型的绑定不会出现，也不会触发

添加快捷键

在添加虚拟形象快捷键里选一种操作——这一组以当前形象命名，每个操作都带一个图标，清单里对应的行也用同一个图标标记——再在旁边的选择器里挑它作用的对象：

这些操作作用于当前主模型，格式不限——VRM 的表情和动画同样能绑。模型没有可绑定的动作或表情时，对应的选择器不可用；替换模型列出的是已注册模型里除它自己以外的那些，一个都没有时同样不可用

新增的行一开始未绑定。点击设置快捷键…打开录制器，按下你想要的组合键，再用保存或 Enter 确认。清除可以再次解除绑定

录制器打开期间所有已注册的快捷键都会被释放，所以已经绑定过的组合键会传到对话框里，而不是触发它自己的快捷键

录制器也接受手柄，同一只手柄上最多三个控件，摇杆与十字键的方向、扳机都算——见 手柄快捷键

一个组合最多两个修饰键加一个按键。这不是界面的限制而是存储的限制——VTube Studio 的格式每个热键正好保留三个触发槽位，Persona 只接受能保存到该格式的组合。修饰键按平台命名，所以 macOS 上的绑定显示为 ⌥ 和 ⌘ 而不是 Alt 和 Win

每一行的选项菜单里有触发，可立即测试这条快捷键。凡是 Persona 本来也拒绝运行的，这一项都不可用：不支持的 VTube Studio 操作、被模型关掉的那一条，以及启用虚拟形象快捷键关着时的所有行

后台与聚焦快捷键

每条自动化和每个虚拟形象快捷键的选项菜单里都有后台生效，决定它的组合键在别的应用位于前台时是否仍然有效。会在后台生效的用一个地球图标标记

它需要 Ctrl、Alt 或 Cmd。单独一个按键，或 Shift 加一个按键，正是打字用的——把它注册成全局生效可能阻止其他应用接收该按键——所以这类绑定只在聚焦时生效，该选项会被禁用。手柄组合不在此列：它们不注册进系统的全局快捷键，所以后台生效对它们始终可用，也不需要修饰键

已经被别的应用占用的组合键同样注册不了。快捷键不会因此丢失：它会退回到只在 Persona 聚焦时生效，组合键旁的琥珀色三角会说明原因

两个快捷键共用同一组合键时

两个虚拟形象快捷键用同一组合键时都会触发，对应的行会标上警告三角。这与 VTube Studio 一致，一个组合键可以同时驱动多个热键——想一次应用两个表情时很有用，若不是你的本意也值得留意

自动化优先：组合键归自动化时，只执行自动化，同一组合键上的虚拟形象快捷键不会触发；两条自动化共用一个组合键时，只有清单里靠前的那条会执行。这些行同样会标上警告三角

每个快捷键都有各自短暂的重复触发保护，所以按住不放只会触发一次，而不是一直重复

存放位置

Persona 会原地编辑这些文件，并保留未识别的字段。用到 Persona 没有对应实现的 VTube Studio 操作的热键，会以灰显列出并标记为不支持，永远不会触发，写回文件时也原样保留——所以在 Persona 里编辑快捷键，会保留 VTube Studio 配置中的其他内容

只读的配置文件永远不会被写入，改动也就不会保存