DSH 支持插件扩展，dsh-piano 是其中一种插件，它在界面中添加了一个钢琴键盘。它使用 Web Audio API 实时合成声音，无需外部采样或网络请求。
这是什么¶
dsh-piano 是一个由 439436269-ctrl 维护的插件，类别为“趣味换装”。它提供一个交互式钢琴键盘，支持点击单个键或按住滑动（刮奏）发声。
核心功能¶
- 浮动键盘面板：默认底部居中显示，包含音量滑块和八度移调按钮（− / +）。
- 白键与黑键：完整的键盘布局，支持点击与按住拖动。
- 刮奏：按住鼠标或触控板横向滑动，经过哪个键即响哪个音。
- 可拖动按钮：左下角的 🎹 开启按钮可拖动，位置会保存到
localStorage。 - 本地持久化：音量和八度设置会保存，刷新后保留。
安装¶
使用官方安装命令将插件添加到桌面配置文件：
dsh plugin --profile desktop add dsh-piano
安装后，左下角会出现 🎹 按钮。插件支持热载入，一般无需重启；若未生效，刷新页面通常即可。
典型用法¶
- 开启面板：点击左下角的 🎹 按钮。
- 单键演奏：点击单个键发出对应音高。
- 刮奏：按住鼠标或触控板横向滑动，实现连续滑奏效果。
- 调整参数：通过音量滑块和八度移调按钮调整声音。
技术与注意事项¶
- 零依赖：声音由 Web Audio 实时合成，不依赖任何采样文件或第三方库。
- 用户手势：浏览器要求首次出声需要一次用户手势（点击按钮或按键）。若浏览器不支持
AudioContext，则静默不发声。 - 兼容性：插件与 DSH >=0.2.0-rc.1 兼容，Node >=22。
结语¶
dsh-piano 提供了一种在 DSH 界面中快速交互和娱乐的方式，适合需要视觉反馈或偶尔放松的开发者。
