DeepSeek Harness 自定义背景壁纸插件

前言¶

DeepSeek Harness 提供了高度可定制性。为聊天界面添加自定义背景壁纸是视觉定制的一部分。该插件允许上传本地图片或使用链接，同时提供透明度和遮罩控制。

简介¶

dsh-background 是一个由 lcohvne-tomorin 维护的插件。它允许自定义 DSH 聊天页面的背景。它支持本地上传、链接和“无背景”模式。设置在重启后持久化。

核心功能¶

• 图片来源：支持三种模式：无背景、本地上传（PNG·JPG·GIF·WebP，≤20MB）、图片链接。
• 图片处理：使用 Canvas 自动等比缩放图片以适应屏幕尺寸。
• 视觉调节：提供透明度（0-100%）和深色遮罩（0-100%）滑杆。
• 作用范围：可在聊天区（默认）和全屏之间切换。
• 持久化：配置和图片保存在 $DSH_HOME/storages/dsh-background/ 中，重启后生效。
• 主题适配：颜色跟随 DeepSeek Harness 主题 token。

安装与启用¶

使用以下命令安装插件：

pnpm dsh plugin --profile web add github:lcohvne-tomorin/dsh-background#84955f4534bf3b2b7d6f300e5d8f72b9ec52a772

安装后，在设置菜单中找到“背景”选项。

使用步骤¶

1. 打开设置 → 背景，勾选启用背景。
2. 选择“本地上传”选图，或切到“图片链接”粘贴地址并点击“下载并应用”。
3. 拖动透明度和深色遮罩滑杆调整效果。
4. 切换“作用范围”为聊天区或全屏。
5. 选择“无背景”或关闭启用以恢复默认。

权限与注意事项¶

• 联网：仅在“图片链接”模式下下载图片（20MB 上限，20s 超时，最多跟随 5 次重定向），有 SSRF 防护。
• 文件操作：配置与图片写入 $DSH_HOME/storages/dsh-background/，卸载时会清除。
• UI 修改：注入样式，全屏模式下侧边栏会变半透明以透出壁纸。
• 隐私：不采集、不上传任何会话或用户数据。
• 依赖：需要 Node.js >= 22，peerDependencies 包含 @deepseek-ai/cordis ^4.0.1 和 react ^18.2.0。

结尾¶

该插件采用 MIT 许可证。源代码托管在 GitHub 上。