huabai-flowerwhite/dsh-ui-skin

README 摘要

dsh ui skin 面向 DeepSeek Harness 的 UI 皮肤插件 ：在 UI 下方注入壁纸 / 视频背景，并把 DSH 整个界面（含侧栏）的表面背景烘焙为半透明（毛玻璃）让皮肤透出。支持拖动裁剪缩放、历史皮肤记录与可拖动悬浮窗；自定义皮肤支持网络地址或本地文件。 依据 DH-TP-SDK（ DeepSeek-Harness-Third-Party-Plugin-SDK-Specification.md ）工程化第三方插件规范落地。Bronze/Silver/Gold、P0–P4、S0–S4 均非 DeepSeek 官方认证。 使用 1. 安装后重启 dsh，打开 设置 → UI 皮肤 切换皮肤与参数（配置持久化到浏览器 localStorage ）。 2. 「自定义」里可填网络地址，或点「选择图片/视频」从本地文件夹选取；拖动预览区裁剪位置、滚轮缩放；上传自动进「历史皮肤」；点「展开悬浮窗」弹出可拖动快捷面板。 3. 聊天框中可调用 skin list 查看皮肤清单。 皮肤清单 id 名称 类型 说明 none 无 — 不使用背景（原版 UI） custom 自定义 壁纸 / 视频 网络地址，或从本地文件夹选择图片 / 视频文件 目录结构 能力 - Host 半体 ： skin list 只读工具（列出皮肤清单）+ /dsh-ui-skin/skins 本地路由。 - Client 半体 ：背景层引擎（壁纸 / 视频，支持拖动裁剪缩放）+ 毛玻璃（ ctx.theme.overrideTokens() 半透明表面，覆盖整个界面含侧栏）+ 历史皮肤记录 + 可拖动悬浮窗 + 「设置 → UI 皮肤」设置页。本地图片压缩后存 localStorage ，本地视频存 IndexedDB。 工作原理 - 背景层 ： 固定层， z-index:0 、 pointer-events:none ，插入 document.body 首部，位于页面背景之上、UI 内容之下。 - 毛玻璃透出 ：用官方扩展点 ctx.theme.overrideTokens() 把 DSH 表面 token（ --dsw-alias-bg- 、 --dsw-specific-sidebar-fill 等）烘焙为半透明 rgba，让壁纸从整个界面（含侧栏）透出；切回「无」时回收覆盖。 - 裁剪缩放 ： transform: scale() + transform-origin 联动—— scale 放大图片， transform-origin 决定露出哪个区域。注意不能用 background-position ，它在 cover 下横向裁剪余量趋近 0（拖不动）。 - 存储 ：配置与图片历史存 localStorage （图片压缩为 1920px JPEG）；视频 Blob 存…

分类