dsh-lightweight-wallpaper:给 DeepSeek Harness 的轻量壁纸插件

前言

DeepSeek Harness(DSH)把界面能力拆成可安装的插件;若只想在聊天窗口底层铺一张图、又不希望卡片和代码块变得难读,常见做法是改主题或手写 CSS,维护成本高,换端口或换浏览器后状态也容易丢。下面介绍社区维护者 KHWLGH 发布的 dsh-lightweight-wallpaper:零运行时依赖、无需构建,把壁纸铺在窗口最底层,并单独处理输入区与侧栏的可读性。

这是什么

dsh-lightweight-wallpaper 是 DSH 的 npm 组合包(bundle)插件,分类为「趣味换装」。它把壁纸画在 Harness 最底层,画布与侧栏可透出壁纸;卡片、弹窗与代码块保持实心。上游图片请求由宿主代发并在本地缓存,浏览器不直连第三方接口;断网或上游失败时回放上一次成功的结果。设置、图片与缓存落在 $DSH_HOME/lightweight-wallpaper/,换端口或换浏览器不会丢。许可证为 MIT,当前 npm 版本为 0.1.0。

壁纸来源

插件提供四种来源,可在设置里切换:

  1. 必应每日:最近 16 天,地区可选 zh-CN、en-US、ja-JP、en-GB;每页 8 张,共 2 页。
  2. 维基共享:公共领域与自由许可名画,可搜索画家、作品或流派,或使用 8 个预设(梵高、莫奈、印象派、中国山水、浮世绘、文艺复兴、维米尔、克林姆特)。
  3. 克利夫兰艺术博物馆:仅 share_license_status = CC0 的条目,翻页时显示「共 N 张」。
  4. 本地上传:支持 JPEG / PNG / WebP;超过 6MB 会在浏览器侧压到最长边 2560 再上传。本地壁纸列表最多 20 张,按最近使用排序。

艺术浏览页每页 24 张;换来源、预设或重新搜索会自动回到第 1 页。

显示与可读性

壁纸铺满整窗后,可通过全局参数调节观感:填充方式(铺满 / 适应)、整窗遮罩(默认 62%)、压暗(默认 18%)、壁纸模糊(0–24px)。毛玻璃只加在两处——输入框卡片与侧栏「新会话」按钮——共用浓度与模糊;关闭总开关即恢复实心。壁纸开启时,输入框「+」菜单、模型选择等弹层改为接近实心并加背景模糊。浅色主题下可开启「浅色增强文字对比」,加深次要灰字;深色主题或关闭壁纸时不生效。遮罩颜色跟随系统深浅主题(含「跟随系统」)。

开启「每日自动更换」后,每次启动会取当天必应每日图并缓存到本地。

缓存与数据目录

所有持久化文件在 $DSH_HOME/lightweight-wallpaper/,例如 state.json(当前壁纸与参数)、history.json(本地壁纸列表)、assets/(已下载图片)、thumbs/(列表缩略图,7 天 TTL)、各来源的列表缓存 JSON。设置 → 壁纸 → 数据 可查看占用并分别或全部清理;清理始终保留当前壁纸与全部设置。应用过的图片写入 assets/,断网仍可显示;上游失败时有兜底列表与条目。

安装与启用

插件装进某个 DSH profile 后,配置层与前端组件一并生效。首次安装或启用后需完整重启一次 Harness;之后仅改插件代码时可走开发免重启流程(见仓库 README)。

桌面版 profile 为 desktop,Web / CLI 通常为 web。无全局 dsh 时用 npx @deepseek-ai/dsh 代替。

推荐从 npm 安装:

dsh plugin --profile desktop add dsh-lightweight-wallpaper

固定或升级版本:

dsh plugin --profile desktop add dsh-lightweight-wallpaper@0.1.0
dsh plugin --profile desktop add dsh-lightweight-wallpaper@latest

也可从 GitHub 或本地路径安装(与 npm 装完行为一致,细节见官方 README):

dsh plugin --profile desktop add github:KHWLGH/dsh-lightweight-wallpaper

桌面版可在侧栏 插件 → 添加插件,粘贴包名 dsh-lightweight-wallpaper 或仓库地址后安装,需要时再 立即启用。

卸载:

dsh plugin --profile desktop remove dsh-lightweight-wallpaper

npm 包为纯 ESM 源码,无安装期脚本,不需要 pnpm 的 allowBuilds 构建授权。

典型用法

  1. 完成安装并重启 Harness。
  2. 打开 设置 → 壁纸。
  3. 打开顶部总开关,在 选择壁纸 中进入「本地壁纸 / 必应每日 / 艺术馆藏 / 上传」任一标签,点缩略图即应用;参数在 显示 与 数据 两组中调整,均自动保存。

显示效果区域底部提供 自检 与 恢复推荐值;自检结果写入 selfcheck.json,排查「壁纸看不到 / 白边 / 毛玻璃未生效」时可对照 README 中的检查项。

适用场景与注意

适合希望在 DSH 桌面或 Web 界面长期使用壁纸、又需要控制正文与弹层可读性的用户。必应图仅限微软声明的壁纸用途;维基与克利夫兰条目在缩略图与设置页顶部保留作者与许可信息。

插件与当前 DSH 进程同权限运行,安装前应自行查看 GitHub 源码 与 MIT 许可证。DSH 社区插件目录为独立站点,与 DeepSeek / 幻方无官方从属关系。

已知限制包括:Windows 原生标题栏约 40px 无法被页面 CSS 覆盖;毛玻璃依赖官方 CSS-module 类名后缀,DSH 大版本改类名后可能需要更新选择器;设置面板固定 800px 宽,插件设置页为单列布局。

链接

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜