dsh-glass-ui

为 DeepSeek Harness (DSH) Web 打造的毛玻璃 UI 主题插件：整体布局保持原样，风格替换为透明毛玻璃；在 设置 → 自定义UI设计 中可实时调节。

功能

毛玻璃风格：界面表面半透明 + 背景模糊（背景层 filter: blur，不改动布局层级，安全无副作用）
透明度滑块：玻璃透明度 10%–95% 实时调节
模糊滑块：背景模糊半径 4–40px 实时调节
自定义字体：预设字体 + 任意字体族输入 + 上传字体文件（woff2/woff/ttf/otf，自动注入 @font-face）
背景壁纸：上传图片（jpg/png/webp/gif/avif）或动态壁纸视频（mp4/webm/mov，≤1GB，流式写入磁盘，<video> 自动循环播放）
背景模式：无背景 / 图片背景 / 动态壁纸三选一；图片支持多图轮播（可调间隔）、遮罩（暗化提高可读性）与三种铺放方式（铺满 / 完整显示 / 原始大小），切换平滑过渡
网易云音乐：扫码或 Cookie 登录、我的歌单 / 每日推荐 / 热门歌单 / 搜索、播放队列，输入框信息栏实时显示滚动歌词（位置可调：信息栏内 / 最右 / 隐藏）；支持 HTTP/SOCKS 代理与远程 API 服务器两种绕风控方案
柔和动画：界面渐渐显现、交互过渡温柔平滑（无 / 轻柔 / 明显三档，支持 prefers-reduced-motion）
自定义 CSS：高级用户可粘贴任意样式，即时生效并自动保存
配置分享：一键导出 / 导入配置 JSON
首屏无闪烁：host 端在 index.html 注入已保存的配置，刷新页面立即呈现玻璃效果
配置持久化于 $DSH_HOME/data/glass-ui/config.json；上传的媒体由 host 自动垃圾回收（未被配置引用的文件会被清理），卸载插件后自动恢复默认外观

安装

从 GitHub 安装（无需发布 npm）

dsh plugin --profile web add github:<你的用户名>/<仓库名>

本仓库已提交构建产物（lib/ + client/），安装无需构建脚本、无交互。若从源码安装（未提交产物），pnpm ≥10 会拦截构建脚本，需在 profile 的 pnpm-workspace.yaml 中 allowBuilds 后重跑。

重启 dsh web，打开 设置 → 自定义UI设计 即可开始调节。

从 npm 安装（发布后）

dsh plugin --profile web add dsh-glass-ui

卸载

dsh plugin --profile web remove dsh-glass-ui

重启后界面恢复默认。

使用

打开设置（左下角齿轮）→ 侧边栏 自定义UI设计
拖动 透明度 / 模糊 滑块，实时预览毛玻璃效果
字体：点选预设，或输入自定义字体族，或上传字体文件
背景壁纸：选择无/图片/动态壁纸，上传你的素材；图片可多张轮播
网易云音乐：扫码登录（或粘贴网页版 Cookie），浏览歌单 / 每日推荐 / 热门歌单 / 搜索后点击歌曲即播放，歌词实时显示在输入框信息栏
所有修改即时生效、自动保存（状态显示"已保存"）

开发

pnpm install
pnpm typecheck
pnpm build          # tsc (host) + tsdown (client) + __ModuleLoader__ 包装

本地安装到 web profile：

cd "$DSH_HOME/profiles/web"
pnpm add "link:<本仓库绝对路径>"
# 然后把 "dsh-glass-ui" 追加进 package.json 的 dsh.profile.bundles

迭代 client 时可 npx tsdown --watch，页面经 dsh-client-hmr 热更新；修改 host 或 manifest 后需重启 dsh web。

技术要点

机制	说明
浏览器半契约	`window.__ModuleLoader__.load({ id, factory })`，导出 `name` / `inject` / `apply(ctx)`
表面透明化	`ctx.theme.overrideTokens()` 把 `--dsw-alias-bg-` 等覆盖为 `var(--glass-surface-)`（值跟随 :root 变量，滑块只改变量）
玻璃模糊	背景层 `filter: blur(var(--glass-blur))` + 表面半透明 —— 刻意不用 `backdrop-filter`（它会改变 `#root` 的 containing block，破坏内部 fixed 元素布局）
壁纸切换	图片双缓冲交叉淡入淡出；视频先用隐藏 probe 预载到 `loadeddata` 再淡入（避免黑闪），旧视频随后释放
配置持久化	host 半路由 `GET/PUT /glass-ui/config`，原子写入 `$DSH_HOME/data/glass-ui/config.json`
媒体上传	`POST /glass-ui/media`（raw body + `x-media-kind`），白名单校验类型/扩展名/大小，流式落盘；`GET/HEAD/DELETE /glass-ui/media/<file>` 流式服务与删除；保存配置与启动时自动 GC 未引用文件
首屏引导	`webServer.tapIndex()` 注入 `<style id="dsh-glass-ui-boot">`，刷新无闪烁
网易云代理	`POST /netease/weapi`（AES+RSA 加密）、`/netease/lyric`、`/netease/hot-playlists`、`/netease/search`、`/netease/song-url`、`/netease/account`、`/netease/logout`、`/netease/cookie`；直连被墙时可配 HTTP/SOCKS 代理或远程 NeteaseCloudMusicApi 服务器
动画	`body.dsh-glass-anim-*` 门控的渐显/过渡，尊重 `prefers-reduced-motion`

已知限制

主题 token 覆盖无完整性校验（DSH 官方标注）：漏覆盖的变量回退内置值
动态壁纸为全屏视频背景，大分辨率视频请控制体积（上限 1GB）
多主题插件并存时由最后激活者生效；设置面板提供"恢复默认"一键还原
token 名称随 DSH 版本迭代可能微调，升级 DSH 后如配色异常请重新构建
网易云歌曲直链受版权/VIP 限制，不可播的歌曲会提示并跳过
导出/导入配置只含 URL 引用，不含媒体文件本身（跨机器导入需重新上传素材）

License

MIT

dsh-glass-ui

Cài đặt

Mã nguồn

Thẻ

Tác giả

Readme

dsh-glass-ui

功能

安装

从 GitHub 安装（无需发布 npm）

从 npm 安装（发布后）

卸载

使用

开发

技术要点

已知限制

License