dsh-shadertoy-skin 0.2.1 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +124 -90
- package/THIRD-PARTY-NOTICES.md +33 -0
- package/client.js +22 -0
- package/native-dist/defaults.json +1 -1
- package/native-dist/panel.html +129 -30
- package/native-dist/player.html +64 -12
- package/native-dist/presets/index.json +26 -3
- package/native-dist/presets/mario-sound.glsl +199 -0
- package/native-dist/presets/mario.glsl +84 -0
- package/native-dist/presets/seascape.glsl +248 -0
- package/package.json +6 -2
package/README.md
CHANGED
|
@@ -8,11 +8,24 @@
|
|
|
8
8
|
|
|
9
9
|
Realtime [ShaderToy](https://www.shadertoy.com/) background skin for DeepSeek Harness (desktop & web): a zero-runtime-dependency WebGL2 player, a background library, and a translucent glass shell.
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
11
|
+
> **推荐去 [www.shadertoy.com](https://www.shadertoy.com/) 逛逛** —— 插件自带的 5 个预设只是开胃菜。ShaderToy 上有几万个社区作品（搜 `background`、`seascape`、`raymarching` 这类关键词，或在 Browse 里按分类翻），挑喜欢的装进「背景库」、按自己的口味调亮度 / 速度 / 代码，就是一张专属桌面。
|
|
12
|
+
> **改好了欢迎分享**：截图、参数、改进思路都可以提到 [Issues](https://github.com/zdjmrq/dsh-shadertoy-skin/issues)，或者直接 PR（作品代码要看原作者的许可证，默认 CC BY-NC-SA 3.0：署名、非商业、同样方式共享；本仓库自写代码是 MIT，两个第三方预设按各自许可证收录）。
|
|
13
|
+
> **欢迎 issue 和 PR**：装不上、画面不对、想要新功能 → 开 [Issue](https://github.com/zdjmrq/dsh-shadertoy-skin/issues)（附截图和 `$DSH_HOME/shader-skin.json` 里对应条目更好排查）；bug 修复、文档修正、自写预设 → 直接提 [PR](https://github.com/zdjmrq/dsh-shadertoy-skin/pulls)。
|
|
14
|
+
>
|
|
15
|
+
> **Recommended: browse [shadertoy.com](https://www.shadertoy.com/)** — import any piece into the background library, tune it to your taste, and feel free to share screenshots, settings or improvements via Issues / PRs.
|
|
16
|
+
|
|
17
|
+
https://github.com/user-attachments/assets/c8801ca1-e96e-4bfe-83bc-6e99b5551cf4
|
|
18
|
+
|
|
19
|
+
*演示 1 · 像素马里奥：静态画 + 一首歌 —— 音乐「只播一次」，放完画面常驻*
|
|
20
|
+
|
|
21
|
+
https://github.com/user-attachments/assets/001acdf6-90e2-4b2c-85fc-e9d076678597
|
|
22
|
+
|
|
23
|
+
*演示 2 · [Seascape](https://www.shadertoy.com/view/Ms2SD1)（© TDM，CC BY-NC-SA 3.0）的个人修改版：摄像机抬到近地轨道，只留海面 —— 已作为内置预设「海面（Seascape）」随插件提供*
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
|
|
14
27
|
|
|
15
|
-
>
|
|
28
|
+
> 视频与截图里的 ShaderToy 作品版权归原作者：像素马里奥「Mario」（© Inigo Quilez）、Seascape（© Alexander Alekseev aka TDM），两者均以 **CC BY-NC-SA 3.0** 收录为内置预设（非 MIT，见文末许可证）。**视频与截图仅作效果展示**，插件自写代码仍是 MIT。
|
|
16
29
|
|
|
17
30
|
## 名字 / 包名（认准这两个）
|
|
18
31
|
|
|
@@ -27,6 +40,85 @@ npm 包名**没有 scope、也不带作者用户名**：不是 `@zdjmrq/dsh-shad
|
|
|
27
40
|
npm view dsh-shadertoy-skin version # 确认 npm 上真实存在的版本
|
|
28
41
|
```
|
|
29
42
|
|
|
43
|
+
## 从 ShaderToy 装一个作品
|
|
44
|
+
|
|
45
|
+
插件自带 5 个预设（3 个自写 MIT + 2 个第三方 CC BY-NC-SA 3.0，见文末许可证），但真正好玩的是把你喜欢的 ShaderToy 作品装进来。**三种做法，任选一种：**
|
|
46
|
+
|
|
47
|
+
> **推荐一试**：[`shadertoy.com/view/4dfXWj`](https://www.shadertoy.com/view/4dfXWj) —— 装进来效果挺带感，导入方式见下面任意一种。
|
|
48
|
+
> 这只是个起点：**大家完全可以根据自己的喜好随便挑别的作品，也可以自己写着色器**（写好了走同样的导入流程）。ShaderToy 作品的许可证由原作者决定（默认 CC BY-NC-SA 3.0）：装在本机自己玩没问题；想提交进仓库或随包分发，先确认许可证允许，并带上署名与相同许可证（本仓库的两个第三方预设就是这么收录的）。
|
|
49
|
+
|
|
50
|
+
### 1. 粘贴代码（最稳，不用抓网页）
|
|
51
|
+
|
|
52
|
+
1. 打开作品页 `https://www.shadertoy.com/view/xxxxxxxx`，右上角 **Shader** 页签；
|
|
53
|
+
2. 全选 `Image` 页签里的代码（如果作品用了 `Common`，把 Common 里的函数一起复制到开头；用了 Buffer 的作品暂不支持）；
|
|
54
|
+
3. 回到插件设置页 → **背景库** → 「粘贴 ShaderToy 代码」→ 填名字 → 粘进 `Image 代码` → **加入背景库**；
|
|
55
|
+
4. 列表里点 **使用** 即可，参数会即时生效。
|
|
56
|
+
|
|
57
|
+
带声音的作品（代码里有 `mainSound`）把声音代码粘进 `Sound 代码`，切到它时会出声。声音签名支持这四种：
|
|
58
|
+
|
|
59
|
+
```glsl
|
|
60
|
+
vec2 mainSound(float time) // 立体声
|
|
61
|
+
float mainSound(float time) // 单声道（自动复制到左右）
|
|
62
|
+
vec2 mainSound(int samp, float time) // 带采样序号
|
|
63
|
+
float mainSound(int samp, float time) // 单声道 + 采样序号
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
如果出声被浏览器拦住，点一下界面任意位置即可解锁（面板音量那一行也会提示）。
|
|
67
|
+
|
|
68
|
+
### 2. 让 AI 帮你装（一条指令，把网址填进去就行）
|
|
69
|
+
|
|
70
|
+
复制下面这段，把第一行的网址换成你要的作品链接，发给 DeepSeek Harness（或任何能操作文件的 AI）：
|
|
71
|
+
|
|
72
|
+
```text
|
|
73
|
+
帮我给 DeepSeek Harness 装一个 ShaderToy 背景皮肤。
|
|
74
|
+
|
|
75
|
+
插件：dsh-shadertoy-skin（npm 包名就是 dsh-shadertoy-skin，GitHub: https://github.com/zdjmrq/dsh-shadertoy-skin）
|
|
76
|
+
如果还没装：桌面版走「插件 → 添加插件 → 填 dsh-shadertoy-skin → 装完完全退出并重启客户端」；命令行用 dsh plugin --profile desktop add dsh-shadertoy-skin。
|
|
77
|
+
|
|
78
|
+
要装的作品链接：<把你复制的 https://www.shadertoy.com/view/xxxxxxxx 粘在这里>
|
|
79
|
+
|
|
80
|
+
做法：
|
|
81
|
+
1. 打开上面的链接，拿到 Image pass 的 GLSL（若用了 Common，把 Common 的函数一起带上），以及可选的 mainSound。
|
|
82
|
+
2. 打开插件设置页（左栏「Shader 背景」）→ 背景库 → 「粘贴 ShaderToy 代码」：名字用作品名，Image 粘主代码，Sound 可空。
|
|
83
|
+
3. 导入后把它设为当前背景，确认背景真的渲染出来（不是黑屏、不是编译报错）；若报编译错误，按错误行号修好再试。
|
|
84
|
+
4. 如果页面抓不到代码（反爬/需要登录/只给 WebGL 不给源码），直接让我手动复制粘贴，不要猜代码。
|
|
85
|
+
5. 该作品的许可由原作者决定（ShaderToy 默认 CC BY-NC-SA 3.0）：只装在本机，不要提交进 git、不要随包发布。
|
|
86
|
+
|
|
87
|
+
装好后告诉我：装的是哪个作品、是否带声音、需不需要我调亮度/玻璃。
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
> AI 抓不到 ShaderToy 页面时（它经常挡爬虫），就走上面第 1 种的「手动粘贴」——一样能装好，而且不会有许可证问题。
|
|
91
|
+
|
|
92
|
+
### 3. 从本地目录导入（批量最方便）
|
|
93
|
+
|
|
94
|
+
把 `ShaderToy 导出的 JSON`、或直接是 `.glsl` / `.txt` 的代码文件放进：
|
|
95
|
+
|
|
96
|
+
```
|
|
97
|
+
$DSH_HOME/shader-skin/presets/ （Windows 默认 C:\Users\<你>\.dsh\shader-skin\presets\）
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
设置页 → 背景库 → 「从本地目录导入」→ 点 **导入**。这个目录不进包、不进 git。
|
|
101
|
+
|
|
102
|
+
## 参数与默认值
|
|
103
|
+
|
|
104
|
+
默认值集中在 [`native-dist/defaults.json`](native-dist/defaults.json)，面板读它来渲染选项与「恢复默认」，Host 用它做兜底——**改一个文件就能改默认值**。
|
|
105
|
+
|
|
106
|
+
| 参数 | 默认 | 可选 | 说明 |
|
|
107
|
+
|---|---|---|---|
|
|
108
|
+
| `enabled` | `true` | 开/关 | 关掉只移除背景层，设置页仍在 |
|
|
109
|
+
| `glass` | `60` (%) | 20–95 | 玻璃不透明度：界面压住背景的程度。越高文字越清晰、背景越淡；越低背景越透亮 |
|
|
110
|
+
| `brightness` | `100` (%) | 30–180 | 背景亮度（着色器输出乘数）。黄昏、夜景类作品看着太暗就调高 |
|
|
111
|
+
| `panels` | `opaque` | opaque / half / clear | 卡片、代码块、弹层、**聊天输入框**、编辑器表面的底色：不透明 / 半透明 / 透明。想让背景从框里透出来就调它 |
|
|
112
|
+
| `blur` | `0` px | 0–12 | 只在 > 0 时启用 CSS `filter` |
|
|
113
|
+
| `scale` | `1`× | 0.25 / 0.35 / 0.4 / 0.5 / 0.6 / 0.75 / 1 / 1.25 / 1.5 / 1.75 / 2 | 渲染分辨率倍率（DPR 上限 1.5）。下拉里**直接写实际分辨率**，例如 `1280 × 810（1×）`、`320 × 203（0.25×）`，窗口变大后这些数字会跟着刷新；显卡弱/想省电选 0.25–0.5×，追求锐利选 1.5–2× |
|
|
114
|
+
| `fps` | `30` | 15 / 20 / 30 / 60 | 渲染帧率上限；聊天时 30 足够 |
|
|
115
|
+
| `speed` | `1`× | 0–2 | 时间轴倍速 |
|
|
116
|
+
| `loop` / `loopSeconds` | `false` / `20` s | 开/关 · 5–120 s | **画面循环**：有的作品播一次就不动了，打开后每个周期把 `iTime` 归零重播（只重置画面，不影响声音）。带淡入淡出的作品（如马里奥）每轮会重新淡入，这是作品本身的效果 |
|
|
117
|
+
| `audioMode` / `audioSeconds` | `loop` / `60` s | loop / once · 10–600 s | **音乐播放方式**：ShaderToy 的曲子是有长度的（播完就静音），所以 `loop` = 每到「音乐时长」就把音乐时间轴归零重放（接缝有 40 ms 淡入淡出）；`once` = 放完「音乐时长」就停、**画面继续常驻**（马里奥这种静态图 + 一首歌正合适） |
|
|
118
|
+
| `volume` / `muted` | `60` / `false` | 0–100 / 开/关 | 带 `mainSound` 的作品默认出声；浏览器可能拦截自动播放，点一下界面任意位置即可解锁 |
|
|
119
|
+
|
|
120
|
+
> 两个滑块的分工：**玻璃不透明度**控制「界面压暗多少」，**背景亮度**控制「画面本身多亮」。前者影响可读性，后者只影响画面。背景看着黑，先加亮度；文字看着花，再加玻璃。
|
|
121
|
+
|
|
30
122
|
## 状态
|
|
31
123
|
|
|
32
124
|
渲染器、插件骨架、设置页、背景库、音频都已完成，剩下的是增强项：
|
|
@@ -38,13 +130,15 @@ npm view dsh-shadertoy-skin version # 确认 npm 上真实存在的版本
|
|
|
38
130
|
- [x] 玻璃壳：外壳表面（AppFrame / 侧栏 / 页面容器）全透明，**暗色滤镜只由播放器画一层**（`tintMix`），不再靠多层半透明 token 叠出来（叠 N 层会把背景压到几乎全黑，旧版就栽在这）
|
|
39
131
|
- [x] 设置页：**左栏一行「Shader 背景」→ 主区域整页**（不是弹窗），带页头、参数 / 背景库 / 代码三个页签
|
|
40
132
|
- [x] **参数**：启用、作品切换、玻璃不透明度、背景亮度、卡片透明度、模糊、分辨率、帧率、速度、**画面循环**、**音乐只播一次**、音量/静音、本背景恢复默认
|
|
41
|
-
- [x] **音乐只播一次**：放完设定时长就停，画面继续常驻（适合马里奥这种静态图 + 一首歌）；`loop`
|
|
133
|
+
- [x] **音乐只播一次**：放完设定时长就停，画面继续常驻（适合马里奥这种静态图 + 一首歌）；`loop` 则是按「音乐时长」把音乐时间轴归零重放，有限长度的曲子也能一直循环
|
|
42
134
|
- [x] **画面循环**：有些作品播一次就停住，可设周期把 `iTime` 归零重播（只重置画面）
|
|
43
135
|
- [x] 设置页配色改用 **DSH 品牌蓝**（亮色 `#3568dc` / 暗色 `#7aaaff`），小字号数值也清楚
|
|
44
136
|
- [x] **背景库**：内置 + 我的背景列表、切换、改名、删除；粘贴代码导入、文件导入（ShaderToy JSON / GLSL）、从 `$DSH_HOME/shader-skin/presets/` 导入
|
|
137
|
+
- [x] **随包 5 个预设**：自写的「极光 / 流体色带 / 脉冲」（MIT）+ 第三方「海面（Seascape）」「马里奥」（CC BY-NC-SA 3.0，署名/非商业/相同方式共享，背景库和下拉里带 `CC BY-NC-SA` 标）
|
|
45
138
|
- [x] **代码页**：查看当前运行作品的 Image / Sound 源码，直接改 → **保存并运行**（内置作品会自动另存为「我的副本」，原件不动；编辑器里 Ctrl/⌘+S 同样保存）
|
|
46
139
|
- [x] **iMouse 只在「按住左键 + 从空白处开始拖动」时驱动**：点按钮、拖滚动条、选中/复制回复文字都不会再带动背景；松手发一次释放（`iMouse.z < 0`）
|
|
47
140
|
- [x] **卡片透明度三档**（不透明 / 半透明 / 透明）：控制卡片、代码块、弹层、输入框、聊天输入栏的底色，让背景能透进这些「框」里
|
|
141
|
+
- [x] **AI 回复里的「白块」也跟着透**：改动文件头、交付物卡片、markdown 代码块、行内代码、消息气泡原本直接读静态中性色（亮色下是不透明白），现在跟 `panels` 同档 alpha —— 亮色主题下不会再出现「别的卡片都透、就这几块死白」
|
|
48
142
|
- [x] **每背景独立参数**（`overrides`）
|
|
49
143
|
- [x] **`mainSound` 音频**：4096 采样块 → `readPixels` → WebAudio 前瞻调度 + Gain/限幅，音量与静音实时生效
|
|
50
144
|
- [x] **音频签名全兼容**：ShaderToy 音频 pass 的四种写法都接受 —— `vec2`/`float` 返回值 × `(float time)`/`(int samp, float time)` 参数（单声道自动复制到左右；`samp` 传绝对采样序号）
|
|
@@ -54,26 +148,6 @@ npm view dsh-shadertoy-skin version # 确认 npm 上真实存在的版本
|
|
|
54
148
|
- [x] **启动自愈**：桌面端 client 插件行与服务是并发激活的，首次启动时 `theme`/`slots` 可能还没就绪（旧版因此「重启后要手动关开一次插件」）。现在服务现取 + 启动后 10 秒内多次自检（背景层缺失就重建、token 被重置就重设、播放器没 `ready` 就重发 init、侧栏没注册上就补注册），**装好重启即生效**
|
|
55
149
|
- [ ] 多 pass（Buffer A–D）、音频可视化回馈、兼容性静态体检
|
|
56
150
|
|
|
57
|
-
## 参数与默认值
|
|
58
|
-
|
|
59
|
-
默认值集中在 [`native-dist/defaults.json`](native-dist/defaults.json)，面板读它来渲染选项与「恢复默认」，Host 用它做兜底——**改一个文件就能改默认值**。
|
|
60
|
-
|
|
61
|
-
| 参数 | 默认 | 可选 | 说明 |
|
|
62
|
-
|---|---|---|---|
|
|
63
|
-
| `enabled` | `true` | 开/关 | 关掉只移除背景层，设置页仍在 |
|
|
64
|
-
| `glass` | `60` (%) | 20–95 | 玻璃不透明度：界面压住背景的程度。越高文字越清晰、背景越淡；越低背景越透亮 |
|
|
65
|
-
| `brightness` | `100` (%) | 30–180 | 背景亮度（着色器输出乘数）。黄昏、夜景类作品看着太暗就调高 |
|
|
66
|
-
| `panels` | `opaque` | opaque / half / clear | 卡片、代码块、弹层、**聊天输入框**、编辑器表面的底色：不透明 / 半透明 / 透明。想让背景从框里透出来就调它 |
|
|
67
|
-
| `blur` | `0` px | 0–12 | 只在 > 0 时启用 CSS `filter` |
|
|
68
|
-
| `scale` | `1`× | 0.5 / 0.75 / 1 / 1.25 / 1.5 | 渲染分辨率倍率（DPR 上限 1.5） |
|
|
69
|
-
| `fps` | `30` | 15 / 20 / 30 / 60 | 渲染帧率上限；聊天时 30 足够 |
|
|
70
|
-
| `speed` | `1`× | 0–2 | 时间轴倍速 |
|
|
71
|
-
| `loop` / `loopSeconds` | `false` / `20` s | 开/关 · 5–120 s | **画面循环**：有的作品播一次就不动了，打开后每个周期把 `iTime` 归零重播（只重置画面，不影响声音） |
|
|
72
|
-
| `audioMode` / `audioSeconds` | `loop` / `60` s | loop / once · 10–600 s | **音乐播放方式**：`loop` 一直放；`once` = 放完「音乐时长」就停、**画面继续常驻**（马里奥这种静态图 + 一首歌正合适） |
|
|
73
|
-
| `volume` / `muted` | `60` / `false` | 0–100 / 开/关 | 带 `mainSound` 的作品默认出声；浏览器可能拦截自动播放，点一下界面任意位置即可解锁 |
|
|
74
|
-
|
|
75
|
-
> 两个滑块的分工：**玻璃不透明度**控制「界面压暗多少」，**背景亮度**控制「画面本身多亮」。前者影响可读性，后者只影响画面。背景看着黑，先加亮度；文字看着花，再加玻璃。
|
|
76
|
-
|
|
77
151
|
## 要求
|
|
78
152
|
|
|
79
153
|
- DeepSeek Harness **0.2.x**（桌面版或 `dsh web`）
|
|
@@ -145,65 +219,6 @@ dsh plugin --profile web add dsh-shadertoy-skin@latest
|
|
|
145
219
|
|
|
146
220
|
`player.html` / `panel.html` / `defaults.json` 由 Host 半**按请求读盘（no-cache）**，手动改这些文件后刷新页面即可；但 `index.js` / `client.js`（Host 半 / Client 半）的改动必须重启对应进程：桌面 = 退出重开客户端，Web = 重启 `dsh web` 并刷新页面。
|
|
147
221
|
|
|
148
|
-
## 从 ShaderToy 装一个作品
|
|
149
|
-
|
|
150
|
-
插件自带三个 MIT 自写着色器，但真正好玩的是把你喜欢的 ShaderToy 作品装进来。**三种做法，任选一种：**
|
|
151
|
-
|
|
152
|
-
> **推荐一试**：[`shadertoy.com/view/4dfXWj`](https://www.shadertoy.com/view/4dfXWj) —— 装进来效果挺带感，导入方式见下面任意一种。
|
|
153
|
-
> 这只是个起点：**大家完全可以根据自己的喜好随便挑别的作品，也可以自己写着色器**（写好了走同样的导入流程）。ShaderToy 作品的许可证由原作者决定（默认 CC BY-NC-SA 3.0），装在本机自己玩没问题，但别把作品代码提交进仓库或随包再分发。
|
|
154
|
-
|
|
155
|
-
### 1. 粘贴代码（最稳，不用抓网页）
|
|
156
|
-
|
|
157
|
-
1. 打开作品页 `https://www.shadertoy.com/view/xxxxxxxx`，右上角 **Shader** 页签；
|
|
158
|
-
2. 全选 `Image` 页签里的代码（如果作品用了 `Common`，把 Common 里的函数一起复制到开头；用了 Buffer 的作品暂不支持）；
|
|
159
|
-
3. 回到插件设置页 → **背景库** → 「粘贴 ShaderToy 代码」→ 填名字 → 粘进 `Image 代码` → **加入背景库**；
|
|
160
|
-
4. 列表里点 **使用** 即可，参数会即时生效。
|
|
161
|
-
|
|
162
|
-
带声音的作品（代码里有 `mainSound`）把声音代码粘进 `Sound 代码`，切到它时会出声。声音签名支持这四种：
|
|
163
|
-
|
|
164
|
-
```glsl
|
|
165
|
-
vec2 mainSound(float time) // 立体声
|
|
166
|
-
float mainSound(float time) // 单声道（自动复制到左右）
|
|
167
|
-
vec2 mainSound(int samp, float time) // 带采样序号
|
|
168
|
-
float mainSound(int samp, float time) // 单声道 + 采样序号
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
如果出声被浏览器拦住，点一下界面任意位置即可解锁（面板音量那一行也会提示）。
|
|
172
|
-
|
|
173
|
-
### 2. 让 AI 帮你装（一条指令，把网址填进去就行）
|
|
174
|
-
|
|
175
|
-
复制下面这段，把第一行的网址换成你要的作品链接，发给 DeepSeek Harness（或任何能操作文件的 AI）：
|
|
176
|
-
|
|
177
|
-
```text
|
|
178
|
-
帮我给 DeepSeek Harness 装一个 ShaderToy 背景皮肤。
|
|
179
|
-
|
|
180
|
-
插件：dsh-shadertoy-skin（npm 包名就是 dsh-shadertoy-skin，GitHub: https://github.com/zdjmrq/dsh-shadertoy-skin）
|
|
181
|
-
如果还没装：桌面版走「插件 → 添加插件 → 填 dsh-shadertoy-skin → 装完完全退出并重启客户端」；命令行用 dsh plugin --profile desktop add dsh-shadertoy-skin。
|
|
182
|
-
|
|
183
|
-
要装的作品链接：<把你复制的 https://www.shadertoy.com/view/xxxxxxxx 粘在这里>
|
|
184
|
-
|
|
185
|
-
做法：
|
|
186
|
-
1. 打开上面的链接，拿到 Image pass 的 GLSL（若用了 Common，把 Common 的函数一起带上），以及可选的 mainSound。
|
|
187
|
-
2. 打开插件设置页（左栏「Shader 背景」）→ 背景库 → 「粘贴 ShaderToy 代码」：名字用作品名，Image 粘主代码，Sound 可空。
|
|
188
|
-
3. 导入后把它设为当前背景，确认背景真的渲染出来（不是黑屏、不是编译报错）；若报编译错误，按错误行号修好再试。
|
|
189
|
-
4. 如果页面抓不到代码（反爬/需要登录/只给 WebGL 不给源码），直接让我手动复制粘贴，不要猜代码。
|
|
190
|
-
5. 该作品的许可由原作者决定（ShaderToy 默认 CC BY-NC-SA 3.0）：只装在本机，不要提交进 git、不要随包发布。
|
|
191
|
-
|
|
192
|
-
装好后告诉我：装的是哪个作品、是否带声音、需不需要我调亮度/玻璃。
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
> AI 抓不到 ShaderToy 页面时（它经常挡爬虫），就走上面第 1 种的「手动粘贴」——一样能装好，而且不会有许可证问题。
|
|
196
|
-
|
|
197
|
-
### 3. 从本地目录导入（批量最方便）
|
|
198
|
-
|
|
199
|
-
把 `ShaderToy 导出的 JSON`、或直接是 `.glsl` / `.txt` 的代码文件放进：
|
|
200
|
-
|
|
201
|
-
```
|
|
202
|
-
$DSH_HOME/shader-skin/presets/ （Windows 默认 C:\Users\<你>\.dsh\shader-skin\presets\）
|
|
203
|
-
```
|
|
204
|
-
|
|
205
|
-
设置页 → 背景库 → 「从本地目录导入」→ 点 **导入**。这个目录不进包、不进 git。
|
|
206
|
-
|
|
207
222
|
## 改代码 / 微调作品
|
|
208
223
|
|
|
209
224
|
设置页第三个页签 **「代码」** 显示的就是**当前正在跑**的那份源码：
|
|
@@ -214,7 +229,7 @@ $DSH_HOME/shader-skin/presets/ （Windows 默认 C:\Users\<你>\.dsh\shad
|
|
|
214
229
|
| 改几行立刻看效果 | 改完点 **「保存并运行」**（或 Ctrl/⌘+S）：保存状态 → 播放器重新编译 → 画面即时更新；编译错误会显示在按钮下方（带行号） |
|
|
215
230
|
| 改坏了想还原 | 点 **「放弃修改」**，重新读取当前已保存的版本（想彻底恢复默认就去「参数 → 本背景恢复默认」，或从「背景库」重新导入） |
|
|
216
231
|
| 内置作品能改吗 | 能改，但内置文件是只读的：保存时会自动另存为 **「<原名>（我的副本）」** 并切过去运行，内置原件不动 |
|
|
217
|
-
| 代码框太小/太大 | 两个代码框（Image / Sound
|
|
232
|
+
| 代码框太小/太大 | 两个代码框（Image / Sound）下面都有一条**拖动把手**，上下拖动即可改高度（把手指到把手上按 ↑/↓ 也行）；调整后的高度会记住（下次打开还是这个高度） |
|
|
218
233
|
|
|
219
234
|
> 注意：ShaderToy 的 WebGL2 着色器语言是 ESSL 3.00，**不支持 `precise` 限定符**（那是 GLSL 4.0 / ESSL 3.20 的东西，ShaderToy 的 Vulkan 后端才有）。需要「共享晶格点必须同哈希」这类修复时，用**整数哈希**（`uint` + 位混合）代替 `precise`——效果是确定的，也不会被驱动 FMA 收缩影响。
|
|
220
235
|
|
|
@@ -222,9 +237,21 @@ $DSH_HOME/shader-skin/presets/ （Windows 默认 C:\Users\<你>\.dsh\shad
|
|
|
222
237
|
|
|
223
238
|
## 预设与许可证（重要）
|
|
224
239
|
|
|
225
|
-
-
|
|
226
|
-
|
|
227
|
-
|
|
240
|
+
随包预设分两类（完整清单见 [`THIRD-PARTY-NOTICES.md`](THIRD-PARTY-NOTICES.md)）：
|
|
241
|
+
|
|
242
|
+
| 预设 | 来源 | 许可证 |
|
|
243
|
+
|---|---|---|
|
|
244
|
+
| `极光` / `流体色带` / `脉冲（带音乐）` | 本项目自写 | **MIT**（可商用、随便改） |
|
|
245
|
+
| `海面（Seascape）` | [Seascape](https://www.shadertoy.com/view/Ms2SD1)，© Alexander Alekseev aka TDM | **CC BY-NC-SA 3.0**（非 MIT） |
|
|
246
|
+
| `马里奥（带音乐）` | [Mario](https://www.shadertoy.com/user/iq)，© Inigo Quilez | **CC BY-NC-SA 3.0**（非 MIT） |
|
|
247
|
+
|
|
248
|
+
两个第三方作品是**按上游许可证收录的**（上游允许再分发），所以：
|
|
249
|
+
|
|
250
|
+
- **署名**：保留作者与许可证声明（文件头、`presets/index.json`、背景库里的红色 `CC BY-NC-SA` 标记）；
|
|
251
|
+
- **非商业**：这两个 shader 不能用于商业用途。要把这个插件用于商业产品，请先删掉 `native-dist/presets/seascape.glsl`、`mario.glsl`、`mario-sound.glsl`（或只保留自写预设）；
|
|
252
|
+
- **相同方式共享**：改过的版本再分发时仍要留在 CC BY-NC-SA 3.0 下。设置页「代码」里另存的「我的副本」同样受这个约束。
|
|
253
|
+
|
|
254
|
+
其余从 ShaderToy 导入的作品（默认 CC BY-NC-SA 3.0，作者可另行声明）**只存在本机** `$DSH_HOME/shader-skin.json`，不会上传，也不会进包；想把自己的修改提交进仓库/随包分发，先确认许可证允许，并带上署名与相同的许可证。
|
|
228
255
|
|
|
229
256
|
## 开发
|
|
230
257
|
|
|
@@ -260,13 +287,20 @@ native-dist/
|
|
|
260
287
|
player.html 零依赖 WebGL2 播放器（渲染 + 滤镜 + mainSound 音频）
|
|
261
288
|
panel.html 设置页（参数 / 背景库 / 代码，深浅色自适应）
|
|
262
289
|
defaults.json 全部默认参数（改这里就改默认值）
|
|
263
|
-
presets/*.glsl
|
|
290
|
+
presets/*.glsl 随包预设：3 个自写 MIT + 2 个第三方 CC BY-NC-SA 3.0（`seascape` / `mario`）
|
|
264
291
|
presets/dev/ 测试夹具（不进 npm 包）
|
|
265
292
|
locale/ icon.svg 插件管理器展示资源
|
|
266
293
|
tools/ 开发服务器 / 包检查 / 渲染冒烟 / 音频冒烟 / 实机检查
|
|
294
|
+
THIRD-PARTY-NOTICES.md 第三方作品的作者 / 来源 / 许可证清单
|
|
267
295
|
.github/workflows/ CI + npm 发布（OIDC trusted publishing）
|
|
268
296
|
```
|
|
269
297
|
|
|
298
|
+
## 参与（issue / PR 都欢迎）
|
|
299
|
+
|
|
300
|
+
- **报问题**：直接[开 Issue](https://github.com/zdjmrq/dsh-shadertoy-skin/issues)。附上 DSH 版本、系统/显卡、截图，以及 `$DSH_HOME/shader-skin.json` 里对应预设的条目（贴之前先删掉不想公开的内容）；播放器自己的诊断行也能帮大忙。
|
|
301
|
+
- **提改进**：bug 修复、文档修正、新的自写预设都欢迎 [PR](https://github.com/zdjmrq/dsh-shadertoy-skin/pulls)。自写预设请标 MIT；第三方作品要带作者与许可证（参考 [`THIRD-PARTY-NOTICES.md`](THIRD-PARTY-NOTICES.md)）。
|
|
302
|
+
- **分享你的背景**：装了什么作品、参数怎么调的，开 Issue 贴截图就行；想把它做成内置预设，先确认原作者的许可证允许再分发。
|
|
303
|
+
|
|
270
304
|
## License
|
|
271
305
|
|
|
272
|
-
[MIT](LICENSE)
|
|
306
|
+
[MIT](LICENSE) 适用于插件代码与三个自写预设。**随包的两个第三方作品（`seascape` / `mario`）不是 MIT**，它们按上游的 [CC BY-NC-SA 3.0](https://creativecommons.org/licenses/by-nc-sa/3.0/) 收录，署名见文件头与 [`THIRD-PARTY-NOTICES.md`](THIRD-PARTY-NOTICES.md)。
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Third-party notices
|
|
2
|
+
|
|
3
|
+
This repository and the npm package `dsh-shadertoy-skin` contain code under two
|
|
4
|
+
different licences:
|
|
5
|
+
|
|
6
|
+
- **The plugin itself** (`index.js`, `client.js`, `native-dist/player.html`,
|
|
7
|
+
`native-dist/panel.html`, `native-dist/defaults.json`, `tools/`, and the
|
|
8
|
+
self-written presets `aurora` / `flow` / `pulse`) is **MIT** — see `LICENSE`.
|
|
9
|
+
- **Two bundled ShaderToy works** are **CC BY-NC-SA 3.0** and are **not MIT**.
|
|
10
|
+
They are included as ready-to-use presets, with attribution, because the
|
|
11
|
+
upstream licences allow redistribution (non-commercially, share-alike).
|
|
12
|
+
|
|
13
|
+
## Bundled presets with third-party licences
|
|
14
|
+
|
|
15
|
+
| preset id | work | author | source | licence | changes |
|
|
16
|
+
|---|---|---|---|---|---|
|
|
17
|
+
| `seascape` | "Seascape" (2014) | Alexander Alekseev aka TDM | <https://www.shadertoy.com/view/Ms2SD1> | [CC BY-NC-SA 3.0](https://creativecommons.org/licenses/by-nc-sa/3.0/) | desktop-background modifications plus verifiable performance work and fixes: sky early-out, bounded regula-falsi tracing (32→16 steps), integer-hash noise, `pow(max(color, 0.0))` NaN fix, specular base clamp, dithering. Details in the file header. |
|
|
18
|
+
| `mario` + `mario-sound` | "Mario" (2014) | Inigo Quilez (iq) | <https://www.shadertoy.com/user/iq> | [CC BY-NC-SA 3.0](https://creativecommons.org/licenses/by-nc-sa/3.0/) | bundled as a preset as-is (pixel art + one music piece). |
|
|
19
|
+
|
|
20
|
+
What **CC BY-NC-SA 3.0** means for these two files:
|
|
21
|
+
|
|
22
|
+
- **Attribution** — credit the authors (TDM / Inigo Quilez) and keep the licence notice.
|
|
23
|
+
- **NonCommercial** — you may not use these two shaders for commercial purposes.
|
|
24
|
+
If you want to use this plugin commercially, delete `native-dist/presets/seascape.glsl`,
|
|
25
|
+
`native-dist/presets/mario.glsl` and `native-dist/presets/mario-sound.glsl`
|
|
26
|
+
(or ship your own MIT shaders only).
|
|
27
|
+
- **ShareAlike** — if you redistribute modified versions of these shaders, they
|
|
28
|
+
must stay under CC BY-NC-SA 3.0.
|
|
29
|
+
|
|
30
|
+
Everything you import yourself from ShaderToy stays on your machine
|
|
31
|
+
(`$DSH_HOME/shader-skin.json` / `$DSH_HOME/shader-skin/presets/`); it is never
|
|
32
|
+
uploaded and never shipped in this package. ShaderToy works are CC BY-NC-SA 3.0
|
|
33
|
+
unless the author states otherwise.
|
package/client.js
CHANGED
|
@@ -207,6 +207,25 @@ window.__ModuleLoader__.load({
|
|
|
207
207
|
const RAISED_TOKENS = [
|
|
208
208
|
'--dsw-alias-bg-overlay', '--dsw-specific-menu',
|
|
209
209
|
]
|
|
210
|
+
/**
|
|
211
|
+
* Content fills that never go through the `bg-layer-*` tokens: the
|
|
212
|
+
* changed-files header strip, deliverable/plan cards, markdown code
|
|
213
|
+
* blocks + inline code, and the user-message bubble. In the light theme
|
|
214
|
+
* those default to opaque near-white (the static neutral-50/100 scale),
|
|
215
|
+
* which is what made some assistant replies look like solid white
|
|
216
|
+
* patches while every other card was translucent. Each entry is
|
|
217
|
+
* [token, weight]: the weight scales the current `panels` alpha.
|
|
218
|
+
*/
|
|
219
|
+
const CONTENT_TOKENS = [
|
|
220
|
+
['--dsw-static-neutral-50', 0.62],
|
|
221
|
+
['--dsw-static-neutral-100', 0.62],
|
|
222
|
+
['--dsw-static-neutral-800', 0.62],
|
|
223
|
+
['--dsw-static-neutral-850', 0.62],
|
|
224
|
+
['--dsw-alias-markdown-code-block', 0.9],
|
|
225
|
+
['--dsw-alias-markdown-code-block-banner', 1],
|
|
226
|
+
['--dsw-alias-markdown-inline-code', 0.7],
|
|
227
|
+
['--dsw-specific-bubble', 1],
|
|
228
|
+
]
|
|
210
229
|
|
|
211
230
|
/** `panels` = opaque (leave theme fills) | half | clear. */
|
|
212
231
|
const PANEL_ALPHA = { half: 0.62, clear: 0.22 }
|
|
@@ -230,6 +249,9 @@ window.__ModuleLoader__.load({
|
|
|
230
249
|
const raised = Math.min(0.96, alpha + 0.32)
|
|
231
250
|
for (const token of LAYER_TOKENS) tokens[token] = rgba('9, 12, 16', alpha)
|
|
232
251
|
for (const token of RAISED_TOKENS) tokens[token] = rgba('9, 12, 16', raised)
|
|
252
|
+
for (const [token, weight] of CONTENT_TOKENS) {
|
|
253
|
+
tokens[token] = rgba('9, 12, 16', Math.min(0.96, alpha * weight))
|
|
254
|
+
}
|
|
233
255
|
return tokens
|
|
234
256
|
}
|
|
235
257
|
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
"panels": { "values": ["opaque", "half", "clear"] },
|
|
22
22
|
"blur": { "min": 0, "max": 12, "step": 0.5, "unit": "px" },
|
|
23
23
|
"fps": { "values": [15, 20, 30, 60] },
|
|
24
|
-
"scale": { "values": [0.5, 0.75, 1, 1.25, 1.5] },
|
|
24
|
+
"scale": { "values": [0.25, 0.35, 0.4, 0.5, 0.6, 0.75, 1, 1.25, 1.5, 1.75, 2] },
|
|
25
25
|
"speed": { "min": 0, "max": 2, "step": 0.05, "unit": "x" },
|
|
26
26
|
"loopSeconds": { "min": 5, "max": 120, "step": 1, "unit": "s" },
|
|
27
27
|
"audioMode": { "values": ["loop", "once"] },
|