前言¶
DSH（DeepSeek Harness）的界面主题和对话背景由原生客户端控制。想要换一种配色或背景时，常见的做法是改 profile 配置或直接改样式文件：前者容易被下一次配置写入覆盖，后者会影响布局、字体和交互。zxbingoo/dsh-minimalist-appearance 把这件事做成一个插件：新增左侧「外观」入口，只覆盖颜色与对话背景，不改变原有字体、字号、字重、行高、间距、控件尺寸、消息结构或交互。下面介绍这个插件的能力、安装方式和使用要点。
这是什么¶
dsh-minimalist-appearance 是 zxbingoo 维护的 DSH 持久化外观插件，分类属于「趣味换装」。它解决的问题是：在不去动 DSH 原生排版和交互的前提下，切换配色与对话背景，并保证切换结果在重启后保留。
插件在侧栏新增「外观」入口，把设置页做成静态外观示意，并提供七种预置主题。当前版本为 0.2.18，仓库的 package.json 写的是 "private": true，发行只通过 GitHub Release 发布；npm 上的旧名 dsh-appearance 属于另一个项目，不是本插件。
核心功能¶
插件只做绘制层面的覆盖：
- 左侧新增「外观」入口，插件管理页显示为「外观(dsh-minimalist-appearance)」，侧栏仍为「外观」。
- 七种主题：「浅色」「深色」「跟随系统」「绿色」「海蓝」「暖沙」「原始」。其中「绿色」原名「有风」，内部标识仍是
breeze/forest。 - 设置页顶部是 2:1 大预览，下方是「全部主题」紧凑缩略图。常规宽度下五列，窄面板自动减为三列或两列；点击主题后上方示意立即更新，并以一次原子写入保存。
- 大预览只是设置页内的静态示意，不是第二个真实会话，不能输入或发送消息，布局和裁切也不保证与原生对话一致。
- 缩略图和示意共用真实背景的图片、配色、fade 和 cover 绘制规则。「原始」主题同等对待，点击即应用并移除插件的颜色与背景覆盖。
- 只读或离线状态下点击只改变本页示意，不应用也保存，页面显示「仅预览 · 未应用」。关闭或刷新页面会清除未保存的内存选择。
- 不提供自定义颜色、上传、背景或淡化控件，旧版本保存的自定义值继续可读和生效，不做破坏性迁移。
配色覆盖的边界是明确的：完整对话框架的背景、正文与滚动层、输入区座位的透明底色、文件变更卡片与附件按钮的局部填充变量、共享弹出菜单的材质/图标/分组标题颜色变量、品牌标牌的局部反色文字，以及 macOS 侧栏的不透明底色。插件不修改布局、字体和原生主题偏好。
安装与启用¶
插件通过 DSH 的原生插件管理器安装，不是在普通终端执行命令：
{
"action": "install_bundle",
"target": "https://github.com/zxbingoo/dsh-minimalist-appearance/releases/download/v0.2.18/dsh-minimalist-appearance-0.2.18.tgz"
}
这条安装命令来自 README 的「初版定版与安装」一节，指向 v0.2.18 Release 的预构建 .tgz 包。安装、启用和卸载都通过 DSH 插件管理器完成，不手改 profile。本地目录安装是链接不是复制，替换已加载的 Host 代码通常需要重启 DSH。
需要注意发行身份：本仓库保留发行包名 dsh-minimalist-appearance、包名派生的浏览器 factory，以及原有 dsh-appearance / dsh_appearance 内部地址。不要在同一 profile 同时启用旧开发包与本发行包；旧保存项里可能包含旧包名断言。需要替换时，先通过受支持的插件管理与设置流程备份并确认迁移。
典型用法¶
-
打开左侧「外观」。
-
在设置页点击「浅色、深色、跟随系统、绿色、海蓝、暖沙、原始」中的任一主题。上方示意立即更新，并以一次原子写入应用及保存。保存中暂时禁止重复点击，失败时保留选择，可再次点击同一主题重试。
-
点击「原始」同样应用即生效：移除插件的颜色与背景覆盖，但不改原生 DSH 的主题、字体或布局偏好，也不删除旧配置里的休眠图片。
-
如果设置在其他位置更新，未修改的选择会同步；已有修改则保留并锁定选择，点击提示中的「重新载入」会明确丢弃旧选择后继续。
插件设置由当前 profile 的会话共享，通过原生 settings 服务写入，重启后仍保留。禁用插件会移除配色覆盖、背景样式及订阅，但保留保存的偏好；重新启用即可恢复。
适用场景与注意¶
适合这些使用者：想给 DSH 换配色或对话背景，但又不希望布局、字体、控件尺寸和消息结构发生变化的人；以及需要用 Agent 工具批量读写外观配置、又不想在页面上手工点击的人。dsh_appearance 提供 get / set / reset 三种操作，与页面共享 Host settings.mutate 操作及校验，get 返回 revision，set 和 reset 可以附带 expectedRevision 拒绝过期写入。返回值只包含图片 MIME 与字节数，不包含图片正文。
运行时权限与边界需要提前看清楚。插件以当前 DSH 进程的权限运行，安装前应当检查源码与许可证（package.json 中标注为 MIT）是否与自己的合规要求一致。README 明确写了当前运行环境 DSH 0.2.1-rc.5 / 0.2.2-rc.1 的 Host/Client 加载与接口已核对，但真实页面视觉验收仍受认证限制，不能把源码测试当作全面的视觉验收。升级 DSH 后若结构变化，需要重新核对。通用 settings 编辑器可以暂存「上传背景但未提供图片」的不完整组合，专用页面和 Agent 工具都会拒绝这样的保存，Client 对不完整配置不应用任何视觉覆盖并提供恢复入口。
已知限制方面，README 提到插件针对既有界面的 CSS 仅改绘制，并罗列了完整的对话框架、输入座位、文件变更与交付文件卡、共享弹出菜单、品牌标牌和 macOS 侧栏等接入点；这些接入点按 DSH 0.2.1-rc.5 的结构核实。背景不请求外部图片服务，旧背景以内联 data URL 保存在 profile 设置中，选择预设不会清除休眠图片。内置 PNG 在构建时校验签名并限制为 4 MiB，内联进 Client，不写入 profile 图片字段，也不占用用户上传图片的 2 MiB 限额。
结尾¶
这个插件的价值在于范围窄而明确：只改颜色和背景，不碰字体、布局和交互，切换通过原生插件管理器和 settings 服务完成，改完重启仍在。项目目录页在 https://www.skillhub.cn/plugins/zxbingoo/dsh-minimalist-appearance，源码和 Release 在 https://github.com/zxbingoo/dsh-minimalist-appearance。
