dsh-galgame · GalGame 模式界面插件

简介

在 DSH Web GUI 的聊天主界面新增一个与「聊天」「轨迹」并列的界面栏——「galgame 模式」。该模式下，DeepSeek 娘（鲸鱼娘）以 GalGame 女主角的形式与你对话：立绘 + 差分接口 + 思考气泡 + 打字机对话框 + 分块阅读 + 提问/审批选项 + 历史回顾 + 调试模式。纯视觉层：不写会话、不干预 agent 循环，随时可切回常规聊天。

能力清单（v1.0.0）

界面预览

配色主题化：跟随 DSH 当前主题/皮肤（默认浅色、默认深色、皮肤 mod 均自动适配）。

> 致谢：本插件的女仆鲸鱼娘立绘素材取自 dsh-deep-whale 皮肤（作者 Small-tailqwq），完整署名链见下方「素材来源与许可」。

形态与架构

• 形态：树外 npm 包（@lanxing/dsh-galgame，link 安装到 web profile）
• 平台：Host（立绘静态资源路由）+ Client（conversation.view 注册 + GalGame UI）
• 架构（详见 DESIGN.md）：

ConversationSnapshot (useSession 只读)
  → GalgameAdapter（纯函数：过滤工具/思维链、按换行分块）
  → 演出状态（分块/打字机/自动模式/翻页）
  → Stage（立绘+气泡+浮层插槽）/ DialogueBox / ChoicePanel / ApprovalPanel / Backlog

• 关键契约：conversation.view keyed slot（id/order/label/inject）、s.pending（question/approval 交互）、ctx.webServer prefix 路由、session.prompt(..., 'steer') 插话引导

使用方式

1. 构建：pnpm install && pnpm build（在 plugins/dsh-galgame/ 目录）。 2. 安装（本地 link）：dsh plugin --profile web add link:H:/Projects/DEEPSE~1/plugins/dsh-galgame；或从 npm：dsh plugin --profile web add @lanxing/dsh-galgame。 3. 重启 DSH Web（dsh web）后刷新浏览器。 4. 用户操作入口：聊天主界面顶部标签栏 →「galgame 模式」。

立绘资源约定

assets/characters/deepseek/
├── portraits/           # 差分图（同画布、同锚点、同基准线，避免切换跳位）
│   └── neutral.webp     # 当前唯一差分（透明底）
└── raw/                 # 原图/素材留档（不参与渲染）

• 补差分：把 smile.webp / thinking.webp / angry.webp 等放入 portraits/，并在 src/client/manifest.ts 的 portraits 表里增加条目（组件全链路已按 portrait ID 解析，接口已预留；表情规则引擎规划中，见 DESIGN.md）。
• 差分切换动画与「说话弹跳」在 src/client/galgame.module.css（ggPortraitFade / ggBounce），prefers-reduced-motion 下自动关闭。

源码与版本

• Client 入口：src/client/index.ts（locale + conversation.view 注册 + steer 发送）
• Host 入口：src/index.ts（/api/dsh-galgame/assets/* 静态路由）

限制与注意事项

• 差分自动情绪分类未做（规划中，见 DESIGN.md 表情方案）：台词当前固定 neutral，差分接口已预留。
• 播放状态只存组件局部：切换会话/视图后从快照重建，不持久化演出位置。
• 立绘为透明底 WebP；原图（白底 JPG）仅留档于 raw/。
• 纯前端渲染 + pending.respond，不发模型请求、不阻塞 agent 循环。
• 选项框/审批框位置已固化为默认值，仅调试模式可拖拽调整。

素材来源与许可

本插件代码（src/、build/）以 MIT 许可发布；立绘素材（assets/）为衍生创作，以 CC BY-NC-SA 4.0（署名-非商业性使用-相同方式共享）发布，禁止任何商业性使用。

立绘素材为衍生创作，署名链（详见 NOTICE）：

1. 一创 上善（Pixiv · Bilibili：上善无形）—— 鲸鱼娘角色形象原作者 2. 二创 zipzip（Pixiv · Bilibili：ZipZipPipe）—— 在其形象上加入 DeepSeek 元素的女仆鲸鱼娘二次设计（生成模型 GPT Image 2） 3. 三创 Small-tailqwq（dsh-deep-whale / maid-atelier）—— 本插件使用的女仆鲸鱼娘立绘素材即来自该皮肤（DeepSeek 元素再设计）

素材源文件在 assets/characters/deepseek/（portraits/neutral.webp 为透明底成品，raw/ 为原图留档）。完整许可文本见 LICENSE 与 NOTICE。

维护位置

• 本项目 plugins/dsh-galgame/

变更日志