跳到主内容

dsh-galgame 使用指南

为 DSH Web 聊天界面新增第三个「galgame 模式」标签，把会话渲染成 GalGame 演出：立绘+打字机+分块翻页+提问选项，纯视觉层不改会话。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-galgame

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @lanxing/dsh-galgame

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 形态：树外 npm 包（@lanxing/dsh-galgame，link 安装到 web profile）
  • 平台：Host（立绘静态资源路由）+ Client（conversation.view 注册 + GalGame UI）
  • 架构（详见 DESIGN.md）：
  • 关键契约：conversation.view keyed slot（id/order/label/inject）、s.pending（question/approval 交互）、ctx.webServer prefix 路由、session.prompt(..., 'steer') 插话引导
  • 补差分：把 smile.webp / thinking.webp / angry.webp 等放入 portraits/，并在 src/client/manifest.ts 的 portraits 表里增加条目（组件全链路已按 portrait ID 解析，接口已预留；表情规则引擎规划中，见 DESIGN.md）。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件装上后界面会立刻变吗？

需要重启 dsh web 并刷新浏览器，然后在聊天主界面顶部标签栏（聊天 / 轨迹右侧）切换到「galgame 模式」才能看到。安装本身不会自动激活任何视图（README.md:53-57）。

切换到 galgame 模式后，agent 行为会被插件改变吗？

不会。插件只读会话快照（useSession），只在用户回复提问/审批时调用 wait.respond；任务执行中的用户输入走 session.prompt(..., 'steer') 引导插话，不会主动发起新模型请求（src/client/GalgameView.tsx:48-53、src/client/index.ts:135-145）。

立绘差分只有一张吗？会自动切表情吗？

当前只有 neutral.webp 一张透明底立绘，差分接口已预留但表情规则引擎未实现（README.md:81-83、DESIGN.md:36、src/client/manifest.ts:24-31）。用户可自行放入 smile.webp 等文件并注册到 manifest。

思考气泡是什么？

模型流式输出思维链时，在立绘旁边弹出的漫画风气泡，会随流式追加自动滚到底，提问/审批/定稿后自动收起。可在设置面板里关闭（src/client/Stage.tsx:54-91、src/client/settings.ts:14）。

提问工具触发的选项框长什么样？

是 GalGame 风格的选择卡（与官方对话 UI 的列表选项不同），支持多选、自定义答案（Shift+Enter 换行）、分多题时的「下一题」流程，以立绘为原点绑定。位置已固化为默认值，仅调试模式可拖拽（src/client/ChoicePanel.tsx:39-41、README.md:17）。

切换会话/视图后，会话演到一半的进度还在吗？

部分保留。播放位置（行号+句号）会写入 localStorage（dsh.galgame.playback），重挂时尝试恢复到上次的 key；演出状态本身仅存组件局部（README.md:82-83、src/client/GalgameView.tsx:117-145）。

立绘素材能商用吗？

不能。assets/ 下的立绘以 CC BY-NC-SA 4.0 发布，明确禁止任何商业性使用，且必须保留「上善 → ZipZipPipe → Small-tailqwq」三创署名链（README.md:88-98、NOTICE）。代码本身是 MIT。

桌面端 / Electron 能用吗？

package.json:21-27 声明 dsh.client.platform = "web"，client 半边只注入 Web GUI；Host 半边的静态资源路由依赖 webServer 服务，理论上不限制宿主平台，但当前未做 Electron 适配声明。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+
  • Node: ^22.19.0 || >=24.0.0
  • Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则

dsh-galgame 使用指南