前言¶
DSH 的插件化理念意味着外观扩展可以以插件形式接入。对于需要在 DeepSeek Harness 中维护主题、壁纸素材和预设配置的开发者来说，常见问题是：预设、封面、聊天背景、设置卡、侧栏海报分散在不同位置，手工调整不容易复用。
下面介绍一个 DSH 第三方插件：wallpaper-plugin。它提供预设墙、壁纸素材库、图层合成壁纸和分享导入导出，安装后设置页会出现「外观预设」入口。
这是什么¶
wallpaper-plugin 的定位是“DSH 壁纸插件：预设/主题管理 + 壁纸素材库”。
- 仓库：
https://github.com/Ayase34/wallpaper-plugin - 许可证：
MIT - 适用对象：需要在 DSH 中管理多套外观预设、壁纸素材，并把配置分享给其他使用者的开发者
资料中未确认最终插件展示名称、星标数、分类和目录页 URL，因此本文不把它们作为确定信息。
核心功能¶
预设墙¶
安装后，设置页会出现「外观预设」入口。预设墙支持卡片一键切换、封面展示和 diff 告警。
工作室中还提供深度编辑能力，包括：
- 原始令牌
- CSS 补丁
- 主题注册
- 素材部件
壁纸素材库¶
壁纸素材库支持上传图片，限制如下：
- 单个图片不超过
20MB - 素材库上限
100个
上传后的素材可以分配给三个部件：
16:9聊天背景1:1设置卡1:5侧栏海报
素材会按固定比例裁剪，并支持明暗分别配置和不透明度配置。
图层合成壁纸¶
图层合成壁纸支持以下场景：
- 多张小图拼贴合成
- 多个
GIF按时间轴合成，输出真动图 - 单个动图场景自动分层输出
AI 协同¶
插件提供 12 个 preset_* / asset_* 工具，用于对话式换肤，包括：
- 创建
- 应用
- 微调
- 自纠
分享与还原¶
分享能力使用 zip 三件套导出：
- 预设
- 封面
- 全部素材内嵌
导入时可以完整还原，包括分层规格。
安装与启用¶
先使用已核实的安装命令：
dsh plugin --profile <name> add github:Ayase34/wallpaper-plugin
这里的 <name> 是要安装到的 DSH profile 名称。安装完成后，从设置页进入「外观预设」即可应用出厂预设。
可选目录配置¶
如果需要自定义目录，可以在 profile 的 cordis.patch.yml 中写入：
- id: wallpaper-plugin
config:
presetsDir: C:/你的预设目录 # 可选；默认 <dshHome>/.ui-presets
assetsDir: C:/你的壁纸库目录 # 可选；默认 <presetsDir>/assets
presetsDir 用于指定预设目录，assetsDir 用于指定壁纸库目录。
不配置时，默认路径为：
<dshHome>/.ui-presets
<presetsDir>/assets
典型用法¶
应用出厂预设¶
1、进入设置页。
2、打开「外观预设」。
3、选择一个出厂预设并应用。
上传并启用聊天背景¶
1、进入工作室「素材与部件」区。
2、上传图片；单个文件不超过 20MB，素材库最多 100 个。
3、点「设为聊天背景」。
4、系统自动按 16:9 裁剪并启用。
导出与导入¶
1、选择「导出 ZIP」。
2、把生成的 ZIP 发给其他使用者。
3、对方在工作室或预设墙中「导入」。
4、导入后还原预设、封面和全部内嵌素材，包括分层规格。
开发与测试注意¶
如果要从源码构建或运行测试，资料中给出以下约束：
DSH_CHECKOUT必须显式指向deepseek-harnesscheckout。- e2e 必填环境变量：
UIP_PLAYWRIGHT_DIR、UIP_CHROMIUM。 - 测试使用独立 spike profile 和端口
3180，不触碰正式 profile。 - Node 引擎要求：
>=20.11。 package.json标记private: true。
这些约束主要面向源码构建和测试环境。普通安装与使用主要依赖前面的安装命令、设置页入口和工作室入口。
适用场景与注意¶
适合的场景：
- 在 DSH 中维护多套主题预设，并快速切换。
- 统一管理聊天背景、设置卡、侧栏海报等壁纸素材。
- 用多张小图或
GIF合成壁纸。 - 通过
preset_*/asset_*工具进行创建、应用、微调、自纠。 - 把预设、封面、素材打包成 ZIP 分享给他人。
注意事项：
- 该插件以当前
dsh进程权限运行，安装前应检查源码和MIT许可证。 - 壁纸库有数量与单文件限制：单个图片不超过
20MB，库内素材最多100个。 - 资料中未确认星标数、分类、维护者身份和目录页 URL，因此本文不展开。
- 资料将其描述为 DSH 第三方插件，不应把它写成 DeepSeek / 幻方官方应用商店。
结尾¶
wallpaper-plugin 把 DSH 外观调整中的预设、封面、壁纸素材和分享流程放在同一个插件里，适合需要复用外观配置和壁纸素材的开发者。
已核实的 GitHub 地址：
https://github.com/Ayase34/wallpaper-plugin
目录页 URL 未在已核实资料中确认，本文不列出。
