FunctionHookTJU/dsh-custom-wallpaper ↗★ 0
dsh-plugin-custom-wallpaper
DSH 外观定制:主题色 / 背景色 / 壁纸(渐变·URL·本地图片)/ 面板不透明度 / 磨砂玻璃,设置自动持久化。
安装
此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗
说明文档
阅读完整 README ↗dsh-custom-wallpaper
适用于 DeepSeek Harness (DSH) 的动态 Cordis 插件:自定义主题色、壁纸与面板不透明度,支持磨砂玻璃模糊,设置自动持久化。
功能123
- 主题色:自定义强调色(品牌主色)与背景色,自动推导边框、文字、侧栏等派生配色
- 壁纸:4 个渐变预设(无 / 暮色 / 晨曦 / 深海)、任意图片 URL、本地图片(大图自动压缩后写入配置)
- 不透明度:面板 20%–100% 半透明,数值越低壁纸透出越明显;开启壁纸时面板最高 90% 不透明,壁纸始终可见
- 磨砂玻璃:0–30px 模糊强度,作用于壁纸层(
filter: blur+ 轻微放大消除边缘留白),不破坏界面fixed弹层布局 - 持久化:全部设置写入
localStorage(key:dsh.custom-appearance.v1),关闭设置面板或刷新页面后自动恢复 - 入口:设置 → 「外观定制」分区(位于「通用」之后)
安装
方式 A:持久安装到 DSH profile(推荐,重启后仍生效)
插件已按 DSH 持久插件规范打包成本仓库根目录的 npm 包 dsh-plugin-custom-wallpaper:
package.json— 包元数据 +dsh.client.platform: "web"声明 +exports["./client"]lib/index.js— host 半(空实现,仅为让 profile 的 cordis loader 有可导入的插件入口)lib/client.js— 客户端 bundle(window.__ModuleLoader__.load注册工厂,功能与client.js一致)
应用到本机 DSH 的步骤:
- 把包安装进 web profile 的 node_modules:
C:\Users\12252\.dsh\profiles\node_modules\dsh-plugin-custom-wallpaper\(已复制) - 在 profile 的 patch 层注册插件:编辑
C:\Users\12252\.dsh\profiles\web\cordis.patch.yml,在insert列表中追加{ id: custom-wallpaper, name: dsh-plugin-custom-wallpaper }(已完成) - 重启 DSH(
npx @deepseek-ai/dsh web),客户端刷新后插件即生效 - 验证:设置 → 「插件」页应出现
dsh-plugin-custom-wallpaper; 设置 → 「外观定制」分区出现全部控件
以后修改插件:改本仓库 lib/ 下的源码 → 重新复制到 profile 的
node_modules(或 pnpm 重装)→ 重启 DSH。DSH 从 profile 的 node_modules
副本加载,仓库文件只是源码仓库。
方式 B:会话内动态加载(临时,重启失效)
插件亦可作为纯客户端动态包(无 Host 半)。在 DSH 会话中:
- 用
cordis_define新建插件(plugin.kind: "new",idPrefix如theme),把client.js的内容原样作为code.client; - 用
cordis_run激活返回的pluginId/packageId; - 客户端包首次激活需要授权(运行卡片上单击 ✓ 授权当前包,双击 ✓✓ 授权该插件后续所有版本)。
注意:cordis_* 工具只在含 Cordis 工具链的 preset(如「创造模式」)会话中可用。
文件
client.js— 动态包的code.client函数体(纯 JS:无 JSX / TypeScript / import)