BPZ0726/dsh-bestui

README 摘要

BestUI · 壁纸主题插件 给 DeepSeek Harness Web GUI 的背景主题插件（又名 壁纸主题 / Wallpaper theme ）。 A background theme plugin for the DeepSeek Harness Web GUI , a.k.a. 壁纸主题 . 预览版提示 / Preview: BestUI 0.1.x 面向仍在快速迭代的 DeepSeek Harness Developer Preview，宿主升级后可能需要同步适配。 功能特性 / Features - 🖼 上传图片当背景 / Wallpaper upload ：本地选图即用，超限图片自动压缩（降采样 + JPEG 重编码），动画 GIF 保留动画，设置持久保存在浏览器 localStorage 。 - 🪟 透明部件不透明度 / Per-surface opacity ：背景基底 / 第二层表面 / 侧边栏各配独立滑块与「默认」勾选；数值越小壁纸透出越多。其余表面固定不透明（颜色仍可自定义）。 - 🎨 元素颜色自定义 / Per-element colors ：14 个设计 token（表面 / 边框 / 品牌色 / 主次文字 / 状态色）+ 9 个额外元素色（悬停 / 选中按下 / 滚动条 / 提示气泡等），每个都按 浅色 / 深色 两套方案分别取色，边框按 shell 同款透明度渲染。 - 颜色自定义与「启用」开关 无关 ：关闭壁纸后自定义配色仍然生效。 - 「恢复默认配色」= 产品 design-platform 原始色板（逐值一致），旧方案自动迁移。 - ✨ 自动配色 / Auto palette ： - 有背景图 → canvas 采样（32×32 降采样 + 色桶统计），浅色方案取自图片亮部、深色方案取自暗部，并按图片明暗自动切换浅/深主题； - 无背景图 → 中性配色与产品默认一致，随系统深浅自动切换。 - 🔤 字体与界面 / Fonts & interface ：字体风格 / 字重 / 字体大小（纯文字缩放，不动控件）/ 文字色相；界面缩放、按钮 / 输入框 / 卡片 / 设置窗口圆角、设置窗口宽高，全部带「默认」勾选。 - 📤 方案导出 / 导入 / Scheme export & import ：一键导出完整方案为 JSON（壁纸、配色、字体、圆角、不透明度），导入整体替换并完整校验迁移。 - ♻️ 停用易恢复 / Unload-safe styling ：视觉效果基于 theme.overrideTokens 覆盖层 + 受控样式标签，不注册第三方主题 id；停用/卸载会移除样式覆盖，可与其它主题插件并存。若曾按壁纸明暗自动切换主题，主题偏好需在宿主设置中手动切回。 截图 / Screenshots TODO：…

分类