个性化与项目设置

「个性化」模块管理游戏的项目级外观和运行方式，集中在「项目设置」视角中：基础信息、个性化样式、输入按键、游戏系统，以及当前项目的扩展与界面。 这些配置会跟随项目保存，并在预览和打包后的游戏中生效。

​

画布与窗口

「画布与窗口」分类决定打包后的游戏窗口形态。它分为两组设置。

​

画布

设计画布会按比例适配玩家窗口。建议尽早确定与背景、立绘素材一致的宽高比，避免 UI 完成后再大规模调整。

​

桌面窗口

​

个性化

「项目设置 → 个性化」顶部提供「对话框」「光标」「选项」和「输入框」四个标签。对话框和光标使用专用样式编辑器；选项和输入框会打开默认游戏壳中的可视化界面编辑器。

​

对话框样式

「对话框」标签先显示当前项目可以使用的样式：

• 默认游戏壳 → 预设：Studio 自带的 5 套样式；修改过的预设会标记「已编辑」；
• 默认游戏壳 → 用户自定义：当前项目新建或从预设创建副本的样式；
• 外部扩展：已安装扩展提供的对话框样式。

点击「设为默认」会改变游戏当前使用的样式；点击「编辑 UI」进入可视化编辑器。选择尚未加入项目或已经停用的扩展样式时，Studio 会先加入或启用它。扩展被移除、停用或缺失后，游戏会安全回退到内置样式。

​

在 UI 编辑器中调整

现代对话框样式将内容拆成独立图层： 对话框编辑模式仍可以添加文字、图片、按钮、矩形和表单控件，也可以添加「角色名」「对白文本」「对白头像框」三种专用智能组件。设计时可选择项目角色和表情预览头像，正式运行时会按当前对白自动替换。 文档级「行为」设置用于调整逐字间隔、字符淡入和等待图标延迟。没有覆盖的项目继续沿用样式或引擎默认值。

​

管理样式

• 点击「新建」创建空白自定义样式；
• 右键内置预设可以「创建副本」或「恢复预设原样」；
• 右键自定义样式可以重命名、设为默认或删除；
• 在剧本中使用切换对话框样式，可以在回忆、战斗等段落临时切换。

​

游戏光标

「光标」标签控制玩家在游戏画面里看到的鼠标样式。设置会立即反映到右侧实时预览和独立测试窗口，并随项目一起写入发布后的游戏。 预设区同时提供：

• 图片预设 Secret Letter、Moonlit Quill；
• CSS 预设 先锋指针、霓虹棱线；
• 当前项目保存的「我的设置」和「新建空白设置」。

每张预设卡片会标明「图片」或「CSS」。当前显示方式对应的预设可以直接应用，其他类型仍会保留展示。图片预设包含普通状态和带外缘泛光的可点击状态，并使用 2 倍像素素材适配 Retina 与高 DPI 屏幕。

​

显示方式

• 系统默认：沿用玩家设备上的系统光标。
• 自定义图片：从项目素材中选择图片，设置显示尺寸和点击热点。打开「为按钮和链接单独设置光标」后，可以分别配置普通状态与可点击状态。
• CSS 值：填写标准 cursor 属性值，也可以粘贴类似 cursor: crosshair; 的完整声明。CSS 模式同样支持为普通区域和可点击区域分别配置样式。

图片和 CSS url() 光标可以选择 16、24、27、32、48、64px 的常用正方形尺寸，也可以使用 8～128px 的自定义边长。新选图片默认是 24 × 24px；内置预设的泛光交互状态使用 27 × 27px，以保持主体视觉大小一致。 图片光标由游戏画面直接绘制，不受系统光标切换影响，运行时会同步换算显示尺寸和热点坐标。纯 crosshair、pointer 等系统关键字由操作系统绘制，因此不使用图片尺寸设置。 可以先应用内置预设再继续修改，然后通过「保存到我的设置」创建项目专属样式。保存后的图片与 CSS 设置支持应用、更新、重命名和删除，数据写入当前项目的 config/personalization/cursor-styles.json，不会影响其他项目。

​

选项与输入界面

「选项」和「输入框」标签分别提供默认游戏壳中「剧情选项」与「玩家输入」可视化界面的快捷入口。

​

剧情选项

剧情选项界面决定分支 Block 运行时的选项列表外观。点击「在 UI 编辑器中编辑」后，可以调整：

• 选项排列、间距、尺寸和编号；
• 常态、悬停、按下、禁用和焦点状态；
• 背景与选项图片；
• 进场、退场和错峰动画；
• 运行区域的尺寸和位置。

界面中的「选项列表」智能组件在设计时使用示例文案，运行时会自动替换为当前分支 Block 的真实选项，并把玩家选择映射回原分支序号。

​

玩家输入

玩家输入界面用于收集姓名、数值或自由文本。可以修改标题、说明、输入框、确认按钮、校验状态和进退场动画。 打开编辑器后，Studio 会为当前项目创建默认游戏壳界面的可编辑副本。修改只影响当前项目，并同时用于预览和发布版本；需要回到内置版本时，可以使用「恢复原始界面」。

​

输入按键

「项目设置 → 输入按键」用于调整推进对话、跳过、自动播放、隐藏对话框和重放语音等语义动作的按键。 扩展程序也可以注册自己的动作。动作注册后会出现在这里，项目创作者可以统一修改默认按键。开发方法见系统插槽与内置动作。

​

游戏系统

「项目设置 → 游戏系统」决定标题、对话工具栏、存档、读档、设置、历史、鉴赏、玩家输入和剧情选项实际由哪一份 UI 提供。 默认情况下，九个位置都由「默认游戏壳」实现。你可以把它们绑定到：

• 自己制作的可视化界面；
• 本地或工坊扩展提供的可视化界面；
• 声明支持对应插槽的程序 UI。

标题、对话工具栏、存档、读档、玩家输入和剧情选项属于必需位置。绑定失效时，引擎会回退到默认游戏壳。完整说明见默认游戏壳与系统界面。

​

扩展与界面

项目设置左侧第二级导航的下半部分是扩展树。扩展按「本项目」和「本机的其它扩展（全局）」分组显示，全局组的扩展点击「加入」即可加入当前项目，详见扩展工坊 · 安装后的管理。 扩展来源分三种，以行尾徽章区分：

• 内置：Studio 自带，不能停用或删除；
• 本地：自己新建或导入，可编辑、移动和删除；
• 工坊：从扩展工坊安装，只读，可按项目启用或停用。

每个扩展下会按能力显示「界面」和「程序」分组：

• 在「界面」中创建、复制和编辑可视化 UI；
• 在「程序」中查看 React 模块、剧本方法、设置和存档字段；
• 新扩展默认可以只做界面，需要写代码时再初始化程序。

​

项目发行物

项目启用一份本地或市场扩展后，Studio 会把扩展运行所需的内容保存为项目发行物。它会跟随项目一起保存，用于预览、构建和分享。 因此，把整个项目目录复制给其他人时，扩展提供的界面和功能也会一起带过去，对方不需要另外安装原扩展，也不需要拥有扩展源码。源码仍留在开发者自己的电脑上，不会被复制进项目。 项目发行物和本机源码是两份不同的内容：前者保证项目可以独立运行，后者用于继续编辑和开发扩展。扩展信息页会分别显示它们的状态。 扩展下的「界面」和「程序」分组可以分别折叠。管理本地扩展时注意两种删除操作：

• 从 Studio 移除：解除本机工作区关联，保留磁盘上的扩展源码；项目发行物可继续保证项目运行。
• 彻底删除：把本机源码移到系统废纸篓，并删除当前项目中的对应发行物和依赖关系。

彻底删除前先确认源码已提交或另有备份。工坊扩展使用卸载流程，内置扩展不能删除。 从可视化界面编辑器开始制作 UI；安装成品扩展见扩展工坊。