Ayase34/gal-view 预览 preview

Ayase34/gal-view

把dsh会话界面切换成galgame游戏界面的插件

项目介绍Project Overview

gal-view 是 DSH Web GUI 的 bundle 插件,在会话页「对话」与「轨迹」之间新增「GAL视窗」标签。核心能力是把会话渲染为 16:9 Galgame 舞台(立绘占位、大对话框、打字机台词),并提供场景编辑器模式,支持拖拽、属性修改与图层调整,编辑结果实时同步。适用于希望以视觉小说形式定制对话界面的用户。安装或更新后必须重启 web profile 才会生效,且场景与素材均存储在浏览器本地。

gal-view is a DSH Web GUI bundle plugin that inserts a "GAL View" tab between the "Chat" and "Trajectory" tabs of a session page. Its core capability is rendering sessions as a 16:9 galgame stage with character stand placeholders, large dialog boxes, and typewriter-style lines, plus a built-in scene editor for drag-and-drop placement, property changes, and layer reordering with live sync. Use it when you want a visual-novel-style chat interface. The web profile must be restarted after install or update, and all scenes and assets live in the browser.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

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

Ayase34/gal-view 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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 即可生效。

前置条件

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

从 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)
上一个 Prev A-share-Ai 下一个 Next dsh-noema