dsh-ui-appearance

dsh-ui-appearance

English · 中文 · 参与贡献

DeepSeek Harness 生态中首个支持多维度 UI 参数深度自定义的外观插件 —— 不局限于固定预设，支持面板/侧边栏/设置弹窗/菜单浮层/输入框/代码块 6 路独立透明度微调、毛玻璃强度、壁纸/视频背景及色板智能衍生；WebUI 与 DSH Desktop 均可使用。 零核心代码改动:完全通过官方插件机制(ctx.theme.overrideTokens() 主题扩展点与 settings.general.item 插槽)实现;卸载后界面完整恢复默认。 界面 在 DSH Desktop(桌面客户端)中同样开箱即用,以下为实拍: 官方桌面端新版实拍(社区版截图保留在上方): 效果图中的壁纸素材 © MadYY(原图),仅作演示;用户上传自己的图片即可。 功能

深浅双模式独立外观 —— 设置面板顶部提供「浅色模式 / 深色模式」独立分段卡，分别配置双模式下的 6 种颜色角色与预设，实时跟随宿主状态与系统 prefers-color-scheme 自适应切换。接入 WCAG 2.1 动态反解算法（次级文字 $\ge 7:1$、三级说明字 $\ge 4.5:1$），彻底杜绝浅色模式“白底淡字”或深色模式图标隐形。

主题颜色 —— 6 个核心颜色角色：主色、背景色、面板色、输入框色、文字色、边框色。每个角色支持原生取色器与 HEX 精确输入，全局色彩严格遵循所见即所得（不隐式篡改你手选的文字色）；主操作按钮、文字选区高亮、键盘焦点环跟随主色，用户消息气泡跟随面板色，并在局部实心/半透明表面自动做可读性对比度兜底。

壁纸与视频背景（最高 200MB） —— 支持上传或拖拽图片（JPG / PNG / WebP / GIF），或粘贴 URL 一键加载（自动按扩展名分流，支持 CORS 友好直链）。原画质通过 IndexedDB Blob 存储（零额外堆内存复制，不占 localStorage 配额；超 4096px 等比缩边，限内 GIF 保留动效）。上传时自动采样平均亮度并智能提取主色衍生周边色阶。支持原生流式硬解动态视频背景（MP4 / WebM，静音循环播放，最高 200MB）。

毛玻璃与多维独立半透明机制 —— 主面板、侧边栏、设置与弹窗、菜单与浮层、输入框、代码块均拥有独立的 0%~100% 连续不透明度滑块，互不干扰（彻底解决主面板全透时设置弹窗或下拉菜单/浮窗看不清字的问题）。毛玻璃强度（glassBlur）与背景模糊（backgroundBlur）完全解耦：背景模糊仅作用于底层壁纸/视频，而毛玻璃精准作用于侧边栏、输入框、斜杠命令（/）浮层、下拉菜单与浮窗、消息气泡、代码块、设置弹窗及弹窗外围遮罩。行内代码等强调字保留低透明度主色相，配合「强调字浓度」滑块精细微调；中性控件与菜单项 hover / 选中状态同步烘焙对应透明度，鼠标悬停平滑自然，绝不闪现死白/死黑的实心水泥块（解决 hover snapped opaque）。

背景三层架构与氛围 —— 独创三层渲染架构：底层基础画布（承载自定义纯色背景）、中层媒体层（承载壁纸/视频的独立不透明度与模糊）、顶层防眩光遮罩（随深浅色模式自动配色的纱帘渐变）。调低壁纸不透明度时平滑融入自定义背景底色，消除白斑；遮罩层有效保证亮图之上的文字易读性。

双模式专属预设 —— 浅色 5 款专属预设（晨曦、云天、薄荷、樱粉、雅灰）+ 深色 6 款经典预设（默认、午夜、海洋、森林、玫瑰、单色），一键应用并支持自由微调。

配色方案分享 —— 一键导出配色 JSON 至剪贴板，粘贴即可导入应用；欢迎在 GitHub Discussions 社区分享交流你的专属配色方案。

所有修改实时生效，无需刷新，无需保存。 安装 方式一：npm 一行命令（推荐）

方式二：一键脚本（Windows，无需 npm 账号与 git）

脚本直接从 npm registry 拉取已构建的发布包（lib/ 预构建产物随包分发），链接进 profile 自己的 node_modules 并在该 profile 的 package.json 中注册（dependencies 条目 + dsh.profile.bundles，与 dsh plugin add 的产物一致）——幂等，可重复执行。可选参数：