前言¶

DeepSeek Harness（DSH）的 Web 界面默认是统一的主题色与纯色背景，长时间对着同一套壳子开发或调试智能体，视觉疲劳很常见。有人用浏览器扩展改背景，但那和 DSH 的设置页、主题 token 脱节；也有人只关心功能、不关心外观，但换 profile 或重装后，分散在各处的自定义很难保持一致。

下面介绍社区插件 dsh-appearance（维护者 zhaohzXo）：在 DSH 自带的 设置 → 外观 里集中管理窗口壁纸和每次启动/刷新时的开场动画。壁纸与动画配置只写在本机浏览器存储，不改 Host 状态、不为此联网同步；界面外壳可半透明磨砂，卡片与弹窗仍保持不透明。分类上属于 DSH 生态里的「趣味换装」类插件。

这是什么¶

dsh-appearance 是 DSH 的 Client 端 Web 插件（当前版本 0.4.0，MIT 许可证）。它向设置面板注入一页「外观」（位于「通用」与「模型」之间），并提供：

• 壁纸：本地图片、图片 URL，或六张内置 canvas 绘制的壁纸；支持缩放、拖拽取景、遮罩强度。
• 开场动画：全屏启动封面，四种预设、四种强调色、可调时长与标题，可关闭或允许跳过。

Host 侧 index.js 为空实现，仅满足 Loader；实际逻辑在 client.js，通过 Cordis patch 注入 @deepseek-ai/dsh-client-ui-settings-general 与 @deepseek-ai/dsh-client-ui-theme。若宿主版本过旧、缺少上述注入目标，设置页不会出现「外观」且通常不报错，需要升级 DSH 后再装。

核心功能¶

壁纸¶

启用壁纸后，插件通过 theme.overrideTokens() 覆盖 --dsw-alias-bg-base 与 --dsw-specific-sidebar-fill，让外壳透出 document.body 的背景图。

六张内置壁纸不带静态图片文件：按参数用 canvas 绘制 2400×1350，再压成 WebP 写入存储键 dsh.appearance.image.v1（README 称实测约 20–115 KB）。内置与本地/URL 共用取景、缩放、遮罩；当前内置项记在配置里的 background.preset。

开场动画¶

模块加载时挂载全屏封面（自有 DOM + canvas + 定时器，结束自毁），思路来自上游 boot-intro.ts，在本插件中改为可配置、可换色、多预设。

在 prefers-reduced-motion 下会降级为静态封面。下拉菜单与开关为自绘，颜色跟随主题 token，避免深色主题下原生 <select> 白底闪屏。

四种预设简述：

• 电影序列：跃迁隧道 → 神经网格 → 轨道阵列 → 运行时内核。
• 极光流带：缓慢光带，最安静。
• 星域网络：星点与近邻连线。
• 极简光环：光环、进度条与文字，相对省电。

本地存储¶

旧键 dsh.background.v1 会在首次读取时迁移。拖取景、改缩放只重写小体积配置，不会反复重写整图。

安装与启用¶

从 GitHub 安装（README 推荐写法）：

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

也可安装本地目录（路径按你的机器修改）：

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

或在 DSH GUI 的插件管理里选择同一本地目录。安装后刷新页面或重启应用一次，才能在左侧设置里看到「外观」。

桌面端 Electron 的 desktop profile 由应用独占，命令行可能出现 profile "desktop" is managed exclusively by the Electron application，此时应改用应用内插件管理，而不是 CLI 带 --profile desktop。

若 GitHub HTTPS 被阻断或超时，README 给出 codeload 直链、本地 .tgz、或为 github.com 配置 git 代理等兜底方式；装完可对照插件管理器是否出现 + dsh-appearance <版本>，并检查 <DSH_HOME>/profiles/<名>/package.json 的 dependencies 与 dsh.profile.bundles。

插件为零依赖、无构建步骤即可使用分发包；改源码需在本仓库运行 node build.mjs 生成 client.js。

典型用法¶

1. 安装并刷新或重启 DSH Web UI。
2. 打开 设置，左侧进入 外观。
3. 壁纸：点一张内置缩略图，或上传本地图 / 粘贴图片 URL；在缩略图上调整取景与缩放，按需调节遮罩强度。
4. 开场动画：选择样式与强调色，设置时长与标题；用「预览动画」确认效果；不需要时可关闭「启用开场动画」。

以上选项立即作用于当前浏览器 profile；换 profile 或清除站点数据后配置会丢失，README 已明确不跟随账号同步。

适用场景与注意¶

适合谁：长期在 DSH Web UI 里写 prompt、看日志、调模型的开发者，希望在不 fork 主题的前提下给界面加壁纸和启动动效，且接受「仅本机、本 profile 生效」。

安装前建议：插件以当前 DSH 进程及其 Client 注入权限运行，安装前应浏览 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。社区目录 SkillHub 插件页 与 DSH Market 收录 便于发现条目，但与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。

已知限制（摘自 README）：外壳依赖特定 CSS token 名，上游改名需插件同步；动画若在首屏之后才加载脚本，封面会略晚出现；壁纸尺寸在未知原图宽高时取景换算为近似比例。

结尾¶

dsh-appearance 把壁纸、六张内置背景和可配置开场动画收进 DSH 原生设置页，数据和图片都留在本机，适合给 Harness Web UI 做轻量换皮。查阅详情与截图见仓库 README。

• 社区目录：https://www.skillhub.cn/plugins/zhaohzXo/dsh-appearance
• GitHub：https://github.com/zhaohzXo/dsh-appearance