dsh-any-background

dsh plugin --profile web add dsh-any-background

dsh-any-background

<p align="center">

<a href="https://www.npmjs.com/package/dsh-any-background"><img alt="npm 版本" src="https://img.shields.io/npm/v/dsh-any-background?color=4d6bfe"></a>

<a href="https://www.npmjs.com/package/dsh-any-background"><img alt="npm 月下载量" src="https://img.shields.io/npm/dm/dsh-any-background?color=4d6bfe"></a>

<a href="https://github.com/Tkingxiao/dsh-any-background/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/npm/l/dsh-any-background?color=4d6bfe"></a>

<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="支持的 DSH 版本：0.2.0-rc.1 ~ 0.2.2-alpha.2 及其上" src="https://img.shields.io/badge/DSH-0.2.0--rc.1%20~%200.2.2--alpha.2%2B-4d6bfe" /></a>

<a href="https://github.com/topics/dsh-better-sidebar"><img alt="插件生态：GitHub topic dsh-better-sidebar" src="https://img.shields.io/badge/%E6%8F%92%E4%BB%B6%E7%94%9F%E6%80%81-topic%20dsh--better--sidebar-4d6bfe" /></a><br /><br />

<a href="https://github.com/Tkingxiao/dsh-any-background"><img src="https://img.shields.io/github/stars/Tkingxiao/dsh-any-background?style=social" alt="GitHub stars"></a>

<a href="https://dsh.directory/plugins/tkingxiao/dsh-any-background"><img src="https://dsh.directory/badges/listed.svg" alt="dsh.directory listed"></a>

</p>

[English](README.md) | 中文

一个 DeepSeek Harness 外观插件：自定义主题色、背景壁纸（图片 / 视频 / 算法生成），以及逐表面的透明度与模糊度控制。兼容 DSH 0.2.0-rc.1 直至 0.2.1-rc.3，其上所有版本一并放行。

---

截图

<table>

<tr>

<td align="center"><img src="example_img/image.png" width="440" alt="自定义主页"><br/><em>自定义主页 · 壁纸与主题色同时生效</em></td>

<td align="center"><img src="example_img/image-2.png" width="440" alt="主题色选择器"><br/><em>主题色选择器 · PS 风格色轮 + HSL/RGB 输入</em></td>

</tr>

<tr>

<td align="center"><img src="example_img/image-3.png" width="440" alt="分部位透明度与模糊度"><br/><em>分部位透明度与模糊度</em></td>

<td align="center"><img src="example_img/image-4.png" width="440" alt="背景编辑器"><br/><em>背景编辑器 · 平移与缩放</em></td>

</tr>

<tr>

<td align="center"><img src="example_img/image-6.png" width="440" alt="动态生成背景"><br/><em>动态生成背景 · 网格渐变 / Shader / 几何</em></td>

<td align="center"><img src="example_img/image-9.png" width="440" alt="几何背景低多边形模式"><br/><em>动态生成背景 · 几何低多边形</em></td>

</tr>

<tr>

<td align="center" colspan="2"><img src="example_img/image-10.png" width="440" alt="配置导出导入"><br/><em>配置的导出与导入，方便分享</em></td>

</tr>

</table>

功能特性

色彩与主题

• PS 风格色轮 — 色环取色相、内嵌方形调饱和度与明度，实时生成 30+ 个 CSS 设计令牌。
• 精确 HSL / RGB 输入 — 数值输入，与色轮双向同步。
• 智能取色 / 吸管取色 — 一键从壁纸提取主题色（采样可见区域、剔除灰色与近黑近白），或在壁纸上悬停取任意一点；视频壁纸自动截帧参与。全程在客户端完成。
• 强制界面明暗 — 亮 / 暗 / 自动。「自动」下表面与字体方向由主题色明度决定（深色 → 浅字，浅色 → 深字），未选主题色时按壁纸亮度判断。
• 主题导出 / 导入 — 一键导出自包含的 dsh-any-theme.json（配置 + 壁纸 + 整个轮换池），随时导入还原。
• 外观预设与档案 — 六套一键预设，外加可重命名、可复制的自定义档案；删除有二次确认。

背景与壁纸

• 图片壁纸 — 上传任意图片作为背景。
• 视频壁纸 — 静音循环播放，刷新不丢失（落盘持久化 + HTTP Range 流式播放），并自动截取一帧用于预览、取色与位置编辑。
• 位置编辑器与布局模式 — 拖动平移、滚轮或双指缩放、一键重置；适应 / 填充 / 拉伸 / 平铺 / 居中，图片与视频的位置各存各的，互不覆盖。
• 动态生成背景 — 网格渐变 / Shader / 几何图案，可调扩散范围与色彩强度、锁定种子。
• 壁纸轮换 — 缩略图选择器组池，按随机或顺序、每次刷新 / 每小时 / 每天 / 每周更换；页面开着也会按时推进。
• 昼夜自动切换 — 指定日间与夜间两套配置，按固定时段或跟随系统深色模式自动切换。

逐表面的透明度与模糊

• 十一个部件各自一对滑块 — 主背景、侧边栏、卡片面板、输入框与控件、设置面板、对话文本框、轨迹页、右方侧边栏（或 bettersidebar）、产出物 / 高亮内容、顶栏浮层、标题栏。
• 滑块就是磨砂量，0 就是没有磨砂 — 会盖掉宿主默认的菜单磨砂；每个部件的默认值仍是 30px，所以全新安装保持宿主的磨砂观感。
• 透明度改的是宿主令牌本身 — 不在原色上再叠一层新色，壁纸从内容后方透出来。
• 产出物 / 高亮内容共用一支滑块 — 代码块（含语言顶栏）、行内 code 芯片与产出物 chip 同步。
• 右方侧边栏 / bettersidebar 同一对滑块两种身份 — 未装 dsh-better-sidebar 时驱动官方右侧栏，装了之后接管它的底部工作台面板（官方侧栏同样生效）。
• 桌面壳（Windows）还管标题条带 — 「侧栏」那对滑块同时驱动侧栏正上方的条带分段，切口随侧栏宽度拖动与折叠跟进（宽度 0 时整条交还「标题栏」）；「标题栏」卡片驱动其余分段与原生按钮区，并提供「标题条带文字」四态（自动 / 跟随主题 / 始终白 / 始终黑）供条带发浅时裁定文字颜色。

界面部件

• 侧边栏「主题」页面（双模式） — 同一套五页（色彩 / 界面 / 字体 / 背景 / 配置）注册到官方右侧栏引导页或 dsh-better-sidebar 的侧栏，与设置面板三处共用一份状态，改一处处处同步；宿主没有该扩展点时静默不注册。
• 对话视图卡片 — 消息列表自动包成半透明卡片，轨迹页可整页调节。
• 顶栏浮层与标题栏各自可调 — Agent Team 面板、后台任务列表、会话头部下拉菜单，以及会话顶部那条标题 / 页签行，都有独立的透明度 + 模糊。
• 自定义字体 — 上传 ttf / otf / woff / woff2（上限 100 MB）应用到整个界面，代码块保持等宽；可随时停用或移除。
• 分组文字描边 — 与界面页同一套分组，每组独立 -webkit-text-stroke（0–4px，0 = 关闭），颜色可自动反色 / 灰 / 黑 / 白 / 主题色 / 自定义；代码块、inline code、图标与宿主的流光文字自动豁免。
• 第三方插件兼容 — 认出 dsh-better-display 时把它那条吸顶总结栏钉在 20% 底板 + 30px 磨砂、不随滑块；其它插件的表面若吃了本插件接管的令牌会在控制台点名，设置页可以整体关掉。

其它

• 文件持久化 — 所有设置落盘在 ~/.dsh/.dsh-any-background-data/，不依赖 localStorage。
• 中英双语界面 — 自动跟随宿主语言设置。
• 主题守护 — 宿主重置主题后自动重新激活自定义主题。

更新日志（只保留最近两个版本）

v0.4.2（兼容 dsh-better-display 的吸顶总结栏 · 修掉 issue #32）

• 总结栏不再被掏空。 它的底板用的是「主界面」透明度接管的那个令牌，被拉到 0 之后正文直接从总结栏底下透上来。现在认出 dsh-better-display 就把这条带子钉在 20% 底板 + 30px 磨砂（不随任何滑块调节，颜色仍跟主题走），并把原来分开的三条合并成一整块，底部两角倒圆。
• 第三方表面自检 + 兼容开关。 开机扫一遍其它插件的样式表，在控制台点名「谁的表面吃了本插件接管的令牌」：已登记的自动保护，未登记的提示把这条日志发过来就能加钉。「界面」页底部新增「第三方插件兼容」卡片，关掉后整张钉表撤下，完全不介入另一个插件的画法。
• 修掉 issue #32。 被磨砂的侧栏列提到 z-index:1，提示条悬出侧栏右缘的那一段重新清晰；模态豁免里 z-index 与 isolation 同进同退。
• 装完或更新后请重启一次宿主——兼容门禁在组装 profile 时才跑。

v0.4.3（跟到 dsh 0.2.1-rc.5 与新开的 0.2.2 线）

• 新增核对的宿主构建：0.2.1-rc.4、0.2.1-rc.5、0.2.2-alpha.2。
• rc.4 / rc.5 不改动任何东西。 把 rc.3 装机目录里 296 个 @deepseek-ai/dsh- 包、5604 个产物文件逐个取哈希：跨到 rc.5 只有 30 个文件变过，且没有一个是本插件读的那张样式表——三处只是内联的版本号字符串，其余是宿主设置页标签的提示条改成按需弹出、以及思考过程正文插槽多传一个 rawText。令牌、[class="…"] 类形状、z-index、data-slot 一个都没动，于是两个构建并入 v0-2-1 的档位，判定从 line 升为 exact。
• 0.2.2 是一条新补丁线，另开 v0-2-2 事实目录。 这一版动静大（1151 个文件改动、1709 个新增），但本插件声称的每一项事实逐条重读后仍然成立：_handle{z-index:11} / _leadingSeat{z-index:15} / _overlayLayer{z-index:20} 逐字节一致（所以侧栏列 z-index:1 的上限和标题行 z-10 的论证照旧），菜单霜的四个令牌与 8 个 --dsw-menu-backdrop-filter 消费者不变，宿主仍在 body 上合成 --dsw-font-family（字体规则的 !important 仍须胜出），5 个会话头部插槽键不变；本插件写到的 75 个宿主选择器全部还能命中。宿主侧的 peer 门禁实现逐字节未变。
• 0.2.2 上两处值得记下的宿主改动：--dsw-specific-sidebar-nav-item-hover 被宿主删掉了（连它唯一的消费者一起），本插件仍会写这个令牌——写了没人读，且宿主自己本来也不再画那个悬停底色，相对宿主默认观感没有退步；ui-plugin-manager 新增一处用「主界面」接管的那个令牌做底板（页面头部一条 `

…(truncated)