前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在开发或使用过程中，单一的界面和默认音效可能无法满足个性化需求。如果需要为客户端环境增加视觉背景和音频控制能力，可以使用 dsh-ambience。该插件通过在 localStorage 中持久化设置，实现了界面氛围的本地化定制。
插件定位¶
dsh-ambience 是一个由 Hyna-hla 维护的纯客户端插件，旨在为 DSH 提供自定义的背景图片与背景音乐播放功能。其核心价值在于不干扰前端 UI，同时提供完整的音频处理能力。项目采用 MIT 许可证。
核心功能¶
插件主要包含以下能力：
- 背景图片
支持导入 JPG、PNG 或 WebP 格式。背景图具备淡化效果，包括透明度调节、模糊处理以及呼吸淡化动画。图片层为半透明，不会遮挡前端 UI 内容。 - 背景音乐
支持导入 FLAC、MP3、WAV 或 M4A 格式音频。音量控制范围在 0% 至 200% 之间。播放列表支持循环和随机模式。 - 音频处理
内置 10 段均衡器，支持预设、预放大以及旁路功能。 - 控制面板
右下角设有悬浮条，点击可展开设置面板。
安装与启用¶
该插件需要手动将构建产物放入 DSH 的 profile 目录中，并通过配置文件注册。
-
拷入文件
将构建产物拷入 profile 的node_modules\dsh-ambience目录（或通过file:依赖方式引入）。确保目录结构完整。 -
注册插件
编辑 profile 下的cordis.patch.yml文件，添加如下配置：
- insert:
- id: dsh-ambience
name: dsh-ambience
- 重启加载
重启 DeepSeek Harness 进程。插件会在启动时通过window.__ModuleLoader__.load握手机制加载单文件客户端 bundle。
技术细节与注意事项¶
- 运行机制
这是一个纯客户端插件，Host 仅提供 stub。插件运行在 Web 平台，注入了slots和theme，并立即执行。 - 依赖关系
依赖项包括@deepseek-ai/cordis和react（可选）。 - 配置持久化
用户在面板中的设置会自动保存至localStorage，键名为dsh-ambience:v1。 - 源码审查
在安装前，建议检查源码与许可证。虽然项目使用 MIT 许可证，但作为本地插件，确认其行为符合预期是必要的。
总结¶
dsh-ambience 为 DeepSeek Harness 提供了基础的视觉和听觉环境定制能力。通过合理的背景设置和均衡器调节，可以改善长时间使用的体验。更多细节可参考 GitHub 仓库。
