# gal-view · GAL 视窗

[English](README.en.md) | 中文

DSH Web GUI 会话页的 **Galgame 风格对话视图 + 场景元素可视化编辑器**（官方 bundle 插件格式）。

在会话标签页栏（「对话」/「轨迹」）中间加入 **「GAL视窗」** 标签，点开之后会话视窗变成
16:9 Galgame 舞台：占位立绘、大对话框、打字机台词、玩家输入；内置「编辑模式」可像场景
编辑器一样拖拽/改属性/换图层，编辑结果实时同步回游戏模式。

![image.png](image.png)


## 默认预设

仓库根 [`gal-scene.json`](gal-scene.json) 是随包分发的**默认预设场景**（编辑器导出的格式，内嵌被引用的图片/字体）：首次打开「GAL视窗」且本地没有存档场景时自动加载，编辑模式的「重置」也回到该预设。更新预设：编辑场景 → `Ctrl+S` 导出 → 用导出的 `gal-scene.json` 替换仓库根同名文件 → `npm run build:client` 并提交。


## 安装

本插件以官方 bundle 格式分发，用一条 dsh plugin 命令安装到 web profile，装完**重启 web** 即可生效。

### 前置条件

- 已安装 DeepSeek Harness，并且能在终端执行 dsh 命令
- 如果你是从源码 checkout 运行 Harness（日常命令是 pnpm dsh）：先 cd 到 Harness 仓库根目录，再把下面的 dsh 全部替换为 pnpm dsh

### 从 GitHub 安装（一行命令）

```sh
dsh plugin --profile web add github:Ayase34/gal-view#main
```

#main 表示使用仓库的 main 分支；想锁定某个具体版本，可以换成提交哈希，例如 #ae73dca。

### 完成安装

安装后**重启 web**（bundle 层在启动时合成，必须重启才会加载插件）。重启后打开 Web GUI 的会话页，标签栏应出现 **「GAL视窗」** 标签（位于「对话」和「轨迹」之间）。

> 可选验证：执行 dsh --profile web --dump-config，输出中应能看到 # == gal-view 这一层，说明插件层已进入组合。

### 更新到新版本

```sh
dsh plugin --profile web update gal-view
# 更新后同样要重启 web
```

### 卸载

```sh
dsh plugin --profile web remove gal-view
# 卸载后同样要重启 web
```

> 说明：场景布局、素材图片、字体与阅读进度都保存在你的**浏览器**里（localStorage / IndexedDB），重装或卸载插件不会丢失；清除浏览器站点数据才会重置它们。


## 开发

```sh
pnpm install            # 安装 esbuild devDependency
npm test                # 纯逻辑单测（node:test，同进程运行）
npm run build:client    # 生成 .dsh-plugin/client.js（生成物勿手改）
npm run check:client    # 校验 client.js 新鲜度
npm run smoke           # Playwright 冒烟（需 DSH_CHECKOUT 指向 dsh checkout）
```

## 结构

```
.dsh-plugin/index.mjs     Node half（极简，无宿主行为）
.dsh-plugin/client/       client 源码：场景模型/打字机/转录映射/组件/样式
.dsh-plugin/client.js     构建产物（scripts/build-client.mjs 生成）
scripts/build-client.mjs  esbuild 构建器（--check 守护新鲜度）
tests/                    纯逻辑单测（node:test）
```