NS2 界面音效 2486809961-alt/dsh-ui-sound-ns2

dsh-ui-sound-ns2

给 DeepSeek Harness Web GUI 用的 Nintendo Switch 2 系统 UI 音效插件：点哪里响哪里，每类交互都对应 NS2 系统里语义相同的那一声。

- 全局点击层：在捕获阶段监听 pointerdown，任意控件（按钮、菜单项、标签、链接、开关、滑块、输入框、展开/收起……）被点击时播放对应 NS2 音效；点非控件区域也能发声（可关）。
- 音量：默认 100%，输出链上再带 1.25× 增益与限幅器（DynamicsCompressorNode），短促的点击音更清楚又不破音。
- 任务音：任务开始 / 完成 / 失败 / 待处理提醒，接当前会话的运行状态与待处理交互。
- 设置页：每个情景可单独挑音色、单独试听、单独开关；音量、键盘音可独立配置。
- 推理等级滑条：拖动/点选 dsh-codex-effort-slider 的档位时，每一档都响一声 NS2 滑条音（slider-up / slider-down），拖得越快音高越高。
- 一键静音：聊天输入框下方有「静音 / 取消静音」小芯片，点一下静音整层 NS2 音效；任意位置按 ⌘/Ctrl+Shift+M 也能切换，静音状态与设置页的「启用音效」是同一个开关。
- 偏好持久化在 $DSH_HOME/ui-sound-ns2/config.json，清站点数据不会丢。

情景 → 默认音效

| 情景 | 触发 | 默认 NS2 音效 |
| click.normal | 普通点击 / 列表项 | nav-tick（导航轻点） |
| click.primary | 主要按钮 / 确认 | confirm（确认） |
| click.toggle-on | 开关 · 打开 | toggle-on |
| click.toggle-off | 开关 · 关闭 | toggle-off |
| click.tab | 标签切换 | bumper |
| click.menu | 菜单项 / 下拉 | nav-tick |
| click.select | 选中项 / 模型选择（menuitemradio、列表项） | confirm |
| click.settings | 侧栏头像 / 账户菜单里的「设置」 | modal-open |
| click.send | 发送 | confirm |
| click.close | 关闭 / 取消 | slide-close |
| click.danger | 删除 / 危险操作 | error |
| click.link | 链接 / 详情 | detail-open |
| click.back | 返回 | detail-close |
| click.field | 输入框聚焦 | typing |
| click.slider-up | 滑块调高 | slider-up |
| click.slider-down | 滑块调低 | slider-down |
| click.expand | 展开 | slide-open |
| click.collapse | 收起 | slide-close |
| task.start | 任务开始 | launch |
| task.success | 任务完成 | achievement |
| task.failure | 任务失败 | error |
| task.pending | 待处理提醒 | mention |

另外提供 31 个可换的 cue：nav-tick confirm bumper toggle-on toggle-off scroll transition slide-open slide-close modal-open modal-close detail-open detail-close message mention chatroom friend friend-game toast toast-short volume slider-up slider-down typing recording-start recording-stop recording-highlight camera launch achievement error。

结构

- lib/index.js：宿主半。在 webServer 上注册
- GET/POST /ui-sound-ns2/api/settings：持久化偏好；
- GET /ui-sound-ns2/api/status：状态；
- GET /ui-sound-ns2/audio/<cue>.wav：loopback-only 音效文件（immutable 缓存）。
- lib/client.js：浏览器半。Web Audio 引擎 + 全局点击/键盘监听 + 任务状态监听 + 设置页。
- assets/：31 个 NS2 音效（16-bit mono 44.1 kHz WAV，已去首尾静音、归一化）。
- cordis.patch.yml：插入一行名为 dsh-ui-sound-ns2 的 Loader 行。
- scripts/fetch-assets.sh + scripts/make_assets.py：从上游下载源音效并重建 assets/（见下节）。

仓库与音效素材

插件代码以 MIT 许可发布；assets/ 下的 31 个 NS2 音效（16-bit mono 44.1 kHz WAV）已入库，克隆后开箱可用。这些音频不属于 MIT 许可，版权归 Nintendo，仅作本机个人试听 / 交互用途，详见 NOTICE。

如需从上游重建音效（例如自己替换素材），运行：

bash scripts/fetch-assets.sh
脚本会把源文件下载到 .asset-sources/（已 gitignore，只是本地构建缓存），用 macOS 自带的 /usr/bin/afconvert 转成 mono 44.1 kHz，再由 scripts/make_assets.py 去首尾静音、加淡入淡出、RMS 归一化到 -20 dBFS（峰值上限 -1 dBFS），产出 31 个 WAV 与 MANIFEST.json。

安装

git clone https://github.com/2486809961-alt/dsh-ui-sound-ns2.git
cd dsh-ui-sound-ns2
以本目录为 bundle 安装到当前 profile
dsh plugin --profile desktop add "$PWD"
或在本会话里用 plugin_manager install_bundle

安装后新开 / 刷新 Web 页面即可；设置 → 「NS2 音效」。

版权与来源

- 插件代码：MIT。
- 音效素材：Nintendo Switch 2 系统 UI 原始音效，版权归 Nintendo。素材取自 Mipaichik/Nintendo-Switch-2-UI-Steam-Deck-Sound-Pack （该仓库亦声明版权归 Nintendo）。assets/ 内的 WAV 不在 MIT 许可范围内，随仓库提供只为让本机试用开箱即用；请勿将其用于商业用途或再分发，如需公开分发衍生作品请先用自己拥有授权的音效替换 assets/。
- 情景模型与任务状态监听思路移植自 MIT 许可的 dsh-ui-sound（Copyright © 2026 林冠宇 SOH4C4759）与更上游的 dsh-plugin-uisfx；音频引擎、NS2 素材映射、全局点击分类与设置页为本插件重写。详见 NOTICE。