dsh-minimalist-appearance

外观 / Appearance

DSH 持久化外观插件。新增左侧「外观」入口，只覆盖颜色与对话背景，不改变原有字体、字号、字重、行高、间距、控件尺寸、消息结构或交互。

初版定版与安装

首个公开定版为 v0.2.14，保留已验收的七种主题、壁纸和菜单适配。已针对 DSH 0.2.1-rc.5 验证；其他版本尚未验证。纯逻辑、源策略及发行标识回归为 96/96 通过，不将其当作跨平台视觉验收。

• 仓库：zxbingoo/dsh-minimalist-appearance。
• 安装包：从 v0.2.14 Release 下载预构建 .tgz，或让 DSH 安装下方固定版本地址。
• 发行包名为 dsh-minimalist-appearance，本次仅通过 GitHub Release 发行，保留 private: true 防止误发 npm。npm 上的旧名 dsh-appearance 属于另一项目，不是本插件。
• 为兼容已验收版本，内部配置、面板及工具标识保持 dsh-appearance / dsh_appearance。不要在同一 profile 同时启用旧开发包与本发行包；这是新的发行包名，不承诺旧开发包的设置自动迁移：旧保存项可能包含旧包名断言。需要替换时，先通过受支持的插件管理与设置流程备份并确认迁移，不手改 profile。本次发布不会替换当前已安装的开发包。

在 DSH 中使用原生插件管理器安装（不是在普通终端执行）：

{
  "action": "install_bundle",
  "target": "https://github.com/zxbingoo/dsh-minimalist-appearance/releases/download/v0.2.14/dsh-minimalist-appearance-0.2.14.tgz"
}

源码克隆也已包含生成的 Client 与全部运行资源，不需要安装第二份 React。安装、启用和卸载均通过 DSH 插件管理器操作；不手改 profile。历史开发壁纸备份不随仓库或发行包公开。

使用

1. 打开左侧「外观」。
2. 设置页按参考图分为上方 2:1 大预览、下方「全部主题」紧凑缩略图。常规宽度为五列，名称在缩略图下方，选中项使用主文字色双层轮廓；窄面板自动减为三列或两列。不复制参考图的设置侧栏。
3. 点击「浅色、深色、跟随系统、绿色、海蓝、暖沙、原始」任一主题，上方示意立即更新，并以一次原子写入应用及保存；不再设置分组、长说明、独立保存页脚或跳转真实对话的预览按钮。保存中暂时禁止重复点击；失败保留选择，可再次点击同一主题重试。
   • 「绿色」（原名「有风」）保留既有灰绿色侧栏、水彩壁纸和已修复的组件配色，内部 breeze / forest 标识不变。
   • 「原始」同样点击即应用，移除插件的颜色与背景覆盖，不修改原生 DSH 的主题、字体或布局偏好，也不删除旧配置中的休眠图片。
4. 大预览是设置页内的静态外观示意，不是第二个真实会话，也不能输入或发送消息；布局和裁切不保证与原生对话一致。缩略图及示意共用真实背景的图片、配色、fade 和 cover 绘制规则；基础主题缩略图用静态窗口骨架，系统主题左右展示浅深色。原始主题使用注册主题颜色和中性色回退，不冒充像素级真实渲染。
5. 只读或离线时点击仅改变本页示意，不应用或保存，并显示「仅预览 · 未应用」。重连不会自动保存或重启临时覆盖，需再次点击主题；进行中的保存由插件持有，切换面板后仍可结算。关闭或刷新页面会清除未保存的内存选择。
6. 若设置在其他位置更新，未修改的选择会同步；已有修改则保留并锁定选择，点击提示中的「重新载入」明确丢弃旧选择后继续。当前版本仍不提供任何自定义颜色、上传、背景或淡化控件。

各预设固定其配色、明暗和背景组合，不修改 DSH 原生主题偏好。浅/深色基础配色是本插件的中性色方案，不保证与原生 DSH 逐像素相同；「原始」不应用任何颜色或背景覆盖，也是首次安装默认状态。旧版本保存的自定义值继续可读和生效，不进行破坏性迁移；只有明确选择并保存预设时才替换当前外观。

0.2.1 移除了与 DSH 布局不一致的 SVG 模拟界面。素材展示和真实背景共用配色解析、图片、淡化、cover 和居中规则；素材展示不承诺界面布局或不同宽高比下的裁切一致。真实预览使用原有 DSH 对话区、输入框和控件，原布局与字体不变。

0.2.2 修复了「有风」显示为空白的问题：2.97 MB 的内联图片与 var() 出现在同一条 background-image 中，超过了 Blink 对待变量解析样式的长度限制。现在先从同一套主题状态解析淡化底色，再把不含变量替换的绘制值共用于大图、缩略图和真实对话。保留原图、data URL 和上传限制，不新增 Blob 地址或网络请求；明暗与系统主题变化仍会更新淡化底色。回归测试覆盖真实内置大图和上传上限，不将字符串测试当作实际页面视觉验收。

0.2.3 将背景从正文移到已核实的完整 Conversation 框架，统一覆盖标题、对话与底部输入区；仅清除正文、滚动层和输入区座位的背景绘制，不改变尺寸、滚动或定位。补齐输入框、用户消息、工具详情和任务/队列面板的专用底色 token；文件变更标题与交付文件卡只局部重绑其绕过 alias 的静态深色底色。保留增删 diff、成功/错误与任务状态语义色，不全局修改静态调色板。「原始」且明暗跟随 DSH，或仅改强调色时，组件补色不生效。

0.2.4 针对两处对比问题做局部补色：共享 BrandWordmark 的 Harness 字形通过原生 dsh-wordmark-badge-clip 标记定位，反色文字与当前标牌底色配对；输入框内添加附件/指令按钮的默认和悬停填充在 [data-composer-card] 内重绑，避免浅色模式的深色图标搭配残留深色圆底。只改颜色变量，不替换标识、图标或按钮，不调整禁用透明度、焦点、尺寸与交互；侧栏和背景配色保持不变。

0.2.6 按用户要求撤回 0.2.5 方案，恢复 0.2.4 的外观：移除标题、回复及状态区域的阅读底色和状态文字覆盖，撤销回到底部按钮的填充及悬停改色。保留此前 Harness 标牌、附件按钮及其他已完成的配色修复；不修改保存的主题、背景或 fade。

0.2.7 只重绘「有风」壁纸构图：移除顶部遮挡标题的枝冠，将中下部高大深色树林收拢为底部两角的水彩绿植与花草，保留淡蓝天空和暖色草甸，在标题及中下部工作区域留出连续、浅淡、低细节的空间。图片尺寸仍为 1536×1024，继续使用原有居中 cover 规则；不增加界面底板、遮罩或文字覆盖，不改配色、控件、布局与已保存设置。开发阶段的原图备份仅本地保留，不随仓库或发布包分发。

0.2.8 根据「太亮太黄、需要柔和」的反馈，只调整内置壁纸的色调、亮度与局部对比：去除黄绿草甸的发光感和天空白色高光，改为低饱和雾蓝灰绿与鼠尾草灰绿，柔化边角枝叶和花朵。保留水彩纹理、标题与中下部的低细节留白；不通过界面遮罩实现，不改主题 token、布局、控件、fade 或已保存配置。开发阶段的上一版壁纸备份仅本地保留，不随仓库或发布包分发。

0.2.9 按用户重新提供的参考图恢复原有淡蓝天空与鲜绿色水彩风格，不再沿用 0.2.8 的整体灰绿改色。只从原始壁纸重新处理构图：去掉左上枝冠、左侧枝条和底部连续树林，原树木位置以同风格天空自然补齐，花草收敛为极底边的窄带。标题和中下部阅读区不再叠有树冠或树影；不新增界面底板、遮罩，不改主题 token、布局、控件或保存的配置。开发阶段的上一版壁纸备份仅本地保留，不随仓库或发布包分发；实际页面可读性仍需视觉验收。

0.2.10 按「原图只改两处」重新局部编辑原始壁纸：去掉左上枝冠和左边小枝条；左侧至中下部侵入输入区的高松树换成低矮绿草、白色与蓝色小花。保留原图的淡蓝天空、白鸟、右侧树丛及上升草坡，不再把景物压成极底边细条，也不整体改色。仅更新内置图片与 Client 代次标记，配色、CSS、控件、字体、布局和保存偏好不变。开发阶段的上一版壁纸备份仅本地保留，不随仓库或发布包分发；实际工作区观感仍以页面视觉验收为准。

0.2.11 按用户要求适配聊天区「跳转到底部」按钮：原生按钮的专用浮动底色仍跟随 DSH 明暗，而箭头已使用本插件的文字色。现在仅在 [data-conversation-content] 内将 --dsw-alias-button-floating-fill / --dsw-alias-button-floating-hover 绑定到当前主题的抬升表面与悬停底色，箭头和阴影描边继续使用已适配的文字及边框 token。保留原生按钮、尺寸、位置、阴影、焦点、显隐与滚动逻辑；不恢复已拒绝的标题/回复阅读底板，不改壁纸、全局配色或保存偏好。原始外观、仅改强调色或仅改背景时仍不加组件覆盖。

0.2.12 重做配置页为居中的六张预设卡片，移除大幅素材面板、色条、所有自定义控件及占位内容，将「有风」显示名改为「绿色 / Green」。缩略图与原 PNG 同为 3:2，共用真实背景绘制规则；草稿、保存请求和临时预览状态分离，取消/返回不再丢失选择，过期 revision 不能绕过保存冲突检查。「恢复原始」同样遵循暂存及保存流程。Host 配置和 Agent 工具保留旧数据兼容，壁纸、原生对话布局和此前组件补色不变。单元测试、构建及实时 Client 注册不代替已认证页面中的视觉和交互验收。

0.2.13 按用户参考图重做且仅重做外观设置页：顶部 2:1 大舞台和右上角徽标，底部单组五列缩略图、外置名称、主文字色选中轮廓。点击即更新示意并原子保存，取消原来分组、冗长说明、保存页脚及跨页预览流程；原始外观作为同级主题。示意完全非交互且不挂载真实会话，原生侧栏、对话、壁纸和既有补色不改。只读/离线只更新本页示意，失败可重点击重试，冲突显式重新载入。旧自定义配置和休眠图片保持兼容，不做迁移。

0.2.14 适配共享弹出菜单：输入框的模型/推理等级、权限、指令与引用候选，以及右上角「打开方式」等使用同一 MenuSurface 的菜单，统一跟随当前主题表面色、图标色及分组标题底色。通过 [data-menu-material] 局部重绑材质变量，兼容独立挂载到 body 的菜单与子菜单，避免原生深灰材质残留；分组标题只在原生吸顶状态使用 94% 不透明度。悬停、导航高亮、选中勾、文字、边框继续使用既有主题 alias；保留 macOS backing、模糊、阴影、位置、尺寸、字体、键盘与点击逻辑，不改变应用图标或默认打开方式。「原始」及仅改强调色/背景时不加此覆盖，壁纸、设置页和已保存偏好不变。

设置由当前 profile 的会话共享，通过原生 settings 服务写入，重启后仍保留。禁用插件会移除配色覆盖、背景样式及订阅，但保留保存的偏好。重新启用可恢复；删除工作区目录前请先卸载本地链接插件。

图片与隐私

• 当前配置页不提供上传和图片清理。为兼容旧配置，Host/Agent 校验仍只接受 PNG、JPEG、WebP，最大 2 MiB（原始解码字节），拒绝 SVG、远程 URL、错误 MIME/文件签名及超限数据。
• 旧背景以内联 data URL 保存在 profile 设置中，不请求外部图片服务；选择预设不会清除休眠图片。配置、备份或可读该 profile 的用户仍可获得图片。
• 「绿色」为参考配色与构图重新创作的内置水彩 PNG，不是参考应用截图；海蓝、暖沙和调色板图标为原创 SVG。随本插件提供，不含远程资源。
• 内置 PNG 在构建时校验签名并限制为 4 MiB，内联进 Client；它不写入 profile 图片字段，也不占用用户上传图片的 2 MiB 限额。

Agent 操作

dsh_appearance 提供 get / set / reset，与页面共享 Host settings.mutate 操作及校验。get 返回 revision，set/reset 可附 expectedRevision 拒绝过期写入。返回值只包含图片 MIME 与字节数，不包含图片正文。为保持兼容，工具仍支持旧自定义字段；当前配置页只选择预设，不再提供上传。

开发与安装

使用 Node 运行：

node build.mjs
node --test test/*.test.mjs
node --check client.js

通过 DSH 的 plugin_manager install_bundle 安装本包的绝对目录。无需安装第二份 React，也不导入其他 Harness Client 包；Client 仅使用原生服务和新增 Slots。Host 的 schemastery peer 由当前 DSH runtime 提供。

本地目录安装是链接，不是复制；请保留此目录。替换已加载的 Host 代码通常需要重启 DSH。卸载/禁用请使用插件管理器，不手改 profile。

已知限制

通用 settings 编辑器可以暂存「上传背景但未提供图片」的不完整组合；专用页面和 Agent 工具均拒绝这样保存。Client 对不完整配置不应用任何视觉覆盖，并提供恢复入口。

样式使用主题 tokens，补齐已核实的中性色文字、边框和交互底色。针对既有界面的 CSS 仅改绘制：完整对话框架背景及正文/滚动/输入区座位的透明底色，文件变更、交付文件卡和附件按钮的局部填充变量，共享弹出菜单的材质/图标/分组标题颜色变量，品牌标牌的局部反色文字，以及 macOS 侧栏的不透明底色（避免原生半透明材质将浅灰绿混成灰色）。不修改布局、字体或原生主题偏好。

背景接入点按 DSH 0.2.1-rc.5 的结构核实：完整对话框架使用 div[data-phase]:has([data-conversation-content])，输入座位使用 [data-composer-seat]；文件变更与交付文件卡使用原生 [data-changed-files] / [data-presented-file] 挂钩。共享弹出菜单按 MenuSurface 的 [data-menu-material] 挂钩重绑颜色，不限定菜单必须是输入框后代，也不按本地化标签、role 或散列类名猜测归属。macOS 侧栏仍按 AppFrame 含直接 [data-shell-overlay] 子元素的框架的第一个 div 定位，不使用散列类名；「原始」及仅改强调色时不覆盖原生侧栏材质。升级 DSH 后若结构变化，需要重新核对。设置页/对话真实预览的视觉效果仍需在已认证的实际页面中验证；单元测试和 Client 注册不代表视觉验收。