前言¶
在 DeepSeek Harness（DSH）的使用中，界面外观通常由默认设置或手动设置固定。如果需要根据当前会话的模型切换背景，dsh-background-by-model 提供了一种基于规则的自动化方案。
基本介绍¶
该插件是一个外观类插件，属于“趣味换装”类别，由开发者 HarmlessFunny 维护。它通过维护一个有序的模型规则列表，在切换模型时自动应用对应的背景设置。插件的核心价值在于将背景的切换逻辑与模型选择绑定，实现了界面风格的动态跟随。
功能详解¶
模型规则匹配¶
插件基于规则列表工作，列表中的每条规则包含一个匹配字符串和一组完整的背景设置。系统会按顺序扫描当前会话的模型名称（合并 provider、model id 和 display name），找到第一个匹配的规则（不区分大小写）。如果没有匹配项，则使用第一条规则作为默认背景。
规则与图片配置¶
- 规则独立配置：每条规则可以独立设置图片的透明度、亮度和模糊度。
- 图片独立设置：规则下的每张图片可以拥有独立的布局模式、边框和主题色。
- 数据存储：所有配置数据存储在磁盘（
~/.dsh/.dsh-background-by-model-data/），而非浏览器 localStorage。
轮播与切换效果¶
- 图片轮播：每条规则内的图片支持轮播，可自定义时长（5秒至24小时）和顺序（顺序播放或随机）。注意：轮播功能默认关闭，仅在当前激活规则下生效。
- 全局切换效果：支持四种全局切换效果：淡入（默认）、瞬间、缩放和滑动。可设置动画时长，支持标准、线性、ease-out 等缓动函数。
节日背景¶
提供中秋和国庆的节日背景切换功能。节日背景默认关闭，支持农历日期判断（基于 Asia/Shanghai 时区）。节日壁纸需联网下载，不支持自定义替换。
规则管理¶
支持规则的导入与导出，便于配置的保存和迁移。
安装与启用¶
通过 DeepSeek Harness 的插件目录进行安装：
# 在 DSH 环境中通过目录链接安装
# 目录地址：https://www.skillhub.cn/plugins/HarmlessFunny/dsh-background-by-model
启用后，插件会自动监听模型切换事件并应用相应的背景设置。
使用示例¶
- 定义匹配规则：在配置页添加规则，设置匹配字符串（例如 “deepseek”），并上传对应的背景图片。
- 调整视觉效果：为每张图片设置独立的布局、边框和主题色，或在规则级别调整透明度、亮度和模糊。
- 配置轮播：在规则编辑器中开启轮播功能，设置图片切换时长和顺序。
- 设置全局效果：在配置页选择全局切换效果（如淡入或缩放）和动画时长。
- 启用节日背景：在配置页开启节日背景功能（推荐配置），插件会在特定日期自动切换壁纸。
注意事项¶
- 版本变更：v0.3.0 为破坏性版本，移除了视频壁纸、生成背景以及单一的全局主题色设置。
- 减少运动模式：系统的“减少运动”设置会阻止动画播放，而不是缩短动画时长。
- 轮播限制：轮播功能默认关闭，且仅在当前激活的规则下生效。
- 节日壁纸：节日壁纸依赖联网下载，不支持本地自定义替换。
- 匹配顺序：规则按顺序匹配，第一条规则为默认规则（fallback）。
- 依赖要求：需确保 DSH 版本满足
>=0.2.1-alpha.2。
结语¶
dsh-background-by-model 通过规则驱动的机制，为 DSH 用户提供了精细化的模型级外观管理能力。无论是通过轮播增加动态感，还是通过节日背景增添仪式感，都能在不修改核心代码的情况下实现个性化定制。
