前言¶
DeepSeek Harness (dsh) 是一个插件驱动的平台，虽然它提供了核心的智能体开发与调试能力，但默认的 Web 界面视觉风格较为单一。在长时间使用或需要定制工作区时，缺乏原生支持的壁纸主题方案往往需要依赖第三方浏览器扩展或手动修改代码。zoyluoblue/deepseek-harness-avatar 插件解决了这一痛点，它允许用户在设置页面直接上传图片作为 Web UI 背景，并提供可调节的可读性遮罩和模糊效果，以保证界面元素的清晰度。
这是什么¶
这是一个为 DeepSeek Harness (dsh) 提供壁纸主题功能的插件，由用户 zoytown 维护。它允许用户在 Web 界面中上传图片，将其渲染为整个 UI 的背景，并提供可调节的可读性遮罩、背景模糊和填充模式。
核心功能¶
-
图片上传与管理
- 支持在设置页点击或拖拽上传图片（支持 png/jpg/webp/gif 格式，默认单文件限制 20MB）。
- 提供画廊功能，显示所有已上传图片的缩略图。
- 在画廊中点击缩略图即可应用壁纸，悬停可删除。选择 ‘None’ 可恢复默认纯色背景。
-
可读性控制
- 提供“可读性遮罩”滑块：使 UI 元素保持半透明，从而突出背景图片。
- 提供“模糊”滑块：柔化背景图像，减少视觉干扰。
- 支持“填充模式”选择：包括 Fill（填充）、Fit（适应）和 Tile（平铺）。
-
主题自适应与存储
- 遮罩颜色会根据 dsh 的浅色或深色主题自动调整。
- 图片采用内容寻址方式存储在本地目录，不上传任何数据。
安装与启用¶
通过官方命令安装插件：
dsh plugin --profile web add @zoytown/dsh-avatar
安装完成后，打开 dsh Web 界面的 设置 -> 背景 页面即可开始使用。
典型用法¶
- 应用壁纸：在设置页面上传图片，点击缩略图应用。
- 调整显示效果：拖动“可读性遮罩”或“模糊”滑块，或更改填充模式，以改善文字可读性。
- 恢复默认：在画廊中选择 ‘None’，恢复纯色背景。
适用场景与注意¶
- 环境限制：仅支持 dsh 的 Web 界面。Electron 桌面应用不支持此插件。
- 远程访问限制：通过非 Loopback（非本地回环）的远程浏览器访问时，插件仅处于只读模式，无法应用壁纸。
- 隐私安全：所有图片和设置均存储在本地，不上传任何数据到外部服务器。
该插件通过本地化存储和简单的 UI 控制，为 dsh Web 界面提供了轻量级的视觉定制方案。所有文件存储在 ~/.dsh/avatar/ 目录下。
