前言¶
在 DeepSeek Harness（DSH）里同时启用多套皮肤、主题、视频背景和挂件时，外观相关设置往往分散在不同插件各自的面板里。要换一套搭配，需要在多个入口之间来回切换；多个插件若改写同一段启停配置，还容易出现覆盖与冲突。下面介绍社区插件 dsh-appearance-master（维护者 cozylove-girl，分类：趣味换装），它把皮肤、主题、背景动画和装饰件分成四层，每层独立开关，并支持保存与应用整套外观方案。
这是什么¶
dsh-appearance-master 是 DSH 的外观管理面板（DeepSeek Harness appearance switcher）。插件扫描本机已安装的外观类插件及其配置，在 设置 → 外观总控 提供统一入口：快速选择当前使用的外观、关闭某一层效果、把常用搭配保存为方案。皮肤的具体样式仍可在皮肤管理器中细调；外观总控负责快捷切换与方案管理，不调用外部网络，也不读取会话内容。
面向 DSH 0.2 系列，package.json 声明兼容范围为 >=0.2.0-rc.2 <0.3.0-0；当前资料中的版本号为 0.9.2，许可证 MIT。
核心功能¶
外观总控按层管理内容，选择方式如下：
| 层 | 管理内容 | 选择方式 |
|---|---|---|
| 皮肤 | 页面布局 | 单选，支持关闭所有皮肤 |
| 主题 | 配色与质感 | 单选 |
| 背景 / 动画 | 视频、壁纸、开机动画 | 单选 |
| 装饰件 | 挂件、桌宠、状态条 | 多选 |
除分层切换外，插件还提供：
- 将当前选择保存为整套方案，随时从方案列表重新应用。
- 通过配置中的受管区块管理启停状态，保留其他插件写在
cordis.patch.yml里的内容。 - 在直接修改补丁文件前自动生成
cordis.patch.yml.master-bak备份。
面板上的「已加载 / 已停用」反映读取到的启停配置；尚未点击应用的选择会显示为「待应用」。安装新的外观插件后，刷新外观总控即可重新扫描。
安装与启用¶
插件包含宿主端与 Web 客户端，通过 dsh.bundle 加载，无需额外构建。以下命令使用 desktop profile；若使用其他 profile，请替换对应名称。
从 npm 安装：
dsh plugin --profile desktop add dsh-appearance-master
从 GitHub 安装：
dsh plugin --profile desktop add git+https://github.com/cozylove-girl/dsh-appearance-master.git
从本地目录安装（将路径替换为实际绝对路径）：
dsh plugin --profile desktop add /绝对路径/dsh-appearance-master
也可在 设置 → 插件 的安装入口填写本地目录路径。安装完成后，重启 DSH 并刷新页面。
卸载：
dsh plugin --profile desktop remove dsh-appearance-master
如需清理保留的启停配置，可在 profile 和 DSH home 的 cordis.patch.yml 中移除 # --- appearance-master managed 至 # --- end appearance-master managed --- 的完整受管区块。
典型用法¶
- 打开 设置 → 外观总控，为皮肤、主题、背景各选择一项，按需勾选装饰件；若不需要皮肤层，可选择「关闭所有皮肤」。
- 点击 应用并刷新，写入配置并重新加载页面。
- 为常用组合命名并保存，之后从方案列表重新应用即可。
应用外观选择后会刷新页面，以重新加载客户端外观插件；若宿主提示需要重启，请重启 DSH。视频素材、主题细节、挂件角色等仍在对应插件的设置中调整。
配合其他外观插件¶
| 插件 | 用途 |
|---|---|
| 外观总控（本项目） | 分层切换、关闭皮肤、管理整套方案 |
皮肤管理器 @smalltailqwq/dsh-client-ui-skin-deep-whale-manager |
皮肤切换、桌面图标跟随及皮肤细调 |
皮肤市场 dsh-skin-market |
浏览、安装与卸载皮肤 |
外观总控与皮肤管理器读取相同的皮肤启停配置；在一处切换后，可刷新另一处查看状态。多个管理器修改相同启停项时，最终状态受配置层级与写入顺序影响，建议完成一次切换后刷新其他管理面板。
数据与文件¶
| 文件 | 用途 |
|---|---|
<profile>/cordis.patch.yml |
profile 层的外观启停配置 |
<DSH home>/cordis.patch.yml |
home 层的外观启停配置（优先级更高） |
<DSH home>/appearance-presets.json |
保存的外观方案 |
<DSH home>/appearance-master.heartbeat.json |
启动诊断信息 |
DSH home 由环境变量 DSH_HOME 指定，默认 ~/.dsh。
适用场景与注意¶
适合已经在 DSH 里安装多套皮肤、主题、背景或装饰件插件、希望用一个面板切换整套搭配并保存方案的用户。DSH 生态以「一切皆插件」为思路；社区目录（如 SkillHub 插件页）是独立收录渠道，与 DeepSeek / 幻方无官方从属关系。
安装任意 DSH 插件前，插件以当前 DSH 进程权限运行，应自行查看源码与许可证（本项目为 MIT）。社区目录页：https://www.skillhub.cn/plugins/cozylove-girl/dsh-appearance-master ；源码与完整说明：https://github.com/cozylove-girl/dsh-appearance-master 。
