Persona

在 控制面板 左侧导航栏的捕捉下方，点击自动化即可进入配置面板。一条自动化是一条基于时间轴组织的操作序列，作用于当前活动场景。自动化可通过键盘快捷键、游戏手柄按键组合启动，亦可由场景切换、面部捕捉丢失等系统运行时事件触发，或随时手动执行。借助自动化，单次触发即可并行或按顺序执行多项舞台操作，例如同步开启滤镜特效、平移相机机位、切换图层可见性，或配合伴奏音频按节拍触发运镜。

自动化面板首先呈现应用全局的自动化项目清单。当舞台视口中存在模型时，面板下方将显示可折叠的虚拟形象快捷键分区，按模型分组列出 模型自带的专属快捷键；该分区默认保持展开，并会记住折叠状态。

创建自动化复制锚点链接

点击列表上方的添加自动化按钮，在下拉列表中选择初始操作类型，并在相邻选择器中指定作用目标（无需指定目标的操作将直接显示添加按钮；归属于虚拟形象分组的 虚拟形象操作 需先选择目标虚拟形象）。系统将基于该动作生成一条新的自动化项目并自动展开配置卡片，输入光标聚焦于自动化名称输入框。

每条自动化都是一张卡片。卡片顶部显示名称和触发条件摘要，右侧依次是绑定的按键组合、启用自动化开关和自动化选项菜单；播放期间，前面还会出现暂停自动化和停止自动化按钮。

关闭启用开关即可停用这条自动化：摘要以已暂停开头，所有触发都会被忽略（包括来自 Persona 外部的 API 调用），正在播放的时间线也会立即停止。

点击标题栏可展开或折叠卡片。可以在名称中自定义标题；留空时，标题由各操作名称以 · 连接而成。卡片主体从上到下依次是 触发条件、打开 时间线面板 的时间线编辑器按钮，以及 执行操作 列表。

卡片选项菜单包含执行自动化、复制自动化、导出自动化、后台生效和删除自动化。

• 复制自动化：在下方插入一份副本并展开。副本保留所有操作及其时序、触发条件、冷却时间和启用状态，名称后加上「副本」；出于安全考虑，不复制按键组合。
• 导出自动化：将这条自动化导出为独立文件（详见 导入与导出）。
• 后台生效：决定其他应用在前台时，这条自动化的快捷键是否仍能触发（详见 后台与聚焦快捷键）。

触发条件复制锚点链接

触发条件区块列出了启动该自动化的所有监听通道。满足其中任意单一条件即可触发执行，用户亦可随时手动触发；卡片摘要栏实时罗列已配置的触发类型，未配置任何触发源时显示为仅手动执行。

键盘、鼠标或控制器复制锚点链接

键盘、鼠标或控制器触发器始终排在第一位。展开后点击「设置快捷键…」打开录制弹窗，同时按下最多三个按键或鼠标按键，再点击保存或按 Enter 确认；点击清除可解除绑定。

响应规则与 虚拟形象快捷键 相同：

• 开启后台生效时，任何组合（包括不带修饰键的单键）在其他应用位于前台时也能触发；关闭时只在 Persona 窗口处于焦点时响应。
• 自动化要求按住的修饰键与绑定完全一致：绑定 W 的自动化在按住 Shift 时不会触发。
• 录制器也可绑定同一手柄上最多三个输入。手柄绑定与键盘遵循相同的规则（详见 手柄快捷键）。

按键绑定并非必选项。未分配快捷键的自动化仍可通过运行时事件触发、手动点击执行，或 经由外部接口调度。

事件触发条件复制锚点链接

点击添加触发条件可向自动化中追加以下事件监听器。每项触发器均为独立的可折叠条目，标题栏直观概括当前参数（已保存项默认折叠，新添加项自动展开），点击移除触发条件可将其删除：

若参数值与动作播放所绑定的图层被替换为其他模型资产，原监听条件将自动失效；当场景中尚未添加虚拟形象图层时，上述两项在添加触发条件菜单中呈灰显禁用状态；若当前未配置活动的人脸追踪数据源，面部捕捉选项亦同步禁用。

• 参数值：监听图层收到的原始输入，默认为 MouthOpen，可在参数下拉列表中改为任意面部、控制器轴向或 随机脉冲输入（RandomPulse1 – RandomPulse8，无论是否已绑定到模型参数，均可用作随机定时触发源）。它在 参数映射 之前取值，反映原始追踪数据，不受模型形变曲线影响。
• 麦克风音量：使用 口型同步 中选择的麦克风输入，沿用其增益、噪声门和平滑设置。即使关闭了口型同步驱动，它也能正常工作，只是不驱动唇形。
• 面部捕捉：追踪源明确报告未检测到人脸，或连续 1.5 秒没有收到数据时，即判定为丢失人脸。
• 场景切换：由它触发的操作始终作用于正在进入的目标场景，即使触发时机设为离开时也是如此。只在编辑器中修改场景配置不算场景切换。

麦克风音量和参数值在信号越过阈值时触发：

展开条目可看到重新触发所需的数值，以及对比当前输入与阈值的实时电平表。

麦克风音量、输入参数及面部状态触发器在建立监听初始时刻不会因静止状态触发，仅对后续的动态边沿变化产生响应；当音频或追踪信号中断后重新恢复时，系统将重新初始化边沿判定。即使控制面板窗口处于关闭状态，所有后台事件触发器仍保持持续监听。

冷却时间复制锚点链接

冷却时间用于设定两次自动化执行之间的最小强制时间间隔，取值范围 0 – 3600 秒，自上一次序列启动时开始计时。当自动化正处于回放执行中或处于冷却保护期内时，接收到的所有外部触发信号均被直接丢弃，不进入等待队列；冷却计时不会对同一序列内部的后续操作产生任何延迟干扰。

操作复制锚点链接

执行操作区块罗列了当前自动化所包含的操作指令，点击底部的添加操作可追加新的动作。每项操作均以以下三种时序形态之一排列在 时间线 上：

准备类操作始终严格优先于时间线执行：系统按列表顺序依次完成目标场景载入及模型资产替换，待目标环境就绪且资产完全加载后，时间线时钟方开始计时。准备操作条目在界面中以虚线边框标识，并注有播放前准备。

单次操作在时间线的精确时间点瞬时触发一次（条目标注为在第 X 秒执行），其产生的状态变更将持续保持，即使中止自动化回放亦不会自动撤销。处于同一时间戳的多个单次操作严格按照列表先后顺序串行执行。

片段覆盖一段连续时间（例如标注为 2–7 秒 · 时长 5 秒），结束时释放所控制的通道：临时特效恢复为场景设置，运镜、音频和动作停止播放。

• 未裁剪的播放相机运动、播放音频、歌词和播放动作片段沿用文件自身的时长，标注为从第 X 秒开始 · 自动时长。
• 相机运镜、同一虚拟形象的动作通道、同一特效、同一文本图层，同一时间都只能由一个片段控制；音频片段可以自由重叠。

每条操作均为独立可折叠条目，标题栏摘要显示当前配置。界面同一时间仅展开一行详情，在时间线上选定片段将联动展开对应的操作条目。拖拽条目左侧手柄可调整其在列表及时间线轨道中的上下堆叠顺序，该操作不会改变实际触发时间点。自动化序列必须保留至少一项操作，最后剩余的条目禁止删除。

执行期间，每个条目的标题旁会显示操作状态和已用时间：等待执行、正在执行…、已完成、已跳过、失败或已取消。音频和运镜条目还会显示百分比进度。将鼠标悬停在状态上，可查看失败或跳过的原因。

目标选择器会考虑前面的准备操作：序列中有切换场景时，图层选择器列出目标场景中的图层；有替换模型时，列出替换后的模型。

引用的目标被删除后，条目仍会保留，并显示警告：场景不存在、图层已丢失、预设不存在、虚拟形象不存在、模型不存在、表情不存在、动作不存在、音频不存在、相机运动缺失或歌词不存在。执行时：

• 以下操作会自动跳过：
  • 图层已丢失的图层可见性
  • 预设不存在的应用预设
  • 图层已丢失或不是文本图层的设置文本
  • 图层已丢失、或既不是 VRM 模型也不是 3D 物体的相机跟随、相机注视目标与相机对焦（相机保持原状）
• 其他目标缺失会导致 执行失败。

以下操作的选项较为简单：

直播模式是唯一修改全局设置、而非场景状态的操作，因此和 舞台 中的开关一样，切换场景后仍保持原有状态。

应用效果设置复制锚点链接

新建应用效果设置操作时，会以特效当前的实时参数作为初始快照；之后在条目中修改数值只影响这条自动化，不会改动当前场景。条目包含特效自身的全部滑块，另有：

• 触发时启用：决定操作执行后特效处于开启还是关闭状态。
• 从当前舞台复制：用视口当前的实时参数覆盖保存的快照。
• 重置为默认值：将参数恢复为特效的出厂默认值，触发时启用的设定保持不变。

执行该操作时，浮点数值与色彩参数将在 0.4 秒内平滑插值过渡，枚举模式与硬开关则瞬时切换完成。

临时效果复制锚点链接

临时效果的控件与应用效果设置相同，另有淡入（秒）和淡出（秒），各最长 10 秒。新建片段默认时长 5 秒，淡入淡出各 0.4 秒；两段淡变加起来不能超过片段长度。

片段播放期间，保存的参数接管特效：开头淡入，结束前淡出。之后特效回到场景中的设置。

• 临时参数不会写入场景配置文件。
• 回放期间手动调节这个特效，自动化会立即交出它的控制权，直到下次执行。

切换场景复制锚点链接

添加该操作时，系统默认抓取当前活动场景作为目标，用户可在场景下拉菜单中重定向至其他场景。执行切换时无缝调用目标场景预设的 场景转场 动画。作为准备步骤，该动作在时间线时钟启动前优先执行；待目标场景激活加载后时间线正式开始计时，此时全屏转场动画可能仍在播放过渡中。

若目标场景当前已处于激活状态，该操作仅取消挂起中的其他切换，不进行冗余的重新加载。若在执行等待期间触发了更新的场景切换（例如另一条自动化的切换场景、控制面板手动选景或插件调用 scene.activate），系统将直接取消当前的等待执行，不会报错。若目标场景已被物理删除，条目显示为场景不存在，执行将报错中断。

若需通过实体按键或游戏手柄切换场景，只需创建包含切换场景操作的自动化条目，并为其绑定相应的快捷按键。

应用预设复制锚点链接

应用预设提供预设选择器，列出目标场景中已保存的 场景预设；如果序列包含切换场景，则列出切换后场景的预设。执行时，图层按预设自身的转场方式移动。

• 如果目标场景中已没有这个预设，条目显示预设不存在，执行时跳过。
• 与其他单次操作一样，通过自动化应用预设不会产生撤销步骤。

若需通过键盘快捷键或手柄按键应用预设，只需创建包含应用预设操作的自动化条目并绑定快捷按键；Stream Deck 插件另提供专用的应用预设按键。

相机位置复制锚点链接

新建相机位置条目将自动捕获当前视口相机的机位参数，并支持在面板中直接进行微调：

点击从当前舞台复制可用当前视口相机的构图参数覆盖现有数值，便于在舞台中直观取景后保存；点击预览位置可驱动视口相机即时移至保存的机位；修改参数仅影响当前自动化条目。

若捕获快照时相机处于初始默认构图状态，条目将标记为默认构图，仅视场角开放编辑，直至用户点击设置位置完成自定义。

若需实现多机位连续运镜，只需在时间线上为不同相机位置条目分配递进的时间戳。若当前场景在 相机 配置中启用了全局运镜动画，该运镜轨迹将覆盖静态机位，条目将显示相应提示。

播放相机运动复制锚点链接

播放相机运动允许从 素材库 中选取 .vmd 格式的相机运动资产，在片段持续时间内独占驱动 3D 相机运动，片段结束后将视口平滑归还场景相机；亦可通过单次的停止相机运动指令提前收回控制权。该操作优先级高于场景 相机 中的全局待机运镜，且其时间基准严格锁定于自动化时间线（而非虚拟形象自身的待机动作循环）。因此，暂停自动化或在时间线上拖拽播放头时，相机运镜将同步暂停或精确定位。在自动化暂停期间手动调整舞台相机，恢复播放后相机将平滑重新捕捉运镜轨迹。

相机跟随复制锚点链接

相机跟随让相机跟随指定图层或 主模型 移动取景；选择「无」则停止跟随。

设置项与 相机：跟随 相同：图层、锚点（骨骼或根节点）、旋转（忽略 / 偏航 / 偏航和俯仰 / 偏航、俯仰和滚转 / 延迟跟随）和阻尼。点击从当前舞台复制可读取视口相机当前的跟随设置。

相机注视目标复制锚点链接

相机注视目标让相机原地转动，使指定图层或主模型保持在屏幕的指定区域内；选择「无」则恢复朝向常规注视点。

设置项与 相机：注视目标 相同：图层、锚点、屏幕位置（屏幕 X 与 Y）、死区、软区、偏置、阻尼和预判。点击从当前舞台复制可读取视口相机当前的注视设置。

相机对焦复制锚点链接

在场景启用 景深 效果时，相机对焦将景深焦平面持续锁定在指定图层或主模型的特定骨骼锚点上，并支持设定对焦阻尼；选择「无」则将对焦点恢复至相机注视点。详见 相机：对焦。点击从当前舞台复制可直接同步当前相机的对焦配置。

手持晃动复制锚点链接

手持晃动用于在自动化运行过程中切换相机的程序化轻微晃动，提供切换、开启与关闭三种模式（初始预设为切换）。开启后相机将产生自然呼吸感与微幅晃动；关闭则恢复完全平稳的机械机位。参数配置见 相机：手持晃动。

播放音频复制锚点链接

播放音频用于播放素材库 音频 分类中的声音文件，支持配置以下控制项：

淡入作用于第一次播放的开头，淡出作用于最后一次重复的结尾；设为循环播放时，只在主动停止时淡出。

再次触发时决定前一次播放尚未结束、操作又被触发时的行为：

• 从头播放：立即结束之前的播放，从头开始。
• 叠加播放：再开一个并行的播放实例，与原来的叠加混音。
• 继续播放：忽略这次触发，原音频继续播放。

不同条目播放同一音频文件时互不影响。

启用驱动口型同步后，指定的虚拟形象将在音频回放期间自动解析音频波形驱动唇形（详见 口型同步）。主模型动态指向音频触发时刻的主导虚拟形象。

条目标题栏会显示播放状态和已播放时长，重复播放时还会标出当前次数（如第 2/3 次播放）。状态包括正在加载…、播放中、循环播放中、已暂停、正在停止…、已完成、已停止和失败。时间线片段结束时，音频随之停止。

控制音频对指定音频文件的所有播放实例执行暂停、继续或停止（默认停止），无论播放来自自动化还是素材库。选择停止时，音频会先完成设定的淡出再停止。

设置文本复制锚点链接

设置文本允许在时间线的指定时间点向指定的 文本图层 推送一段动态文字内容。该操作仅临时改变舞台画面，既不写入 scenes.json 场景配置文件，也不产生撤销步骤。临时文本将一直保持，直到该文本图层触发恢复已保存文本操作、在属性面板中手动修改保存的文本，或该图层被移出舞台。若运行时目标图层不存在或并非文本图层，该操作会自动跳过。

歌词复制锚点链接

歌词操作允许在指定 文本图层 上绑定素材库中的 .lrc 歌词文件，随时间线驱动卡拉 OK 风格的逐行歌词伴唱回放：

• 自动对齐伴奏：添加歌词操作时，系统会自动继承同一自动化中第一个播放音频片段的起始时间点、源起点（Source In）与持续时长；若音频为原生未截断播放，歌词片段亦保持原生自动时长（即以歌词文件自身时间为准，而非强制截断于音频终点）。添加完成后，两个片段的时间互不影响。
• 时长推导：歌词文件的原生时长优先读取元数据 [length:] 标签；若未提供，则推导至最后一个歌词单字的结束时间戳；若均无则推导至最后一行起始时间戳顺延 5 秒。若歌词片段的持续时长超出文件本身长度，文本图层将停留在最后一行动画状态直至片段结束。
• 两行轮播：为防止歌词刷新时视线跳跃，文本图层始终以两行固定布局呈现当前行与下一行歌词（偶数行显示在顶部，奇数行显示在底部），各行在原位刷新而不发生垂直跳位；在首行歌词起唱前，两行均呈现未唱状态。
• 逐字染色与逐行点亮：增强型 LRC 格式（包含 <分:秒.毫秒> 标记）支持逐字精准擦除染色；普通标准 LRC 则在每行起始时间点整行点亮。已唱部分字体的填充色与描边样式由文本图层自身的已唱颜色与已唱描边决定。
• 时间标签解析：支持 [offset:] 整体微调偏移（正偏移提前显示）；针对重复时间戳，保留首个包含文本的行；空时间戳行将作为前一行的结束截断标志。文件编码自动按 BOM 识别 UTF-8 或 UTF-16，无 BOM 时优先按 UTF-8 解析，失败后回退至 GB18030。
• 状态恢复：当歌词片段到达右侧边界结束、自动化被用户手动停止或回放异常中断时，该文本图层将立即恢复为其自身原本保存的文本内容（包括先前已生效的瞬态文本）。
• 校验保障：若引用的歌词文件缺失、解析损坏，或目标文本图层不存在/非文本图层，自动化将在启动前直接报错拦截，杜绝异常执行。

虚拟形象操作复制锚点链接

切换表情、播放动作、清除所有表情、替换模型和模型位置作用于虚拟形象选择器选定的对象：可以是某个虚拟形象图层，也可以动态指向主模型。

表情选择器和 Live2D 动作选择器直接读取模型元数据，无需先把模型载入舞台。VRM 模型的动作则通过「选择动作…」在 素材库 中选取，包括内置动作包和自定义导入的剪辑；也可以点击「打开文件…」即时导入本地文件。

模型位置可将虚拟形象当前的姿态坐标保存为快照，并支持使用标准的 2D 或 3D 变换控件进行微调；修改参数不会直接移动模型，点击从当前舞台复制可重新捕获视口坐标，操作执行时虚拟形象将平滑滑行至目标坐标。替换模型作为准备步骤，在保留原图层空间变换的前提下于时间线启动前预载新资产。若运行时绑定的表情、动作或虚拟形象已失效，执行将直接报错中断。

Live2D 模型的播放动作片段始终要求自起始帧完整播放，系统禁止对其执行时间轴首部裁剪或中途跳播。VRM 动作片段支持自由裁剪与播放头拖拽跳转，但物理弹簧骨骼不会追溯模拟跳转点之前的惯性轨迹。

时间线编辑器复制锚点链接

在展开的自动化卡片中点击时间线编辑器，将在控制面板底部（横跨左右双栏）展开一个停靠式时序编辑工作台。切换浏览其他卡片时，时间线编辑器保持与当前自动化绑定；在时间线轨道中选定片段，对应的卡片条目将自动滚动并高亮呈现。点击关闭时间线编辑器可将其收起，拖拽面板顶部分隔栏可调整编辑区高度。

编辑器顶部工具栏：

• 左侧：撤销时间线编辑、重做时间线编辑、在播放头处分割、复制所选操作、删除所选操作和添加标记
• 右侧：播放（播放时变为暂停）、停止和关闭时间线编辑器

工具栏下方，左侧是操作列表，右侧是多轨时间线，顶部有标明当前时间与总时长的走带滑块。

轨道下方的属性条可精确设置时间（单位均为秒）：开始时间，片段的结束和持续时间，以及媒体的源起点。点击使用源媒体长度可将音频或歌词片段恢复为源文件的完整长度。

以下两项均不改变实际播放时序：

• 锁定时间：列表项旁的开关，防止误拖动或意外裁剪。
• 添加标记：放置用于吸附定位和快速跳转的标记。

在列表中拖动条目手柄可调整轨道的上下顺序，拖动列表右侧的分割线可调整列表宽度。

时间线编辑遵循以下规则：

• 移动、裁剪或删除某个片段不会影响其他片段，空出的间隔也不会自动合拢。
• 在播放头处分割可在播放头位置将选中的片段一分为二；淡入淡出区间内不能分割。
• 控制相机运镜、同一虚拟形象动作通道、同一特效或同一文本图层的片段不能重叠。重叠的片段会标红，解决冲突前自动化无法执行。
• 每次修改都会产生撤销步骤，可用 ⌘ + Z / ⌘ + Shift + Z 撤销与重做（Windows 与 Linux 下为 Ctrl + Z / Ctrl + Y）。
• 正在播放的序列继续按触发时的快照执行，不受编辑影响。

点击右下角齿轮图标可展开时间线设置：

开启在舞台上预览后，图层可见性条目（以及修改图层可见性的应用预设条目）会随播放头位置实时追帧计算：拖拽走带滑块时，舞台直接预览播放头所在时刻各目标图层的显隐状态，而不写入场景存档，图层列表中的眼睛图标仍保持已保存状态，直到正式播放经过该时间点时才实际写入。在回放或预览期间，若通过眼睛图标、场景预设或插件 API 手动修改了某个图层的保存可见性，自动化会立即将该图层的控制权交还场景，直到点击停止、播放或编辑该自动化为止。

点击播放将从当前播放头位置启动执行（若自动化此前处于停止状态或前置准备步骤发生过改动，会先执行准备步骤，并将当前追帧计算出的图层可见性写入场景后继续播放），即使该自动化当前处于禁用或冷却状态亦可完整试播至序列末尾；点击暂停后再次点击即可在暂停处断点续播。点击停止将立即终止当前执行，截断音频输出，平滑淡出正在运行的动作，撤销临时特效与预览中的图层可见性，并将播放头复位至 0 秒。移动走带滑块不会触发准备步骤或除图层可见性以外的单次操作。

执行自动化复制锚点链接

除了触发条件，还可以通过以下方式执行自动化：

• 卡片选项菜单：执行自动化
• 摄影棚模式：在相机设置中选定自动化，从首帧到末帧完整录制成视频
• Web 控制台：自动化页面
• Stream Deck：执行自动化按键
• 插件 API 与 MCP 服务器：automation.run（以及时间线走带控制接口 automation.control）

这些方式都不占用键盘快捷键，很适合在外部控制器上密集布置动作。除了在桌面端界面编辑外，具备 automation-editing 与 automation-transport 能力的客户端也可通过 插件 API 读取、创建、更新、删除自动化或驱动时间线走带（通过 API 新建的自动化默认处于禁用状态且不绑定快捷键）。已禁用的自动化无法通过 automation.run 或外部快捷按键触发，但可在桌面端时间线编辑器或通过 automation.control 走带指令强制试播。

序列启动后，系统首先执行前置准备，随后启动时间线时钟调度：单次指令与时段片段依照时间戳精准调度执行，时间轴上的空闲间隔自然计时流逝；时间线推进至序列终点时，仍在持续的一切媒体与效果统一停止。相关媒体资源在时钟启动前预载完毕；若某一片段到达执行时间点而外部大文件尚未加载就绪，系统将暂停等待加载完成，确保动作与音频节拍绝对对齐。

回放期间，自动化卡片标题栏将伴随时间线进度自左向右填充半透明强调色，正在播放音频或运镜的条目亦高亮闪烁。若执行遭遇未捕获异常，自动化将在出错时刻停滞冻结，错误信息直观显示于故障条目下方；在用户手动点击停止前，该自动化拒绝响应后续触发。

场景切换将强制终止所有正在执行的自动化序列；禁用或删除某项自动化将立即中断其自身的活动实例。打开按键录制弹窗将暂停正在播放的自动化，录制器开启期间抑制一切新的自动化启动。自动化序列支持链式联动触发（例如通过切换场景进入另一自动化监听的场景，或通过播放动作与替换模型触发相应的事件监听），但同一轮触发中每项自动化最多执行一次，避免无限循环。键盘按键、手动点击、API 调用或硬件传感器输入均会开启一条新的触发链，而在时间线上拖拽预览不会触发任何自动化。

导入与导出复制锚点链接

列表上方的导入与导出工具栏提供导入自动化和全部导出；只导出单条自动化时，使用卡片选项菜单中的导出自动化。

导出的文件为 JSON 格式，包含序列时序、操作、触发条件和冷却时间，通过 UUID 引用场景、图层、模型和媒体资产，但不内嵌媒体文件本身。文件声明了官方 JSON Schema，可在 VS Code 等编辑器中即时校验和补全。

点击导入自动化后，系统将预先对文件数据结构进行完整合规校验；任何版本不兼容或包含损坏操作/触发器定义的文件将被整体验证拦截。成功导入的项目将追加至列表底部，默认置于禁用状态且清除所有按键组合。若当前设备缺失某些引用的场景、模型或媒体文件，相关条目将显示缺失警告，在重新指定可用资产前请逐项复核目标设置。

虚拟形象快捷键复制锚点链接

每个模型的快捷键均拥有独立的折叠区块，位于应用自动化列表下方。组头标明模型格式图标与名称（主模型 额外带有星标标识），各组折叠展开状态按模型独立记忆；右侧开关负责控制该分组是否响应输入；分组内包含添加虚拟形象快捷键入口及该模型的各条快捷键条目。在桌面端与 Web 控制台中，键盘总开关与快捷键控制项均完整保留在对应模型的专属区块内。每行快捷键均标有格式图标，悬停提示注明随「模型名」一起保存。

虚拟形象快捷键归属于模型资产本身而非应用全局。每个模型均保存各自的快捷键配置，因此按键绑定可以随模型在不同设备之间迁移，并直接兼容 Persona 与 VTube Studio。

舞台上的所有活动模型均可独立响应自身的热键绑定，无论其是否为主模型、Live2D 还是 VRM 资产均遵循相同机制（与 VTube Studio 保持完全一致）。主模型分组默认排在首位。若同一模型资产被添加至两个不同图层，列表仅呈现一组快捷键定义（快捷键写入模型私有配置文件，多图层共享）；模型离开舞台时，对应控制分组自动隐藏。

添加快捷键复制锚点链接

在对应模型分组中点击添加虚拟形象快捷键，选择目标动作类型（分组以模型名称命名，每个动作均配有专属图标，列表项亦使用相同图标标识），随后在相邻选择器中指定作用对象：

上述操作针对当前分组对应的模型生效，不论模型格式，VRM 模型的表情与动作同样支持绑定。对于切换表情与播放动作，除了在此处添加外，也可以直接在模型面板中展开任意表情或动作按钮右侧的下拉菜单并选择「设置快捷键…」（多动作分组为设置快捷键子菜单），或在 Live2D 表情编辑器 与 动作录制/编辑器 对话框内直接绑定。当模型未定义动作或表情时，对应的选择器将自动禁用；替换模型下拉列表罗列已注册模型中除自身以外的所有可用资产，列表为空时同样禁用，且替换操作仅作用于当前模型所处的特定图层。

新添加的快捷键初始处于未绑定状态。点击「设置快捷键…」唤出录制弹窗，按下目标按键组合，随后点击保存或按下 Enter 确认；点击清除可重新解除按键映射。

录制弹窗处于开启状态时，任何快捷键都不会触发，因此按下已绑定的组合键只会被录入弹窗，而不会误触发既有的快捷动作。

录制器同时支持游戏手柄输入，允许映射单一手柄上的最多三个控件（涵盖摇杆与十字键的方向轴以及线性扳机，详见 手柄快捷键）。

单一快捷键最多由三个按键或鼠标按键组成，修饰键、普通按键与鼠标左键、中键、右键可任意搭配：既可以是 E + 1 这样的两个普通按键，也可以只是单个修饰键或单个鼠标按键。该上限对应 VTube Studio 配置文件为每个热键分配的三个触发槽位，因此 VTube Studio 模型自带的此类组合导入后可直接使用。组合按同时按住的按键集合判定，与按下顺序无关：E + 1 与 1 + E 视为同一组合，重复绑定警告同样据此判断。显示时修饰键排在最前，其余按键保留录制时或配置文件中的顺序；修饰键遵循当前系统的命名习惯，在 macOS 上显示为 ⌥ 与 ⌘ 而非 Alt 与 Win。

录制器按按下顺序记录每次按下时同时按住的全部按键与鼠标按键；在弹窗内（弹窗按钮及其底部按钮栏除外）点击即可录入鼠标按键。修饰键只有在单独按下并原样松开时才会录为单键，因此按下 ⌘/Ctrl + Enter 这类组合的途中不会误录单个修饰键。手柄按钮只能与同一手柄的按钮组合，不能与键盘或鼠标混用。

每个快捷键条目的选项菜单均提供触发选项，便于在配置过程中即时测试动作。凡是 Persona 运行时拒绝执行的状态，该测试选项均自动禁用：包括未支持的 VTube Studio 动作、模型端禁用的条目，以及组头总开关处于关闭状态时的所有子项。

播放方式复制锚点链接

对于切换表情与播放动作两类快捷键，条目选项菜单中提供了高级回放参数配置。上述选项完全对应 VTube Studio 的同名参数，并在两款软件的配置文件中保持双向互通：

按住时生效与自动关闭时间仅适用于表情条目，停在最后一帧与播放时长上限仅适用于 Live2D 动作条目（VRM 动作片段遵循标准播放逻辑）。两类时间参数均预置了常用档位，当资产配置文件中存储了非标准自定义数值时，菜单将同步列出。

按住时生效机制依赖于系统能够准确捕获物理按键的释放事件（Key Up）：组合中任意一个键松开，表情即淡出。键盘、鼠标与手柄快捷键无论是否在后台生效均能正常检测释放。通过条目菜单中的触发按钮、Stream Deck、MCP 或 插件 API 发起的外部触发不存在物理释放事件，系统统一按开关模式调度。

由开启了按住时生效或自动关闭时间的快捷键所激活的表情，不会被 记住表情 保存，避免在按住按键时保存场景导致下次加载模型时残留临时表情。

后台与聚焦快捷键复制锚点链接

每项自动化与虚拟形象快捷键的选项菜单中均包含后台生效开关，决定该组合键在外部其他应用程序处于前台焦点时是否仍可触发。当前确实能在后台触发的条目在界面中以地球图标清晰标明。

Persona 不向操作系统注册全局热键，而是直接读取按键状态，因此任何组合（包括不带修饰键的单键）都能在后台生效。前台应用照常收到每一次按键，不会被 Persona 拦截，也不存在与其他应用争抢同一组合键的问题；macOS 上也无需授予「输入监控」权限。鼠标按键与游戏手柄组合遵循相同规则。

• 后台生效的单键在其他应用中打字时同样会触发；如不希望如此，请关闭该条目的后台生效，或改用带修饰键的组合。单独绑定的鼠标按键同理，在任何应用中点击都会触发。
• 关闭后台生效的条目只在 Persona 的舞台窗口或控制面板窗口处于焦点时响应。
• 在 Persona 的文本输入框中打字不会触发任何快捷键。
• Wayland 不提供读取按键状态的途径，因此所有快捷键只在舞台窗口处于焦点时生效，含鼠标按键的快捷键则完全无法触发。
• 鼠标按键以轮询方式读取，短于一次轮询（约 16 毫秒）的按下（例如触控板轻点）可能无法识别，这与 VTube Studio 相同。
• 在非 QWERTY 键盘布局的 Mac 上，字母键按该字母在美式键盘布局中的位置触发，可能与键帽上的字母不同。

两个快捷键共用同一组合键时复制锚点链接

当两个虚拟形象快捷键绑定了完全相同的按键组合时，两者在按键按下时将同时触发执行，对应条目均将标注警示三角。该行为与 VTube Studio 完全一致，允许用户通过单一按键复合触发多个动作（例如同时激活两组互补表情），但在意外冲突时亦提供了明确的视觉提示。

归属于不同模型的两条快捷键若共享同一组合键，同样会同时触发，分别作用于各自的模型（例如通过单个快捷键同步控制虚拟形象与独立的手持道具模型）。VTube Studio 对此类跨模型按键冲突不作任何警示，Persona 则统一以警告三角清晰标注。

自动化拥有绝对的执行优先级：当按键组合分配给某项自动化时，系统仅执行自动化序列，同一按键上的虚拟形象快捷键将被抑制屏蔽；若两条自动化项目共用同一组合键，系统仅执行在列表中排序靠前的一项。相关条目均会标注警告三角。

组合在其最后一个键按下时触发。虚拟形象快捷键与 VTube Studio 一致，不检查同时按住的其他键（例如按住 Shift 再按 W 仍会触发绑定 W 的虚拟形象快捷键，方便以键盘或 WASD 操控的模型）；自动化则要求按住的修饰键与绑定完全一致，并只在完全匹配时从虚拟形象快捷键手中接管该组合。

所有快捷键均内置了硬件级的防抖连击保护，持续长按按键仅激发一次触发动作，不会引发无限连击。

存放位置复制锚点链接

Persona 原地编辑更新上述配置文件，并完整保留所有未识别的扩展字段。对于引用了 Persona 尚未支持的 VTube Studio 高级操作的热键条目，界面会灰显列出并标记为不支持，运行时不会触发，写回文件时原样保留，确保在 Persona 中修改快捷键不会破坏现有的 VTube Studio 配置。

播放方式 中的高级配置字段完全复用 VTube Studio 原生字段，在两类配置文件中均能规范存储；Persona 仅序列化写入用户实际修改过的配置项，未触碰的默认字段保持原样。两者存在一处格式差异：.vtube.json 中的淡入淡出时间强制为数值类型（选择默认时写入为 0.5 秒），而 .persona.json 允许缺省该字段，直接在运行时遵循模型原始资产的时序定义。

处于只读状态的配置文件不会写入，此时所做的修改不会保存。