前言¶

在使用 DeepSeek Harness 时，界面通常较为单调。dsh-background-swapper 作为一个插件，解决了将个人照片设为 Harness 背景、管理图片库以及精细调整界面透明度和特效的问题。

功能概览¶

该插件由 DevTarlow 维护，采用 MIT 许可证。核心价值在于提供了一套完整的背景管理方案，包括照片上传、库管理、预设效果以及界面透明度的精细调节。

• 设置背景与库管理：支持拖拽上传或选择文件，上传后可重命名或删除。照片以缩略图形式展示在「Recent」中，点击即可切换。
• 预设效果：提供 Wallpaper、Glass、Solid 三种预设，一键调整背景、元素和侧边栏的不透明度平衡。
• 精细调节：通过背景不透明度、元素不透明度、侧边栏不透明度三个滑块控制界面与背景的融合；支持 Tint（色调）和 Blur（模糊）效果。
• 保存自定义外观：调整满意后可点击「Save current」保存当前组合，后续可随时调用。
• 关闭背景：可随时关闭背景显示，界面恢复默认。

安装与启用¶

1. 在 Harness 左侧边栏打开 Plugins。
2. 点击 Install。
3. 粘贴仓库地址：

    https://github.com/DevTarlow/dsh-background-swapper

4. 安装并刷新页面。

如果从本地安装，也可以直接克隆仓库并将文件夹路径填入安装对话框。

典型用法¶

1. 点击左侧边栏设置上方的 Swap Background 打开面板。
2. 在「Add a photo」区域拖入图片或点击「Choose file」，输入名称后点击 Save。
3. 在「Appearance」区域选择预设（如 Glass），然后手动拖动滑块微调。
4. 调整满意后，点击 Save current，输入名称保存该外观。
5. 在「Recent」列表中点击缩略图切换当前照片，或点击 Turn off 清除背景。

数据存储与配置¶

• 存储位置：照片与配置文件存储在 Harness 数据目录下：

    ~/.dsh/storages/background-swapper/
    ├── index.json      (包含名称、当前照片、滑块设置及自定义外观)
    └── images/         (照片文件)

*注意：跨浏览器同步的前提是 Harness 数据目录相同。*

• 配置项：插件读取 cordis.patch.yml 中的以下配置：
  • pageSize: Recent 分页数量（默认 6）。
  • maxImageBytes: 最大上传文件大小（默认 16MB）。
  • maxDimension: 最大图片边长（默认 2560px）。
  • dataDir: 自定义存储目录（默认为空，使用上述路径）。

总结¶

如果你需要在 Harness 中打造个性化的工作台背景，或者需要统一管理多张壁纸并配合不同的界面风格，该插件提供了直接可行的方案。更多细节与源码可在 GitHub 查看：https://github.com/DevTarlow/dsh-background-swapper