dsh-dream-skin 0.4.0 → 0.4.2

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <strong>中文</strong> · <a href="./README.en.md">English</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.es.md">Español</a> · <a href="./README.fr.md">Français</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ru.md">Русский</a>
+  <strong>中文</strong> · <a href="./docs/i18n/README.en.md">English</a> · <a href="./docs/i18n/README.ja.md">日本語</a> · <a href="./docs/i18n/README.ko.md">한국어</a> · <a href="./docs/i18n/README.es.md">Español</a> · <a href="./docs/i18n/README.fr.md">Français</a> · <a href="./docs/i18n/README.de.md">Deutsch</a> · <a href="./docs/i18n/README.ru.md">Русский</a>
 </p>
 
 <div align="center">
@@ -19,7 +19,7 @@
 
 ✨ **Design Philosophy — [一份关于「什么算高级」的设计声明](./docs/design-philosophy.md)** · 以 iOS / Linear 的审美为基准，把「高级感」建立在材质的准确与配色的克制上。
 
-[English](./README.en.md) · [变更日志](./CHANGELOG.md) · [项目说明](./docs/PROJECT.md) · [设计哲学](./docs/design-philosophy.md) · [发布指引](./docs/publishing-to-npm.md)
+[English](./docs/i18n/README.en.md) · [变更日志](./CHANGELOG.md) · [项目说明](./docs/PROJECT.md) · [设计哲学](./docs/design-philosophy.md) · [发布指引](./docs/publishing-to-npm.md)
 
 ![npm version](https://img.shields.io/npm/v/dsh-dream-skin?color=4f83f2&label=npm)
 ![license](https://img.shields.io/github/license/RevolutionLA/dsh-dream-skin?color=34d399)
@@ -103,6 +103,7 @@ dsh plugin --profile web add dsh-dream-skin && dsh web
 | 📦 **主题包格式 + 导入/导出** | 一个 `*.dsh-theme.json` 主题包 = 格式标记 + 版本 + manifest（id/name/作者/色系/accent/tokens）。可**导入文件**、**一键应用**、**复制分享链接**（编码进 URL hash） |
 | 🌈 **每用户强调色 Accent** | 为当前皮肤叠加一个自定义品牌强调色（`overrideTokens` 层，不动皮肤本身），**12 个典型色块一键选色** + 选色盘 + 随机 + 恢复主题色 |
 | 🖼️ **壁纸 2.0** | 本地图 / **图片 URL** / **渐变预设**，每套皮肤**自动建议**一张渐变，可**自动弱化**（聚焦任务时降低干扰）；**最近使用**（最多 5 张）一键换回 |
+| 🪟 **弹窗不透明度** | 设置 → 外观 →「弹窗不透明度」滑块（0–100%），控制选项弹窗 / 选项卡卡片的底填充透明度——调高文字更清晰，调低可透出背后内容，跟随持久化保存 |
 | 🧩 **本地主题包库** | 你导入的自定义主题包集中展示，**应用 / 收藏 / 移除** 一键完成（内置 8 套皮肤在「皮肤」行选择） |
 | ✅ **清晰选中反馈** | 切换皮肤时选中态（✓ + 边框）**即时跟随**，不再残留模糊的白色高亮框 |
 | 🎲 **换一个试试（surprise me）** | 随机挑一个和你当前不同的主题 |
@@ -136,31 +137,31 @@ DeepSeek Harness 的口号是「一切皆插件」：模型、工具、沙箱、
 
 <table>
   <tr>
-    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b> · 深海渊</td>
-    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b> · 极光</td>
-    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b> · 星云</td>
-    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b> · 余烬</td>
+    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b> · 沉静蓝</td>
+    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b> · 极光青</td>
+    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b> · 星云紫</td>
+    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b> · 余烬橙</td>
   </tr>
   <tr>
-    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b> · 午夜</td>
-    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b> · 象牙暖</td>
-    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b> · 晨雾蓝</td>
-    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b> · 蔷薇粉</td>
+    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b> · 午夜黑</td>
+    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b> · iOS 扁平</td>
+    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b> · 液态玻璃</td>
+    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b> · Material 粉</td>
   </tr>
 </table>
 
 ### 预设一览
 
-| id | 色系 | 氛围 |
+| id | 风格 | 特质 |
 |------|-------|------|
-| `abyss` | 🕶️ dark | DeepSeek 深蓝深渊（品牌锚点） |
-| `aurora` | 🌌 dark | 极光 · 青绿 |
-| `nebula` | 🪐 dark | 星云 · 紫 |
-| `ember` | 🔥 dark | 余烬 · 暖橙 |
-| `midnight` | 🌚 dark | 纯黑 OLED |
-| `ivory` | 📜 light | 象牙暖 · 纸感 |
-| `mist` | 🌫️ light | 晨雾蓝 · 冷调 |
-| `rose` | 🌸 light | 蔷薇粉 |
+| `abyss` | 🕶️ 沉静蓝 | 冷静深沉的靛蓝，克制不喧哗 |
+| `aurora` | 🌌 极光青 | 清冽通透的冷青，自然冷调 |
+| `nebula` | 🪐 星云紫 | 深邃漫射的紫青，朦胧神秘 |
+| `ember` | 🔥 余烬橙 | 温暖克制的琥珀橙 |
+| `midnight` | 🌚 午夜黑 | 极简纯黑，OLED 沉浸 |
+| `ivory` | 📐 iOS 扁平 | 极简平白，iOS 系统灰 + 克制的蓝 |
+| `mist` | 🧊 液态玻璃 | 清透毛玻璃，半透明 + 模糊 |
+| `rose` | 🌸 Material 粉 | 明快彩粉，谷歌 Material 扁平彩色 |
 
 ## ⚡ 快速开始（3 步）
 

package/docs/design-philosophy.md

@@ -79,14 +79,24 @@
 
 ---
 
-## Material — 弥散光与毛玻璃
+## Material — 弥散光与液态玻璃
 
-高级感的另一半来自**材质**，由两条通道实现：
+高级感的材质由两层承载：
 
 1. **每皮肤弥散光渐变**：每套皮肤内置一份多层 `radial-gradient` 弥散光背景（柔和光斑 + 同色系暗部分层）——选皮肤即自动挂载（用户未设自定义壁纸时），一选即现「材质感」。
-2. **毛玻璃（已实现）**：注入一段自包含 CSS 为 DSH 主容器叠加 `backdrop-filter: blur()`，把弥散光雾化透入形成真·玻璃。用 `@supports` 兜底浏览器、用 `teardown` 随卸载移除；若 DSH 的 hashed 类名未来漂移，选择器静默失配、绝不破坏布局，只停止加模糊。
+2. **液态玻璃（leaf cards）**：为**叶子卡片**（输入框 `.uV2eYG_card`、行内告警 `.bqrRRG_card`、小浮层 `.lXshSW_root`）注入半透明填充 + `backdrop-filter: blur()`，让弥散光「雾化透入」形成液态玻璃。
 
-> 配色负责「气质」，材质负责「质感」。两样配齐，才是完整的高级感。
+### 材质分层（每层的透明度各不相同）
+- **背景层**：`bg-base` / `bg-layer-1/3` —— 半透玻璃，弥散光可透出。
+- **浮层/模态层**：`bg-layer-2`（设置面板用）—— 深色 `rgba(带色深,0.85)`（高不透明、背后文字不透）、亮色 `rgba(255,255,255,0.92)`（清透但可读）。
+- **输入框**：`--dsw-specific-input-major` —— 深色 `rgba(255,255,255,0.08)` 液态玻璃（半透白 + blur）；亮色 `rgba(255,255,255,0.92)` 干净利落。
+- **用户选项弹窗**（`.Mbwy4a_card`）：与输入框复用 `input-major`，因输入框刻意很透明，选项弹窗单独以 `color-mix(in srgb, var(--dsw-alias-bg-base) 94%, transparent)` 覆盖为高不透明——深浅色都保证选项文字清晰、背景不透。
+- **输入框底部 scrim**：给输入框根容器一条「透明 → 高不透明 tip 色」的渐变，把滚动上来的消息 / "第 N 轮" 监控行**遮在输入框下方**，不重叠、不杂乱。
+
+### 关于 backdrop-filter 的安全性边界
+`backdrop-filter` 会创建新的包含块（containing block），**只有加在「承载 `position: fixed` 弹窗的大容器」上**才会破坏 fixed 定位（设置面板会从「相对视口居中」被「困」进容器里）。因此我们严格只对**叶子卡片**加 blur——它们不是任何 fixed 弹窗的祖先，安全；**绝不对侧边栏 / 主列这类大容器加**。设置面板模态自身使用 DSH 自带 mask blur + 高不透明 `bg-layer-2`，可读且零风险。
+
+> 配色负责「气质」，弥散光与液态玻璃负责「质感」。两者配齐，才是完整的高级感。
 
 ---
 

package/{README.de.md → docs/i18n/README.de.md}

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="./README.md">中文</a> · <a href="./README.en.md">English</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.es.md">Español</a> · <a href="./README.fr.md">Français</a> · <strong>Deutsch</strong> · <a href="./README.ru.md">Русский</a>
+  <a href="../../README.md">中文</a> · <a href="./README.en.md">English</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.es.md">Español</a> · <a href="./README.fr.md">Français</a> · <strong>Deutsch</strong> · <a href="./README.ru.md">Русский</a>
 </p>
 
 <div align="center">
@@ -17,9 +17,9 @@ Natives Skinning · Wallpaper · teilbare Theme-Pakete — eine elegante Umsetzu
 
 > 1-Zeilen-Installation · rein nativ (keine Injektion, keine Installer-Patches) · übersteht DSH-Updates
 
-✨ **Design Philosophy — [eine Aussage darüber, was „premium" bedeutet](./docs/design-philosophy.md)** · mit der iOS-/Linear-Ästhetik als Basis entsteht Premium aus der Präzision des Materials und der Zurückhaltung der Farben.
+✨ **Design Philosophy — [eine Aussage darüber, was „premium" bedeutet](../../docs/design-philosophy.md)** · mit der iOS-/Linear-Ästhetik als Basis entsteht Premium aus der Präzision des Materials und der Zurückhaltung der Farben.
 
-[中文](./README.md) · [Änderungshistorie](./CHANGELOG.md) · [Projektnotizen](./docs/PROJECT.md) · [Design Philosophy](./docs/design-philosophy.md) · [Veröffentlichungsanleitung](./docs/publishing-to-npm.md)
+[中文](../../README.md) · [Änderungshistorie](../../CHANGELOG.md) · [Projektnotizen](../../docs/PROJECT.md) · [Design Philosophy](../../docs/design-philosophy.md) · [Veröffentlichungsanleitung](../../docs/publishing-to-npm.md)
 
 ![npm version](https://img.shields.io/npm/v/dsh-dream-skin?color=4f83f2&label=npm)
 ![license](https://img.shields.io/github/license/RevolutionLA/dsh-dream-skin?color=34d399)
@@ -146,31 +146,31 @@ von DSH.
 
 <table>
   <tr>
-    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b></td>
-    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b></td>
-    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b></td>
-    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b></td>
+    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b> · Tiefes Blau</td>
+    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b> · Aurora Grün</td>
+    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b> · Nebel Lila</td>
+    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b> · Bernstein</td>
   </tr>
   <tr>
-    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b></td>
-    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b></td>
-    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b></td>
-    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b></td>
+    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b> · OLED Mitternacht</td>
+    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b> · iOS Flat</td>
+    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b> · Flüssiges Glas</td>
+    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b> · Material Pink</td>
   </tr>
 </table>
 
 ## 🎲 Die Presets
 
-| id | scheme | vibe |
+| id | Stil | Charakter |
 |------|--------|------|
-| `abyss` | 🕶️ dunkel | DeepSeek tiefblauer Abgrund (Anker) |
-| `aurora` | 🌌 dunkel | Aurora-Türkisgrün |
-| `nebula` | 🪐 dunkel | kosmisches Lila |
-| `ember` | 🔥 dunkel | warmes Glut-Orange |
-| `midnight` | 🌚 dunkel | reines Schwarz (OLED) |
-| `ivory` | 📜 hell | warmes Elfenbein / Papier |
-| `mist` | 🌫️ hell | kühler Blauer Nebel |
-| `rose` | 🌸 hell | Rosarot / Blush |
+| `abyss` | 🕶️ Tiefes Blau | ruhiges tiefes Indigo, zurückhaltend und leise |
+| `aurora` | 🌌 Aurora Grün | kühles, klares, transluzentes Türkis, natürlicher Kaltton |
+| `nebula` | 🪐 Nebel Lila | tiefes, diffuses Violett-Blau, neblig und geheimnisvoll |
+| `ember` | 🔥 Bernstein | warmes, zurückhaltendes Amber-Orange |
+| `midnight` | 🌚 OLED Mitternacht | minimalistisches reines Schwarz, immersives OLED |
+| `ivory` | 📐 iOS Flat | minimalistisches flaches Weiß, iOS-Systemgrau + zurückhaltendes Blau |
+| `mist` | 🧊 Flüssiges Glas | klares Milchglas, halbtransparent + unscharf |
+| `rose` | 🌸 Material Pink | helles kräftiges Pink, flache Google-Material-Farben |
 
 ## 📦 Installation
 
@@ -308,12 +308,12 @@ Das Client-Bundle ist direkt im `__ModuleLoader__`-Format geschrieben (dieselbe
 - **Einen integrierten Skin hinzufügen**: Füge dem `SKINS`-Array in `lib/client.js` ein Objekt (`id` + `colorScheme` +
   `tokens`) hinzu; es erscheint dann automatisch in den Einstellungen. Füge einen Schlüssel `skin.<id>` in **allen 8 Sprachwörterbüchern** (`zh`/`en`/`ja`/`ko`/`es`/`fr`/`de`/`ru`) hinzu.
 
-- **Ein Theme-Paket ausliefern (empfohlen)**: Folge [`docs/examples/sample-theme-pack.json`](./docs/examples/sample-theme-pack.json) —
+- **Ein Theme-Paket ausliefern (empfohlen)**: Folge [`docs/examples/sample-theme-pack.json`](../../docs/examples/sample-theme-pack.json) —
   eine `*.dsh-theme.json` ist in den Einstellungen importierbar und über einen Link teilbar, ohne Codeänderungen.
-- **Eigene Wallpaper hinzufügen**: Lege Bilder in [`wallpapers/`](./wallpapers/) ab (verbreite nur, wofür du die Rechte
+- **Eigene Wallpaper hinzufügen**: Lege Bilder in [`wallpapers/`](../../wallpapers/) ab (verbreite nur, wofür du die Rechte
   hast) und importiere sie dann über die „Wallpaper“-Reihe von DSH.
 - **Validieren**: `npm test` (VM-Smoke-Tests, die Factory-Eval, `apply()` sowie Paket-Import/-Persistenz abdecken).
-- **Neu einfärben**: Nutze die `--dsw-alias-*`-Tokens (vollständiger Vertrag in [`docs/themes-spec.md`](./docs/themes-spec.md)).
+- **Neu einfärben**: Nutze die `--dsw-alias-*`-Tokens (vollständiger Vertrag in [`docs/themes-spec.md`](../../docs/themes-spec.md)).
 
 ## 📌 Roadmap
 
@@ -329,8 +329,8 @@ Das Client-Bundle ist direkt im `__ModuleLoader__`-Format geschrieben (dieselbe
 
 ## 🤝 Mitwirken
 
-Issues und PRs sind willkommen! Bitte lies den [Contributing Guide](./CONTRIBUTING.md) und beachte den
-[Code of Conduct](./CODE_OF_CONDUCT.md).
+Issues und PRs sind willkommen! Bitte lies den [Contributing Guide](../../CONTRIBUTING.md) und beachte den
+[Code of Conduct](../../CODE_OF_CONDUCT.md).
 
 ## ⭐ Das Projekt unterstützen
 
@@ -340,11 +340,11 @@ beisteuern? Mach mit.
 
 ## 🔒 Sicherheit
 
-Ein Sicherheitsproblem gefunden? Öffne kein öffentliches Issue — siehe die [Security Policy](./SECURITY.md).
+Ein Sicherheitsproblem gefunden? Öffne kein öffentliches Issue — siehe die [Security Policy](../../SECURITY.md).
 
 ## 📄 Lizenz
 
-[MIT](./LICENSE)
+[MIT](../../LICENSE)
 
 ## 🙏 Danksagungen
 

package/{README.en.md → docs/i18n/README.en.md}

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="./README.md">中文</a> · <strong>English</strong> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.es.md">Español</a> · <a href="./README.fr.md">Français</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ru.md">Русский</a>
+  <a href="../../README.md">中文</a> · <strong>English</strong> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.es.md">Español</a> · <a href="./README.fr.md">Français</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ru.md">Русский</a>
 </p>
 
 <div align="center">
@@ -17,9 +17,9 @@ Native skinning · wallpaper · shareable theme packs — an elegant implementat
 
 > 1-line install · purely native (no injection, no installer patches) · survives DSH updates
 
-✨ **Design Philosophy — [a statement on what "premium" means](./docs/design-philosophy.md)** · grounded in iOS / Linear aesthetics, premium comes from material precision and restrained color.
+✨ **Design Philosophy — [a statement on what "premium" means](../../docs/design-philosophy.md)** · grounded in iOS / Linear aesthetics, premium comes from material precision and restrained color.
 
-[中文](./README.md) · [Changelog](./CHANGELOG.md) · [Project Notes](./docs/PROJECT.md) · [Design Philosophy](./docs/design-philosophy.md) · [Publishing Guide](./docs/publishing-to-npm.md)
+[中文](../../README.md) · [Changelog](../../CHANGELOG.md) · [Project Notes](../../docs/PROJECT.md) · [Design Philosophy](../../docs/design-philosophy.md) · [Publishing Guide](../../docs/publishing-to-npm.md)
 
 ![npm version](https://img.shields.io/npm/v/dsh-dream-skin?color=4f83f2&label=npm)
 ![license](https://img.shields.io/github/license/RevolutionLA/dsh-dream-skin?color=34d399)
@@ -146,31 +146,31 @@ system.
 
 <table>
   <tr>
-    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b></td>
-    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b></td>
-    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b></td>
-    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b></td>
+    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b> · Deep Blue</td>
+    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b> · Aurora Green</td>
+    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b> · Nebula Purple</td>
+    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b> · Ember Amber</td>
   </tr>
   <tr>
-    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b></td>
-    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b></td>
-    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b></td>
-    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b></td>
+    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b> · Midnight OLED</td>
+    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b> · iOS Flat</td>
+    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b> · Liquid Glass</td>
+    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b> · Material Pink</td>
   </tr>
 </table>
 
 ## 🎲 The presets
 
-| id | scheme | vibe |
+| id | style | trait |
 |------|--------|------|
-| `abyss` | 🕶️ dark | DeepSeek deep-blue abyss (anchor) |
-| `aurora` | 🌌 dark | aurora teal-green |
-| `nebula` | 🪐 dark | cosmic purple |
-| `ember` | 🔥 dark | warm ember orange |
-| `midnight` | 🌚 dark | pure-black OLED |
-| `ivory` | 📜 light | warm ivory / paper |
-| `mist` | 🌫️ light | cool blue fog |
-| `rose` | 🌸 light | rose pink / blush |
+| `abyss` | 🕶️ Deep Blue | calm deep indigo, restrained and quiet |
+| `aurora` | 🌌 Aurora Green | crisp translucent cool teal, natural cold tone |
+| `nebula` | 🪐 Nebula Purple | deep diffused violet-blue, hazy and mysterious |
+| `ember` | 🔥 Ember Amber | warm restrained amber orange |
+| `midnight` | 🌚 Midnight OLED | minimal pure black, immersive OLED |
+| `ivory` | 📐 iOS Flat | minimal flat white, iOS system gray + restrained blue |
+| `mist` | 🧊 Liquid Glass | clear frosted glass, translucent + blurred |
+| `rose` | 🌸 Material Pink | bright vivid pink, Google Material flat colors |
 
 ## 📦 Install
 
@@ -306,12 +306,12 @@ seeds (`react`, `react/jsx-runtime`, …) and registered client bundles (`@deeps
 - **Add a built-in skin**: append an object (`id` + `colorScheme` + `tokens`) to the `SKINS` array in `lib/client.js`;
   it then appears in Settings automatically. Add a `skin.<id>` key to **all 8 locale dictionaries**
   (`zh`/`en`/`ja`/`ko`/`es`/`fr`/`de`/`ru`).
-- **Ship a theme pack (recommended)**: follow [`docs/examples/sample-theme-pack.json`](./docs/examples/sample-theme-pack.json) —
+- **Ship a theme pack (recommended)**: follow [`docs/examples/sample-theme-pack.json`](../../docs/examples/sample-theme-pack.json) —
   one `*.dsh-theme.json` is importable in Settings and shareable via a link, no code changes needed.
-- **Add your own wallpapers**: drop images into [`wallpapers/`](./wallpapers/) (distribute only what you have rights
+- **Add your own wallpapers**: drop images into [`wallpapers/`](../../wallpapers/) (distribute only what you have rights
   to), then import them via DSH's "Wallpaper" row.
 - **Validate**: `npm test` (VM smoke tests covering factory eval, `apply()`, and pack import/persistence).
-- **Repaint**: reference the `--dsw-alias-*` tokens (full contract in [`docs/themes-spec.md`](./docs/themes-spec.md)).
+- **Repaint**: reference the `--dsw-alias-*` tokens (full contract in [`docs/themes-spec.md`](../../docs/themes-spec.md)).
 
 ## 📌 Roadmap
 
@@ -327,8 +327,8 @@ seeds (`react`, `react/jsx-runtime`, …) and registered client bundles (`@deeps
 
 ## 🤝 Contributing
 
-Issues and PRs welcome! Please read the [Contributing Guide](./CONTRIBUTING.md) and follow the
-[Code of Conduct](./CODE_OF_CONDUCT.md).
+Issues and PRs welcome! Please read the [Contributing Guide](../../CONTRIBUTING.md) and follow the
+[Code of Conduct](../../CODE_OF_CONDUCT.md).
 
 ## ⭐ Support the project
 
@@ -337,11 +337,11 @@ get discovered and keeps it maintained. Want to contribute themes / an online St
 
 ## 🔒 Security
 
-Found a security issue? Don't open a public issue — see the [Security Policy](./SECURITY.md).
+Found a security issue? Don't open a public issue — see the [Security Policy](../../SECURITY.md).
 
 ## 📄 License
 
-[MIT](./LICENSE)
+[MIT](../../LICENSE)
 
 ## 🙏 Acknowledgments
 

package/{README.es.md → docs/i18n/README.es.md}

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="./README.md">中文</a> · <a href="./README.en.md">English</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <strong>Español</strong> · <a href="./README.fr.md">Français</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ru.md">Русский</a>
+  <a href="../../README.md">中文</a> · <a href="./README.en.md">English</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <strong>Español</strong> · <a href="./README.fr.md">Français</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ru.md">Русский</a>
 </p>
 
 <div align="center">
@@ -17,9 +17,9 @@ Skinning nativo · wallpaper · paquetes de temas compartibles — una implement
 
 > Instalación en 1 línea · 100 % nativo (sin inyección, sin parches al instalador) · sobrevive a las actualizaciones de DSH
 
-✨ **Design Philosophy — [una declaración sobre qué significa «premium»](./docs/design-philosophy.md)** · con la estética de iOS / Linear como base, lo premium nace de la precisión del material y la restricción del color.
+✨ **Design Philosophy — [una declaración sobre qué significa «premium»](../../docs/design-philosophy.md)** · con la estética de iOS / Linear como base, lo premium nace de la precisión del material y la restricción del color.
 
-[中文](./README.md) · [Historial de cambios](./CHANGELOG.md) · [Notas del proyecto](./docs/PROJECT.md) · [Design Philosophy](./docs/design-philosophy.md) · [Guía de publicación](./docs/publishing-to-npm.md)
+[中文](../../README.md) · [Historial de cambios](../../CHANGELOG.md) · [Notas del proyecto](../../docs/PROJECT.md) · [Design Philosophy](../../docs/design-philosophy.md) · [Guía de publicación](../../docs/publishing-to-npm.md)
 
 ![npm version](https://img.shields.io/npm/v/dsh-dream-skin?color=4f83f2&label=npm)
 ![license](https://img.shields.io/github/license/RevolutionLA/dsh-dream-skin?color=34d399)
@@ -146,31 +146,31 @@ de plugins de DSH.
 
 <table>
   <tr>
-    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b></td>
-    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b></td>
-    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b></td>
-    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b></td>
+    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b> · Azul profundo</td>
+    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b> · Aurora verde</td>
+    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b> · Nebulosa púrpura</td>
+    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b> · Ámbar</td>
   </tr>
   <tr>
-    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b></td>
-    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b></td>
-    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b></td>
-    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b></td>
+    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b> · OLED medianoche</td>
+    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b> · iOS Flat</td>
+    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b> · Vidrio líquido</td>
+    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b> · Material rosa</td>
   </tr>
 </table>
 
 ## 🎲 Los ajustes predefinidos
 
-| id | esquema | vibra |
+| id | estilo | rasgo |
 |------|--------|------|
-| `abyss` | 🕶️ dark | abismo azul profundo de DeepSeek (ancla) |
-| `aurora` | 🌌 dark | verde azulado tipo aurora |
-| `nebula` | 🪐 dark | púrpura cósmico |
-| `ember` | 🔥 dark | naranja brasa cálido |
-| `midnight` | 🌚 dark | OLED negro puro |
-| `ivory` | 📜 light | marfil cálido / papel |
-| `mist` | 🌫️ light | niebla azul fría |
-| `rose` | 🌸 light | rosa / rubor |
+| `abyss` | 🕶️ Azul profundo | índigo profundo y sereno, contenido y silencioso |
+| `aurora` | 🌌 Aurora verde | verde azulado frío, nítido y translúcido, tono frío natural |
+| `nebula` | 🪐 Nebulosa púrpura | azul violáceo profundo y difuso, brumoso y misterioso |
+| `ember` | 🔥 Ámbar | naranja ámbar cálido y contenido |
+| `midnight` | 🌚 OLED medianoche | negro puro minimalista, OLED inmersivo |
+| `ivory` | 📐 iOS Flat | blanco plano minimalista, gris del sistema iOS + azul contenido |
+| `mist` | 🧊 Vidrio líquido | vidrio esmerilado claro, semitransparente + difuminado |
+| `rose` | 🌸 Material rosa | rosa vivo y brillante, colores planos de Google Material |
 
 ## 📦 Instalación
 
@@ -305,12 +305,12 @@ entidades de la tabla de módulos: semillas de plataforma (`react`, `react/jsx-r
 
 - **Añadir un skin integrado**: añade un objeto (`id` + `colorScheme` + `tokens`) al array `SKINS` en `lib/client.js`;
   aparecerá automáticamente en Ajustes. Añade una clave `skin.<id>` a **los 8 diccionarios de idioma** (`zh`/`en`/`ja`/`ko`/`es`/`fr`/`de`/`ru`).
-- **Publicar un paquete de temas (recomendado)**: sigue [`docs/examples/sample-theme-pack.json`](./docs/examples/sample-theme-pack.json):
+- **Publicar un paquete de temas (recomendado)**: sigue [`docs/examples/sample-theme-pack.json`](../../docs/examples/sample-theme-pack.json):
   un único `*.dsh-theme.json` es importable en Ajustes y compartible mediante un enlace, sin necesidad de cambios de código.
-- **Añadir tus propios wallpapers**: coloca las imágenes en [`wallpapers/`](./wallpapers/) (distribuye solo aquello sobre
+- **Añadir tus propios wallpapers**: coloca las imágenes en [`wallpapers/`](../../wallpapers/) (distribuye solo aquello sobre
   lo que tengas derechos) e impórtalas desde la fila «Wallpaper» de DSH.
 - **Validar**: `npm test` (pruebas de humo en VM que cubren la evaluación de la factory, `apply()` y la importación/persistencia de paquetes).
-- **Repintar**: consulta los tokens `--dsw-alias-*` (contrato completo en [`docs/themes-spec.md`](./docs/themes-spec.md)).
+- **Repintar**: consulta los tokens `--dsw-alias-*` (contrato completo en [`docs/themes-spec.md`](../../docs/themes-spec.md)).
 
 ## 📌 Hoja de ruta
 
@@ -326,8 +326,8 @@ entidades de la tabla de módulos: semillas de plataforma (`react`, `react/jsx-r
 
 ## 🤝 Contribuciones
 
-¡Las issues y los PRs son bienvenidos! Lee la [Guía de contribución](./CONTRIBUTING.md) y sigue el
-[Código de conducta](./CODE_OF_CONDUCT.md).
+¡Las issues y los PRs son bienvenidos! Lee la [Guía de contribución](../../CONTRIBUTING.md) y sigue el
+[Código de conducta](../../CODE_OF_CONDUCT.md).
 
 ## ⭐ Apoya el proyecto
 
@@ -336,11 +336,11 @@ ayuda a que el proyecto sea descubierto y se mantenga. ¿Quieres aportar temas,
 
 ## 🔒 Seguridad
 
-¿Has encontrado un problema de seguridad? No abras una issue pública: consulta la [Política de seguridad](./SECURITY.md).
+¿Has encontrado un problema de seguridad? No abras una issue pública: consulta la [Política de seguridad](../../SECURITY.md).
 
 ## 📄 Licencia
 
-[MIT](./LICENSE)
+[MIT](../../LICENSE)
 
 ## 🙏 Agradecimientos
 

package/{README.fr.md → docs/i18n/README.fr.md}

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="./README.md">中文</a> · <a href="./README.en.md">English</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.es.md">Español</a> · <strong>Français</strong> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ru.md">Русский</a>
+  <a href="../../README.md">中文</a> · <a href="./README.en.md">English</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.es.md">Español</a> · <strong>Français</strong> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ru.md">Русский</a>
 </p>
 
 <div align="center">
@@ -17,9 +17,9 @@ Habillage natif · fond d'écran · packs de thèmes partageables — une implé
 
 > Installation en 1 ligne · 100 % natif (aucune injection, aucun patch d'installation) · résiste aux mises à jour de DSH
 
-✨ **Design Philosophy — [une déclaration sur ce que « premium » signifie](./docs/design-philosophy.md)** · avec l'esthétique iOS / Linear comme base, le premium naît de la précision du matériau et de la retenue des couleurs.
+✨ **Design Philosophy — [une déclaration sur ce que « premium » signifie](../../docs/design-philosophy.md)** · avec l'esthétique iOS / Linear comme base, le premium naît de la précision du matériau et de la retenue des couleurs.
 
-[中文](./README.md) · [Historique](./CHANGELOG.md) · [Notes du projet](./docs/PROJECT.md) · [Design Philosophy](./docs/design-philosophy.md) · [Guide de publication](./docs/publishing-to-npm.md)
+[中文](../../README.md) · [Historique](../../CHANGELOG.md) · [Notes du projet](../../docs/PROJECT.md) · [Design Philosophy](../../docs/design-philosophy.md) · [Guide de publication](../../docs/publishing-to-npm.md)
 
 ![npm version](https://img.shields.io/npm/v/dsh-dream-skin?color=4f83f2&label=npm)
 ![license](https://img.shields.io/github/license/RevolutionLA/dsh-dream-skin?color=34d399)
@@ -146,31 +146,31 @@ officiel de DSH.
 
 <table>
   <tr>
-    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b></td>
-    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b></td>
-    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b></td>
-    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b></td>
+    <td align="center"><img src="docs/previews/abyss.svg" width="220" alt="abyss"/><br/><b>abyss</b> · Bleu profond</td>
+    <td align="center"><img src="docs/previews/aurora.svg" width="220" alt="aurora"/><br/><b>aurora</b> · Aurora vert</td>
+    <td align="center"><img src="docs/previews/nebula.svg" width="220" alt="nebula"/><br/><b>nebula</b> · Nébuleuse violette</td>
+    <td align="center"><img src="docs/previews/ember.svg" width="220" alt="ember"/><br/><b>ember</b> · Ambre</td>
   </tr>
   <tr>
-    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b></td>
-    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b></td>
-    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b></td>
-    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b></td>
+    <td align="center"><img src="docs/previews/midnight.svg" width="220" alt="midnight"/><br/><b>midnight</b> · OLED minuit</td>
+    <td align="center"><img src="docs/previews/ivory.svg" width="220" alt="ivory"/><br/><b>ivory</b> · iOS Flat</td>
+    <td align="center"><img src="docs/previews/mist.svg" width="220" alt="mist"/><br/><b>mist</b> · Verre liquide</td>
+    <td align="center"><img src="docs/previews/rose.svg" width="220" alt="rose"/><br/><b>rose</b> · Material rose</td>
   </tr>
 </table>
 
 ## 🎲 Les préréglages
 
-| id | schéma | ambiance |
+| id | style | trait |
 |------|--------|------|
-| `abyss` | 🕶️ sombre | abîme bleu profond DeepSeek (ancrage) |
-| `aurora` | 🌌 sombre | aurore vert sarcelle |
-| `nebula` | 🪐 sombre | pourpre cosmique |
-| `ember` | 🔥 sombre | orange braise chaleureux |
-| `midnight` | 🌚 sombre | noir pur OLED |
-| `ivory` | 📜 clair | ivoire chaleureux / papier |
-| `mist` | 🌫️ clair | brume bleue froide |
-| `rose` | 🌸 clair | rose / blush |
+| `abyss` | 🕶️ Bleu profond | indigo profond et calme, sobre et discret |
+| `aurora` | 🌌 Aurora vert | vert sarcelle froid, limpide et translucide, ton froid naturel |
+| `nebula` | 🪐 Nébuleuse violette | violet-bleu profond et diffus, brumeux et mystérieux |
+| `ember` | 🔥 Ambre | orange ambre chaleureux et sobre |
+| `midnight` | 🌚 OLED minuit | noir pur minimaliste, OLED immersif |
+| `ivory` | 📐 iOS Flat | blanc plat minimaliste, gris système iOS + bleu sobre |
+| `mist` | 🧊 Verre liquide | verre dépoli limpide, translucide + flou |
+| `rose` | 🌸 Material rose | rose vif et éclatant, couleurs plates Google Material |
 
 ## 📦 Installation
 
@@ -305,12 +305,12 @@ seeds de plateforme (`react`, `react/jsx-runtime`, …) et les bundles client en
 
 - **Ajouter un skin intégré** : ajoutez un objet (`id` + `colorScheme` + `tokens`) au tableau `SKINS` dans `lib/client.js` ;
   il apparaîtra alors automatiquement dans les Paramètres. Ajoutez une clé `skin.<id>` aux **8 dictionnaires de langue** (`zh`/`en`/`ja`/`ko`/`es`/`fr`/`de`/`ru`).
-- **Publier un pack de thèmes (recommandé)** : suivez [`docs/examples/sample-theme-pack.json`](./docs/examples/sample-theme-pack.json) —
+- **Publier un pack de thèmes (recommandé)** : suivez [`docs/examples/sample-theme-pack.json`](../../docs/examples/sample-theme-pack.json) —
   un `*.dsh-theme.json` est importable dans les Paramètres et partageable via un lien, sans aucune modification de code.
-- **Ajouter vos propres fonds d'écran** : déposez des images dans [`wallpapers/`](./wallpapers/) (ne distribuez que ce dont vous avez
+- **Ajouter vos propres fonds d'écran** : déposez des images dans [`wallpapers/`](../../wallpapers/) (ne distribuez que ce dont vous avez
   les droits), puis importez-les via la rangée « Fond d'écran » de DSH.
 - **Valider** : `npm test` (tests de fumée VM couvrant l'évaluation de la factory, `apply()` et l'import/la persistance des packs).
-- **Repeindre** : référez-vous aux tokens `--dsw-alias-*` (contrat complet dans [`docs/themes-spec.md`](./docs/themes-spec.md)).
+- **Repeindre** : référez-vous aux tokens `--dsw-alias-*` (contrat complet dans [`docs/themes-spec.md`](../../docs/themes-spec.md)).
 
 ## 📌 Feuille de route
 
@@ -326,8 +326,8 @@ seeds de plateforme (`react`, `react/jsx-runtime`, …) et les bundles client en
 
 ## 🤝 Contribuer
 
-Issues et PR bienvenues ! Veuillez lire le [Guide de contribution](./CONTRIBUTING.md) et respecter le
-[Code de conduite](./CODE_OF_CONDUCT.md).
+Issues et PR bienvenues ! Veuillez lire le [Guide de contribution](../../CONTRIBUTING.md) et respecter le
+[Code de conduite](../../CODE_OF_CONDUCT.md).
 
 ## ⭐ Soutenir le projet
 
@@ -336,11 +336,11 @@ Si vous l'aimez : mettez une étoile **⭐** au dépôt, un pouce **👍** sur n
 
 ## 🔒 Sécurité
 
-Vous avez trouvé un problème de sécurité ? N'ouvrez pas d'issue publique — consultez la [Politique de sécurité](./SECURITY.md).
+Vous avez trouvé un problème de sécurité ? N'ouvrez pas d'issue publique — consultez la [Politique de sécurité](../../SECURITY.md).
 
 ## 📄 Licence
 
-[MIT](./LICENSE)
+[MIT](../../LICENSE)
 
 ## 🙏 Remerciements