HarmlessFunny/dsh-background-by-model 预览 preview

HarmlessFunny/dsh-background-by-model

Plugin插件 Native原生 ⭐ 3 MIT UI & Themes界面与主题

DeepSeek Harness 背景随当前模型而切换

Project Overview项目介绍

dsh-background-by-model is an appearance plugin built specifically for DeepSeek Harness, distributed as a DSH bundle with the npm package name dsh-background-by-model and a bundle-manifest on the GitHub repository. Its core abstraction is an ordered list of "model rules," where each rule owns its own wallpapers, layout mode, background opacity, background blur, and per-image framing plus theme color (wheel / HSL / RGB / extract-from-image / pick-from-image). Installation goes through npm (npm i dsh-background-by-model), and the v0.3.0 release is a hard break that removed video wallpapers, generated dynamic backgrounds, and the single global theme color, with the new per-image color field replacing them.

On every model change, the plugin reads the current session's modelSelection projection — the same value the composer's model picker renders — and scans the rule list top-down, applying the first rule whose match string appears anywhere inside the concatenation of provider, model id, and model display name (case-insensitive). Rule 1 doubles as the fallback and is also used whenever no rule matches, including for sessions where only the host-wide default is available, in which case the UI labels the result "host default." A live readout at the top of the Model Background tab shows the currently detected model and which rule was hit, so users can verify a rule without leaving the page, and a dedicated Kimi example in the README demonstrates how an absent rule silently falls back to rule 1, which can look like "nothing happened."

The intended user wants a different wallpaper and palette per model: they add rules named for deepseek, flash, glm, kimi, drag to reorder, and drop images onto each rule's filmstrip, optionally overriding the theme color per image. Holiday palettes are forced on every read, rotation steps share one funnel so both the timer and the manual Next-image button re-emit the palette, and the version check is a plain >= — a host announcing schema 3 holds every write and the panel tells the user to restart DSH. License is MIT; runtime dependency is Node, and example artwork is credited to Bilibili user ZipZipPipe.

dsh-background-by-model 是一款专为 DeepSeek Harness 打造的外观插件,名称与打包方式均带 dsh- 前缀,并以 bundle-manifest 作为分发形态。它以"模型规则有序列表"为核心,每条规则绑定一张或多张壁纸、布局模式、背景透明度与模糊度,并允许每张图片独立配置取景框与主题色。安装通过 npm 拉取(npm i dsh-background-by-model),并在 v0.3.0 引入不兼容变更:移除了视频壁纸、动态生成背景以及单一全局主题色,旧版配置文件中的图片 color 键也由此被纳入迁移路径。

插件会在每次会话切换模型时,读取当前会话的 modelSelection 投影(即编辑器模型选择器所显示的值),然后自上而下扫描规则列表,把第一条匹配字符串命中模型名的规则应用到界面上;列表第一条同时充当兜底,未命中时强制使用该规则。匹配字符串会与 provider、模型 id、模型显示名三者的拼接结果进行大小写不敏感的子串比对,因此一个名为 deepseek 的规则可以同时覆盖多种 DeepSeek 变体。Model Background 标签页顶部会实时回显当前命中情况,例如 "Current model deepseek-flash → matched · Rule 1",便于用户在原地验证规则是否生效;当只能读到宿主全局默认模型时,会标记为 host default。

典型用户希望每个模型都拥有自己专属的壁纸与配色,依次新建 deepseek、flash、glm 等规则并拖动排序即可。v0.3.0 引入 schema 4,旧版宿主无法读取新增的 images[].color 字段,插件会在面板中拦截写入并提示用户重启 DSH。项目以 MIT 协议开源,依赖 Node 环境(check:node、check:repaint 用作门禁),示例壁纸素材由 Bilibili 用户 ZipZipPipe 提供。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-background-by-model

把 HarmlessFunny/dsh-background-by-model 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-background-by-model

GitHub stars npm version

English | 中文

Forked from Tkingxiao/dsh-any-background and renamed to dsh-background-by-model.

A DeepSeek Harness appearance plugin built around an ordered list of model rules. Each rule carries its own wallpaper, theme color, layout mode, framing, opacity and blur — switch the model, and the background switches with it, through the global switch effect you choose on the Config page.

v0.3.0 is a breaking release. Video wallpapers, generated dynamic backgrounds and the single global theme color were removed. See the v0.3.0 entry in CHANGELOG.md.


How Model Rules Work

A rule is a match string plus one complete set of background settings. When you switch models, the plugin reads the current session's model name, scans the list top-down, and applies the first rule whose match string appears anywhere in that model name (case-insensitive). If nothing matches, rule 1 is used — rule 1 doubles as the fallback.

Example list:

# Match string Wallpaper
1 deepseek Image A
2 flash Image B
3 glm Image C
Current model Result Why
DeepSeek-Flash Rule 1 → Image A deepseek matches first
GLM-Flash Rule 2 → Image B flash is earlier in the list than glm
Qwen-Flash Rule 2 → Image B flash matches
GLM-Turbo Rule 3 → Image C only glm matches
Kimi-K3 Fallback → Rule 1 → Image A no rule matches

Notes:

  • Order matters. The first match wins, not the best match — drag rules to reorder them.
  • An empty match string makes a rule skip matching entirely and act purely as a fallback. A single rule with an empty match string is therefore "one wallpaper everywhere".
  • The match string is compared against the concatenation of provider, model id and model display name, so any of the three can be used to select a rule.
  • The current model is read from this session's durable model selection (the modelSelection projection — the same value the composer's model picker renders), so switching the model inside a session takes effect immediately. The Model Background page shows which model was read, and labels it host default when only the host-wide default was available instead of this session's own selection.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-edit-turn 下一个 Next dsh-desktop-launcher2 →