# Galgame 可视化编辑器 · 桌面版使用说明

**构建号：R265 (11-15)**　　版本：0.1.0

---

## 本压缩包内容清单（R265 包 · 含网页版与教学模板）

| 条目 | 说明 |
| --- | --- |
| `galgame-editor.exe` | 桌面版主程序（已代码签名，双击运行） |
| `网页版/` | **浏览器直接打开的完整编辑器**：双击 `网页版/galgame-editor.html` 即可用，无需安装、无需联网；含 `tutorial_project_inline.js`，一键教学模板在网页版同样可用 |
| `桌面版使用说明.txt` | 本文件 |
| `版权与许可.txt` | 开源许可与第三方声明 |
| `证书/` | 自签名公钥与安装说明（可选，用于让其他机器识别发布者） |
| `演示模型/` | Live2D 演示模型 eyu 等真模型素材 |
| `教学模板/` | 教学模板工程 `教学模板.galproj` + 编号使用说明（替代「上手视频」） |

### 教学模板（替代上手视频）

`教学模板/教学模板.galproj` 是**独立工程文件**，不写入编辑器内部，与内置演示模板互不影响。
**一键打开（推荐）**：开始界面左栏「🎓 打开教学模板」，或右侧「🎓 教学模板」固定卡片 → 自动载入 → 时间轴 ▶ 从头播放。
手动打开：开始界面左下方「＋ 导入工程文件…」→ 选择 `教学模板/教学模板.galproj` → 载入后按章节播放讲解。
两条路径载入的是同一份工程；数据文件 `tutorial_project_inline.js` 随 `网页版/` 分发并内嵌进桌面 exe，网页版与桌面版都能一键使用。

配套 `教学模板_使用说明.txt` 按 `1. XXX功能 / 1.1 有哪些按钮 / 1.2 按钮做什么 / 1.3 怎么进去 / 1.4 还可以做什么 / 1.5 小提醒`
编号，共 **29 章 / 147 个小节**，全部用大白话讲按钮、功能与进入路径，不出现代码名；工程同样按功能归档成 **29 个章节 / 147 条教案 + 6 张内嵌入口示意图**，
总时长 **778.8 秒**，0.8 倍速播放约 **16.2 分钟**（远超 5 分钟要求）。

网页版与桌面版共用同一份编辑器源码，区别只在本机能力：模型导入 / 素材库镜像 / ffmpeg 转码 /
工程落磁盘 / 原生分屏 / 自动更新仅桌面版提供；编排、播放、WebGAL 双向、导出成品 HTML 两边都能用。
网页版的具体打开方式、目录文件作用与数据保存注意事项，见 `网页版/网页版使用说明.txt`。

### 当前版要点（R265 · 对齐修复与文案清理）

- **全工程对齐检查**：逐一打开所有弹窗测量「文字 ↔ 输入框」垂直对齐，修复三处真实问题——音频总线滑条/复选框上浮约 7px 与文字不同行、人物弹窗底部「编码/主名称/别名」输入框内边距把写字区挤到 4px 文字放不下、人物列表卡片里「编码」输入框继承下方留白比人名高约 7px；统一改为紧凑行内规格，实测中心重合、写字区恢复 20px。
- **多余文案清理**：桌面版《使用说明》历史版本标题前残留的排序符号已全部清除，标题恢复清爽。
- **自检结果**：真浏览器全弹窗扫描确认其余对齐正常、展开态零重叠、零脚本错误；死代码扫描零真实死代码（两个候选均被回归沙箱使用）。
- **不回退**：R264 使用说明修复、R263 音频字段对齐 / 成就卡片 / 演示模板二周目 5000 字，以及 R253-R262 的网格动画、玻璃液化、音频中心、变量四列等全部保留。
### 上一版要点（R264 · 使用说明修复）



- **「使用说明」点击无反应已修复**：此前点「帮助 → 使用说明」没有任何反应，说明书窗口弹不出来。根因是历次升级往说明书数据里插入的一种简写条目，与正文渲染要求的结构不一致，读取时报错中断；现在渲染前统一补齐这类条目的显示结构，简写与标准格式都能正常显示。
- **版本说明更健壮**：以后再往说明书追加版本更新条目，无论简写还是标准格式，不会再让「使用说明」打不开；左侧目录与右侧正文都会自动包含新条目。
- **不回退**：R263 的音频字段对齐、成就卡片文字完整、演示模板二周目 5000 字，以及 R253-R262 的网格动画、玻璃液化、音频中心、变量四列等全部保留。
### 上一版要点（R263 · 对齐修复 + 二周目演示）


- **音频中心字段对齐**：详情页「设置」区此前文字、输入框与右侧数值不在同一行（数字 / 文本 / 滑条框相对标签上移约 7px，下拉框本就正常）。现统一 margin 与行高，字段名称 / 输入控件 / 数值落回同一水平线。
- **成就玩家视角文字完整**：「成就 → 玩家视角」奖章卡片此前底部两行说明被卡片边框裁掉半截；卡片最小高度从 96px 抬到 148px，名称与说明全部完整显示、不再溢出。
- **演示模板扩充到二周目**：内置「星光的彼端」正文约 5000 中文字（41 段文案），原网格动画章之后新增「第五章 · 重逢（二周目）」「第六章 · 星河回响（二周目）」两章；两章带通关门槛，首周目自动跳过、通关一次后解锁，用于演示「通关次数」分支。
- **教学模板同步**：一键教学讲义补写了音频中心（从哪里进、左边列表右边波形与数值）、变量设置四列、演示模板二周目三处；工程与纸面说明、一键数据文件三处同源。
- **保真与不回退**：R262 变量系统四列 / 波形留白 / 轨道字号、R261 波形就地显示、R260 音频增强七项、R253-R259 网格动画与玻璃液化粒子全部保留。
> 以下为历史版本要点沿革记录，标题中的 R 号是当时版本，不代表当前构建号。

## 〇、历史版本要点（R237 · Spine 协议双门禁）

- **R237 · Spine 协议双门禁（30s 阅读 + 滚动至文末）**：此前同意 Spine 运行时许可协议只需等待 30 秒倒计时结束即可勾选「我已阅读并同意」；本版新增第二道门禁——必须**把协议正文滚动到最底部**，勾选框才会启用、「同意并启用」按钮才能解锁。两条件（倒计时结束 **且** 已读至文末）同时满足才放行；协议正文过短无需滚动时直接视为已读。回看协议（review）只读模式不受门禁约束、不动签字状态。

### 上一版要点（R233 · 模型弹窗位图 + 占位音频静音口径 + 音频格式兼容）

- **R233 · 模型弹窗四页签带目录结构示意图**：🎭 模型弹窗的四个页签（Live2D / Spine / DragonBones / 序列帧）各自加了代表性图标，列表为空与「WebGAL 侧接入说明」里都新增了对应模型的**目录结构内联 SVG 示意图**（.model3.json+.moc3+纹理、.atlas+.json/.skel+.png、*_ske.json+*_tex.json+*_tex.png、GIF/WebM/PNG 序列），一眼看清该把什么文件放进去。
- **R233 · 占位音频静音口径明确**：内置的 BGM / 音效 / 配音占位（无真实音频文件）在编辑器与导出工程里都**保持静音**——播放不出声、不报错、不影响真实音频；导出 WebGAL 时降级为注释，导入带占位的工程不报缺素材。要出声请到素材库导入真实音频替换。
- **R233 · 音频格式兼容更广**：素材导入的音频格式判定从「只认 MIME 前缀」改为「扩展名白名单 + MIME 兜底」，现在 **MP3 / WAV / OGG / M4A / AAC / FLAC / OPUS / WEBM / AIFF** 等都能顺利导入（此前浏览器对 FLAC/AAC/OPUS/AIFF 返回空 MIME 时会被误拒）。实际能否解码仍由浏览器决定（播放 / 波形阶段再兜底）。

### 上一版要点（R232 · WebGAL 场景调用语义显式化）

- **R232 · 导入 WebGAL 时的调用关系看得见了**：官方 `callScene`（调用子场景、播完回到调用点）与 `changeScene`（永久跳转、不返回）此前被同等处理，调用点之后的父章语句还会被误并入子章。现在导入时会把子场景独立成章、把调用点之后的语句单独成「续演」章，并在**归档章节列表**标出「由谁调用 / 是否返回 / 调用时刻」；章节区间仍首尾相接、不重叠。
- **R232 · 语义落差不再隐形**：导入结束会给出一条「调用关系已线性化」提示，应用内使用说明也补了对应章节。此前这里没有任何提示，容易被误认为脚本内容丢失；提示文案明确说明这是结构转换，不是能力缺失。
- **R232 · 导出能回写调用类型**：从官方脚本导入过 `changeScene` 的章节，再导出时该行会写回 `changeScene`；自建工程仍按 `callScene` 链写 `start.txt`，round-trip 产物与之前逐字一致。
- **R232 · 明确不碰的东西**：主时钟 `wgClockInfer`、播放推进 `advanceTo`、存档 / 快进 / 回滚链一律未改，`callScene` 在时钟里仍是并行命令、不推进主时钟。子场景复用与真运行时调用栈仍不在编辑器能力内，手册已写明边界。
- **R233 · 版本口径**：五处构建号统一升到 `R233 (11-06)`（`MS_BUILD_TAG` / 启动 toast / 两份 `tauri.conf.json` 标题；`APP_BUILD` 为日期戳，同日不变），源码快照按新版本号重新生成。

### 上一版要点（R231 · 序列帧帧率滑杆 + 手册配图 + 说明页重拍）

- **R231 · 序列帧帧率可调**：选中「序列帧 / 动图」类型的立绘片段，属性面板新增**帧率滑杆（1–60 fps，默认 12）**，调完立即作用于编辑器内逐帧预览与导出时的 GIF 烘焙；帧率随工程保存，做过 1–60 边界与脏值归一。现成 GIF / WebM 动图自带帧延时，不显示该控件（避免误以为能改播放速度）。
- **R231 · 顺手修掉一个真 bug**：模型 / 序列帧片段的属性面板不渲染「立绘特效」下拉，但保存函数无条件读它的值，导致这类片段改任何属性都会抛异常、写不回去。现已判空，模型片段的起始 / 时长 / 动作 / 帧率都能正常编辑并入撤销栈。
- **R231 · 应用内使用说明有图了**：手册新增 8 张**内联 SVG 示意图**（整体布局、素材库镜像目录、五分钟流程、九轨时间轴、属性工作区与帧率、模型四页签、分支区间、导出链）。全部随单文件 HTML 内嵌，不引用外部图片，网页版与桌面 exe 离线打开都能看；配色跟随帮助面板主题变量。同步把手册里「只有 Live2D / Spine」「Spine 仍是静态占位」等过时结论改到 R231 现状。
- **R231 · 说明页 9 张截图全部重拍**：用真浏览器固定 1440×900 视口、固定演示工程逐张取景，替换 10-03 的旧截图；九段文案同步到四章演示、Canvas/DOM 混合时间轴、四类模型、拼音搜索、WebGAL 双向、序列帧烘焙与自签名 EXE 等现状。另有 14 张零引用死图移入 `归档/说明页旧图_R230/`（可恢复，未直接删除），说明页 `img/` 只保留 9 张新截图 + hero + 图标。

### 上一版要点（R230 · 外来骨骼适配 + 三项体验优化）

- **R230 · L1 导入侧归一化**：DragonBones 现支持 `*_ske.dbbin` 二进制骨架（运行时内置 BinaryDataParser，无需转格式）、多页 `*_tex.json` 图集、导入期版本预检（DB / Spine 4.3 / Cubism 4 / 帧完整性），模型入口改为相对路径，子目录不再丢层级。
- **R230 · L2a 动图直通**：模型新增「序列帧 / 动图」第四类。现成 GIF / WebM 整目录导入即预览，导出写官方原生 `changeFigure: figure/<名>/xxx.gif`，由 WebGAL 的 GifResource / VideoResource 播放，无需 ?type= 或播放器配套。
- **R230 · L2b 真序列帧**：PNG 序列 + 通用图集（TexturePacker JSON hash/array、XML SubTexture）可在编辑器内逐帧预览；导出时用内置纯 JS GIF89a 编码器烘焙成 `*_r230.gif`，不依赖 ffmpeg，网页版同样可用。⚠ 这是视觉降级通道，不保留 IK / 参数驱动 / 换装 / 动作切换等骨骼语义。
- **R230 · 体验优化**：开始界面侧栏按钮改为贴合文字；素材库搜索支持拼音首字母（如输入 `smsn` 搜「神秘少女」）；源码注释去除往期版本流水账，改为描述当前功能。

### 上一版要点（R229 · DragonBones 骨骼运行时：编辑器内真渲染）

- **R229：新增 DragonBones 骨骼模型（第三类模型）**——此前模型只有 Live2D / Spine。本版把 MIT 许可的 `pixi-dragonbones-runtime 7.0.0` 离线预封进安装包（复用编辑器已有的 PixiJS 7.4.2，不重复打包），桌面版启动即自动激活，**无需像 Spine 那样点「安装」或同意协议**。
- **R229：编辑器内真骨骼渲染**——导入 DragonBones Pro 导出的三件套 `<名>_ske.json` + `<名>_tex.json` + `<名>_tex.png` 后，把立绘轨片段「类型」切为「DragonBones 骨骼」，预览里就是**真骨架动画**（循环播放首个动作，属性面板「动作」可指定动画名），不再是 🎭 静态占位；模型弹窗「👁」同样可预览并切换动画。
- **R229：一键上轨 + 空白脚手架 + 导出映射**——素材库「模型」里的 DragonBones 条目单击即加到立绘轨；没有模型时点「✨ 创建空白模型」生成**最小可加载骨架**（含 idle 动画与占位纹理），把正式素材贴进去即可用。导出 WebGAL 工程时整目录拷入 `game/figure/`，脚本 `changeFigure` 带 `?type=dragonbones`；导入侧也能把该后缀回填成模型片段。
- **R229：绑骨编辑器不做**（沿用既定决策）——权重 / IK / 曲线 / 洋葱皮等请继续用 DragonBones Pro，本编辑器只负责导入、挂载、动画选择与导出。
- ⚠ **导出后的播放需 WebGAL 侧配套**：官方 WebGAL 引擎目前没有 DragonBones 通道，使用方需在播放器接入同名 runtime，或把骨骼动画转成序列帧 / Spine 数据；**编辑器内预览不依赖 WebGAL**。
- 本版新增 `r229_dragonbones.cjs`（20/0）真浏览器断言：验证 Armature 真挂舞台、WebGL 像素非零、导出后缀、坏目录降级与销毁回收。

### 更早要点（R228 · Canvas 时间轴补齐后重新启用 + 逐像素比对）

- **R228：桌面端重新启用 Canvas 时间轴**——R226 撤销启用时列出的三项缺口已全部补齐：① 背景音乐 / 特效音乐 / 配音三条轨道的波形（与 DOM 共用同一份峰值缓存，解码完成后自动补绘）；② 归档回放双刻度（当前章节相对时间白字 + 章节起点总体时间绿字）；③ `🔍` 密度模式（强制密集时去掉文字、波形、各类徽标，只留色块与拉伸手柄）。此外把 Canvas 自带的深蓝配色改成读取主题 CSS 变量、补上播放模式/立绘特效徽标的点击热区、把裁剪窗扩到与 DOM 相同的「两端各一屏」，快速横向滚动不再闪白。
- **R228：切换前做了 DOM ↔ Canvas 逐像素比对**——真浏览器里同一工程、同一视口各截一张整页 PNG，逐像素统计：时间轴区域之外 **1,135,316 个像素仅 1,034 个有差异（0.09%）**；时间轴内按 8×8 网格判定「此处有片段」的一致率 **99.46%**；61 个片段逐点采样，**60 个与 DOM 计算色一致、平均色距 2**。新增 `r228_parity.cjs`（14/0）长期看护；比对不达标则默认仍守 DOM。
- **R228：一键回退（重要）**——若真机上遇到任何时间轴显示/交互异常，点时间轴工具栏的 **⚡** 按钮即可切回 DOM 基线（选择会被记住，重启仍生效）；也可以在地址后加 `?tl=dom`，或把本地存储 `gal_timeline_canvas` 设为 `dom`。网页版本来就走 DOM，不受影响。

## 上一版要点（R227 · OffscreenCanvas 演出时钟 + 全轨道可视性审计）

- **R227：演出时钟真正离屏化（OffscreenCanvas）**——此前播放时钟是「主线程累加 rAF 时间差」，窗口最小化/切后台/主线程被长任务卡住时会丢帧、时长漂移。本版起：① 权威时间在 Worker 里用积分式给出（`t = 起点 + 真实流逝 × 速率`，倍速=2、快退=-2），不再逐帧累加；② 帧相位由 Worker 的 16ms 恒定节拍产生，主线程只「消费拍子」，且与 rAF 双挂、谁先到谁推进（可见时 60fps，隐藏时靠拍子，任一路失效都不会卡住播放）；③ 音频试听波形画布通过 `transferControlToOffscreen()` 交给 Worker，波形与播放头完全在 Worker 内绘制——转移后主线程再对该画布取 2D 上下文会抛异常，这正是「确实离屏」的铁证。
- **R227：不支持的环境自动回退**——没有 OffscreenCanvas / transferControlToOffscreen / Worker 的旧内核，自动走原来的 rAF + 心跳路径，网页版与旧系统行为不变；Worker 崩溃或拿不到 2D 上下文时会自动重建画布回主线程绘制，不会出现「波形画死」。
- **R227：全轨道可视性 / 可编辑性审计（12 项全绿）**——针对上一版「轨道不显示 / 双击改不了台词」这一整类缺陷做了全量回归：九条轨道（文案/背景/图片/立绘/背景音乐/特效音乐/配音/特效/故事线说明）逐轨验证——每个片段都能在某个滚动位置被渲染出来（不允许「永久看不见」）、每轨泳道行与标签行都在、预览层真的产出元素、普通台词与分支台词都能双击行内编辑并回车写回、折叠轨确实不渲染且展开恢复、归档视图四章齐全。新增 `r227_audit.cjs`（12/0）、`r227_osclock.cjs`（14/0）、`r227_play.cjs`（6/0）长期看护。

## 上一版要点（R226 · 时间轴回退 DOM 基线 + Canvas 渲染层补齐）

- **R226：时间轴回退到 DOM 稳定基线（重要）**——R225 曾在桌面端启用 Canvas 时间轴，实测出现四处问题：分支轨不显示、立绘轨不显示、双击文案改不了台词、时间轴看起来「只到第二章」。根因是 Canvas 渲染层未补齐：分支子行与图片图层的纵向偏移缺失（片段全叠在同一行互相覆盖）、滚动后不重绘（初始视口之外的第三/四章永远是空白）。本版撤销桌面端启用，恢复 DOM 渲染——波形、章节刻度、分支子行、双击改台词全部恢复正常。
- **R226：Canvas 渲染层缺陷已修复并加真浏览器断言**（r177c 10/0）——分支子行/图片图层按行高正确偏移、滚动按新视口重绘（不再空白）、折叠轨不渲染也不参与命中、HiDPI（125%/150% 缩放）下框选与悬停边界修正。当时遗留的波形/章节刻度/密度模式差异已在 **R228** 补齐并重新启用。
- **R226：演示工程完整可玩**——四章齐全（第一~四章 · 80s），播放遇到分支自动弹出选项，选完继续推进直到真结局；首次打开若只看到前两章内容，请确认已升级到本构建。

## 上一版要点（R225 · 时间轴 Canvas 交互层桌面端启用；R226 撤销、R228 重新启用）

- R225：轨道区交互从 DOM 迁移到 Canvas 2D 虚拟化层（单击 / Shift 多选 / 空白框选、拖拽移动、右缘拉伸、吸附、分支线拖拽、轨道高度 grip、折叠块展开、右键菜单、双击行内编辑）。因渲染层未补齐，R226 回退 DOM；R228 补齐渲染层并通过逐像素比对后重新启用，交互能力至此完整生效。
- R224 收尾三件套（自定义 JSON 动画运行时 / 连续回溯栈 / Worker 演出时钟 / WebGL 注册表 / CA 关闭按钮）详见下方「上一版要点」。

## 上一版要点（R224 · CA弹窗关闭按钮 + 阶段5/6 收尾三件套）

- **R224：CA签名弹窗新增「✕ 关闭」按钮**——此前只能点保存/清除才关得掉。
- **R224：自定义 JSON 动画（GALAnim v0 运行时落地，阶段5⑥）**——图片轨 / 图片立绘片段的属性面板新增「JSON动画」编辑框：粘贴 {"dur":2,"tracks":[{"target":"y","keys":[[0,0,"out"],[2,-40,"out"]]}]} 点「✔ 应用动画」，播放与拖播放头时逐帧采样（位移/旋转/缩放/透明度，缓动 linear/in/out/inout），叠加在原有变换之上，可撤销可清除。
- **R224：连续回溯 / 回滚栈（阶段5⑩）**——走带栏新增「⏪ 回溯」：播放每跨过一句台词就自动记录演出快照（上限 40），点一下回到上一句开始前的完整状态（BGM/立绘/背景/变量一并恢复），连点可一路往回走。
- **R224：演出时钟 Offscreen 化（阶段6②）**——播放主循环改为双路调度：前台 rAF，后台/最小化切独立 Worker 线程计时（16ms，不受页面可见性节流），后台播放不再丢帧漂移。
- **R224：WebGL 上下文整合（阶段6③）**——Live2D/Spine 预览的 PIXI 应用统一收口到注册表（断连即回收、存活上限 8 个、超限驱逐最旧），多角色同屏频繁切换不再触顶丢上下文。

## 上一版要点（R223 · 版权与许可）

- **R223：「帮助 → 关于」新增版权与许可声明**——版权主体 **LUCA LAB**，本软件基于 **Apache License 2.0** 授权发布；NOTICE（本产品由 LUCA LAB 开发并享有版权、LUCA LAB 名称与标识归其所有）也已写进关于页，与随包「版权与许可.txt」同源同义。
- **R223：随包新增「版权与许可.txt」**（与 galgame-editor.exe 同级）——内含版权声明、NOTICE 与 Apache License 2.0 全文，再分发时请保留本文件。

## 上一版要点（R222 · CA签名作者信息 + 设置界面修正）

- **R222：文件菜单新增「🔐 CA签名（游戏作者信息）」**。点击后填写**作者名 / 组织**并保存，之后每次导出的成品游戏 exe，其数字签名证书都会署名给你：证书主体为 `CN=<作者名>, O=<组织>, OU=Made with Galgame Visual Editor`。
  - **编辑器制作标识写死**：`OU=Made with Galgame Visual Editor` 固定在签名里，任何人右键游戏 exe → 属性 → 数字签名 → 查看证书详情都能看到「用本编辑器制作」，无法移除。
  - 未设置作者时使用编辑器内置证书（签名者 Galgame Visual Editor）；点弹窗里的「清除」可随时恢复。
  - 作者信息是编辑器级设置（跨工程共用），同一作者的证书会在本机复用，不会每次导出都新建证书。
- **R222：设置弹窗「尺寸值」输入框高度修正**——数字框高度与行内文本一致，不再是高出标签一截的大方块。

## 上一版要点（R221 · 导出的游戏 exe 也自动带签名）

- **R221：导出成品游戏 exe 时自动数字签名，用户零操作。** 导出流程末尾（写完自定义图标之后）会自动用同一张发布证书给 `<游戏名>.exe` 再签一次，导出完成提示里显示「（已数字签名）」。
  - **为什么必须"写完图标后再签"**：数字签名是对文件全部字节算的哈希，而「自定义图标」是用 Windows 资源接口改写 exe 里的图标资源＝改字节。先签名后写图标，签名会立刻变成红色「签名损坏」（比不签名更糟）。所以固定顺序：写图标 → 重签。
  - **失败不影响游戏**：签名失败只会降级成「未签名」，游戏照常运行，提示里会写明。
  - **原理**：编辑器内嵌了发布证书，导出时在本机用 PowerShell 的 `Set-AuthenticodeSignature` 完成签名；证书与密钥不联网、不上传。
  - ⚠️ 自签名证书的「信任」不会跨机器传染——玩家若没装 `证书/galgame-selfsigned.cer`，第一次运行仍会看到 SmartScreen，点「更多信息 → 仍要运行」即可。将来换成公共 CA 证书，只需替换包里那张证书，导出的游戏立刻全球免警告，代码无需改动。

## 上一版要点（R220 · exe 代码签名 + 开始界面布局修正）

- **R220 起 exe 已带数字签名**（自签名证书 `Galgame Visual Editor`）：右键 `galgame-editor.exe` →「属性 → 数字签名」可见签名，本机状态「已验证」，不再提示「未知发布者」。随包附 `证书/galgame-selfsigned.cer` + 说明，别的电脑可选择安装后同样认可该发布者（详见第一节末）。注意：自签名不等于公共 CA 证书，陌生电脑首次运行仍可能被 SmartScreen 拦一次。
- **R220 修正开始界面布局**：上一版左竖栏被堆到了上方，本版改为「左侧竖栏 | 右侧工程网格」的左右分栏（左栏 230px 固定，右侧 5×3 卡片网格，底栏横跨）。

- **R219 全新「开始界面」（PS 风格）**：启动即见左右布局——左竖栏「🆕 新建工程 / 📂 查看以往工程 / 📖 加载演示模板」，右侧 5×3 网格展示**真实最近工程**（点卡片一键重开）；底部「预览玩家名」小输入框 + 「进入编辑器 ▶」。顶栏「🏠 开始界面」按钮随时可重新打开。

- **Live2D 模型现在可以在编辑器里直接预览了**（此前是 🎭 灰色占位）：本版内置 Cubism 4 运行时（Cubism Core + PixiJS + pixi-live2d-display，全部内嵌、离线可用），把立绘轨片段的类型切成「Live2D 模型」后，播放头走到该片段，预览区就会**渲染真实模型**并按片段设置播放 idle 动作与表情。
- **怎么试**：① 左上角「文件 → 指定素材库文件夹」选一个文件夹（模型必须落在素材库里）；② 顶栏「🎭 模型」→ Live2D 页签 →「＋ 导入模型目录…」选 Cubism 导出的整个模型文件夹；③ 素材库模型条目**单击**即上立绘轨；④ 播放头走到该片段即可看到模型动起来。
- **预览失败会安全降级**：未指定素材库文件夹 / 模型目录被移走 / 目录里没有 `.model3.json` / 模型文件损坏 → 自动退回 🎭 占位（鼠标悬停可看到具体原因），不会白屏或卡住预览。
- **Spine 仍为 🎭 占位**（官方 WebGAL 已移除 pixi-spine，需在引擎侧自行安装依赖），导出链不受影响：两种模型照常发射 `changeFigure` 并整目录拷进 `game/figure/`。
- **口型/眨眼不在编辑器预览内**：图片立绘的口型同步仍是导出后由 WebGAL 按配音音量驱动（编辑器内只显示主立绘）。
- P2「模型纯导出」经核实已完整可用：整目录导入 → 导出 `changeFigure`（Spine 自动带 `?type=spine`）→ `-motion` / `-expression` / `-skin` 透传 → 资源清单 `D,` 条目 → 导出时整目录写进 WebGAL 工程。

## 上一版要点（R202）

- **演示背景升级为真实场景图**：教室 / 走廊 / 天台 / 夕阳 / 星空五张 1280×853 背景图（WebP 内联），直接铺满画布——不再是偏平渐变。时间轴全程连续覆盖、无背景片段的空档显示白底。
- **演示立绘替换为高清抠图立绘**：神秘少女（银白长发）、男主角（黑发）、开朗男生（棕发）三张全身立绘，各带一张表情差分（少女微笑 / 男主惊讶），均为 1024×1536 透明底 WebP，替换掉旧的小尺寸占位图。
- **修复「点任意章节播放，最后都弹出第一章分支选项」**：切章 / 跳章 / 进入章节时统一清除残留的分支选择框（此前上一章的分支弹窗不会随切章消失）。
- **演示模板剧情扩写约 1000 字**：主线与「再想想」分支的台词大幅加长，章节内容更完整。
- **口型同步素材已就位并接进演示（三个角色全覆盖）**：神秘少女 / 主角 / 同学A 各配 3 张差分图（嘴半开 / 嘴张 / 闭眼），共 9 张，均为 1024×1536 透明底 WebP；与配音重叠的 7 个立绘片段已启用口型同步（时间轴带 👄 标记）。导出到 WebGAL 后由引擎按**配音音量**自动切换嘴型——编辑器内不预览属预期行为。
- **差分素材经过一致性修复**：AI 生图无法做到「只改嘴、其余逐像素一致」（实测非改动区色差约 10/255），直接使用会出现「说话时人物整体轻微抖动」。本版用局部合成把差分区域贴回主图，非改动区色差已降到 3.1–4.9，轮廓 IoU 1.0000，9 张全部通过一致性校验。
- **鉴赏「星空下的约定」补上真实图**：此前该 CG 条目无图，鉴赏里会显示 🖼 占位，现已配星空背景图。
- **模型片段属性面板新增「动作 / 表情 / 皮肤」可编辑字段 + 「🎭 模型构成（可查看）」信息卡**（类型 / 目录 / 入口 / 文件清单）——解决「不能查看模型」：选中模型片段即可在右侧看到该模型的完整设置。
- **演示模板第三章模型片段已烘焙具体设置**：Spine「光之精灵」= idle / default（皮肤），Live2D「守护灵」= idle / happy（表情）/ default；打开演示工程即可在属性面板看到导入的 Live2D 具体配置。
- **导出按 WebGAL 官方方言发射模型动作 / 表情 / 皮肤**：`changeFigure` 自动拼 `-motion=` / `-expression=`（Live2D）/ `-skin=`（Spine），仅字段非空时发出（旧工程 / 无设置片段零影响）。
- 应用内「使用说明」面板已同步新增 **背景与场景 / 模型 / 口型同步** 三节，可随时查阅。
- 若此前已打开过演示工程并产生了本地存档，请用顶栏「📖 打开模板工程」或菜单「打开模板工程…」重新载入，即可看到上述更新。

## 一、运行

1. 关闭已运行的旧版本（若标题栏显示 R200 或更低，先完全退出）。
2. 删除旧的解压目录与旧 zip，重新解压本包。
3. 双击 `galgame-editor.exe`。
4. **核对标题栏**：应显示 `Galgame可视化编辑器 · R265 (11-15)`。若仍是旧构建号，说明解压的还是旧包。

**关于签名与 SmartScreen**

- 本包 exe 使用**自签名证书**（`CN=Galgame Visual Editor`）签名，有效期至 2029-11-02。
  - 在**本机**（证书已装入「当前用户 → 受信任的根证书颁发机构」）：属性里数字签名显示「已验证」，双击无「未知发布者」提示。
  - 在**别的电脑**：双击若弹「Windows 已保护你的电脑」，点「更多信息」→「仍要运行」即可；想让那台电脑也认可，可双击 `证书/galgame-selfsigned.cer` →「安装证书」→ 当前用户 →「将所有的证书都放入下列存储」→「受信任的根证书颁发机构」（详见 `证书/自签名说明.txt`，仅建议在信任的机器上安装）。
- 自签名只能证明「文件自签发后未被改动」，**不具备公共 CA 的全球信任**。要彻底消除陌生电脑的警告，需购买/申请公共 CA 代码签名证书（SignPath 开源项目免费通道 / Certum / Azure Trusted Signing），属后续事项。
- **你自己导出的游戏 exe 同样带这张签名**（R221 起自动完成）：导出完成后右键 `<游戏名>.exe` → 属性 → 数字签名，可看到同一发布者。玩家端要点同上——装了 `证书/galgame-selfsigned.cer` 的机器不再提示。

## 二、本版更新（R199d · 模型脚手架）

### 1. 顶栏「🎭 模型」新增「✨ 创建空白模型」
- 打开顶栏「🎭 模型」弹窗（Live2D / Spine 页签旁），点「✨ 创建空白模型」→ 输入名称 → 自动生成**官方标准目录结构**：入口文件 + 占位纹理 + 「使用说明.txt」替换指引，落在「素材库文件夹 → 模型/<类型>/<名称>/」。
- 定位说明：编辑器**不做「捏模型」**（Live2D Cubism Editor / Spine 是专业美术软件）——脚手架让你把 Cubism / Spine 导出的正式素材（.moc3/.model3.json、.json/.atlas/.png）贴进对应位置即可用。
- 创建后条目自动进素材库「模型」分类，**单击即上立绘轨**（R198c 链路），导出时整目录自动拷入 WebGAL 工程 `game/figure/`。

### 2. 演示模板新增模型使用场景
- 演示工程「星光的彼端」第三章尾声立绘轨出现两个**模型片段**——Spine「光之精灵」+ Live2D「守护灵」（时间轴 🎭 紫色标记），配说明台词。
- 桌面版首次打开演示工程会自动在素材库创建这两个模型的脚手架（占位文件）；用网页版打开演示工程时，模型片段属性面板会提示「请使用桌面版」。
- 选中模型片段 → 属性面板「类型」可切换 Live2D / Spine 骨骼、「模型目录 / 入口文件」可改；R201 起还会显示「动作 / 表情 / 皮肤」输入框与「🎭 模型构成（可查看）」信息卡，直接看到该模型导入了哪些设置。

### 3. 演示模型 eyu 已随安装包附带（R217 · 一键导入，无需选文件夹）
- **真模型 eyu（Live2D，约 18MB）现在随安装包一起分发**：解压后 `演示模型/eyu/` 文件夹与 `galgame-editor.exe` 同级。
- 顶栏「🎭 模型」弹窗点「🎬 导入演示模型 eyu…」→ **自动从自带包导入**，不再弹出文件夹选择框，导入后演示模板的 Live2D 片段即可在编辑器内真渲染。
- 已导入过再点会提示「无需重复导入」。若你自行从源码构建且未带 `演示模型/` 资源，按钮会兜底退回「手动选择模型目录」流程（与旧版一致）。

## 三、本版更新（R199 · 图片立绘口型同步）

立绘轨片段的属性面板新增「**口型同步**」一节（仅桌面版）：

- **启用开关**：打开后该立绘在配音播放时按音量自动切换嘴型（官方按语音振幅驱动，编辑器不发驱动指令）。
- **五个差分图选择器**：嘴型·张 / 半开 / 闭 + 眨眼·睁 / 闭，从素材库立绘分类选取。
- ⚠️ **口型图是与主图配套的整张立绘差分**，不是嘴部贴片：嘴型需 闭 / 半开 / 张 三张，眨眼需 睁 / 闭 两张（须成对才生效）。
- 导出时立绘语句自动带官方 `-animationFlag=on` + 五个口型参数，台词行自动关联 `-figureId`（按说话人与立绘名自动配对，也支持导入回填的显式关联）。
- 时间轴标记：启用口型的立绘片段带 👄 标记。
- 未配差分图则按官方语义不启用，导出不会臆造参数。导入官方 WebGAL 工程时，原有的口型配置会被读回（此前会静默丢失）。

### 素材库模型一键上立绘轨（R198c 回顾）
- 桌面版素材库「模型」分类下**单击模型条目**，即加到立绘轨末尾（类型自动设为 Live2D / Spine、目录与入口文件自动带上），并自动选中打开属性面板。
- 立绘轨上的模型片段：时间轴显示 🎭 标记 + 紫色区分；预览画布显示 🎭 占位与「模型名 · Live2D/Spine」标注（透传期不播动画，动效由 WebGAL 引擎播放）。
- 网页版不变：无「🎭 模型」入口、素材库无「模型」分类；用网页版打开含模型的工程时，模型片段属性面板会提示「请使用桌面版」。

## 四、本版更新（R198 · Live2D / Spine 透传）

### 1. 模型透传（最小环）
桌面版新增「🎭 模型」入口（顶部菜单栏「变量」右边）：

- **素材库新增「模型」分类**，内分 `live2d` / `spine` 两个文件夹——模型按**整个目录**导入（不是单文件）。
- **立绘轨片段属性新增「类型」分流**：图片立绘（默认）/ Live2D 模型 / Spine 骨骼，后两者可选模型目录与入口文件。
- **导出按 WebGAL 官方方言发射**：Live2D → `changeFigure: figure/<模型名>/<x>.model3.json`；Spine → `changeFigure: figure/<模型名>/data.json?type=spine`。模型整目录自动拷入 WebGAL 工程 `game/figure/<模型名>/`，资源清单用 `D,src,dest` 目录条目。
- **透传模式**：编辑器内为静态占位（不解析模型、不播动画），动作 / 表情由 WebGAL 引擎按官方 runtime 播放。

### 2. 模型功能仅桌面版
网页版不提供模型功能（渲染性能与目录访问限制）——顶栏无「🎭 模型」按钮、素材库无「模型」分类；用网页版打开含模型的工程时，模型片段会提示「请使用桌面版」。

### 3. WebGAL 接入前置条件（在 WebGAL 工程侧）
- **Live2D**：须自备官方 runtime（`live2d.min.js` + `live2dcubismcore.min.js`）放入工程 `lib/` 目录（Cubism SDK 发布许可见官方条款）。
- **Spine**：官方已移除 `pixi-spine`，须 `yarn add pixi-spine@3.1.2` + 取消 `pixi/spine.ts` 三行注释 + `yarn build` 重构建引擎。
- 详细步骤见编辑器内「🎭 模型 → 接入说明」页签。

## 五、WebGAL 导出 / 导入

- 菜单「文件 → 导出 WebGAL」生成 WebGAL 官方脚本（`start.txt` + 各章节 `chapter_*.txt`）。
- 「文件 → 导入 WebGAL」可读回官方 WebGAL 工程，双向已对齐官方方言（含条件分支、变量、粒子、滤镜运镜、章节跳转、模型与口型等）。
- 已知诚实降级（导出时以注释保留、不丢数据）：图片轨视频、聚光 / 震动 / 跟随 / 负片 / 萤火虫 / 星光特效、choose 选项显示条件。

## 六、常见问题

| 现象 | 处理 |
|---|---|
| 标题栏构建号不是 R265 (11-15) | 解压的是旧包，删旧目录后重新解压 |
| 双击无反应 / 秒退 | 右键「以管理员身份运行」；若弹出错误请截图反馈 |
| SmartScreen 拦截 | 「更多信息」→「仍要运行」 |
| 时间轴看不清内容 | 工具栏点密度按钮切到「完整」档，或放大时间轴 |
| 导出脚本在 WebGAL 里缺效果 | 查看导出文件里以 `;` 开头的注释行——那是编辑器无对应表达的部分，属已知降级 |
| 模型导入按钮不可用 | 先「文件 → 指定素材库文件夹」；模型仅桌面版支持 |
| 选中模型片段看不到设置 | 确认是桌面版；R201 起属性面板有「动作 / 表情 / 皮肤」+「🎭 模型构成」信息卡 |

## 七、反馈

如有问题，请提供：**标题栏构建号** + 复现步骤 + 截图或工程文件。
