前言¶
DSH 的社区生态强调“一切皆插件”。社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；插件本身由社区维护，使用者需要自行判断是否适合当前环境。
dsh-wallpaper 是一个 DSH Web 壁纸插件，用来在 DSH Web 界面更换背景图片，并继续调整壁纸上的模糊、表面不透明度、文字配色、填充与位置等显示效果。它支持主界面与轨迹页分别配置壁纸，也支持无壁纸、内置渐变、上传图片、导入文件夹和裁剪图片。
插件定位¶
dsh-wallpaper 是 RNlao 维护的 DSH Web 壁纸插件，仓库地址为：
https://github.com/RNlao/dsh-wallpaper
当前已核实版本为 v0.1.0，许可证为 MIT。包元数据中声明 peerDependencies: react ^18.2.0。
这个插件解决的是 DSH Web 外观自定义问题：如果你希望主界面和轨迹页使用不同背景，或者希望调整背景上的面板透明度与文字可读性，可以直接在 DSH Web 的设置页中配置，而不是修改 DSH 本身。
核心功能¶
已核实的功能包括：
- 在 DSH Web 界面更换背景图片。
- 主界面 / 轨迹页独立壁纸。
- 边栏自动跟随当前页面壁纸。
- 无壁纸。
- 预设渐变：8 个内置渐变。
- 上传图片 / 导入文件夹 / 裁剪图片进入图片库。
- 裁剪：拖拽框选保留区域并输出新图。
- 模糊 0–50px。
- 表面不透明度 0–1.0。
- 面板半透明。
- 主界面文字颜色：自动 / 浅色 / 深色 / 自定义取色。
- 填充与位置调整：裁切填充 / 完整显示 / 拉伸、水平 / 垂直位置。
- 界面语言：中文 / English。
- 轨迹页配色方案：DSH 原生 / 清澈 / 青玉。
- 图片原始字节存浏览器 IndexedDB。
- 当前选择 + 效果参数存
localStorage。 - 关闭总开关可恢复 DSH 原始外观。
这里的“独立壁纸”指主界面和轨迹页可以分别配置背景。轨迹页还提供 DSH 原生、清澈、青玉三套配色方案。
存储方式¶
dsh-wallpaper 的存储分为两部分：
- 图片原始字节：存放在浏览器 IndexedDB 中。
- 当前选择 + 效果参数：存放在
localStorage中，仅保存元数据，体积很小。
图片不压缩、不 base64，容量不受 localStorage 5MB 限制。
需要注意的是，图片存在浏览器侧。浏览器清除站点数据、清缓存或使用隐私模式时，相关图片数据可能一并被清除；换浏览器使用时也不会自动共享。
安装¶
下面介绍几种安装方式。安装前先确认 web profile 是否已经初始化；如果尚未初始化，先运行一次：
dsh web
插件会以当前 dsh 进程可用权限运行。安装前建议检查源码与许可证。
从 GitHub 安装¶
推荐从 GitHub 安装 v0.1.0：
dsh plugin --profile web add github:RNlao/dsh-wallpaper#v0.1.0
从 Release 安装¶
从 Release 下载 dsh-wallpaper-0.1.0.tgz，然后在本地执行：
dsh plugin --profile web add /path/to/dsh-wallpaper-0.1.0.tgz
这里的 /path/to/dsh-wallpaper-0.1.0.tgz 需要替换为你实际下载到的文件路径。
从源码安装 / link: 开发链接¶
从源码安装时，先 clone 仓库：
git clone https://github.com/RNlao/dsh-wallpaper.git
然后执行：
dsh plugin --profile web add link:./dsh-wallpaper
也可以下载 ZIP，解压后从上一级目录执行：
dsh plugin --profile web add link:./dsh-wallpaper-main
link: 是开发链接，不是持久安装。插件会持续依赖该源码目录；如果目录被移动或删除，插件会失效。
如果修改 lib/client.js，不需要重新 link 或重启服务，DSH client HMR 会自动重载；如果没有立即反映到浏览器，再强刷浏览器。
卸载¶
卸载命令为：
dsh plugin --profile web remove dsh-wallpaper
启用与刷新¶
安装后打开：
设置 → 壁纸 / Wallpaper
如果 dsh web 正在运行，首次安装或卸载后需要重启该进程，并强刷浏览器，使新的 profile bundle 列表生效。
强刷浏览器快捷键：
- macOS：
Cmd+Shift+R - Windows / Linux：
Ctrl+Shift+R
如果 host 或挂载配置发生变化，需要重启 dsh web。本插件为纯浏览器实现，host 半为空插件，无操作系统特定代码。
典型用法¶
下面是一个可复现的使用流程：
1、从 GitHub 安装插件：
dsh plugin --profile web add github:RNlao/dsh-wallpaper#v0.1.0
2、如果 web profile 尚未初始化，先运行：
dsh web
3、打开 DSH Web 界面，进入：
设置 → 壁纸 / Wallpaper
4、选择壁纸来源：
- 无壁纸
- 8 个内置渐变之一
- 上传图片
- 导入文件夹
- 裁剪图片
5、调整显示效果：
- 模糊：0–50px
- 表面不透明度：0–1.0
- 主界面文字颜色：自动 / 浅色 / 深色 / 自定义取色
- 填充与位置：裁切填充 / 完整显示 / 拉伸、水平 / 垂直位置
- 轨迹页配色方案：DSH 原生 / 清澈 / 青玉
6、如果希望恢复 DSH 原始外观，关闭壁纸效果总开关即可。
平台与浏览器注意¶
dsh-wallpaper 跨平台，Windows / macOS / Linux 功能一致。差异主要在路径和浏览器快捷键：
- 数据目录：
- macOS / Linux 默认
~/.dsh - Windows 默认
%USERPROFILE%\.dsh - 安装命令：GitHub、Release 和源码
link:./dsh-wallpaper安装在各平台相同。 - 浏览器强刷：
- macOS：
Cmd+Shift+R - Windows / Linux：
Ctrl+Shift+R
导入文件夹依赖 webkitdirectory：Chrome / Edge / Safari 支持，Firefox 不支持；单张上传不依赖它，因此单张上传在浏览器侧更通用。
半透明面板底色通道取自当前 DSH 的 design-platform.css。如果未来 token 色值调整，透明度观感可能略变；这是外观层面的差异，不改变插件基本功能。
适用场景与注意¶
dsh-wallpaper 适合需要在 DSH Web 中自定义背景、调整面板透明度、配置轨迹页配色方案，或者希望用图片库管理多张壁纸的用户。
使用前需要注意：
- 插件由社区维护，当前版本为
v0.1.0，许可证为MIT。 - 插件会以当前
dsh进程可用权限运行，安装前应检查源码与许可证。 - 图片存储在浏览器 IndexedDB 中，清站点数据或隐私模式可能导致图片丢失。
link:安装依赖源码目录，目录移动或删除后插件失效。- 导入文件夹受浏览器
webkitdirectory支持情况影响，Firefox 不支持。 - 首次安装或卸载后，如果
dsh web正在运行，需要重启进程并强刷浏览器。
相关链接¶
已核实仓库地址：
https://github.com/RNlao/dsh-wallpaper
本文未列出社区目录页地址，因为已核实资料中没有可确认的目录页 URL。
