gal-view README

The project's README from github.com/Ayase34/gal-view. As one markdown file: README.md.

gal-view · GAL 视窗

English | 中文

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

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

image.png

默认预设

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

安装

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

前置条件

从 GitHub 安装(一行命令)

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 这一层,说明插件层已进入组合。

更新到新版本

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

卸载

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

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

开发

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)

gal-view (Ayase34/gal-view)

Searching Database…

这是什么?GAL View 是一个 DeepSeek Harness(dsh)插件,把 Web GUI 的会话页面变成 Galgame 风格的视觉小说界面,带角色立绘、大对话框、打字机式文本和玩家输入框。
这是独立应用,还是 dsh 的插件?它是 DeepSeek Harness 的官方 bundle 格式插件,不是独立应用——它安装到 dsh 的 web profile 里,只改变现有 Web GUI 会话页面的呈现方式。
需要先装好 DeepSeek Harness 吗?需要——你需要已经部署好 DeepSeek Harness,并且终端里有能用的 dsh 命令;如果你是从源码检出运行 Harness,请把每条命令里的 dsh 换成 pnpm dsh。
如果我更新或卸载插件,我的场景编辑会怎样?什么都不会丢:场景布局、图片、字体和阅读进度都保存在浏览器的 localStorage/IndexedDB 里,而不是插件本身,所以重装或卸载都不会清掉它们——只有清除浏览器的站点数据才会。
编辑模式下能做什么?编辑模式让你像在场景编辑器里一样处理场景:拖动和重新摆放元素、修改属性、更换图片图层,改动会实时同步回游戏模式。
我可以自定义默认的 Galgame 场景吗?可以——在内置编辑器里编辑场景,用 Ctrl+S 导出得到更新后的 gal-scene.json,替换仓库根目录下的同名文件,然后运行 npm run build:client 并提交。
GAL View 标签页出现在哪里?它被加到 DSH Web GUI 会话页面的标签栏中,位于现有的对话(Dialogue)和轨迹(Trajectory)标签之间。
怎么确认插件真的加载了?运行 dsh --profile web --dump-config,检查输出里是否包含 “# == gal-view” 层,有就说明插件已组合进你的配置。
Creator
Ayase34
Size
10.4 MB
Stars
205
Updated
CommitAug 16
Age
2mo
Commits · 90 Days