본문으로 건너뛰기
4

dsh-piano

439436269-ctrl/dsh-piano

A piano keyboard in the DeepSeek Harness UI: click a key to play it, or hold and drag sideways for a glissando across the keys. Notes are synthesized live with Web Audio — no samples, no network, no third-party dependencies — and the volume and starting octave are remembered between sessions.

설치

dsh plugin --profile web add github:439436269-ctrl/dsh-piano

README

dsh-piano · 滑动钢琴

在 DSH 界面里弹一条钢琴键盘:点单个键出声,按住鼠标 / 触控板横向滑动会像刮奏(glissando)一样连续发声。声音用 Web Audio 实时合成,零采样、零网络、零第三方依赖。

效果

  • 左下角一枚 🎹 按钮(默认收起,不打扰正常使用)。按钮可拖动:按住移动超过 6px 即判定为拖(不会误开面板),松手后位置存 localStorage,下次进来仍在原处;400ms 内的 click 才算"点开",拖动不会吞掉下一次真正点击。
  • 点开是底部居中的浮动键盘面板:音量滑块、八度移调(− / +)、收起。
  • 键盘含白键 + 黑键;按住后滑动,指到哪个键就响哪个音(按住拖动 = 刮奏)。
  • 设置(音量、起始八度)持久化到 localStorage,刷新后保留。

技术要点

项做法
挂载槽位shell.overlay(常驻应用面座位)
音频Web Audio 合成:基音 + 泛音(指数衰减)+ 高通噪声锤击瞬态 + 低通 + 压缩器防削波
刮奏指针按下 setPointerCapture → pointermove 用 document.elementFromPoint 命中 data-midi 键 → 键变化即触发新音
客户端形态手写 window.__ModuleLoader__.load 零构建 bundle,platform: web

安装

dsh plugin --profile desktop add dsh-piano

装好后左下角出现 🎹 按钮(包名会进 dsh.profile.bundles,实测热载入,一般不用重启;没生效就刷新页面)。

本包是「双面」的(dsh.bundle.patch + dsh.client):Loader 行拉起空的 Host 半,浏览器半通过 exports["./client"] 到达。

本地开发安装

# 以 file:/link: 目录依赖装进 profile,并加入 bundles(或 cordis insert)
dsh plugin --profile desktop add /path/to/dsh-piano -w
# 或手写:profile/package.json 加 "dsh-piano": "link:...", 并在 dsh.profile.bundles 加 "dsh-piano"

开发

npm test          # node test/bundle-check.mjs —— 断言 bundle 结构与关键 marker

客户端 bundle 用 link: 目录依赖时,改完浏览器刷新即生效;服务端半改动需重启 Host。

说明

  • 首次出声需要一次用户手势(点开按钮或按下琴键即自动解锁 AudioContext)。
  • 浏览器无 AudioContext(极老环境)时静默不发声。

관련 플러그인