lsaa4/dsh-custom-ui 预览 preview

lsaa4/dsh-custom-ui

Plugin插件 Native原生 ⭐ 4 UI & Themes界面与主题

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

catalog descriptioncatalog 简介 / catalog description:毛玻璃风格DSH主题,含壁纸、字体定制与网易云音乐

Project Overview项目介绍

dsh-glass-ui is a native theme plugin built exclusively for the DeepSeek Harness (DSH) Web interface. It can be installed in two common ways: either run dsh plugin --profile web add github:lsaa4/dsh-custom-ui to install directly from GitHub, or install the published npm package via the same dsh plugin command. After installation, you just need to restart dsh web and navigate to the custom UI settings panel to start customizing your interface. The plugin comes with a range of features including adjustable frosted glass transparency and blur, custom font support, static and dynamic background options, and built-in NetEase Cloud Music playback with scrolling lyrics.

This plugin is designed for any DSH user who wants to personalize their Web interface and get a unique, modern frosted glass visual effect. The workflow is straightforward after installation: you open the settings menu from the bottom left corner, enter the custom UI panel, and start dragging the sliders to adjust transparency and blur in real time. You can choose from preset fonts, upload your own font file in common formats like woff2 and ttf, or set your own background with multiple auto-rotating images or a dynamic video wallpaper. All changes are saved automatically, so you do not need to manually save or apply changes every time you tweak a setting.

The plugin is released under the open source MIT license, which allows free use and modification. It automatically persists configurations to $DSH_HOME/data/glass-ui/config.json and runs garbage collection on uploaded media files to clear unused assets, and it will automatically restore the default DSH appearance after you uninstall the plugin. There are several known limitations to note: exported configurations do not include the media files themselves, so you need to reupload assets when importing on another device; dynamic video wallpapers are capped at 1GB file size; and only the last activated theme will work if multiple themes are installed at the same time.

这是一款专为 DeepSeek Harness (DSH) Web 端打造的原生毛玻璃 UI 主题插件,仅面向 DSH 平台开发,不对原有界面布局做任何修改。用户可通过 dsh plugin 命令从 GitHub 或 npm 完成安装,安装后重启 dsh web 即可进入设置界面的自定义UI设计面板开始调节。插件核心功能包括可实时调节的毛玻璃透明度与模糊效果,支持自定义字体、静态多图轮播/动态视频背景壁纸,还内置网易云音乐播放、自定义CSS、配置一键导出导入等功能,所有修改都即时生效。

这款插件适合想要自定义 DSH Web 界面外观、追求个性化视觉效果的用户。使用流程非常简单:打开左下角设置图标,进入侧边栏的自定义UI设计面板,拖动透明度和模糊滑块即可实时预览并调整效果;你可以选择预设字体,也能上传自定义字体文件,还可上传图片或视频作为背景,支持多图轮播、遮罩和多种铺放方式,设置好的参数会自动保存,下次打开直接生效。如果使用网易云音乐功能,扫码或粘贴Cookie登录后即可播放音乐查看滚动歌词。

该插件采用 MIT 许可证开源,配置自动持久化保存在 $DSH_HOME/data/glass-ui/config.json,上传的媒体文件会自动垃圾回收,卸载后自动恢复默认外观。已知限制包括:主题变量无完整性校验,大分辨率动态壁纸请控制体积在1GB以内,多个主题插件同时激活时仅最后一个生效,配置导出不包含媒体文件本身,跨设备使用需重新上传素材,网易云音乐部分歌曲受版权VIP限制无法播放。开发可使用 pnpm 完成安装构建,支持热更新,方便开发者进行二次开发与定制。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 lsaa4/dsh-custom-ui 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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 安装

dsh plugin --profile web add github:lsaa4/dsh-custom-ui

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

从 npm 安装

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

卸载

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

重启后界面恢复默认。

使用

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

开发

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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-web-search-provider 下一个 Next dsh-file-drop →