dsh-wallpaper

DeepSeek Harness 壁纸插件（静态双面包）。为 Harness Web 界面添加可自定义的壁纸背景：渐变预设、自定义图片 URL、多来源随机壁纸（Bing 每日 / Picsum / LoremFlickr）、自动定时更换与设置持久化。

随 DSH 组合自动加载——重启后插件和设置都在，无需手动激活或授权。

功能

• 🎨 8 款渐变预设：点击缩略图即换
• 🔗 自定义图片 URL：输入地址按回车 / 点「应用」
• 🎲 多来源随机壁纸：自动 / Bing 每日 / Picsum 随机图 / LoremFlickr 随机图
  • Bing 走 Host 路由（同源 fetch，无 CORS 问题）；失败自动降级 Picsum
  • Picsum / LoremFlickr 由浏览器直连
• 🌗 变暗滑杆：0–80%，保证文字可读性
• 🔁 自动定时更换：默认每 2 小时，可选 30 分钟 ~ 24 小时；关设置页仍生效；显示「下次自动更换」倒计时；拖变暗不会重置计时
• ⏻ 启停开关：停用时恢复默认背景并暂停自动更换
• 💾 设置持久化：浏览器 localStorage（键 dsh-wallpaper-v1），重启自动恢复

入口：设置 ⚙️ → 壁纸。

要求

• DeepSeek Harness（Web profile，dsh web）
• 浏览器支持 localStorage 与 ES2017（现代浏览器均可）

安装

一键安装（推荐）

powershell -ExecutionPolicy Bypass -File .\install.ps1

脚本会：

1. 复制包到 $DSH_HOME\profiles\node_modules\dsh-wallpaper\
2. 在 $DSH_HOME\profiles\web\cordis.patch.yml 追加组合行（若已是默认 [] 则整体替换）
3. 在 $DSH_HOME\profiles\web\package.json 声明依赖

然后 重启 dsh 即生效。无需任何授权或手动激活。

手动安装

1. 复制 package.json、lib\ 到 $DSH_HOME\profiles\node_modules\dsh-wallpaper\

2. $DSH_HOME\profiles\web\cordis.patch.yml 追加：

   - insert:
       - id: wallpaper
         name: dsh-wallpaper

3. $DSH_HOME\profiles\web\package.json 的 dependencies 增加 "dsh-wallpaper": "0.1.0"

4. 重启 dsh

卸载

powershell -ExecutionPolicy Bypass -File .\uninstall.ps1

删除包目录、移除组合行与依赖声明，然后重启 dsh。

验证（安装并重启后）

• [ ] 设置 → 壁纸 出现「壁纸」分区
• [ ] 默认渐变壁纸立即生效
• [ ] 修改设置后刷新页面 → 设置保留
• [ ] 「随机」三个来源可用（Bing 走 Host 路由 /wallpaper/bing）

实现机制

• 包结构：静态双面包，单行组合（dsh.client 声明 + exports["./client"]）
  • lib/index.js（Host 半部）：注册 webServer 路由 /wallpaper/bing，用 Node 全局 fetch 抓取 Bing 每日壁纸 JSON
  • lib/client.js（浏览器半部）：client-modules 加载器格式（window.__ModuleLoader__.load），工厂内 require("react")（平台 seed 词），导出 { inject: ['slots','theme','timer'], apply }
• 壁纸渲染：动态创建 <style data-plugin-css="dsh-wallpaper"> 写 html, body 背景（渐变/图片 + 暗度叠层，background-attachment: fixed）+ ctx.theme.overrideTokens('dsh-wallpaper', …) 将 --dsw-alias-bg-base / --dsw-specific-sidebar-fill 调半透明，形成毛玻璃透出效果
• 设置页：ctx.slots.inject('settings.section', …) 注册分区（id wallpaper，order 12）
• 自动更换：ctx.timer.interval 插件级定时器 + 签名守卫（拖变暗不重置计时）；倒计时由 30 秒 ticker 驱动
• 持久化：localStorage 每次状态变更即写；激活时 loadSaved() 恢复（带类型校验）

许可

MIT

Copyright (c) 2025 Lueb386-LGTM