Skip to content
dsh marketplace

dsh-any-background

Verified

dsh-any-background · v0.2.1 · MIT · Web UI

Appearance plugin for DeepSeek Harness: custom theme color (PS-style color wheel), background wallpaper with opacity/blur controls, and separate main/settings interface opacity.

Install

dsh plugin add dsh-any-background

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-any-background

GitHub stars

English | 中文

一个 DeepSeek Harness 外观插件，让你完全自定义 Web 端的主题色、背景壁纸，以及分部位精细的透明度与模糊度控制。

截图

自定义主页
自定义主页 · 壁纸与主题色同时生效

主题色选择器
主题色选择器 · PS 风格色轮 + 精确 HSL/RGB 输入

分部位透明度与模糊度
分部位透明度与模糊度 · 主背景、侧边栏、卡片、设置面板

背景编辑器
背景编辑器 · 图片/视频壁纸支持拖动平移与滚轮缩放

动态生成背景
动态生成背景 · 网格渐变 / Shader / 几何图案预设

几何背景 低多边形模式
动态生成背景 · 几何 低多边形模式预览

配置导出导入
配置的导出和导入进行分享

功能特性

  • PS 风格色轮 — 在色相环上选取色相，在内嵌方形中调整饱和度与明度，实时生成 30+ 个 CSS 设计令牌。
  • 精确 HSL / RGB 输入 — 通过数值精确输入颜色，与色轮实时双向同步。
  • 智能取色 — 一键从壁纸提取主题色：采样可见区域、量化像素、剔除灰色/近黑/近白，选出现量最大的鲜亮色。视频壁纸自动截帧参与取色。纯客户端完成。
  • 吸管取色 — 在壁纸上悬停预览颜色，点击即可选为主题色。
  • 背景壁纸 — 上传任意图片作为壁纸，在视口比例的编辑器中拖动平移、滚轮缩放。
  • 视频壁纸 — 上传视频作为动态壁纸：静音循环播放、刷新不丢失（落盘持久化 + HTTP 流式播放，支持 Range seek）；自动截取一帧用于预览、主题色提取与位置编辑参考。
  • 位置编辑器 — 图片与视频共用同一套编辑器：拖动平移、滚轮缩放、一键重置；图片与视频的位置状态各自独立保存，互不覆盖。
  • 布局模式 — 适应 / 填充 / 拉伸 / 平铺 / 居中五种排布，图片与视频通用；「适应」模式下编辑器提交的构图在窗口缩放、跨屏移动后保持一致。
  • 动态生成背景 — 支持网格渐变、Shader、几何图案，可调节扩散范围、色彩强度并锁定种子。
  • 分部位界面透明度 — 主背景、侧边栏、卡片面板（含对话框周围的选项框/菜单）、输入框与控件（发送框、Cordis 插件面板）、设置面板与壁纸各自独立滑块。
  • 分部位界面模糊度 — 每个界面部位可独立调整毛玻璃 backdrop-filter 模糊（0–60 px），并通过宿主的稳定选择器为发送框与 Cordis 面板提供真实背景模糊。
  • 对话视图卡片 — 消息列表自动包裹为半透明卡片，轨迹页可整页调节透明度与模糊，让壁纸从内容后方透出来。
  • 主题导出 / 导入 — 一键导出为自包含的 dsh-any-theme.json（配置 + 壁纸，视频以 data URL 内嵌），可随时导入还原。
  • 文件持久化 — 所有设置保存到文件系统 ~/.dsh/.dsh-any-background-data/，不再依赖 localStorage。
  • 中英双语 — 完整的中英文界面，自动跟随语言设置。
  • 主题守护 — 宿主重置主题后自动重新激活自定义主题。

近期优化

  • 视频壁纸全链路 — 视频按 MIME 改名落盘（wallpaper.mp4/webm/...），经插件自建 HTTP 路由流式播放；刷新、重启后自动恢复，导出配置时视频一并内嵌分享。
  • 大视频二进制直传 — 上传改走 HTTP 二进制 POST 流式落盘，不再 base64 绕行 RPC（突破通道 body 上限，任意大小可传），中断自动清理临时文件。
  • 视频位置编辑 — 以截帧为参考图的位置编辑器，支持缩放/移动，与五种布局模式适配；图片与视频构图各自独立持久化。
  • 对话视图卡片化 — 消息列自动上卡片（边框/圆角/内边距），轨迹页整页透明度与模糊可控，视图切换时旧宿主自动还原。
  • 消除启动闪屏 — 主题令牌改为通过独立的 !important 样式表注入，可抵御宿主主题服务的重置。
  • 修复色轮覆盖 — 色相环绘制在饱和度/明度方形之上，方形四角不再遮挡色环。
  • 灵感色板选中重置 — 在色轮中选取主题色后，灵感色板中的之前选中状态自动清除。
  • 移除调试埋点 — 清理了临时的启动日志与 MutationObserver 探针代码。
  • 分部位模糊隔离 — 模糊效果施加在 ::before 伪元素上，避免影响宿主固定定位的设置弹窗。
  • 新增「输入框与控件」部件 — 发送框、斜杠菜单、Cordis 插件面板拥有独立的透明度滑块；半透明表面通过宿主的稳定 data 属性（[data-composer-card]、[data-cordis-panel]）获得真正的毛玻璃背景模糊。
  • 修复原生控件明暗对比 — 实心表面令牌（发送框、菜单、Cordis 面板）现在参与分部位 alpha，并强制 color-scheme 让原生 <select> 弹层保持可读——消除壁纸判暗把标签转白后出现的白底白字。
  • 透明化不反噬自身 — 「输入框与控件」透明度滑块刻意与该面板自己的控件（共享同一批按钮令牌）解绑，调节它不会把插件自身的滑块和按钮也变透明。
  • 拖动性能优化 — 透明度令牌改为写 <html> 上的 CSS 变量（拖动时不再整表重建），滑块更新按 rAF 合帧为每帧一次；「主背景」列仅在自身滑块变化时才重染。
  • 拖动时壁纸降采样 — 拖动任意滑块期间，壁纸临时切换到（~720px）低清副本以降低大图上的合成成本，松手后恢复全分辨率。
  • 导入即播视频壁纸 — 选中的视频立即通过本地对象 URL 开始播放，原始字节在后台流式落盘，下次刷新自动切回持久化服务地址——不再有「上传 + 首帧缓冲」的等待。
  • 选项框跟随卡片滑块 — 对话框周围的下拉菜单、斜杠命令菜单、模型选择器与弹层现在跟随「对话框中选项面板」透明度滑块，而非「输入框与控件」；Cordis 插件面板保持自己的输入滑块绑定。

安装

方式一：npm 安装（推荐）

dsh plugin --profile web add github:Tkingxiao/dsh-any-background
# 若已发布到 registry：
dsh plugin --profile web add dsh-any-background

然后启动：

dsh web

插件会出现在设置面板的 “主题” 分类中。

方式二：npx（无需全局安装）

npx @deepseek-ai/dsh plugin --profile web add github:Tkingxiao/dsh-any-background
npx @deepseek-ai/dsh web

方式三：本地构建（开发）

lib/ 目录已提交，安装后无需构建。修改 src/ 后重新构建：

git clone https://github.com/Tkingxiao/dsh-any-background.git
cd dsh-any-background
pnpm install
pnpm run bundle
pnpm dsh plugin --profile web add "dsh-any-background"
pnpm dsh web

兼容性

  • dsh web — 完全支持。
  • deepseek-harness-desktop — 支持；已知 Electron 打包问题导致左侧边栏与中心区域透明度显示相反，需等待桌面端更新修复。

Star History

Star History Chart

许可

MIT