メインコンテンツへスキップ
L

dsh-appearance

liuecreater/dsh-appearance

A DSH appearance plugin offering wallpaper, glassmorphism, palette theming, and a sidebar usage widget. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

インストール

dsh plugin --profile web add github:liuecreater/dsh-appearance

README

Liue 的大傻鱼背景主题

dsh-lifiwallpaper — 给 DeepSeek Harness 换一张自己的脸:整窗壁纸、卡片玻璃、图片取色,以及侧栏余额与用量。

一个 DSH 外观插件。上传图片或视频作为整个界面的底层背景,拖动裁切、缩放、调模糊;给侧栏按钮、对话内容、输入框和弹窗套上圆角玻璃;从壁纸里自动提取主题色;浅色/深色各自一套样式;设置可导出为带校验的样式包。

icon

截图

壁纸玻璃遮罩圆角卡片
整窗壁纸玻璃遮罩圆角卡片

截图分别展示:整窗壁纸铺底、卡片玻璃遮罩、以及可调圆角。

功能

壁纸

  • 图片(PNG / JPEG / GIF / WebP / AVIF)与视频(MP4 / WebM / OGG),单文件 ≤ 80 MB。
  • 上传、拖放、粘贴都可以;大于 3840px 的图片会先在浏览器里压缩。
  • 预览里直接拖动定位,滚轮或滑块缩放(1–4×),可选「填满 / 适应」。
  • 整体模糊 0–32px,支持高斯(CSS blur)与线性(SVG 横向模糊),只模糊壁纸层。
  • 视频静音循环,Host 端支持 HTTP Range,不会一次性把大文件读进内存。

玻璃

  • 四种卡片质感:无 / 半透明 / 磨砂 / 液态;强度 0–100、圆角 0–28px。
  • 玻璃只加在“卡片”上:侧栏的新对话、插件、工作区按钮,对话区的回答、思考/工具调用过程、输入框、用量条,插件面板与弹窗菜单。其余区域和顶部栏保持透明,直接露出壁纸。
  • 分区开关:侧栏按钮、对话内容、插件面板、弹窗与菜单;AI 回答的玻璃底可单独开关。
  • 输入框上方的对话文字用 mask 渐隐,不铺纯色遮罩;回答的圆角边框不会被渐隐裁掉。

主题色

  • 上传壁纸后自动量化取色,最多 5 个主色。
  • 取色器、HEX、RGB 手动指定;只覆盖 --dsw-alias-brand-primary,由插件生成对应的浅色/深色两版。
  • 浅色与深色主题各自保存主题色与调色板,切换主题时使用对应一套,互不覆盖。

侧栏底部

  • 余额(官方 API Key 优先,失败回退 DeepSeek 账号登录态)。
  • 今日全部 token / 本对话 token,以及按峰谷价估算的费用。
  • 每轮对话结束立即刷新,有页面订阅时每 60 秒刷新;缓存 25 秒。
  • 「重新加载界面」与「退出并重启」说明按钮。
  • 可关闭 token/花费显示,关闭后只剩两个按钮和一张贴合按钮的小玻璃卡。

其他

  • 输入框内容超过视口约 45% 时出现折叠按钮,一键收回 168px。
  • 设置页顶部固定「快速更改 / 上传新样式」两栏。
  • 样式包 ZIP 导出/导入:固定 magic + 整体 SHA-256 + 每张壁纸 SHA-256,全部校验通过才应用。

安装

要求:DSH 0.2.x(含 Web GUI),Node.js 22+。

从本地目录

在 DSH 里打开插件管理,使用 install_bundle,目标指向本 README 所在目录(包含 package.json 的那一层):

<克隆目录>/dsh-lifiwallpaper

安装后在插件列表启用 dsh-lifiwallpaper,刷新页面。

从 GitHub

git clone https://github.com/LiueCreater/dsh-lifiwallpaper.git

然后同样用 install_bundle 指向克隆下来的 dsh-lifiwallpaper 目录。

从 npm

npm 包名:dsh-lifiwallpaper。在插件管理器中安装该包并启用,刷新页面。

使用

  • 入口:设置 → 啥鱼外观(settings.section,order 5),导航图标为自绘相框山景。
  • 侧栏底部:设置按钮上方(sidebar.footer.action)。
  • 设置页里的改动先进入草稿并在预览中显示;点顶部「保存」才写入配置、应用到整个界面。「放弃更改」回到已保存状态。
  • 「快速更改」用于日常调壁纸/玻璃/主题色;「上传新样式」用于导入/导出样式包与重置。
  • 浅/深编辑切换只决定正在编辑哪一套,不会切换当前主题;保存另一套不会影响当前画面。

数据与隐私

存储目录:$DSH_HOME/dsh-appearance/(默认 ~/.dsh/dsh-appearance/)

文件内容
config.jsonv2 配置:profiles.light/dark、ui.showUsage
background-light.bin/.json浅色壁纸与元数据
background-dark.bin/.json深色壁纸与元数据
usage.json按日、按会话的 token 账本(保留 30 天)
  • 所有数据只保存在本机;壁纸不会上传到任何第三方。
  • 余额请求只发往 api.deepseek.com(使用本机 DSH 凭据)或由宿主代为请求账号余额。
  • 写入使用临时文件 + rename;配置损坏时会备份为 .bad-<ts> 并回退默认值。

Host 接口

插件注册同源路由,前缀 /dsh-appearance:

方法路径说明
GET/state?force=1配置、两套壁纸元数据、余额、今日用量
POST/config保存配置(JSON)
GET / POST / DELETE/background?mode=light|dark读取(支持 Range)/ 上传 / 删除壁纸
GET/export.zip导出样式包
POST/import.zip导入样式包(≤ 200 MB,校验通过才应用)
GET/eventsSSE state 事件(25s 心跳)
POST/refresh强制刷新余额
GET/health健康检查

安全约束:

  • Host 必须是 loopback(127.0.0.1 / localhost / [::1]),或在 DSH_APPEARANCE_TRUSTED_HOSTS 中显式列出。
  • 拒绝跨站 Sec-Fetch-Site;带 Origin 时必须与 Host 完全一致。
  • 请求体有大小上限;ZIP 解析拒绝路径穿越、加密条目、ZIP64 与重复条目。

已知限制

  • 窗口最顶部的「应用 / 编辑」是 Electron 原生菜单,渲染层无法改色。
  • 桌面端没有向渲染层开放退出/重启接口,插件只能重新加载页面;彻底重启请用托盘或窗口菜单退出。
  • 第三方插件自己的配置页文本框由其自身样式控制,本插件不去改写。
  • 媒体格式取决于 Chromium 的解码能力;AVIF/HEVC 等在部分平台可能不可播。

开发

npm run check          # node --check 所有入口

手动验证:

  1. 插件管理器里 disable → enable dsh-lifiwallpaper,刷新页面。
  2. 设置 → 啥鱼外观:上传壁纸、调位置/缩放/模糊、切玻璃与主题色、保存。
  3. 检查侧栏底部余额/用量、折叠按钮、过程卡玻璃、全屏右侧栏、菜单层级。
  4. GET /dsh-appearance/health 应返回 {"ok":true}。

更新日志

0.2.5

  • 修正仓库地址为 https://github.com/LiueCreater/dsh-lifiwallpaper(npm 0.2.4 的元数据仍指向旧仓库)。
  • npm 上 0.2.4 已被占用且不可覆盖,改用 0.2.5 重新发布;建议升级。

0.2.4

  • 修复壁纸尺寸缺失:Host 端会解析 PNG/JPEG/GIF/WebP 并回填旧壁纸的宽高,UI 状态也会下发宽高。此前未知尺寸导致缩放始终从左上角放大、拖动跨度为 0(看起来完全拖不动)。
  • 编辑背景位置/缩放只影响预览与草稿,点击保存后才改变整页壁纸(撤销 0.2.3 的实时应用)。
  • 预览拖动改用与主壁纸一致的 background-position 帧,并同时兼容鼠标与指针事件。
  • npm 包名改为 dsh-lifiwallpaper(dsh-appearance 已被他人占用);插件行名随之变更,本地数据目录仍为 $DSH_HOME/dsh-appearance/。

0.2.3

  • 拖动预览时壁纸立即跟随(保存后持久化),修复拖动看似无效的问题。
  • 预览舞台按当前窗口比例显示,不再固定 190px。
  • 「快速更改 / 上传新样式」与保存按钮合并为置顶浮动栏,滚动设置页时始终可见。
  • 对旧壁纸缺少尺寸信息的情况,重新加载时会自动补探测尺寸。

0.2.2

  • 修复背景图拖动定位在某些情况下无效:改为窗口级指针事件驱动,拖动结束后仍可精确落到保存值。
  • 新增「背景不透明度」滑杆(0–100%):100% 为壁纸,0% 显示当前主题的纯色底(浅色白 / 深色黑)。

0.2.1

  • 浅色/深色各自保存主题色与调色板;auto 模式取各自壁纸的调色板首色。
  • 两套壁纸完全解耦:不再跨主题回退,保存非当前主题不影响当前画面。
  • 关闭 Tokens/花费后只保留刷新/退出按钮,玻璃贴合按钮。
  • 输入框折叠改为 168px,并用行内 !important 压过宿主的行内变量。
  • 主题切换时延迟再写 overrideTokens,修复强调色短暂倒置。
  • 样式包导入改为事务式:壁纸与配置任一步失败都会回滚到导入前的状态。

0.2.0

  • 配置升级 v2:profiles.light/dark,旧配置与旧壁纸首次启动自动迁移。
  • 样式包 ZIP 导出/导入,固定 magic + 整体与逐文件 SHA-256 校验;拒绝路径穿越/加密/ZIP64。
  • 设置页改名并加导航图标;顶部「快速更改 / 上传新样式」两栏。
  • 输入框折叠、过程卡玻璃、全屏右栏玻璃、回答圆角边框修复。
  • token/花费显示开关与估算免责提示。

0.1.9

  • 全屏右栏面板补近不透明玻璃;顶部控件恢复宿主定位,菜单保持最高层。
  • 对话渐隐改为逐行 mask。

许可证

MIT © Liue

関連プラグイン