dsh-galgame · GalGame 模式界面插件

简介

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

能力清单（v1.0.0）

能力	说明
独立界面栏	注册进 conversation.view（id galgame、order 20），位于「轨迹」右侧，可随时切换
立绘舞台	鲸鱼娘立绘（透明底 WebP）+ 差分切换接口（crossfade 120ms），说话每句弹跳一次（弹跳后保持居中）
思考气泡	流式输出思维链时在立绘旁显示（漫画气泡、可拖拽、自动滚动到底）；提问/审批/定稿后自动收起
隐藏幕后	对话框只显示文本输出，工具调用 / 思维链 / 图片块全部隐藏
分块阅读	按换行分块（表格/列表/代码/引用整块不拆），打字机逐字 + Markdown 渲染，点击/滚轮/◀▶ 翻页
自动模式	模型运行中默认自动推进（约 0.95s/块），点击即接管；滚轮切换跳过打字机
提问/审批	提问工具与权限申请 → GalGame 风格选项框（以立绘为原点绑定、位置固化、多选全量传递、自定义答案支持 Shift+Enter 换行）
用户输入	常驻输入条（随内容扩展）；任务执行中默认「插话引导（steer）」发送；你的输入整段显示在对话框（名字牌「你」）
历史抽屉	右上角「历史」按钮展开完整台词回放（含流式内容）
设置面板	自动翻句 / 打字机速度 / 说话弹跳 / 思考气泡 / 调试模式（各图层彩色边框）
立绘位移	提问/审批弹出时立绘自动右移给选项让位，恢复后回到居中

形态与架构

• 形态：树外 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：。