Persona

参数绑定编辑器用于配置输入校准、输入源与混合权重、输入/输出范围以及自定义响应曲线，控制捕捉数据如何驱动 Cubism 模型的各个参数。

Persona 默认优先读取模型自带的 .vtube.json 配置文件，因此在 VTube Studio 中调校好的模型可以直接沿用原有的参数映射。你可以在参数绑定编辑器中继续微调和扩展这些映射；所有修改都单独保存在模型同级目录下的专属配置文件中，不会改动原始的 .vtube.json。

打开编辑器复制锚点链接

在图层列表中选中 Live2D 图层，展开其检查器面板底部的参数（默认折叠）。

本页主要介绍 Live2D 的捕捉参数绑定。VRM 虚拟形象 的面部捕捉直接驱动预设表情形态与人形骨骼；外部游戏手柄与控制器则通过虚拟绑定目标进行映射。

每个输入源在面板中显示为一张独立的卡片，卡片下方列出其驱动的目标参数；点击任意参数行即可在卡片内部直接展开完整的绑定详情与响应曲线编辑器。过滤条件、卡片折叠状态、当前展开的绑定及校准条会在当前会话中按模型实例自动记忆。

输入卡片与工具栏复制锚点链接

顶部的工具栏提供快速检索、过滤与批量操作：

• 搜索输入和参数：可同时匹配输入标签、原始 ID、绑定自定义名称以及目标参数名称与 ID。
• 显示的输入：在使用中与全部输入之间切换。使用中是模型已有绑定时的默认视图，只显示被绑定读取的输入；全部输入显示所有可用输入源。
• 输入类别：按类别筛选卡片，可查看全部类别，或单独查看头部、眼睛、眉毛、嘴巴、手部、鼠标、时间、随机、52 个原始 ARKit 通道的完美同步，以及已连接手柄配置的专属输入分组。
• 添加绑定：从完整输入词汇表中挑选任意输入源，将其卡片固定显示在使用中视图中并直接打开参数选择器。
• 全部校准：同时录制并校准所有使用中、正在接收数据的输入（详见下文 输入校准）。
• 重置校准：一次性清除当前模型上所有输入的校准（作为单步可撤销操作）。
• 全部折叠 / 全部展开：一键收起或展开列表中的所有输入卡片。

手部输入源来自摄像头的手势追踪，详见 摄像头追踪；嘴巴分组中还包含由麦克风音频驱动的 Voice* 输入源，详见 口型同步。

每张输入卡片的顶部显示：

• 输入的本地化标签与原始 ID
• 实时数值与电平条
• 校准按钮（已校准的输入还会显示已校准标记与范围刻度；随机输入卡片则显示触发设置按钮）
• +（添加参数）按钮

卡片下方通过竖向导轨连接该输入驱动的参数行。每行显示：

• 左侧的响应曲线缩略图与实时采样点，无需展开即可看到曲线形状
• 绑定名称与原始参数 ID
• 输入范围 → 输出范围 摘要与平滑系数
• 参数的实时输出值

原始 ID 与 .vtube.json、.cdi3.json 及 插件 API 中的写法一致，可直接选中复制。

参数行与参数选择器中可能包含以下状态标记：

若某个输入作为次要项被合算进其他主输入名下的绑定中，卡片底部会显示同时加入标签与可点击的跳转芯片，点击即可直接定位并展开对应绑定。

点击卡片右上角的 +（添加参数）或工具栏的添加绑定可打开参数选择器。参数名称与其所属分组直接读取自模型的 .cdi3.json 文件；若模型未包含该文件，列表将为空（由于缺乏元数据，无法获取参数的人类可读名称）。

已被其他绑定占用的参数不会被禁用。列表中会清晰标注当前驱动该参数的规则名称（替换 ⋯），选中它会将对应绑定迁移至当前输入，而非创建重复规则，避免两条绑定同时向同一参数写入造成冲突。参数原有的映射配置（输出范围、平滑系数、响应曲线以及自定义名称）均会完整保留，仅替换输入源及其输入范围。

鼠标与时间输入复制锚点链接

鼠标与时间分组无需摄像头：

鼠标输入的 ID 沿用 VTube Studio 的命名。鼠标输入独立于面部捕捉与捕捉总开关，即使关闭摄像头，也能驱动眼睛视线、头部角度或桌宠爪子。目前只提供光标位置；鼠标按键不作为绑定输入，但可用作 快捷键 的触发键。

时间输入读取运行 Persona 的桌面电脑的本地挂钟时间，即使通过 Web 控制台编辑也是如此。例如 06:00 时，Time24h 为 0.25，Time12h 为 0.5。绑定计算保留秒的小数部分，运动更平滑；界面的实时读数则截断至整秒，静止时数值保持稳定，只在正午或午夜回卷。

时间每渲染一帧采样一次，由 Live2D 与 VRM 虚拟形象共享；即使关闭面部捕捉或断开摄像头，时间也会持续驱动绑定。将参数绑定至时间输入时（包括将现有绑定迁移至时间），其平滑系数会自动归零（smoothing: 0），否则 平滑 会在午夜或正午回卷时产生倒退回扫。首尾端点一致的曲线可以避免周期边界处的跳变。

对于同时混合面部捕捉与时间输入的绑定，面部捕捉丢失后的表现由 追踪丢失时 决定：回到待机（idle）会淡出面部捕捉部分、过渡到仅由时间驱动的结果；保持最后姿势（hold）则保留面部捕捉的最后姿态，时钟照常推进。

随机脉冲输入复制锚点链接

随机分组提供八个独立的自动触发输入：随机脉冲 1 至 随机脉冲 8（ID 为 RandomPulse1 – RandomPulse8，量程 0..1）。每个脉冲平时静止在 0，并按各自设定的时间表随机触发升至 1 再回落，无需摄像头，也不受面部捕捉开关或连接状态影响，适合驱动耳朵轻抖、尾巴摆动、眨眼或配饰闪烁等随机小动作。

点击任意随机脉冲卡片上的触发设置即可展开时间配置条（单位均为秒，每次触发都会重新随机抽取等待与持续时间，点击重置可恢复默认值）：

若某次抽中的持续时间短于淡入与淡出之和，两段过渡会按比例缩短。默认的触发设置与 VTube Studio 的自动眨眼完全一致。

仅由随机脉冲驱动的绑定以叠加方式工作，因此可以与普通绑定共用同一个输出参数：

• 在参数选择器中，已被其他绑定驱动的参数会标为加入 ⋯（而非替换 ⋯）。例如，ParamEyeLOpen 可以继续由 EyeOpenLeft 驱动，同时叠加一条 RandomPulse1 绑定在每次脉冲触发时闭眼。
• 脉冲触发期间，参数从当前值平滑拉向绑定输出范围的触发端（outRange[1]，或响应曲线移动的目标端）；两次触发之间不写入参数，保持原有驱动结果不变（若脉冲绑定的静止输出值与参数默认值不同，则在没有其他绑定驱动该参数时维持该静止值）。
• 在随机脉冲上新建绑定时，默认输出范围会从参数的默认值指向远端（对于默认值为 1 的 0..2 参数则设为 1 → 0），且平滑默认为 0（升降过渡已由脉冲自身的淡入与淡出控制）。
• 在组合输入中，随机脉冲绑定只能叠加其他随机脉冲输入，不能与普通捕捉输入混用。

输入校准复制锚点链接

校准用于调整你实际的表情或动作幅度如何映射到该输入的原生量程，在任何绑定读取该输入之前生效。点击输入卡片上的校准按钮即可展开校准条；时间与随机输入不支持校准。

校准位于绑定之前，因此同一虚拟形象上的所有绑定都会共享校准后的信号，通过插件 API 注入的输入与 VRM 手柄绑定也是如此。

校准条提供以下控件：

• 下限与上限：你实际能达到的最小与最大幅度，映射到该输入原生量程的两端。FaceAngleZ（头部倾斜）的校准映射至 ±30°，与其他头部角度及模型常用的 ±30° 绑定区间保持一致。
• 静止位置：自然放松时输入所处的位置，映射到原生量程的中点，因此即使两侧活动幅度不对称，放松时也能准确居中。只有静止在量程中点的输入才提供静止位置滑块与数值框：有符号输入（如头部角度、眼球视线、手柄摇杆），以及 MouthSmile、VoiceFrequencyPlusMouthSmile。
• 镜像：在带有静止位置的输入上，让下限与上限始终以静止位置为中心对称；此时拖动静止位置会整体平移有效区间。

如果不想手动拖动，也可以录制实际幅度：

1. 点击卡片上的录制（或工具栏上的全部校准）。
2. 从静止状态开始：首帧读数会设为静止位置。
3. 向两端做出最大幅度的表情或动作，下限与上限会自动扩展。
4. 完成后点击停止。

录制期间变化幅度不足量程 2% 的输入将保持原样。点击卡片上的重置可清除该输入的校准；点击工具栏上的重置校准可一次性清除当前模型所有输入的校准。

校准采用分段线性映射，超出校准下限或上限的输入会按斜率继续外推。最终参数输出是否截断，由各条绑定自身的限制在范围内开关决定。

绑定详情复制锚点链接

点击输入卡片下的任意参数行，即可在卡片内直接展开该绑定的完整配置面板。面板顶部显示输入及其驱动的参数，两者均附有原始 ID。

• 更改参数：点击顶部的参数，即可将这条绑定改接到另一个参数。输入源、输入范围、平滑系数、曲线形状与自定义名称均保持不变，仅输出范围会按新参数的原生量程更新。若所选参数已由其他绑定驱动，当前绑定会取代它。
• 移除：移除这条绑定。
• 名称：为绑定重命名。按 Esc 可放弃未保存的重命名；清空名称则恢复显示参数自身的名称。

若绑定的参数 ID 在当前模型中不存在，条目将高亮标记为缺失，提示该绑定当前不会生效（常见于切换模型后）。

输入与权重复制锚点链接

组合输入列表展示了汇总至该绑定的所有输入源（点击添加输入可叠加更多输入），每个输入源均带有独立的乘法权重 ×。多路输入经过加权求和后，再统一送入后续的映射管线。权重数值在输入框失焦时自动确认并同步保存至磁盘。

若某个输入在当前帧缺失有效数据，将自动按 0 计算；仅当所有输入源均无数据时，该绑定才会被临时跳过。这一机制使得诸如 blink × −0.8 + wide × 0.8 形式的多信号复合驱动得以稳定运行，公式中的常数偏移量可直接由输入范围吸收。

列表中的第一个输入源决定了该绑定归属的主输入卡片。删除第一个输入会自动将其顺延归属至下一个输入源名下；当仅剩最后一个输入源时不可删除。

平滑复制锚点链接

平滑系数取值范围为 0–100，支持滑块调节或直接输入数值。底层采用随速度自适应的 1€（One Euro）滤波器，而非固定强度的平滑：快速运动时紧密跟随、几乎没有延迟，静止时则能有效抑制抖动与噪声。

将参数绑定至时间输入（Time24h 或 Time12h）时，系统会自动将平滑系数重置为 0，避免时钟在正午或午夜回卷时产生倒退回扫。

响应曲线复制锚点链接

每条绑定都有一张统一的二维响应曲线画布，以绑定的实际单位同时呈现输入与输出范围、三次贝塞尔传递曲线以及实时信号读数。横轴为组合输入的原生量程，纵轴为目标参数的原生量程。若输出范围超出参数自身的量程，超出部分会以阴影标示，因为 Cubism 会在该处截断参数。画布上的动态采样点实时反映当前输入与输出在曲线上的映射位置。

范围复制锚点链接

曲线的首尾两个端点即是该绑定的输入与输出范围。你可以直接在画布上沿横轴（输入）或纵轴（输出）自由拖拽首尾端点，也可以在画布下方的输入（起点 → 终点）与输出（起点 → 终点）数值框中直接输入精确数值。

通过调节输入范围可以精确控制表情的灵敏度与触发阈值。例如，将 MouthSmile 的 0.2–0.8 映射至 −1..1，当面部捕捉输入达到 0.8 时参数即可达到最大输出。点击曲线工具栏的反转按钮（或将输出起点与终点数值对调）即可快速反转映射方向。

新建绑定时，默认输入范围会自动适配该输入源的原生量程，而非固定设为 0..1：例如头部旋转角度以度为单位，ARKit 通道为 0..1，其余输入按各自量程适配。

画布下方的限制在范围内开关（对应 .persona.json 中的 clampOutput）决定输入超出输入范围时的表现：

• 开启时，输出停在输出范围的两端。
• 关闭时，没有塑形曲线的绑定（例如新建的绑定，或已用恢复直线重置的绑定）会线性外推，直至参数自身的物理上下限；用节点或预设塑形过的曲线则保持端点值。

你新增的绑定默认开启此开关。从 .vtube.json 导入的绑定沿用 VTube Studio 自身的截断设置；保存时省略 clampOutput 的绑定按关闭处理。

矢量钢笔手势复制锚点链接

曲线画布采用类似矢量钢笔工具的交互逻辑，支持平滑点与尖角节点的精准调节：

• 添加节点：单击曲线任意位置即可插入新节点。在弯曲的曲线段上，新节点会落在曲线上，曲线形状保持不变。
• 移动节点：拖拽节点调整位置，节点自身的控制柄会随之一同平移，保持原有进出角度；首尾两端点可同时在横轴与纵轴方向移动以直接调整输入与输出范围。
• 调整曲率：拖拽方形控制柄调节曲线弧度。在平滑节点上，对侧控制柄会共线对称旋转并保持原有长度，确保曲线两端平滑连贯。
• 断开控制柄（尖角）：按住 Alt（macOS 上为 Option）拖拽方形控制柄，可单独调整该控制柄的角度与长度，从而在节点处折出尖角。
• 切换平滑/尖角：按住 Alt/Option 单击中间节点，可在尖角与平滑状态之间快速切换。尖角会将控制柄收缩至节点本身；平滑则会朝两侧相邻节点展开对称控制柄。
• 删除节点：右键单击中间节点即可将其移除；曲线始终保留首尾两个范围端点。

选中某个中间节点后，可在画布下方的 X/Y 数值框中以坐标轴的实际单位输入精确坐标。相比鼠标拖拽，直接输入数值能更精准地设定平直死区与触发阈值。

镜像、预设与快捷操作复制锚点链接

曲线画布顶部的工具栏提供以下辅助功能：

• 镜像：以绑定范围的中心点为基准强制保持点对称。编辑任意一侧的节点、控制柄或阶跃模式时，对侧会自动镜像更新。范围居中且曲线对称的有符号输入绑定在展开时会自动开启镜像。
• 预设：用经典传递函数形状替换当前输入/输出端点之间的整条曲线，包括线性、阶梯、反向阶梯、贝塞尔、缓入、缓出、S 曲线、阈值或多级阶梯。
• 反转：一键对调输出范围的起点与终点。
• 恢复直线：移除所有中间节点，将当前输入/输出端点之间的曲线恢复为线性直线。

物理演算复制锚点链接

系统会解析模型的 .physics3.json 物理配置文件，并在编辑器中明确标明各参数与物理系统的关联状态：

• 驱动物理：物理系统将该参数作为输入源。为该参数配置捕捉绑定是标准做法，许多模型正是通过将头部旋转映射至此类参数来间接驱动头发或饰品的物理摇摆。
• 物理：物理演算引擎在运行时会直接计算并写入该参数。若同时为其绑定面部捕捉驱动，二者将在运行中产生竞争与冲突，面板中会以红字显著预警。

实时数值与手动调整复制锚点链接

在捕捉系统运行期间，输入卡片上的电平指示条、参数行缩略图以及展开后的响应曲线采样点均会实时跟随捕捉输入同步变动。

参数行与绑定详情中还会显示参数在模型上的最终值，即叠加动作、表情与物理演算之后的结果。若该数值与曲线上的采样点不一致，说明还有其他动作或物理演算在同时写入这个参数。

直接在输入卡片的电平条上拖拽，可将该输入固定在一个测试值上，无需摄像头即可摆出姿势、调试响应曲线。松开鼠标即恢复实时捕捉。若编辑器不再维持这个值（窗口被关闭或重新加载，或拖拽未正常松开），它会在约 1 秒后自动失效，模型不会被卡住。

撤销与重做复制锚点链接

支持使用快捷键 Cmd/Ctrl + Z 执行撤销，使用 Cmd/Ctrl + Shift + Z 执行重做。

单次拖拽调整记为一步独立的历史记录。输入校准、曲线修改、范围调整、权重变动、增删输入源以及增删绑定规则均统一记录在同一条操作历史中。该历史仅作用于参数面板；当焦点位于其他区域时，同一快捷键会执行全局舞台的撤销与重做。

保存在哪里复制锚点链接

所有参数绑定与输入校准修改均会写入模型同级目录下的 <model>.persona.json 文件中，与 记住表情 共用同一个附随配置文件。自定义参数绑定与输入校准不会写回 .vtube.json，因为该格式本身不支持存储自定义响应曲线、多输入加权参数与输入校准。

在 <model>.persona.json 中，绑定列表（bindings）、输入校准（calibration）与随机脉冲触发设置（randomPulses）作为三个相互独立的顶级字段分别保存：

• 绑定配置读取优先级：<model>.persona.json 中的 bindings → .vtube.json → 内置默认配置。一旦附随文件中保存了 bindings，Persona 就只使用这份绑定列表，不会与 .vtube.json 合并。此后在 VTube Studio 中所做的映射改动不再影响 Persona 中的该模型，面板顶部也会提示这一点。
• 仅校准或调整脉冲不覆盖绑定：如果你只对绑定来自 .vtube.json 的模型进行了 输入校准 或修改了 随机脉冲触发设置，Persona 只会向 <model>.persona.json 写入 calibration 或 randomPulses 字段，不会复制 bindings。模型继续使用 .vtube.json 中的绑定。

从 .vtube.json 导入复制锚点链接

首次读取模型时，Persona 会完整导入其 .vtube.json 中的 ParameterSettings 列表，包括模型作者为每条绑定配置的自定义名称。该名称支持随时修改并保存至附随文件中；清空自定义名称则自动回退显示参数自身的名称。若 .vtube.json 中某条参数未指定输入源但开启了 UseBlinking: true（VTube Studio 中借用自动眨眼触发随机动作的做法），导入时会自动映射为 RandomPulse1，输出范围为 [OutputRangeUpper, 0]。

输入名称经过三阶段解析：优先匹配 VTube Studio 官方输入名称表，其次匹配原始 ARKit 标准 Blendshape 命名，最后兼容 VBridger 将 Left/Right 缩写为 L/R 的命名规范。因此遵循 VBridger 规范绑定的模型均可正确识别，如 EyeSquintL、MouthDimpleR 与 MouthUpperUpL 等均能准确映射，不会丢失条目。

VBridger 特有的几项复合参数在导入时不会作为单一输入处理，而是依据 VBridger 官方预设公式，自动展开为对应基础输入的加权求和，正负符号与权重配比均与 VBridger 完全一致。