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 界面中快速交互和娛樂的方式，適合需要視覺反饋或偶爾放鬆的開發者。
