前言¶

DeepSeek Harness（DSH）通过插件系统扩展功能。在 Web 工作区中，默认界面是静态的。dsh-plugin-wallpaper 插件解决了这个问题，允许用户从本地上传图像，裁剪它们，并将它们设置为工作区背景。

插件介绍¶

这是 DeepSeek Harness Web 壁纸插件。它允许上传和裁剪本地图像，以设置 Web 工作区桌面的背景。它由 JerryPhoenixCKY 维护，属于“趣味换装”类别，并采用 MIT 许可证。

核心功能¶

• 设置页面：在设置中拥有专门的壁纸页面：预览、上传、替换、移除。
• 裁剪工具：上传后裁剪对话框：拖拽移动，八个调整大小手柄，锁定比例（默认），可选导出模糊。
• 即时应用：无需刷新，刷新后自动恢复。
• 参数调整：可调参数包括适配模式（cover/contain/center/stretch）、面板透明度和遮罩变暗。
• 浏览器处理：在浏览器中裁剪并压缩：WebP 格式，最长边 ≤ 2560px，质量 0.85。
• 持久化：设置保存在 $DSH_HOME/settings.yaml 的 wallpaper 部分。

安装与启用¶

通过 npm 安装插件：

dsh plugin --profile web add dsh-plugin-wallpaper

安装后，重启 dsh web 以加载插件：

dsh web

典型用法¶

1. 打开设置（侧边栏齿轮）-> 壁纸。
2. 点击上传图片并选择本地图片（≤ 20 MB）。
3. 在裁剪对话框中调整区域，然后应用为背景。
4. 调整面板透明度和遮罩变暗。

适用场景与注意¶

• 适用场景：需要个性化 Web 工作区外观的用户。
• 权限限制：上传和编辑需要从本地主机（localhost）打开页面。局域网（LAN）其他机器可以看到背景，但写入操作会被拒绝（写入通道只信任回环）。
• 存储位置：图片保存在 $DSH_HOME/storages/wallpaper/。
• 依赖：依赖 @deepseek-ai/cordis peer dependency。

结语¶

该插件为 DeepSeek Harness Web 工作区提供了一种简单的方法来自定义桌面背景。它平衡了即时视觉反馈和持久化配置。

GitHub
Catalog