wangkaxds / dsh-aurora-wallpaper

🔥 你的 AI 界面背景 = Steam 工坊动态壁纸

Wallpaper Engine 的场景壁纸，原汁原味搬进 DeepSeek Harness 网页界面。

别人家的 AI 界面是灰底白字；你的界面背景是心爱的角色在你聊天框后面呼吸，发丝随风水波荡漾。这不是视频回放——这是壁纸引擎的场景文件被真·重新渲染：每一层图层、每一条效果链、每一个 HLSL 着色器，都被实时翻译成 GLSL 在你的 GPU 上跑。

Steam 工坊 40 万张动态壁纸，从今天起都是你的聊天背景。 视频壁纸？零转码直连。场景壁纸？浏览器原生渲染。一个插件全都要。

---

⚡ 一分钟上手

1. DeepSeek Harness → cordis 插件面板，装载 src/host.js + src/client.js
2. src/host.js 里把 workshopDir 指向你的 WE 工坊目录
3. 刷新页面 —— 背景活了（自动扫描、自动排序、记住你的选择）

📖 保姆级教程：docs/INSTALL.zh.md

✨ 能力清单

能力	说明
🎬 视频壁纸直连	自动扫描工坊目录、读取真实标题，4K 原画 + Range 流式，零转码零拷贝
🧩 场景壁纸原生渲染	scene.pkg 图层/旋转/缩放/效果链/着色器全部实时重现——不是预览图凑合
🔁 HLSL→GLSL 实时转译	自研转译器逐字翻译 WE 效果 shader，修一处全场景受益
🎯 视频纹理层	TEXV 容器内嵌 MP4 直接当图层纹理（录屏类场景主视觉）
🧬 父子层级	部件挂接自动合并世界坐标，头发眼睛各就各位
🖱️ 鼠标视差	cameraparallax + parallaxDepth 原参数还原，近景远景分层漂移
🖼️ 雾面玻璃 UI	半透明纱罩 + 顶部渐深 + 底部柔暗，壁纸透光文字清晰
🎨 主题系统	「动态壁纸·暗/亮」与内置明暗共存，设置面板一键切换
⚡ 性能档位	均衡 60fps / 省电 30fps / 低配 30fps+效果降采样，窗口失焦自动暂停渲染，选完即生效
🧠 状态记忆	选择持久化、多页面同步、刷新不丢
🔍 内置诊断	演示器（真实渲染帧率）+ WebGL 环境诊断页

🏗️ 技术内幕

• 通用 pass 管线：copy → 效果链（FBO 乒乓）→ 合成，与 WE 引擎同构，任何场景同一套路；
• 引擎语义级对齐：y = H - origin.y、旋转取负、纹理槽 MASK combo、清屏色……逐条对照引擎源码；
• 修复级转译器：隐式类型转换（1 - g_Rough 也不放过）、行向量 mul、标量广播、精度统一、标识符保护；
• 中文场景名：pkg 条目名 UTF-8 解码，中文名场景不再白屏；
• 不完整 mip 链自救：WE 容器有时只存部分 mip 级（WebGL 采样恒黑），自动补齐——这坑全网没几篇文档提过。

📦 独立开源引擎：we-scene

场景渲染引擎是独立 ES 模块，已单独开源 wangkaxds/we-scene：

• pkg/ —— scene.pkg 容器、TEX 纹理解码（DXT1/3/5、RG88、R8、LZ4…）、视频容器
• render/hlsl2glsl.js —— HLSL→GLSL 转译器，开箱即用
• render/renderer.js —— 通用 pass 管线渲染器（WebGL2）
• scene/ —— 场景解析（父子层级、效果链、视差）

想把 WE 场景塞进你自己的网页？拿走 we-scene，一行 import 的事。

🗺️ 支持矩阵

• ✅ 视频壁纸、2D 场景（图层 + 效果链 + 父子层级 + 视差 + 视频纹理）
• 🔜 粒子系统、3D 模型、组件（时钟/天气）、文字对象、声音
• 📄 疑难场景分析：docs/SCENE_LOAD_FAILURE_REPORT.md

🛠️ 排错速查

• 背景没出现：Ctrl+F5；确认浏览器硬件加速开启（edge://gpu → WebGL 必须是 Hardware accelerated——CPU 软件渲染会让场景卡成幻灯片，这不是插件的问题）
• 场景切换异常 / 白块 / 黑屏：均已修复（shader 缓存串用、空层白兜底、mip 链不完整），复现请报 Issue
• 调口味：src/client.js 里的主题 token

💬 社区

🐛 Issues · 💬 Discussions · 🧭 仓库带 dsh-plugin 标签

📄 许可

MIT —— 见 LICENSE。仓库只含代码，不含任何壁纸素材。

👥 贡献者

• 网卡小电视 —— 需求、设计、素材与验收
• DeepSeek AI —— 插件与渲染引擎实现