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?Это официальный плагин в формате bundle для DeepSeek Harness, а не отдельное приложение — он устанавливается в web-профиль dsh и меняет только отрисовку уже существующей страницы сессии 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