前言¶
DeepSeek Harness（DSH）采用插件化架构，其默认界面以实用为主。对于需要更沉浸式视觉体验的开发者或用户而言，单一的纯色或默认背景往往不够。dsh-wallpaper 插件通过本地化资源支持，允许用户将本地图片和视频设置为 DSH 应用窗口的背景，同时保留操作界面的可读性。
该插件由社区开发者 deepseaandhighsky-arch 维护，目前处于预发布候选版本（v0.3.0-rc.7）阶段。
核心功能¶
本地媒体支持¶
插件支持多种本地静态和动态格式：
* 图片：PNG、JPG、WebP。
* 视频：H.264 编码的 MP4 和 WebM 格式。
独立设置与控制¶
- 设置分类：在 DSH 的设置菜单中，新增了独立的“壁纸背景”分类。
- 分区不透明度控制：提供四个独立的滑块，分别控制“聊天正文”、“左侧栏”、“顶部导航”和“输入框”的底色不透明度。调节互不干扰，不会影响文字本身的显示，也不会降低整张壁纸的可见度。
- 双模糊调节：
- 壁纸自身模糊：对背景图片/视频画面本身应用模糊。
- 面板磨砂强度：对 UI 面板（侧栏、导航等）应用磨砂效果，使文字在背景上更清晰。
- 侧栏视觉修复：启用壁纸时，自动移除侧栏底部的白色渐隐遮罩和硬截断线，优化滚动体验。
可恢复性与对比¶
- 一键恢复：关闭插件时自动撤销样式变更。
- A/B 对比：在调整滑块或应用预设时，插件会自动记录修改前的状态。用户可以实时预览“修改前”与“当前”的效果，并通过“一键恢复”功能回到基准状态。
- 外观预设：提供“阅读”、“均衡”、“沉浸”及自定义预设，一键应用多组参数配置。
本地隐私¶
- 所有壁纸文件存储在浏览器的 IndexedDB 中。
- 外观偏好和自定义预设存储在 localStorage 中。
- 数据仅保存在本地客户端，不上传至远端。
安装与启用¶
当前版本为预发布候选版（v0.3.0-rc.7），安装方式如下：
方式一：通过 CLI 安装¶
在终端中执行以下命令：
dsh plugin add github:deepseaandhighsky-arch/DSH-Wallpaper#v0.3.0-rc.7
方式二：通过 UI 界面安装¶
- 打开 DSH 应用。
- 进入 插件 -> 添加插件。
- 输入安装地址：
github:deepseaandhighsky-arch/DSH-Wallpaper#v0.3.0-rc.7。 - 或者选择本地的
.tgz文件进行安装。
典型用法¶
- 导入媒体：通过插件设置界面导入本地图片或视频文件。
- 调整参数：拖动“分区不透明度”滑块，调整聊天区域与侧栏的底色深浅。
- 应用预设：选择“沉浸”或“均衡”预设，或手动调整模糊与磨砂强度以获得最佳阅读体验。
- 对比验证：在调整过程中，利用 A/B 对比功能查看效果差异。
适用场景与注意¶
- 版本状态：目前仅为 v0.3.0-rc.7 预览候选版，官方 Desktop 端的视觉验收仍在进行中，部分功能可能存在适配问题。
- 技术限制：官方 DSH 暂未提供
shell.background插槽，该插件通过shell.overlay+ Portal 实现，若 DSH 调整布局，部分区域可能需要重新适配。 - 视频播放：视频播放依赖 Chrome/Electron 的解码能力以及 IndexedDB 的存储配额。
- 隐私声明：该插件为非官方第三方插件，与 DeepSeek 无隶属或认可关系。
总结¶
dsh-wallpaper 为 DSH 用户提供了灵活的本地化视觉定制能力。通过独立控制不透明度、磨砂强度以及提供完善的对比与恢复机制，它在不改变系统壁纸的前提下，显著提升了应用窗口的个性化程度。
