# Galgame 可视化编辑器 · 网页版使用说明

**构建号：R265 (11-15)**　　版本：0.1.0
（本目录随「Galgame编辑器桌面版.zip」一同分发，与桌面版是同一份编辑器源码。）

---

## 一、怎么打开

**双击 `galgame-editor.html`** 即可，推荐使用 Microsoft Edge 或 Google Chrome 的较新版本。
不需要安装、不需要联网、不需要账号，也不会往系统写文件 —— 关掉标签页就等于退出。

> 若你的浏览器对 `file://` 本地页面的存储权限做了限制（表现为素材导入后刷新就没了），
> 可改用任意静态服务器打开本目录，例如在文件夹里执行 `python -m http.server 8080`，
> 然后访问 `http://localhost:8080/galgame-editor.html`。
> 注意：`file://` 下浏览器会拦截 ESM 动态 import，这不影响网页版 —— 网页版默认不加载模型运行时。

## 二、目录里都有什么

| 文件 | 作用 |
| --- | --- |
| `galgame-editor.html` | 编辑器本体（单文件，含全部界面、引擎与导出工具），双击打开就是它 |
| `demo_project_inline.js` | 内置演示工程「星光的彼端」的数据，必须和 HTML 放在同一文件夹 |
| `tutorial_project_inline.js` | 教学模板工程数据（29 章功能讲义），开始界面「🎓 打开教学模板」一键加载，必须和 HTML 放在同一文件夹 |
| `spine-pixi-v7.mjs` | Spine 运行时预封包（网页版默认不激活，保留以保证目录完整） |
| `dragonbones-pixi-v7.mjs` | DragonBones 运行时预封包（同上） |
| `网页版使用说明.txt` | 本文件 |

⚠ 请勿单独移动或改名 HTML；要复制网页版，请把整个 `网页版/` 文件夹一起复制。

## 三、网页版能做什么

- 完整的时间轴编排：文案 / 背景 / 图片 / 立绘 / 背景音乐 / 特效音乐 / 配音 / 特效 / 故事线说明九条轨道。
- 分支、变量与好感度、章节归档、鉴赏、成就、存档读档、播放与完整试玩。
- 素材库导入图片 / 音视频 / 字体；序列帧烘焙导出 GIF。
- WebGAL 脚本双向导入导出、章节工程文件（`.galpart`）与文案 TXT 导入导出。
- **导出成品 HTML**：导出的游戏是单文件，编辑器界面在玩家版里全部隐藏，主脚本经过混淆处理
  （删净注释、局部变量改名），源码不易阅读但功能完整；玩家版片尾结束后会回到主菜单按钮界面。
- **播放更顺**：播放头单独浮动、轨道标签与背景填充只在真变化时更新、自动滚动跟随做节流，长时间播放不掉帧。
- **R265 新增功能**：全工程对齐检查，修正音频总线滑条上浮、人物表单输入框文字放不下、人物列表编码框与人名不同行三处对齐问题；清理使用说明里的多余排序符号。R253-R264 的对齐修复、帮助修复、成就卡片、演示二周目 5000 字、音频中心、变量四列、网格动画等能力全部保留；模型导入、ffmpeg 裁剪等本机能力仍仅桌面版提供。

## 四、网页版与桌面版的区别

以下能力依赖本机文件系统 / 原生进程，**仅桌面版 `galgame-editor.exe` 提供**，网页版会自动隐藏入口或给出提示：

- Live2D / Spine / DragonBones 三类模型的导入、预览与导出（网页版顶栏无「🎭 模型」按钮、素材库无「模型」分类）；
  用网页版打开含模型的工程时，模型片段会提示「请使用桌面版」。
- 素材库文件夹镜像同步、视频 ffmpeg 转码、工程与素材落磁盘 / SQLite、自动保存断点恢复。
- 原生多窗口分屏（影子窗口）、桌面导出直接产出 exe、应用内自动更新检查。

## 五、数据保存在哪里（重要）

网页版的工程与素材保存在**当前浏览器的本地存储**里（localStorage / IndexedDB），
换浏览器、换电脑、使用无痕模式或清理站点数据都会导致内容丢失，且不同浏览器之间不共享。

**请养成定期备份的习惯**：用顶栏的「导出工程文件」把工程存成文件，需要时再「导入工程」恢复。
桌面版不受此限制，工程与素材直接落在磁盘目录里。

## 六、教学模板（随包提供）

**一键打开（推荐）**：开始界面左栏「🎓 打开教学模板」，或右侧「🎓 教学模板」固定卡片 → 自动载入教学工程 → 时间轴 ▶ 从头播放。
网页版与桌面版都走同一条链，数据来自同目录的 `tutorial_project_inline.js`（经典脚本加载，不受 `file://` 的 CORS 限制）。

压缩包里的 `教学模板/` 文件夹另含 `教学模板.galproj`（独立工程文件，不写入编辑器内部）与
`教学模板_使用说明.txt`；也可点「＋ 导入工程文件…」选择 `教学模板.galproj` 手动载入。
工程按 29 个归档章节播放功能讲解（每章 5 小节：有哪些按钮 / 按钮做什么 / 怎么进去 / 还可以做什么 / 小提醒，全部用大白话，其中 6 章配内嵌入口示意图），
总时长 778.8 秒，0.8 倍速约 16.2 分钟。它与内置演示模板互不覆盖，不登记最近工程，导出的成品 HTML 也不受影响。

## 七、出问题怎么办

1. 页面空白 / 功能点不动：先确认六个文件齐全且在同一文件夹，然后换 Edge / Chrome 打开。
2. 提示「未找到 demo_project_inline.js」或「未找到 tutorial_project_inline.js」：说明 HTML 被单独拷走了，把对应数据文件补回同目录即可；教学模板也可改用「＋ 导入工程文件…」选 `教学模板.galproj`。
3. 导出成品打不开或报错：换回桌面版导出一次做对照；成品本身不依赖本目录任何文件。
