← 返回列表
D

@midnightbell/dsh-wallpaper-theme

v1.0.1 · 1 天前发布

DSH 背景壁纸主题插件：设置页「背景主题」入口，渐变预设/本地图片/剪贴板/图片链接，设置持久化到 DSH_HOME，重启自动恢复。

dshdsh-plugindsh-bundlewallpaperthemebackground

README

@midnightbell/dsh-wallpaper-theme

DSH 背景壁纸主题插件 —— 在 Web 表面（设置页）新增「背景主题」入口：

  • 5 个内置渐变预设（极光 / 暮色 / 深海 / 晨曦 / 暮林）

  • 本地图片（文件选择或剪贴板粘贴）

  • 任意图片 URL

  • 遮罩强度与沉浸模式（侧栏通透）

  • 设置持久化到 $DSH_HOME（.dsh-wallpaper-settings.json + .dsh-wallpaper-bg.b64），重启自动恢复

    • 安装（用户）

    需要 pnpm 和 DSH（dsh 命令在 PATH 上）。

    sh
    1. 安装插件（会自动加入 profile 的 bundle 层，无需手改配置）

    dsh plugin --profile web add @midnightbell/dsh-wallpaper-theme

    2. 重启 DSH（关掉服务/窗口后重新打开）

    升级：

    sh
    dsh plugin --profile web update @midnightbell/dsh-wallpaper-theme

    卸载：

    sh
    dsh plugin --profile web remove @midnightbell/dsh-wallpaper-theme
    非 web 表面（如 headless）不会加载本插件（dsh.client.platform: "web"）。

    原理

  • Host 端（lib/index.js，ESM 默认导出）：注册 /wallpaper-api JSON 接口，读写 $DSH_HOME 下的设置与本地图片文件。

  • Client 端（lib/client.js）：经 `dsh.cli

    • 版本兼容矩阵

    DSH 版本状态说明
    dsh@0.1.0-rc.6 ✅ 兼容 cordis patch ✅
    dsh@0.1.0 ✅ 兼容 标准 patch ✅
    dsh@0.2.0 ⚠️ 待验证 待实测（API 可能在变）
    dsh@0.3.0+ ❓ 未知 尚未发布

    💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

    元数据

    License
    MIT
    npm
    @midnightbell/dsh-wallpaper-theme
    Repo
    —
    Engines
    {}
    Weekly DL
    0
    Monthly DL
    0
    dsh.bundle
    {"client":{"platform":"web"},"bundle":{"patch":"./cordis.patch.yml"}}