z21for99/silk-background 预览 preview

z21for99/silk-background

Desktop桌面端 Native原生 ⭐ 4 NOASSERTION Clients & Launchers客户端与启动器UI & Themes界面与主题

DSH Web GUI 客户端插件:WebGL 丝绸动态背景 + 全站玻璃化皮肤(官方主题 token 覆盖,零依赖) | DeepSeek Harness Web GUI 的 WebGL 丝绸着色器背景与玻璃拟态皮肤

Project Overview项目介绍

This is a native theme and background plugin built exclusively for the DSH Web GUI. It adds a dynamic WebGL-powered silk background with pointer-following distortion effects and a full-site glassmorphism UI theme to DSH’s web interface. The plugin follows DSH’s official web-profile plugin mechanism, so it does not require modifying any of DSH’s core source code or frontend assets, and your original interface will be restored immediately after you uninstall the plugin. It offers three configurable modes: off, dim (the default, optimized for readability), and vivid (for a more prominent silk background).

The plugin is designed for DSH users who want to customize the visual experience of their web client. After installation, you only need to restart your DSH web service for the plugin to take effect. You can cycle through the three modes by clicking the round button in the lower right corner of the interface. Clicking the gear icon above the button opens a dedicated settings panel, where you can adjust the animation speed and intensity of the silk background, choose from 7 preset color schemes, or use a custom RGB color picker. All your settings are saved in your browser’s localStorage, so they persist across page reloads.

The plugin itself has zero runtime dependencies, as it is built purely with browser JavaScript and WebGL, and requires no build steps to run. You will need a version of DSH that supports web profiles, plus pnpm and git for the recommended installation via the DSH plugin command. It is licensed under the open-source MIT license, and the original Silk shader comes from 21st.dev Shader Builder, which is subject to 21st.dev’s terms of service. It automatically pauses rendering when the page is not visible to save power, and also adapts to the system’s prefers-reduced-motion setting for accessibility.

这是一款专为 DSH Web GUI 开发的原生客户端插件,可为 DSH 添加基于 WebGL 实现的带指针跟随交互的动态丝绸背景和全站玻璃化视觉皮肤。它遵循 DSH 官方的 web-profile 插件开发机制,无需修改 DSH 任何源码或前端产物,卸载即可恢复原有界面,提供关闭、柔和(默认,优先保证可读性)、高亮三种模式可选。

本插件面向想要个性化定制 DSH Web 客户端视觉效果的用户,安装完成后只需重启 DSH Web 服务即可生效。用户可通过界面右下角的圆形按钮循环切换背景模式,点击按钮上方的设置图标即可打开独立面板调整丝绸动效速度、强度,还能选择预设配色或自定义 RGB 取色,所有设置都会保存在浏览器本地存储中。

本插件本体零运行时依赖,仅需支持 web profile 的 DSH 版本即可运行,安装过程需要 pnpm 和 git 工具。支持自动在页面不可见时暂停渲染节省电量,也适配了减少动效的系统设置,采用 MIT 许可证开源,其中 WebGL 丝绸着色器来自 21st.dev Shader Builder,使用需遵守其条款。可通过 git 命令或手动离线方式安装,卸载也十分简便。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
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 github:z21for99/silk-background

把 z21for99/silk-background 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

🧵 silk-background

dsh Web GUI 客户端插件:WebGL "Silk" 丝绸着色器动态背景 + 全站玻璃化皮肤。

基于官方 web-profile 插件机制(dsh.client 声明 + bundle patch 层)实现, 不修改 dsh 任何源码或前端产物,卸载即还原。

dsh-plugin version license dependencies platform


🖼️ 预览

silk-background 效果展示 1 silk-background 效果展示 2

✨ 特性

视觉

  • 🎨 WebGL Silk 着色器(21st.dev Shader Builder):全屏动态丝绸纹理,指针跟随/扭曲
  • 🖥️ 自适应分辨率与 2M 像素预算,页面不可见时自动停渲染(省电)
  • 🌗 三模式:off / dim(默认,可读性优先玻璃)/ vivid(高亮丝绸)

主题

  • 🧊 全站玻璃化:通过 dsh 官方 theme 服务的 overrideTokens 注册 alias token 覆盖层 (--dsw-alias-bg-base、--dsw-alias-bg-layer-1/2、--dsw-specific-sidebar-fill,亮/暗两套值)
  • 🔄 主题重同步与亮暗切换自动保持,无需逐元素 DOM 手术(v4)

控制

  • 🔘 右下角圆形按钮一键循环切换模式,选择持久化在 localStorage
  • ⚙️ 独立设置面板:速度/强度滑杆、7 套配色、4 色 RGB 取色板,全部持久化

健壮性

  • ♿ prefers-reduced-motion 适配
  • 🛡️ WebGL 上下文丢失/恢复、主题重同步自愈

调试

  • 🐞 URL 加 ?silk-debug 打开状态面板;控制台可用 window.__dshSilk (mode / engineStatus / setMode(m))

📦 依赖

插件本体零运行时依赖(纯浏览器 JS + WebGL,无需构建步骤)。

工具 用途 说明
dsh 宿主 任意支持 web profile 的版本(dsh web 命令)
pnpm 安装器 dsh plugin 内部把参数转发给 profile 目录下的 pnpm
git 拉取源码 仅 github: / git+ 安装方式需要

🚀 安装(git 方式,推荐)

# 从 GitHub 仓库安装(dsh plugin 会自动把本包加入 profile 的 bundle 层)
dsh plugin --profile web add github:z21for99/silk-background

# 或锁定到某个 tag/commit
dsh plugin --profile web add "git+https://github.com/z21for99/silk-background.git#v0.4.0"

# 重启 web 让新 profile 生效(端口按需改)
dsh web --port 17890

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

← 上一个 Prev deepseek-kanban-plugin 下一个 Next dsh-balance →