qe2592008/dsh-ui-customizer

README 摘要

dsh-ui-customizer · 界面定制 DeepSeek Harness Web GUI 的界面定制插件：在侧边栏 设置菜单的正上方 添加一个「界面定制」菜单，点击打开配置弹窗，可设置 整个 Web 界面的背景图片 （支持网络 URL 或本地图片文件）并 调节图片透明度 。背景图片铺满整个界面、显示在所有内容之下，形成壁纸效果；设置保存在浏览器本地（localStorage），刷新页面后依然保留。 纯展示层客户端插件：不注入服务、不发 Cordis 事件、不触达模型请求。插件卸载 / 热切换时，所有 DOM/CSS 写入（AppFrame 背景透明化、overlay 层级）都会被 effect 销毁器精确还原。 特性 - 侧边栏「界面定制」菜单（位于设置上方，收起时显示圆形图标） - 配置弹窗：启用开关、图片地址输入、本地图片选择（转为 data URL 内嵌） - 交互式裁剪预览 ：滚轮或按住中键上下拖动 = 缩放（光标锚定），左键拖动 = 平移； 「复位」按钮一键恢复整图； 只有预览中框选出来的区域会作为背景 （以自然像素 的裁剪矩形保存，可精确复现） - 最近使用 ：自动保留最近 5 张用过的背景图片，点击缩略图即可直接切换（当前使用的图片高亮） - 拉伸方式 ：铺满（cover，默认）/ 适应（contain）/ 平铺（tile）/ 拉伸（fill）； 裁剪生效时平铺回退为铺满（平铺子区域需要重新裁图，暂不支持） - 模糊 （0–24px）与 暗化叠加 （0–90%）滑杆，让壁纸更柔和或让文字更易读 - 透明度/模糊/暗化滑杆 实时生效 （无防抖延迟，滑块跟手）；localStorage 写入防抖 合并，不拖累拖动性能 - 背景层挂在布局的 shell.overlay 槽上， z-index: -1 + 透明化 AppFrame 背景，图片真正位于内容之下 - 设置保存在浏览器 localStorage（含多标签页同步），刷新页面后保留 - 中英双语 为什么不用宿主设置文档（settings.yaml） 宿主设置协议目前只把 硬编码白名单 内的命名空间暴露给浏览器 （ dsh-host-apiproxy 的 WEB SETTINGS NAMESPACES ，含 ui-theme 等官方 命名空间）。第三方插件的命名空间即使注册成功，浏览器也读不到、写不进 （ settings-not-exposed ），因此本插件的持久化改用浏览器本地 localStorage （键 dsh-ui-customizer:v1 ），零宿主依赖、热加载即生效。 宿主端仍保留 ui-customizer 命名空间注册（见 lib/index.js ），若 DSH 未来放开注册即暴露，可无缝切回 ctx.settingsScope 。 本地图片选择上限 10 MB…

分类