huguangyu666/dsh-plugin-backdrop

README 摘要

dsh-plugin-backdrop — DeepSeek Harness 动态背景插件 把 DeepSeek Harness 官网 hero 的完整氛围（ 流体 + 平滑鲸鱼 + 发光鱼群 + 点线网格 ） 注入 dsh Web UI 作为动态背景。当前实现为混合渲染： - 流体背景沿用 WebGL2（原官网 GLSL 逆向） - 鲸鱼 / 鱼群使用 Canvas 2D 预渲染精灵，全分辨率平滑渲染 - 点线网格沿用 Canvas 2D 完整技术原理见 docs/ARCHITECTURE.md ； 新版 Canvas 渲染说明见 docs/CANVAS RENDERING.md 。 目录 - 效果一览 - 安装启用 - 配置 - 调试 API - 工作原理 - 常见问题 FAQ - 开发指南 - 踩坑记录 - 文件结构 - 已知限制 效果一览 截图： docs/screenshot.png （效果预览，可用浏览器 F12 对 3090 实例截图后放入）。 - 流体背景 ：WebGL2 flowmap 双缓冲 + fbm/curl-noise 域扭曲，5 层深蓝-暖金渐变， 自发光 bloom + 虚拟光源（跟随鼠标 X）+ 颗粒噪点 + 暗角 - 路径复刻鲸鱼 ：视频抽帧的游动动画（35 帧字符画， 6fps）， 整只鲸鱼在界面里水平无缝漫游、上下呼吸浮动、气泡； 循环接缝赛博朋克故障 ：视频末帧与首帧不重合（循环重启会"拉回"）， 在接缝瞬间自动打一个故障爆发（白闪 + RGB 色差 + 横条撕裂 + 品红残影 + 掉帧跳变 + 扫描线 + 噪点）把位置跳变盖住——曲线救国式赛博朋克转场 - 发光鱼群 ：55 条预渲染平滑鱼形精灵（4 配色 × 6 帧尾摆）， 鱼群中心弧线漫游，鱼在群内绕圈跟随；带转弯侧倾、呼吸缩放、深度透明、气泡 - 点线网格 ：90px 点阵 + 邻点连线 + 鼠标波纹推开（canvas 2D） - UI 融入 ：dsh 页面级容器透明化（已知类名 + 全视口扫描 fallback）， 强制 dsh 官方暗色主题保证文字可读性（实测对比度 9 19:1） - 性能 ：四层全部 30fps 节流 + 视口外停帧 + 静止自停 + dpr 上限 1.5 安装启用 推荐直接用官方安装命令 （一条命令，自动挂载，见方式 ①）。 本地改代码想立即生效再看方式 ②；方式 ③ 是官方命令不可用时的备份。 方式 ①：官方安装（推荐给所有用户） 插件已发 npm，且包内声明了 dsh.bundle.patch （ cordis.patch.yml ）与 dsh.client.platform: web ，所以能用 dsh 官方插件管理命令直接装： 装完 重启 dsh （重启会断开当前会话，挑空闲时操作）刷新页面即可。 官方命令内部会跑 pnpm ，…

分类