前言¶
在 DeepSeek Harness（DSH）里长时间跑 Web UI 或写代码时，很多人会开浏览器标签或本地播放器放环境音。那些方式要么和 DSH 无关、切场景要手动找文件，要么自带一堆预制清单，和你实际有的音频对不上。下面介绍社区插件 @weibaohui/dsh-ambient：它把「场景」交给音频根目录下的文件夹结构决定，可选让宿主在后台起 agent 从 Wikimedia Commons 按许可分门别类下载，并在 Web 里用迷你播放器控制播放与定时关闭。
这是什么¶
@weibaohui/dsh-ambient 由维护者 weibaohui 发布，在 SkillHub 插件目录 归类为「趣味换装」。定位是 DSH Web 侧白噪音播放器：插件包内不含音频文件；宿主侧对流式读取本地库（支持 HTTP Range），不上传、不分发音频。许可与来源记录在库内的 INDEX.md / ATTRIBUTION.txt。
当前 npm 版本为 0.1.2（MIT），engines.dsh 声明最低 @deepseek-ai/dsh >=0.1.7-rc.2；README 版本表记录 0.1.0 在 0.2.0-rc.2 真机验证。
核心功能¶
场景纯目录驱动¶
libraryRoot 下每个子文件夹即一个场景，文件夹名即场景名。无预制场景清单、无别名匹配：建文件夹即建场景，删文件夹即删场景。配置里的 scene 若指向已删文件夹，库加载时会回退到第一个场景并写回配置。
默认音频根目录为 ~/.dsh/dsh-ambient/library/（以设置页为准）。
后台 AI 下载¶
在设置页点「执行下载」后，宿主通过 apiproxy 创建带 bash 的主对话级 agent 会话，无人值守执行下载指令：先读 INDEX.md 跳过已有 URL，再搜 Wikimedia Commons API（免 key），许可优先 PD/CC0 > CC BY > CC BY-SA，下载到对应场景文件夹并更新 INDEX.md / ATTRIBUTION.txt，完成后自动重扫库。按钮下方可看到实时进度；单并发，任务进行中再点会显示当前进度；完成或 30 分钟超时收尾。
播放与控制¶
- 四种播放模式（
playMode）：顺序循环、随机、单曲循环、间歇（放 20 分钟停 5 分钟）。 - 跨场景播放（
crossScene）：勾选后上一首/下一首与循环在全库场景间进行；不勾则仅在当前选中场景内。 - 收藏与只播收藏：心形按钮收藏当前轨（键为
场景id/文件名）；勾选「只播收藏」时播放池为收藏轨，池为空时自动回退全库。 - 播放池优先级：只播收藏 > 跨场景 > 当前场景；池选项变化时尽量保住当前轨无缝续播。
- 智能音量：起播/切歌/恢复从 0 淡入约 3 秒；暂停、切歌、定时关等边界有交叉或长淡出，主体音量保持设定值。
- 定时关（
sleepHours/sleepAtTime）：播放 N 小时后停（可选关、30 分钟、1/2/4/8 小时），或到指定时刻 HH:MM 停（跨天处理）；到点约 4 秒长淡出。 - 迷你播放器：右下角浮窗，可拖动（位置记忆）、可收缩成小圆球，支持场景切换、竖向音量、收藏；信息行显示当前场景与文件名。
- 流式播放：客户端只按 scene + track 下标请求；宿主做路径安全校验，防目录穿越。
安装与启用¶
安装命令以 README 为准：
dsh plugin --profile web add @weibaohui/dsh-ambient -w
装完后重启 dsh web 即生效。插件以当前 dsh 进程权限运行，安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，并确认本机 Node 满足 >=22.5。
典型用法¶
- 打开 Web UI → 设置页 → 白噪音，点「执行下载」，等待后台 AI 建场景文件夹并从 Wikimedia Commons 下载；也可自行在音频根目录的子文件夹中放入音频，再点「扫描」。
- 在场景下拉中选择一个，勾选启用或点迷你播放器 ▶ 开始播放。
- 播放模式、定时关、跨场景、只播收藏等在设置页调整；日常切歌、音量、收藏用右下角迷你播放器。
- 需要新场景时：新建文件夹并放入音频（名称自定），或再次执行 AI 下载。
适用场景与注意¶
适合已在用 DSH Web、希望在同一界面里听环境音、且接受「库完全本地、场景由文件夹决定」的开发者。若不想用 AI 下载，只维护本地文件夹即可。
注意：AI 下载依赖宿主 apiproxy 与会话能力，需网络访问 Wikimedia Commons；下载任务有超时与单并发限制。音频版权以各文件对应的 ATTRIBUTION.txt 与 Commons 许可为准，勿将下载内容当作插件作者重新分发。
DSH 生态理念是「一切皆插件」；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。
