外观壁纸 zhaohzXo/dsh-appearance

外观（壁纸 + 开场动画）

DSH Market 收录徽章

DeepSeek Harness 的 Web UI 外观插件：在设置 → 外观里管理窗口壁纸，以及每次启动/刷新时的开场动画。

- 壁纸：本地图片、图片 URL，或六张内置壁纸（暮色山脉 / 黎明海岸 / 极光夜空 / 深空星云 / 黄昏沙丘 / 极光渐变）；可缩放、拖拽取景；界面外壳变成半透明磨砂，卡片与弹窗保持不透明。
- 开场动画：全屏启动封面，四种预设、四种强调色、可调时长、可改标题、可关闭跳过。
- 控件：下拉菜单与开关自绘，颜色跟随主题 token，深色主题下不会闪出系统白底弹层。

两件事都只在本机生效，不写 Host 状态、不联网。

安装

从 GitHub 安装（推荐）：

dsh plugin --profile desktop add github:zhaohzXo/dsh-appearance

或安装本地目录：

dsh plugin add "D:\workFile\my\dshP\dsh-appearance"

也可以在本 GUI 的插件管理里安装目录 D:\workFile\my\dshP\dsh-appearance。
安装后刷新页面或重启应用一次即可看到「设置 → 外观」。

装不上怎么办

插件本身没有安装门槛（零依赖、无构建、无 engines 限制），失败几乎都发生在下载阶段：

| 现象 | 原因 |
| ERR_PNPM_GIT_RESOLVE_FAILED、Failed to connect to github.com port 443 | github.com 的 HTTPS 在你的网络下被阻断或超时 |
| TimeoutError: The operation was aborted due to timeout | 同上，codeload 拉包超时（仓库较大时更容易出现） |
| 管理器显示成功，但设置里没有「外观」 | 下载失败后静默回滚了，实际没装进去 |

三种兜底方式，按成功率排序：

① codeload 直链：不经过 git 的 ls-remote，最稳
dsh plugin --profile <名> add "https://codeload.github.com/zhaohzXo/dsh-appearance/tar.gz/refs/heads/master"

② 本地 tgz：离线可用，适合发给别人
dsh plugin --profile <名> add "D:\path\dsh-appearance-0.4.0.tgz"

③ 给 git 配代理（只影响 github.com，不动其它仓库）
git config --global http.https://github.com.proxy http://127.0.0.1:7890

装完自检三步，能定位绝大多数「装了没反应」：

1. 看插件管理器返回有没有 + dsh-appearance <版本> 这一行，没有就是没装成功
2. 看 profile：<DSH_HOME>/profiles/<名>/package.json 的 dependencies 与 dsh.profile.bundles 中是否都出现 dsh-appearance
3. 刷新页面（Ctrl+R）；仍无则完全退出应用再启动一次

另外两个已知前提：

- 桌面端（Electron）不能用命令行装：--profile desktop 由应用独占，CLI 会报 profile "desktop" is managed exclusively by the Electron application，请改用应用内的插件管理。
- 宿主版本太旧时缺少本插件声明的注入目标（@deepseek-ai/dsh-client-ui-settings-general、@deepseek-ai/dsh-client-ui-theme），表现是设置页不出现且不报错，升级宿主即可。

用法

设置面板左侧导航新增一页 外观（位于「通用」与「模型」之间）：

| 分组 | 项目 | 说明 |
| 壁纸 | 内置壁纸 | 六张现成壁纸，点缩略图立即生效；当前选中的那张有高亮描边 |
| 壁纸 | 背景图片 | 选本地图片压缩后存本地；已选时可「更换 / 移除」 |
| 壁纸 | 图片链接 | 粘贴 https://… 或 data:image/…，回车或点「载入」直接取用，适合壁纸站直链 |
| 壁纸 | 取景（缩略图区） | 在缩略图上按住拖动改变取景位置，滚轮缩放，双击回到居中 100% |
| 壁纸 | 缩放 | 100–250%，超出容器的部分才能拖动取景 |
| 壁纸 | 遮罩强度 | 30–92%，越高壁纸越淡、文字越清晰（深色主题下可适当调低） |
| 开场动画 | 启用开场动画 | 关闭后启动不再播放 |
| 开场动画 | 动画样式 | 电影序列 / 极光流带 / 星域网络 / 极简光环 |
| 开场动画 | 强调色 | 青蓝 / 紫罗兰 / 琥珀 / 翡翠（同时改变封面与 canvas 粒子） |
| 开场动画 | 时长 | 1.5–8.0 秒；电影序列会把四段镜头均分到该时长 |
| 开场动画 | 标题文案 | 封面主标题，留空回退 DEEPSEEK HARNESS |
| 开场动画 | 允许跳过 | 开启时点击任意处、按 Esc、点右上角按钮都能立即结束 |
| 开场动画 | 预览动画 | 按当前设置立刻播放一次（不改动存储） |

下拉菜单与开关都是自绘的（原生 的弹层由系统绘制，深色主题下会闪出白底，这也是本插件不用它的原因）：菜单位置按视口空间自动上下翻转、跟随面板滚动，颜色全部取自主题 token。

四种预设：

- 电影序列：四段镜头 —— 跃迁隧道 → 神经网格 → 轨道阵列 → 运行时内核，每段切换场记与粒子行为。
- 极光流带：缓慢流动的叠加光带，最安静。
- 星域网络：漂浮星点 + 近邻连线。
- 极简光环：只有光环、进度条与文字，最省电。

内置壁纸

六张，都不带图片文件：按预设参数用 canvas 现画 2400×1350，再走和本地图片相同的那条路径压成 WebP 存进 dsh.appearance.image.v1（实测 20–115 KB），所以分辨率越高越清晰、包体不变大。

| 预设 | 画面 |
| 暮色山脉 | 靛蓝夜空 + 暖色地平线、落日、四层山脊与星点 |
| 黎明海岸 | 桃金渐变天光、海平线、水面反光带与远岬 |
| 极光夜空 | 三层极光帷幕（青绿 / 冰蓝 / 紫）、星空、黑色山脊 |
| 深空星云 | 紫 / 蓝 / 品红星云团、尘埃带、带光晕的亮星 |
| 黄昏沙丘 | 暖橙天光、低角度落日、四层沙丘曲线 |
| 极光渐变 | 蓝→靛→紫对角渐变 + 琥珀光晕，最安静 |

内置壁纸和本地图片共用取景、缩放、遮罩；当前选中的是哪张记在 background.preset（换成本地图或 URL 时自动清空），刷新后高亮仍在。

实现

- client.js：Client 半边。设置页注册到 settings.section（id: appearance, order: 5）；壁纸通过 theme.overrideTokens() 覆盖 --dsw-alias-bg-base 与 --dsw-specific-sidebar-fill，让外壳透出 document.body 的背景图；开场动画是模块求值时立刻挂载的全屏封面（自有 DOM + canvas + 定时器，结束即自毁），来自仓库 packages/client/web/src/boot-intro.ts 的实现思路与样式，改为可配置、可换色、多预设。
- src/client.template.js：可读源码，__INTRO_CSS__ 为样式占位符。
- 控件配色只用语义 token：填充按钮 = --dsw-alias-button-primary-fill + --dsw-alias-label-primary-foreground，开关 = --dsw-alias-brand-primary + --dsw-alias-switch-thumb。brand-primary 在深色主题下是近白墨色，若配 #ffffff 文字或圆点就会变成“一片白”。
- src/intro.css：由上游 boot-intro.module.css 机械转换而来（类名加 dshfx- 前缀、颜色改为 --fx- 变量以支持强调色）。
- 内置壁纸：drawDusk / drawDawn / drawAurora / drawNebula / drawDunes / drawGradient 六个 canvas 绘制函数，配合 seeded() 固定随机种子，同参数每次渲染完全一致；缩略图在挂载时（React.useMemo）以 320×180 画一次。
- build.mjs：把样式拼进模板，生成 client.js。改完 src/ 后运行：

cd D:\workFile\my\dshP\dsh-appearance
node build.mjs

- index.js：Host 半边，空实现，只为提供 Loader 行。
- locale/.json、icon.svg：插件管理里的标题、描述与图标。

存储

| Key | 内容 |
| dsh.appearance.v1 | 配置（遮罩、缩放、取景位置、图片尺寸、内置壁纸 key、开场动画各项），体积很小 |
| dsh.appearance.image.v1 | 壁纸内容（本地图片为 WebP data URL；URL 壁纸则存该 URL，≤2.4 MB） |

旧版 dsh.background.v1 会在首次读取时自动迁移。壁纸与配置分离存放：拖取景、拉缩放只重写几十字节的配置，不会重写整张图片。

截图

| 六张内置壁纸 | 设置 → 外观（深色） |
| 内置壁纸 | 设置页 |

| 开场动画 | 应用壁纸后的主界面 |
| 开场动画 | 主界面 |

已知限制

- 壁纸与动画配置属于浏览器本地，不跟随账号同步，换 profile 或清除站点数据即丢失。
- 壁纸尺寸按 cover × 缩放 计算：知道原图宽高时用像素，未知时回退 百分比 × auto（拖拽换算按近似比例）。
- 外壳底色依赖 --dsw-alias-bg-base 与 --dsw-specific-sidebar-fill 两个 token；若上游改名需同步调整 wallpaperTokens()。
- 取景位置只在图片大于容器时才有拖动空间；双击缩略图可随时回到居中 100%。
- 动画在模块求值时开始，若宿主把插件脚本推迟到首屏之后才加载，封面会晚一点出现（时长仍按配置走）。
- prefers-reduced-motion 下自动降级为静态封面。