dsh-whale-bongo

dsh-whale-bongo

QQ 弹弹的类 bongo 手手挂件

v0.3.4 · dsh-bongo-fish 的独立重置版本

DSH Web Bundle No Build MIT Code

> 是 dsh-bongo-fish 的独立重置版本；参考其注入方式与交互思路。

> 不是官方分支，也不代表原作者发布。

目录

• [版本选择](#版本选择)
• [这是什么](#这是什么)
• [亮点](#亮点)
• [安装](#安装)
• [设置](#设置)
• [音乐律动模式](#音乐律动模式)
• [桌面模式](#桌面模式)
• [与 dsh-bongo-fish 共存](#与-dsh-bongo-fish-共存)
• [卸载与数据清理](#卸载与数据清理)
• [常见问题](#常见问题)
• [项目结构](#项目结构)
• [来源与版权](#来源与版权)
• [素材与许可](#素材与许可)
• [致谢](#致谢)

---

版本选择

两款挂件面向不同的使用偏好，可以按自己的习惯选择：

原版 dsh-bongo-fish

本版 dsh-whale-bongo

适合的需求

正常手/萌圆手两套配置、图片和音效上传、提醒拍手

双手按键反馈、图片 Q 弹、打字角度、手部几何/颜色/轮廓

安装

前往原版仓库

安装本版

同时安装

可以；两个挂件并存，拖开即可

主要区别：

• 手部：原版有正常手/萌圆手两套配置；本版为双手按键的手手，支持手部几何、颜色和轮廓粗细调节。
• 按压手感：原版正常手瞬切下沉、萌圆手下压回弹；本版手手按压后回弹，并提供鼠标按压行为选项。
• 原版敲击抖动：原版敲击键盘时插件有抖动反馈。

---

这是什么

dsh-whale-bongo 是一个 QQ 弹弹的类 bongo 手手挂件，是 [dsh-bongo-fish](https://github.com/YUsaltyfish/dsh-bongo-fish) 的重置版本。

原版 [dsh-bongo-fish](https://github.com/YUsaltyfish/dsh-bongo-fish) 是一个 bongo cat 风格的 DSH 打字挂件，强调跟随敲击节奏互动的原味手感。本版参考它的注入方式与交互思路，重新实现了双手动作、图片回弹和设置系统，采用偏 Q 弹、手部按压表现明显的方向。

它浮在 DSH 输入框旁：

• 默认磁吸在输入框右上方；
• 每敲一下键盘，手手随之按下；
• 支持自定义图片、手手颜色、音效、挂件大小；
• 支持水平自动翻转；
• 透明区域点击/拖动直接穿透到 DSH。

本仓库不是原项目的官方分支，也不代表原作者发布。

一句话：原版偏原味节奏，本版偏 Q 弹、手部表现和可调角度；按习惯选择，也可以两个都装。

---

亮点

| | |

|:--|:--|

| 双手按键反馈 | 两只手随敲键按下。 |

| 鼠标点击按压 | 点击角色图片区域，双手按下、图片压扁；按住保持，松开回弹。 |

| 同键同手 | 同一按键保持同一只手，不同按键交替左右手。 |

| 图片 Q 弹 | 以图片底边为锚点压扁回弹，强度 0–10；回弹时不裁左右，投影完整。 |

| 打字角度 | 随机角度和真实键位两套方向系统，真实键位支持左右手分管；默认真实键位（左右分管）。 |

| 透明穿透 | 按图片 alpha 生成 SVG clip-path，只有角色本体接收鼠标，透明区域直接穿透。 |

| 自由磁吸 | 吸附输入框上/下边线段、上沿中心点，或页面视口边线；中心点会记忆并在布局变化时跟随，拖动时显示吸附圆点。 |

| 水平翻转 | 客户端自动按输入框 45%/55% 迟滞判断；桌面模式只在窗口吸附时按被吸附窗口 45%/55% 翻转，自由放置保持当前朝向；另有自定义分割线、始终不翻转、始终翻转；带弹性过渡。 |

| 菜单安全区 | 菜单不会进入 DSH 标题栏，关闭按钮始终可点。 |

| 自定义音效 | 支持上传本地音频替换默认敲击音，可恢复默认；音效保存在浏览器本地。 |

| 面板同步吸附 | 提问、授权、计划确认面板出现时，按输入框的吸附方式贴到当前面板上；面板关闭后回到输入框。 |

| 目标栏优先吸附 | 当前目标状态栏出现时，按任务栏 > 目标栏 > 排队框的顺序优先吸附。 |

| 排队框优先吸附 | 对话排队消息框出现时，优先吸附排队框；任务栏的优先级高于排队框。 |

| 任务栏优先吸附 | 输入框上方出现「任务 N 已完成」任务条时，优先吸附任务条，而不是隔着它吸输入框。 |

| 出现动效 | 首次挂载时从底部中心轻微上浮、放大并回弹到正常尺寸。 |

| 布局平滑过渡 | 任务栏展开/收起、提问/授权面板出现/消失时，挂件以底部中心为锚点，通过克制的弹簧位移和明显的身体拉伸/落地挤压平滑移动，幅度随「Q 弹程度」变化。 |

| 热启用 / 热关闭 | 在插件列表启用或关闭时即时挂载/移除，不需要重启 DSH。 |

| 无构建依赖 | 纯 DSH bundle，不需要 npm install，不需要前端 build。 |

---

安装

从 GitHub Release 安装

1. 打开 [GitHub Releases](https://github.com/MeteorNOX/dsh-whale-bongo/releases)；

2. 下载最新 Release 中的 dsh-whale-bongo-0.3.4-package.zip 或 dsh-whale-bongo-0.3.4.tgz；

3. 在 DSH「插件 → 添加插件 → 安装本地 bundle」中选择解压后的目录，或选择 .tgz；

4. 在插件列表启用；正常情况下挂件会即时出现。若 Host 路由尚未加载，刷新一次页面即可。