dsh-dream-skin 0.4.1 → 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）** | 随机挑一个和你当前不同的主题 |

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)
@@ -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)
@@ -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)
@@ -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)
@@ -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
 

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

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="./README.md">中文</a> · <a href="./README.en.md">English</a> · <strong>日本語</strong> · <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> · <a href="./README.en.md">English</a> · <strong>日本語</strong> · <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 @@
 
 > 1行インストール · 完全ネイティブ（注入なし・インストーラへのパッチなし）· DSH のアップデート後もそのまま動作
 
-✨ **Design Philosophy — [「高級とは何か」についてのデザイン宣言](./docs/design-philosophy.md)** · iOS / Linear の美学を基準に、高級感を素材の正確さと克制された配色に置く。
+✨ **Design Philosophy — [「高級とは何か」についてのデザイン宣言](../../docs/design-philosophy.md)** · iOS / Linear の美学を基準に、高級感を素材の正確さと克制された配色に置く。
 
-[中文](./README.md) · [変更履歴](./CHANGELOG.md) · [プロジェクトメモ](./docs/PROJECT.md) · [Design Philosophy](./docs/design-philosophy.md) · [公開ガイド](./docs/publishing-to-npm.md)
+[中文](../../README.md) · [変更履歴](../../CHANGELOG.md) · [プロジェクトメモ](../../docs/PROJECT.md) · [Design Philosophy](../../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)
@@ -305,12 +305,12 @@ ui-layout の ThemePresenter によって `<body>` へのインラインカス
 
 - **内蔵スキンを追加する**: `lib/client.js` の `SKINS` 配列にオブジェクト（`id` + `colorScheme` + `tokens`）を追加するだけ。
   Settings には自動的に表示されます。**全 8 言語の辞書**（`zh`/`en`/`ja`/`ko`/`es`/`fr`/`de`/`ru`）に `skin.<id>` キーを追加してください。
-- **テーマパックを配布する（推奨）**: [`docs/examples/sample-theme-pack.json`](./docs/examples/sample-theme-pack.json) に従って —
+- **テーマパックを配布する（推奨）**: [`docs/examples/sample-theme-pack.json`](../../docs/examples/sample-theme-pack.json) に従って —
   `*.dsh-theme.json` を1つ用意すれば Settings からインポートでき、リンクで共有も可能。コードの変更は不要です。
-- **自分で壁紙を追加する**: [`wallpapers/`](./wallpapers/) に画像を配置し（配布権のあるものだけを）、
+- **自分で壁紙を追加する**: [`wallpapers/`](../../wallpapers/) に画像を配置し（配布権のあるものだけを）、
   DSH の「Wallpaper」行からインポートします。
 - **検証する**: `npm test`（ファクトリの評価、`apply()`、パックのインポート/永続化をカバーする VM スモークテスト）。
-- **塗り直す**: `--dsw-alias-*` トークンを参照（完全な仕様は [`docs/themes-spec.md`](./docs/themes-spec.md)）。
+- **塗り直す**: `--dsw-alias-*` トークンを参照（完全な仕様は [`docs/themes-spec.md`](../../docs/themes-spec.md)）。
 
 ## 📌 ロードマップ
 
@@ -326,8 +326,8 @@ ui-layout の ThemePresenter によって `<body>` へのインラインカス
 
 ## 🤝 コントリビューション
 
-Issue や PR を歓迎します！[コントリビューションガイド](./CONTRIBUTING.md) をお読みの上、
-[行動規範](./CODE_OF_CONDUCT.md) に従ってください。
+Issue や PR を歓迎します！[コントリビューションガイド](../../CONTRIBUTING.md) をお読みの上、
+[行動規範](../../CODE_OF_CONDUCT.md) に従ってください。
 
 ## ⭐ プロジェクトを支援する
 
@@ -336,11 +336,11 @@ Issue や PR を歓迎します！[コントリビューションガイド](./CO
 
 ## 🔒 セキュリティ
 
-セキュリティ上の問題を発見しましたか？公開の Issue は開かず、[セキュリティポリシー](./SECURITY.md) を確認してください。
+セキュリティ上の問題を発見しましたか？公開の Issue は開かず、[セキュリティポリシー](../../SECURITY.md) を確認してください。
 
 ## 📄 ライセンス
 
-[MIT](./LICENSE)
+[MIT](../../LICENSE)
 
 ## 🙏 謝辞
 

package/{README.ko.md → docs/i18n/README.ko.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> · <strong>한국어</strong> · <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> · <a href="./README.en.md">English</a> · <a href="./README.ja.md">日本語</a> · <strong>한국어</strong> · <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 @@
 
 > 1줄 설치 · 순수 네이티브 (주입 없음, 설치 프로그램 패치 없음) · DSH 업데이트에도 안전
 
-✨ **Design Philosophy — ["고급"이란 무엇인가에 대한 디자인 선언](./docs/design-philosophy.md)** · iOS / Linear 미학을 기준으로, 고급감을 소재의 정확성과 절제된 배색에 둡니다.
+✨ **Design Philosophy — ["고급"이란 무엇인가에 대한 디자인 선언](../../docs/design-philosophy.md)** · iOS / Linear 미학을 기준으로, 고급감을 소재의 정확성과 절제된 배색에 둡니다.
 
-[中文](./README.md) · [변경 내역](./CHANGELOG.md) · [프로젝트 노트](./docs/PROJECT.md) · [Design Philosophy](./docs/design-philosophy.md) · [배포 가이드](./docs/publishing-to-npm.md)
+[中文](../../README.md) · [변경 내역](../../CHANGELOG.md) · [프로젝트 노트](../../docs/PROJECT.md) · [Design Philosophy](../../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)
@@ -304,12 +304,12 @@ ui-layout의 ThemePresenter가 `<body>`에 인라인 커스텀 프로퍼티로
 
 - **기본 스킨 추가**: `lib/client.js`의 `SKINS` 배열에 객체(`id` + `colorScheme` + `tokens`)를 추가하면
   설정(Settings)에 자동으로 나타납니다. **8개 언어 사전 전체**(`zh`/`en`/`ja`/`ko`/`es`/`fr`/`de`/`ru`)에 `skin.<id>` 키를 추가하세요.
-- **테마 팩 배포 (권장)**: [`docs/examples/sample-theme-pack.json`](./docs/examples/sample-theme-pack.json)을 따르세요 —
+- **테마 팩 배포 (권장)**: [`docs/examples/sample-theme-pack.json`](../../docs/examples/sample-theme-pack.json)을 따르세요 —
   `*.dsh-theme.json` 하나로 설정(Settings)에서 가져오기 가능하고 링크로 공유할 수 있으며, 코드 변경이 필요 없습니다.
-- **자체 월페이퍼 추가**: [`wallpapers/`](./wallpapers/)에 이미지를 넣으세요 (권리 보유 이미지만 배포), 그런 다음
+- **자체 월페이퍼 추가**: [`wallpapers/`](../../wallpapers/)에 이미지를 넣으세요 (권리 보유 이미지만 배포), 그런 다음
   DSH의 "Wallpaper" 행에서 가져오면 됩니다.
 - **검증**: `npm test` (factory eval, `apply()`, 팩 가져오기/영속성 등을 다루는 VM 스모크 테스트).
-- **리페인트**: `--dsw-alias-*` 토큰을 참조하세요 (전체 계약은 [`docs/themes-spec.md`](./docs/themes-spec.md)에).
+- **리페인트**: `--dsw-alias-*` 토큰을 참조하세요 (전체 계약은 [`docs/themes-spec.md`](../../docs/themes-spec.md)에).
 
 ## 📌 로드맵
 
@@ -325,8 +325,8 @@ ui-layout의 ThemePresenter가 `<body>`에 인라인 커스텀 프로퍼티로
 
 ## 🤝 기여하기
 
-이슈와 PR 환영합니다! [기여 가이드](./CONTRIBUTING.md)를 읽고
-[행동 강령](./CODE_OF_CONDUCT.md)을 따라주세요.
+이슈와 PR 환영합니다! [기여 가이드](../../CONTRIBUTING.md)를 읽고
+[행동 강령](../../CODE_OF_CONDUCT.md)을 따라주세요.
 
 ## ⭐ 프로젝트 지원하기
 
@@ -336,11 +336,11 @@ ui-layout의 ThemePresenter가 `<body>`에 인라인 커스텀 프로퍼티로
 
 ## 🔒 보안
 
-보안 문제를 발견하셨나요? 공개 이슈로 열지 말고 [보안 정책](./SECURITY.md)을 참고하세요.
+보안 문제를 발견하셨나요? 공개 이슈로 열지 말고 [보안 정책](../../SECURITY.md)을 참고하세요.
 
 ## 📄 라이선스
 
-[MIT](./LICENSE)
+[MIT](../../LICENSE)
 
 ## 🙏 감사의 말
 

package/{README.ru.md → docs/i18n/README.ru.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> · <a href="./README.de.md">Deutsch</a> · <strong>Русский</strong>
+  <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> · <a href="./README.de.md">Deutsch</a> · <strong>Русский</strong>
 </p>
 
 <div align="center">
@@ -17,9 +17,9 @@
 
 > Установка в одну строку · полностью нативно (без инъекций, без патчей установщика) · переживает обновления DSH
 
-✨ **Design Philosophy — [заявление о том, что значит «премиум»](./docs/design-philosophy.md)** · с эстетикой iOS / Linear за основу премиум рождается из точности материала и сдержанности цвета.
+✨ **Design Philosophy — [заявление о том, что значит «премиум»](../../docs/design-philosophy.md)** · с эстетикой iOS / Linear за основу премиум рождается из точности материала и сдержанности цвета.
 
-[中文](./README.md) · [История изменений](./CHANGELOG.md) · [Заметки о проекте](./docs/PROJECT.md) · [Design Philosophy](./docs/design-philosophy.md) · [Руководство по публикации](./docs/publishing-to-npm.md)
+[中文](../../README.md) · [История изменений](../../CHANGELOG.md) · [Заметки о проекте](../../docs/PROJECT.md) · [Design Philosophy](../../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)
@@ -304,12 +304,12 @@ dsh web   # restores the official appearance
 
 - **Добавить встроенную тему**: добавьте объект (`id` + `colorScheme` + `tokens`) в массив `SKINS` в `lib/client.js`;
   она появится в Настройках автоматически. Добавьте ключ `skin.<id>` во **все 8 словарей языков** (`zh`/`en`/`ja`/`ko`/`es`/`fr`/`de`/`ru`).
-- **Поставлять набор тем (рекомендуется)**: следуйте [`docs/examples/sample-theme-pack.json`](./docs/examples/sample-theme-pack.json) —
+- **Поставлять набор тем (рекомендуется)**: следуйте [`docs/examples/sample-theme-pack.json`](../../docs/examples/sample-theme-pack.json) —
   любой `*.dsh-theme.json` импортируется в Настройках и распространяется по ссылке, без изменений кода.
-- **Добавить свои обои**: положите изображения в [`wallpapers/`](./wallpapers/) (распространяйте только то, на что у вас
+- **Добавить свои обои**: положите изображения в [`wallpapers/`](../../wallpapers/) (распространяйте только то, на что у вас
   есть права), затем импортируйте их через ряд «Обои» в DSH.
 - **Проверка**: `npm test` (VM-смоук-тесты: factory eval, `apply()`, импорт набора и сохранение).
-- **Перекраска**: используйте токены `--dsw-alias-*` (полный контракт в [`docs/themes-spec.md`](./docs/themes-spec.md)).
+- **Перекраска**: используйте токены `--dsw-alias-*` (полный контракт в [`docs/themes-spec.md`](../../docs/themes-spec.md)).
 
 ## 📌 Дорожная карта
 
@@ -325,8 +325,8 @@ dsh web   # restores the official appearance
 
 ## 🤝 Вклад
 
-Приветствуются issue и PR! Пожалуйста, прочитайте [Руководство по вкладу](./CONTRIBUTING.md) и соблюдайте
-[Кодекс поведения](./CODE_OF_CONDUCT.md).
+Приветствуются issue и PR! Пожалуйста, прочитайте [Руководство по вкладу](../../CONTRIBUTING.md) и соблюдайте
+[Кодекс поведения](../../CODE_OF_CONDUCT.md).
 
 ## ⭐ Поддержите проект
 
@@ -336,11 +336,11 @@ dsh web   # restores the official appearance
 
 ## 🔒 Безопасность
 
-Нашли проблему с безопасностью? Не открывайте публичный issue — см. [Политику безопасности](./SECURITY.md).
+Нашли проблему с безопасностью? Не открывайте публичный issue — см. [Политику безопасности](../../SECURITY.md).
 
 ## 📄 Лицензия
 
-[MIT](./LICENSE)
+[MIT](../../LICENSE)
 
 ## 🙏 Благодарности
 

package/lib/client.js

@@ -54,6 +54,12 @@ window.__ModuleLoader__.load({
 		const SIDEBAR_LINK_KEY = "dsh-dream-skin:sidebar-link";
 		/** Default: sidebar wash opacity follows the main canvas (avoids a split look). */
 		const DEFAULT_SIDEBAR_LINK = 1;
+		/** localStorage key holding the popup / option-card fill opacity (0..1). */
+		const MODAL_OPACITY_KEY = "dsh-dream-skin:modal-opacity";
+		/** Default fill opacity for popups & the user-options card (kept readable). */
+		const DEFAULT_MODAL_OPACITY = 0.94;
+		/** CSS variable carrying the current popup fill weight (a percentage). */
+		const MODAL_FILL_VAR = "--dsh-dream-skin-modal-fill";
 		/** Built-in base colors used when no skin token owns a scheme. */
 		const BUILTIN_BASE = {
 			light: "rgb(255, 255, 255)",
@@ -404,7 +410,9 @@ window.__ModuleLoader__.load({
 			"bg2.gradient": "渐变",
 			"bg2.apply": "应用链接",
 			"bg2.autodim": "自动弱化（聚焦任务时不喧宾夺主）",
-			"bg2.remove": "清除壁纸"
+			"bg2.remove": "清除壁纸",
+			"modal.title": "弹窗不透明度",
+			"modal.hint": "控制选项弹窗 / 选项卡的底填充透明度——越高越不透明、文字越清晰；越低越能透出背后的内容。"
 		};
 
 		/** English dictionary, checked complete against the zh key set. */
@@ -451,7 +459,9 @@ window.__ModuleLoader__.load({
 			"bg2.gradient": "Gradient",
 			"bg2.apply": "Apply link",
 			"bg2.autodim": "Auto-dim (gently fade while focusing tasks)",
-			"bg2.remove": "Clear wallpaper"
+			"bg2.remove": "Clear wallpaper",
+			"modal.title": "Popup opacity",
+			"modal.hint": "Controls how opaque the popup / option-card fill is — higher keeps text crisp, lower lets the content behind show through."
 		};
 
 		/** JA dictionary (community translation). */
@@ -498,7 +508,9 @@ window.__ModuleLoader__.load({
 			"bg2.gradient": "グラデーション",
 			"bg2.apply": "リンクを適用",
 			"bg2.autodim": "自動ディム（タスクに集中している間は控えめに薄暗く）",
-			"bg2.remove": "壁紙をクリア"
+			"bg2.remove": "壁紙をクリア",
+			"modal.title": "ポップアップの不透明度",
+			"modal.hint": "オプションのポップアップ / カードの塗り不透明度を調整します。高いほど不透明で文字がはっきりし、低いと背後が透けます。"
 		};
 
 		/** KO dictionary (community translation). */
@@ -545,7 +557,9 @@ window.__ModuleLoader__.load({
 			"bg2.gradient": "그라데이션",
 			"bg2.apply": "링크 적용",
 			"bg2.autodim": "자동으로 은은해지기 (작업에 집중할 때 방해하지 않도록)",
-			"bg2.remove": "배경화면 지우기"
+			"bg2.remove": "배경화면 지우기",
+			"modal.title": "팝업 불투명도",
+			"modal.hint": "옵션 팝업 / 카드 채우기 불투명도를 조절합니다. 높을수록 불투명해져 텍스트가 선명하고, 낮으면 배경이 비쳐 보입니다."
 		};
 
 		/** ES dictionary (community translation). */
@@ -592,7 +606,9 @@ window.__ModuleLoader__.load({
 			"bg2.gradient": "Degradado",
 			"bg2.apply": "Aplicar enlace",
 			"bg2.autodim": "Atenuación automática (se desvanece suavemente mientras te concentras en las tareas)",
-			"bg2.remove": "Quitar fondo"
+			"bg2.remove": "Quitar fondo",
+			"modal.title": "Opacidad de las ventanas emergentes",
+			"modal.hint": "Controla la opacidad del relleno de las ventanas emergentes / tarjetas de opciones: más alta mantiene el texto nítido, más baja deja ver el contenido de atrás."
 		};
 
 		/** FR dictionary (community translation). */
@@ -639,7 +655,9 @@ window.__ModuleLoader__.load({
 			"bg2.gradient": "Dégradé",
 			"bg2.apply": "Appliquer le lien",
 			"bg2.autodim": "Atténuation auto (s'estompe en douceur pendant la concentration)",
-			"bg2.remove": "Effacer le fond d'écran"
+			"bg2.remove": "Effacer le fond d'écran",
+			"modal.title": "Opacité des fenêtres contextuelles",
+			"modal.hint": "Contrôle l'opacité du remplissage des fenêtres / cartes d'options : plus élevée, le texte reste net ; plus basse, le contenu derrière transparaît."
 		};
 
 		/** DE dictionary (community translation). */
@@ -686,7 +704,9 @@ window.__ModuleLoader__.load({
 			"bg2.gradient": "Verlauf",
 			"bg2.apply": "Link anwenden",
 			"bg2.autodim": "Automatisch dimmen (sanft verblassen, während du dich auf Aufgaben konzentrierst)",
-			"bg2.remove": "Wallpaper entfernen"
+			"bg2.remove": "Wallpaper entfernen",
+			"modal.title": "Deckkraft von Popups",
+			"modal.hint": "Regelt die Fülldeckkraft von Popups / Optionskarten – höher hält den Text klar, niedriger lässt den Hintergrund durchscheinen."
 		};
 
 		/** RU dictionary (community translation). */
@@ -733,7 +753,9 @@ window.__ModuleLoader__.load({
 			"bg2.gradient": "Градиент",
 			"bg2.apply": "Применить ссылку",
 			"bg2.autodim": "Автоприглушение (плавно затухает при фокусе на задачах)",
-			"bg2.remove": "Очистить обои"
+			"bg2.remove": "Очистить обои",
+			"modal.title": "Непрозрачность всплывающих окон",
+			"modal.hint": "Регулирует непрозрачность заливки всплывающих окон / карточек с параметрами: выше — текст чётче, ниже — просвечивает фон."
 		};
 
 		//#endregion
@@ -901,6 +923,21 @@ window.__ModuleLoader__.load({
 			const n = Number(raw);
 			return Number.isFinite(n) ? n !== 0 : (DEFAULT_SIDEBAR_LINK !== 0);
 		}
+
+		/** Popup / option-card fill opacity 0..1 (clamped; default when unset). */
+		function readModalOpacity() {
+			const raw = readStorage(MODAL_OPACITY_KEY);
+			if (raw === null) return DEFAULT_MODAL_OPACITY;
+			const value = Number(raw);
+			return Number.isFinite(value) ? Math.min(1, Math.max(0, value)) : DEFAULT_MODAL_OPACITY;
+		}
+
+		/** Persist the popup fill opacity (0..1, clamped) and cache it in-process. */
+		function writeModalOpacity(value) {
+			const clamped = Math.min(1, Math.max(0, Number(value)));
+			writeStorage(MODAL_OPACITY_KEY, String(clamped));
+			return clamped;
+		}
 		//#endregion
 
 		//#region dsh-dream-skin: wallpaper layer + token shading
@@ -984,18 +1021,65 @@ window.__ModuleLoader__.load({
 				"    backdrop-filter: blur(20px) saturate(140%);",
 				"  }",
 				"}",
-				// A second rule (always applied, not @supports-gated) gives the
+				// A second rule (always applied, not @supports-gated) used to give the
 				// composer root a bottom-scrim so a scrolled-up message / "turn N"
-				// monitor row never shows through under the input. It is tinted with
-				// the ACTIVE BASE color (not the tip color, not translucent white),
-				// so on light skins it exactly matches the page background — no
-				// grey/black fog, no dirty gradient — while still shielding the
-				// scrolled content behind the input. On deep skins it leans on the
-				// deep base and stays subtle too.
+				// monitor row never shows through under the input. That scrim was a
+				// full-rectangle gradient over the WIDER `.uV2eYG_root` (which is
+				// wider than the rounded `.uV2eYG_card`), so on skins with a
+				// wallpaper it painted a big sharp-cornered rectangle behind and
+				// around the rounded input — the "外层尖角框" users disliked. The
+				// composer card already carries its own translucent glass fill +
+				// backdrop blur, so the frame is dropped: the root is now fully
+				// transparent and only the rounded card reads. Readability is kept
+				// by the card's own fill; nothing sharp frames the input anymore.
 				".uV2eYG_root {",
-				"  background: linear-gradient(to bottom,",
-				"    color-mix(in srgb, var(--dsw-alias-bg-base) 92%, transparent) 0%,",
-				"    var(--dsw-alias-bg-base) 34%);",
+				"  background: transparent;",
+				"}",
+				// --- Right file panel consistency (issue: left rail vs right panel) ---
+				// The left sidebar reads the skin's `--dsw-specific-sidebar-fill`
+				// (a translucent dark tint that matches the wallpaper wash), but the
+				// right file panel (`nArs4W_panel`) fell back to DSH's default
+				// near-white translucent fill, so the two halves rendered with
+				// totally different tints. Give the right panel the very same
+				// sidebar fill and a matching hairline so both sides look uniform.
+				".nArs4W_panel {",
+				"  background: var(--dsw-specific-sidebar-fill) !important;",
+				"  border-left-color: var(--dsw-alias-border-l2);",
+				"}",
+				// The white default show-through can leak on nested panes that carry
+				// their own translucent white; force them to inherit the sidebar fill.
+				".nArs4W_pane, .nArs4W_paneContent, .nArs4W_workbench, .nArs4W_explorerBody {",
+				"  background: transparent;",
+				"}",
+				// --- Left sidebar foot/settings consistency (issue: settings area) ---
+				// The workspace list region (`hHd-Xa_regionArea`) overhangs to the
+				// column's left/right edges (margin-left:-4px / margin-right:-12px),
+				// but the footer/settings region was a plain `width:100%` box stuck
+				// at the inner padding, so it sat ~4px inset left and ~12px inset
+				// right. At the seam between the scrolling list and the footer that
+				// difference made a visible vertical step that read as a "断裂" —
+				// the two planes looked misaligned/detached. Align the footer to the
+				// exact same span as the list so the whole left column is one
+				// continuous plane.
+				".hHd-Xa_root .hHd-Xa_footArea, .hHd-Xa_root .hHd-Xa_settingsArea, .hHd-Xa_root .hHd-Xa_footerActions {",
+				"  width: auto;",
+				"  margin-right: calc(-1 * var(--dsh-sidebar-inline-padding, 12px));",
+				"  margin-left: -4px;",
+				"  padding-right: var(--dsh-sidebar-inline-padding, 12px);",
+				"  padding-left: 4px;",
+				"}",
+				// Force a single uniform fill across the whole sidebar and remove any
+				// leftover erase-band / divider right at the list-footer boundary.
+				".hHd-Xa_footArea, .hHd-Xa_settingsArea, .hHd-Xa_footerActions {",
+				"  background: transparent;",
+				"  box-shadow: none;",
+				"  border: none;",
+				"}",
+				// The conversation list ends with a fade (`.qDHVXG_fade`) so the whole
+				// left column fades uniformly into the sidebar fill — no seam at the
+				// foot.
+				".qDHVXG_fade {",
+				"  background: transparent;",
 				"}",
 				// The user-questions option card (`.Mbwy4a_card`) shares `--dsw-specific-input-major`
 				// with the composer, which is intentionally very translucent for the liquid-glass
@@ -1003,8 +1087,12 @@ window.__ModuleLoader__.load({
 				// through). Override it with a high-opacity fill derived from the active base color,
 				// so the options stay readable in BOTH deep and light skins while still carrying a
 				// subtle glass blur. This is a leaf card, so backdrop-filter here is safe.
+				//
+				// The fill weight (what % of the base color the block carries) is user-adjustable
+				// via Settings → 外观 → 弹窗不透明度, held in the MODAL_FILL_VAR custom property.
+				// Lower weight = more transparent (content shows through); higher = nearly solid.
 				".Mbwy4a_card {",
-				"  background: color-mix(in srgb, var(--dsw-alias-bg-base) 94%, transparent);",
+				"  background: color-mix(in srgb, var(--dsw-alias-bg-base) var(" + MODAL_FILL_VAR + ", 94%), transparent);",
 				"  -webkit-backdrop-filter: blur(24px) saturate(150%);",
 				"  backdrop-filter: blur(24px) saturate(150%);",
 				"}"
@@ -1021,6 +1109,22 @@ window.__ModuleLoader__.load({
 			materialStyleEl?.remove();
 			materialStyleEl = null;
 		}
+
+		/**
+		 * Apply the persisted popup-fill weight onto `:root` as MODAL_FILL_VAR, so
+		 * every injected rule that references it (the user-options card fill) stays
+		 * in sync without rebuilding the stylesheet. The weight is the base-color
+		 * percentage (0..100): higher = more opaque/solid, lower = more transparent.
+		 * Called at boot (so a saved value re-applies) and whenever the slider moves.
+		 */
+		function applyModalOpacity() {
+			const weight = Math.round(readModalOpacity() * 100);
+			try {
+				document.documentElement.style.setProperty(MODAL_FILL_VAR, `${weight}%`);
+			} catch {
+				// document null in a headless eval — the CSS fallback (94%) still applies
+			}
+		}
 		//#endregion
 
 		//#region dsh-dream-skin: image compression
@@ -1728,6 +1832,38 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
+
+		/**
+		 * Popup-opacity row: a slider for how opaque the popup / option-card fill
+		 * is. Uses the shared Slider component; the injected modal CSS reads the
+		 * persisted value through MODAL_FILL_VAR (see applyModalOpacity), so moving
+		 * the slider re-applies immediately and persists across reloads.
+		 */
+		function ModalOpacityRow({ t, setOpacity, useStore }) {
+			const opacity = useStore((s) => s.opacity);
+			return (0, react_jsx_runtime.jsxs)("div", {
+				style: styles.group,
+				children: [
+					(0, react_jsx_runtime.jsx)("div", {
+						style: styles.title,
+						children: t("modal.title")
+					}),
+					(0, react_jsx_runtime.jsx)(Slider, {
+						label: t("modal.title"),
+						value: Math.round(opacity * 100),
+						min: 0,
+						max: 100,
+						step: 1,
+						format: (v) => `${v}%`,
+						onChange: setOpacity
+					}),
+					(0, react_jsx_runtime.jsx)("div", {
+						style: styles.hint,
+						children: t("modal.hint")
+					})
+				]
+			});
+		}
 		//#endregion
 
 		//#region dsh-dream-skin: P0 shared utilities (packs, accent, persistence, random)
@@ -2203,6 +2339,20 @@ window.__ModuleLoader__.load({
 				}
 			});
 		}
+
+		/** Popup-opacity row store: the current fill weight (0..1) + revision. */
+		function createModalOpacityStore() {
+			return (0, _runtime_client.defineStore)({
+				init: () => ({ opacity: DEFAULT_MODAL_OPACITY, revision: -1 }),
+				actions: {
+					sync: (d, opacity, revision) => {
+						if (revision <= d.revision) return;
+						d.opacity = opacity;
+						d.revision = revision;
+					}
+				}
+			});
+		}
 		//#endregion
 
 		//#region dsh-dream-skin: P0 accent override
@@ -2413,6 +2563,9 @@ window.__ModuleLoader__.load({
 			// Apply + push the wallpaper state (includes the sidebar opacity).
 			applyWallpaper2(ctx);
 			syncWallpaper();
+
+			// Apply the persisted popup-fill weight so saved modal opacity re-applies.
+			applyModalOpacity();
 		}
 
 		/** Clear wallpaper (all kinds) and its overrides. */
@@ -3073,6 +3226,33 @@ window.__ModuleLoader__.load({
 				inject: advWallpaperInjected
 			}, WallpaperAdvancedRow));
 
+			// Popup / option-card fill opacity row.
+			const modalOpacityStore = createModalOpacityStore();
+			let modalOpacityBound;
+			let modalOpacityRevision = 0;
+			const syncModalOpacity = () => {
+				modalOpacityBound?.sync(readModalOpacity(), ++modalOpacityRevision);
+			};
+			const modalOpacityInjected = (actions) => {
+				modalOpacityBound = actions;
+				syncModalOpacity();
+				return {
+					setOpacity: (percent) => {
+						const clamped = writeModalOpacity(percent / 100);
+						applyModalOpacity();
+						modalOpacityBound?.sync(clamped, ++modalOpacityRevision);
+					}
+				};
+			};
+			ctx.slots.inject("settings.dreamSkin.item", () => ctx.slots.register({
+				name: "settings.dreamSkin.item",
+				id: "dream-skin-modal-opacity",
+				order: 32,
+				store: modalOpacityStore,
+				locale: SETTINGS_NS,
+				inject: modalOpacityInjected
+			}, ModalOpacityRow));
+
 			// P0: per-user accent override row.
 			const accentStore = createAccentStore();
 			let accentBound;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-dream-skin",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "DeepSeek Harness 换肤插件（Dream Skin for DSH）：8 套 iOS / Linear 式清透冷调的高质感主题 + 弥散光壁纸 + 每皮肤智能背景 + 强调色 + 主题包分享，把换肤做成材质与配色克制的高级感工艺，而非贴图 — in the spirit of Codex Dream Skin, elevated.",
   "license": "MIT",
   "type": "module",
@@ -23,13 +23,7 @@
     "lib/types",
     "cordis.patch.yml",
     "README.md",
-    "README.en.md",
-    "README.ja.md",
-    "README.ko.md",
-    "README.es.md",
-    "README.fr.md",
-    "README.de.md",
-    "README.ru.md",
+    "docs/i18n",
     "docs/previews",
     "docs/screenshots",
     "docs/examples",