Tkingxiao/dsh-any-background

dsh-any-background

一个 DeepSeek Harness 外观插件：自定义主题色、背景壁纸（图片 / 视频 / 算法动态生成），以及逐表面的透明度与模糊度控制。当前版本面向 DSH 0.1.5-rc.2。

截图

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

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

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

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

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

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

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

功能特性

- PS 风格色轮 — 在色相环上选取色相，在内嵌方形中调整饱和度与明度，实时生成 30+ 个 CSS 设计令牌。
- 精确 HSL / RGB 输入 — 通过数值精确输入颜色，与色轮实时双向同步。
- 智能取色 — 一键从壁纸提取主题色：采样可见区域、量化像素、剔除灰色/近黑/近白，选出现量最大的鲜亮色。视频壁纸自动截帧参与取色。纯客户端完成。
- 吸管取色 — 在壁纸上悬停预览颜色，点击即可选为主题色。
- 背景壁纸 — 上传任意图片作为壁纸，在视口比例的编辑器中拖动平移、滚轮缩放（触屏上单指拖动、双指捏合缩放）。
- 视频壁纸 — 上传视频作为动态壁纸：静音循环播放、刷新不丢失（落盘持久化 + HTTP 流式播放，支持 Range seek）；自动截取一帧用于预览、主题色提取与位置编辑参考。
- 位置编辑器 — 图片与视频共用同一套编辑器：拖动平移、滚轮或双指缩放、一键重置；图片与视频的位置状态各自独立保存，互不覆盖。
- 布局模式 — 适应 / 填充 / 拉伸 / 平铺 / 居中五种排布，图片与视频通用；「适应」模式下编辑器提交的构图在窗口缩放、跨屏移动后保持一致。
- 动态生成背景 — 支持网格渐变、Shader、几何图案，可调节扩散范围、色彩强度并锁定种子。
- 分部位界面透明度 — 主背景、侧边栏、卡片面板（含对话框周围的选项框/菜单）、输入框与控件（发送框、Cordis 插件面板）、设置面板、对话文本框、轨迹页、better-sidebar 工作台、产出物/高亮内容各自独立滑块。
- 分部位界面模糊度 — 每个界面部位可独立调整毛玻璃 backdrop-filter 模糊（0–60 px），并通过宿主的稳定选择器为发送框、Cordis 面板与弹出层提供真实背景模糊。
- 产出物 / 高亮内容 — 对话正文里的代码块（含语言顶栏）、行内 code 高亮芯片与产出物 chip 共用一支滑块：透明度只调制这些表面原本的背景色（不会在旧背景上再叠一层新色），模糊度给同一层表面加磨砂，壁纸从内容后方透出来。
- better-sidebar 工作台 — 安装 dsh-better-sidebar 时出现独立滑块（panelOpacity / blurs.panel），接管其底部工作台面板与原生右侧栏的表面令牌；未安装该插件时该行不显示，滑块无副作用。
- 侧边栏「主题」页面 — 安装 dsh-better-sidebar 后，它的侧边栏会多出一张「主题」卡片：点开是与设置面板完全相同的五页（色彩 / 界面 / 字体 / 背景 / 配置），外壳按侧边栏重做——全高、页面自带滚动区、导航收成一行紧凑标签（不放侧边，省下 150px 给内容）。排版随面板宽度自适应：卡片网格按可用宽度自动排成 2 / 3 / 4 列（约 430px 起两列），面板窄时才收紧内边距与标题字号并回到单列；类型卡片同理。两处共用同一套页面代码与同一份状态，改一处两边同步；未安装 better-sidebar 时静默不注册，不影响任何其它功能。
- 对话视图卡片 — 消息列表自动包裹为半透明卡片，轨迹页可整页调节透明度与模糊，让壁纸从内容后方透出来。
- 主题导出 / 导入 — 一键导出为自包含的 dsh-any-theme.json（配置 + 壁纸，视频以 data URL 内嵌），可随时导入还原。
- 外观预设与配置档案 — 六套一键预设（默认 / 毛玻璃 / 极简白 / 暗夜紫 / 赛博 / 暖阳），外加自定义命名档案：随时保存当前观感、随时套回，删除有二次确认保护。
- 壁纸轮换 — 把多张图片加入轮换池（缩略图选择器），按随机或顺序、每次刷新 / 每天 / 每周的频率自动更换；切换时服务端把所选图片复制进当前壁纸槽，导出/导入与取色管线完全不用改。
- 昼夜自动切换 — 指定日间与夜间两套配置，按固定时段或跟随系统深色模式自动切换。
- 自定义字体 — 上传一个 ttf / otf / woff / woff2 字体文件（上限 100 MB），通过 @font-face 应用到整个界面的文字；可随时停用或移除。字体按原始字节流式上传并持久化到插件数据目录，代码块仍保持等宽字体。
- 分组文字描边 — 沿用界面页那九个「透明度 / 模糊」分组，为每个分组单独加 -webkit-text-stroke 描边：粗细 0–4 px（0 = 关闭），颜色支持自动反色 / 灰 / 黑 / 白 / 主题色 / 自定义。代码块、inline code 与图标自动豁免，多色语法不会糊成一团。
- 强制界面明暗 — 无论主题色明暗如何，都能强制生成亮色/暗色整套令牌；「自动」下配色与字体方向由主题色明度驱动（深色 → 浅字，浅色 → 深字），未选主题色时按壁纸画面亮度判断。
- 文件持久化 — 所有设置保存到文件系统 ~/.dsh/.dsh-any-background-data/，不再依赖 localStorage。
- 中英双语 — 完整的中英文界面，自动跟随语言设置。
- 主题守护 — 宿主重置主题后自动重新激活自定义主题。

更新日志（最新两个版本）

v0.2.10（最后一版0.15 rc2更新）

- 侧边栏「主题」页：安装 dsh-better-sidebar 后，侧边栏会多出一张「主题」卡片，点开就是和设置面板一样的五页（色彩 / 界面 / 字体 / 背景 / 配置）。两边共用同一套页面和同一份状态，在哪边改都会同步。外壳按面板宽度自适应，卡片网格能排几列就排几列（面板 430px 左右起两列，更宽三列、四列），窄了才收紧内边距、回到单列。
- 设置面板适配手机宽度：内容列窄到一定程度后，标题、卡片内边距、色球和色轮卡都会收紧；各处卡片网格加了防溢出的最小宽度，背景类型卡片在窄屏改成按宽度自动排两列，不再挤成一条。
- 面板崩溃时直接把出错堆栈显示在兜底页里，不用再开开发者工具查原因。
- 修复部分环境下面板直接报错 getSnapshot is not a function：装着的 dsh-client-store 是旧版，defineStore() 返回的是声明而不是实例，代码把它当实例用就炸了，连带把状态同步整个关掉（设置面板会一直显示默认值）。现在启动时归一化成单个共享实例，两处读同一份状态；以后形状再变也只是告警并跳过侧边栏页。
- 修复手机上背景编辑器的拖动、捏合完全无效：监听器挂在 Portal 里的节点上，首帧拿不到节点，effect 依赖又是恒定的，所以永远不会再跑。现在弹窗节点改用 state 持有，出现即绑定；触摸监听同时从预览卡片挪到全屏遮罩，两指落在遮罩上不会再缩放整个页面；在预览图外松手也不会误关编辑器。
- 修复拖滑块时拇指弹回旧位置：同步 effect 的依赖里有内联箭头函数，任何父级重渲染都会把值写回上次提交的结果。现在格式化函数走 ref，只有数值真的变了才会动滑块。
- 修复套预设 / 导入主题后「界面」「字体」页滑块停在旧值：这两页此前没有订阅 store，现在跟随 metaRev（背景页的布局选项跟随 bgRev）。
- 修复配置文件被误判为损坏、整套设置静默丢失：之前文件被占用或权限失败也会把好文件改名归档，下次启动就按首次运行写入默认值。现在只有 JSON 解析失败才归档，读取失败只用默认值，不动磁盘上的文件。
- 修复上传超限毫无提示：服务端返回 413 但客户端从不读响应体。现在视频 / 壁纸 / 字体三个入口都会提示「文件过大，上限 100 MB」，超限视频也不会再「能播但不保存」。
- 修复夜间自动切换在缺少 matchMedia 的环境抛错，并因此反复中断启动恢复。
- 正常聊天时每个流式 token 都会触发一遍完整的模糊 / 透明度应用（观察器的短路条件在真实宿主上恒为假）。现在按帧合并，值和目标都没变就整帧跳过。
- 其它：配置写入改成原子写（tmp + rename，失败清理临时文件），解析结果按 mtime/size 缓存；修了一批泄漏和竞态（拖动中关面板遗留监听、动态背景旧帧覆盖新画面、轮换写回覆盖防抖保存、禁用后样式残留等）。
v0.2.9

- 修复：初次安装时透明度与模糊度滑块「要手动拖一次才生效」 —— 根因不是默认值，而是应用链路有两道门槛：① applyCustomTokensNow() 遇到没有调色板的情况直接 return，而没选主题色且没强制明暗时 paletteTokens() 正是返回 null，于是四个透明度滑块的 alpha 变量从头到尾没被写过；② applyWp() 外面还有一层 rHasColor() || rBgDark() !== null || ... 的门，初次安装全部落空，连 apply 都没调用。现在透明度无条件应用，没有自有调色板时回落去读宿主已解析的表面 token（readHostOpacityTokens()，与工作台面板 opacity 的宿主回落同源）——滑块只提供 alpha，配色仍由宿主皮肤决定。
- 默认值改为中档 —— 各分组透明度默认 0.5、模糊默认 30px（滑块量程 0–60px 的一半），初次安装即可看到滑块生效，不再是「看起来没反应」。只影响首次安装：已有 theme-config.json 的用户不受任何影响。壁纸本身的透明度（wallpaperOpacity）保持 100%，否则首次上传的壁纸会被直接压暗一半。服务端 DEFAULT_CONFIG 同步更新——两侧不同步正是 v0.2.8 静默丢字段的原因。
- 首次安装即落盘并强制重读一次 —— read RPC 检测到 theme-config.json 不存在时立刻把默认值写盘并返回 firstRun；客户端收到后 persistConfig() 写入浏览器侧的完整默认集，再 loadPersisted() 重读一次并 applyWp()，确保界面是从磁盘上真实存在的配置渲染出来的。
- 手机端背景位置调整适配 —— 背景编辑器此前只认鼠标，触屏设备上壁纸既拖不动也缩放不了。现在单指拖动画面、双指捏合缩放，且捏合起手时手指下方的画面会始终钉在手指上——所以「双指一边拖动一边缩放」由同一条关系式自然得出，不需要额外分支。触摸事件以 passive: false 原生挂载是有意为之：React 在根节点注册的 touchmove 是被动的，preventDefault() 在那里形同空操作，页面会在弹窗背后跟着滚动、浏览器还会把整个视口一起缩放；容器同时声明 touch-action: none，从声明式一侧兜住同样的行为。双指抬起其中一指时会以仍按住的那根手指重新建立平移基准，画面不会再按原偏移量弹回去。
- 新增「字体」设置页 — 设置面板在「界面」之后多出一页，收纳两组新能力：自定义字体与分组文字描边。
- 自定义字体 — 上传 ttf / otf / woff / woff2 文件应用到整个界面。文件以原始字节 POST 到 /dsh-any-background/font/upload（不走 RPC base64，上限 100 MB），服务端按魔数嗅探真实容器格式并据此命名落盘，再由 /dsh-any-background/font 提供 @font-face 源；宿主的基础字体令牌 --dsw-font-family 被收敛为 'DAnyFont', ，代码块等宽字体不受影响。支持停用（保留文件）与移除（删除文件），上传失败会回滚到原有字体。字体文件与壁纸一样是本机资源，不进配置档案与导出包。
- 分组文字描边 — 九个界面分组各自独立的描边粗细（0–4 px，0.5 步进，0 = 关闭）与颜色；颜色存的是预设键而非解析后的色值：「自动」按字体明暗取反色（浅字配深描边），「主题色」跟随当前主色，二者都会随主题自动重算。代码块、行内 code、图标与 placeholder 显式豁免，多色语法着色不会糊。
- 已知取舍 — -webkit-text-stroke 在部分单行省略号容器边缘可能有 1px 级裁切；多行容器正常。

安装

方式一：npm 安装（推荐）

已发布到 npm registry
dsh plugin --profile web add dsh-any-background

或直接安装 GitHub 仓库
dsh plugin --profile web add github:Tkingxiao/dsh-any-background

然后启动：

dsh web

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

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

npx @deepseek-ai/dsh plugin --profile web add 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 0.1.5-rc.2 — 当前版本只面向 0.1.5-rc.2（已在该版本上验证）；package.json 的 engines.dsh 与 dsh.compatibility.dshReleases 也只声明这一项。
- DSHA — DeepSeek Harness 安卓启动器（免 ROOT、免 Termux）。其包内 dsh 同为 0.1.5-rc.2，即本插件的目标版本，故兼容；移动端界面由 dsh-web-mobile 提供。
- deepseek-harness-desktop — 支持

Star History

Star History Chart

许可

MIT