dsh-mpkg-wallpaper 3.1.1 → 3.1.3

package/README.en.md

@@ -16,7 +16,7 @@ One plugin covers the whole wallpaper chain — import, parsing, playback, rotat
 - **Video files**: pick an mp4/webm file directly as a video background
 
 **🌊 Full-screen frosted blur suite**
-- **Unified blur (own section)**: one slider controls the wallpaper blur degree of the whole screen (0 = sharp, higher = more blurred); sidebar/title-bar fog thickness, chat-area follow and new-chat button follow are adjustable independently; when on it takes over the items below (sidebar frost, title-bar frost and the frosted-blur slider are disabled with a hint)
+- **Unified blur (own section)**: one slider controls the wallpaper blur degree of the whole screen (0 = sharp, higher = more blurred); sidebar fog thickness, chat-area follow and new-chat button follow are adjustable independently; when on it takes over the sidebar frost and the frosted-blur slider (the title bar is NOT taken over - it follows its own frost slider, transparent by default)
 - **UI blur (own section)**:
   - **Blur dialogs**: generic center-screen windows + the chat input box (frosted backdrop; text scrolling under the input box turns hazy)
   - **Blur settings panel**: the DSH settings panel with its own toggle + amount
@@ -51,7 +51,7 @@ One plugin covers the whole wallpaper chain — import, parsing, playback, rotat
 
 - **Background source**: master toggle, hybrid large-file mode, .mpkg file, image URL, local image/GIF, local wallpaper library (Steam discovery + custom folder + folder picker), wallpaper switching & rotation
 - **Appearance**: panel opacity, frosted blur, lens zoom, lens position
-- **Unified blur**: full-screen blur toggle + amount, sidebar/title-bar fog thickness, chat-area follow, new-chat button follow
+- **Unified blur**: full-screen blur toggle + amount, sidebar fog thickness, chat-area follow, new-chat button follow
 - **UI blur**: dialog / settings panel / download-confirm popup blur (each with its own toggle + amount), popover blur, mask blur, sidebar frost (Aqua scheme), Deep diving background box, title-bar frost/show (independent frost amount)
 - **Other**: sidebar shows wallpaper, light sharpen, third-party UI radius compat (off by default), update check / one-click hot update, restore defaults
 
@@ -106,7 +106,7 @@ Settings → **Wallpaper Engine Background**:
 | Image URL / local image | Plain images or GIFs |
 | Panel opacity | 50–100% |
 | Frosted blur | How blurred the wallpaper itself is, 0–40px (0 = sharp) |
-| Unified blur (own section) | One slider controls the whole screen's wallpaper blur degree (0=sharp, higher=more blurred); sidebar/title-bar fog thickness, chat-area follow and new-chat follow adjustable; takes over the items below when on |
+| Unified blur (own section) | One slider controls the whole screen's wallpaper blur degree (0=sharp, higher=more blurred); sidebar fog thickness, chat-area follow and new-chat follow adjustable; takes over sidebar frost and the frosted-blur slider when on (title bar keeps its own frost slider) |
 | Dialog / settings panel / confirm popup / popover / mask blur | Each with its own toggle + amount slider; sidebar frost (Aqua scheme, auto-lifted while a dialog is open) |
 | Lens zoom / position | Zoom (10–2000%) and pan the background; zoom out to see components at the picture edges |
 | Sidebar / title-bar wallpaper | Toggles; off = solid opaque color for that area; title-bar frost amount adjustable independently |
@@ -117,49 +117,48 @@ Settings → **Wallpaper Engine Background**:
 
 ## Install
 
-### Option 1: dsh plugin add (recommended)
+The plugin is published on npm (`dsh-mpkg-wallpaper`). Pick one:
+
+### Option 1: dsh plugin add (recommended, market-recognized)
 
 ```bash
 dsh plugin --profile web add dsh-mpkg-wallpaper
 # restart dsh web, then hard-refresh the browser (Ctrl+F5)
 ```
 
-### Option 2: pnpm install (standard for the pnpm-workspace profile)
-
-```bash
-# 1. Put the plugin folder under the profile's node_modules (or extract the GitHub zip)
-git clone https://github.com/XHR666/dsh-mpkg-wallpaper.git $DSH_HOME/profiles/web/node_modules/dsh-mpkg-wallpaper
-#    (if your profile is not at ~/.dsh/profiles/web, use your profile directory)
+Installs from the official npm registry and writes into the profile's `package.json`
+dependencies — the plugin market recognizes it as installed, shows the download count,
+and can manage updates.
 
-# 2. Register a line in the profile's cordis.patch.yml:
-#    - insert:
-#        - id: dsh-mpkg-wallpaper
-#          name: dsh-mpkg-wallpaper
+### Option 2: pnpm manual install (pnpm-workspace profile)
 
-# 3. Restart dsh web, then Ctrl+F5 in the browser
+```bash
+# run in the profile directory (replace <profile> with your profile name, e.g. web)
+pnpm --dir $DSH_HOME/profiles/<profile> add dsh-mpkg-wallpaper
+# restart dsh web, then Ctrl+F5 in the browser
 ```
 
-> Note: the DSH profile is a pnpm workspace (`pnpm-workspace.yaml`, `nodeLinker: hoisted`),
-> so a plugin folder under the profile's `node_modules/` is picked up by pnpm's hoisted
-> linking automatically — no manual lockfile edits. Prefer Option 1 (`dsh plugin add`) if
-> you want a registry install.
+Also writes into the dependency table, so the market recognizes it. No pnpm available?
+Use Option 1 (`dsh plugin add` wraps pnpm).
 
-### Option 3: Git clone
+### Option 3: Git clone (developers / offline)
 
 ```bash
 git clone https://github.com/XHR666/dsh-mpkg-wallpaper.git $DSH_HOME/profiles/node_modules/dsh-mpkg-wallpaper
+# then register in the profile's cordis.patch.yml:
+#   - insert:
+#       - id: dsh-mpkg-wallpaper
+#         name: dsh-mpkg-wallpaper
+# restart to take effect
 ```
 
-Uninstall: `dsh plugin --profile web remove dsh-mpkg-wallpaper` (or remove the mount line + delete the plugin directory + restart).
-
-> **Why does the plugin market show this plugin but not in the "installed plugins" list?**
-> The market's installed detection reads only the profile's `package.json` dependencies.
-> Manual installs (Option 2/3: clone into `node_modules` + `cordis.patch.yml` insert) are
-> not recorded there, so the market reports "not installed" — this only affects the market
-> display, not the wallpaper feature. To be recognized as installed (and market-managed for
-> updates), install via **Option 1** `dsh plugin add` and remove the old manual copy (the
+> Note: Option 3 is a manual placement and is **not** recorded in the dependency table —
+> the market won't report it as installed (market display only; the wallpaper feature is
+> unaffected). For market recognition use Option 1/2, and remove the old manual copy (the
 > `cordis.patch.yml` insert line + plugin directory) to avoid double-loading the plugin.
 
+Uninstall: `dsh plugin --profile web remove dsh-mpkg-wallpaper`.
+
 
 ## Official Docs
 
@@ -198,6 +197,11 @@ dsh-mpkg-wallpaper/
 ```
 
 
+## Acknowledgements
+
+- [Bil812](https://github.com/Bil812) — proposed wallpaper tint, adaptive text color and full-screen unified-mask appearance ideas in [PR #2](https://github.com/XHR666/dsh-mpkg-wallpaper/pull/2) and maintains a long-running fork. The wallpaper tint, adaptive ink, blue-cleanup and color-picker ideas were absorbed as the plugin's **Aqua experiment** mode (toggles, off by default).
+- [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) community — listing & promotion.
+
 ## Notes for Distribution
 
 ### Portability

package/README.md

@@ -16,7 +16,7 @@
 - **视频文件**：直接选择 mp4/webm 文件作为视频背景
 
 **🌊 整屏虚化（磨砂）体系**
-- **统一虚化（独立分组）**：一个条控制整屏壁纸模糊度（0 = 壁纸清晰，拉高 = 越来越模糊）；侧边栏/标题栏白雾厚度、聊天区跟随、新会话按钮跟随独立可调；开启时接管下方各项（界面虚化里的侧边栏磨砂、标题栏磨砂、磨砂模糊条被接管并提示）
+- **统一虚化（独立分组）**：一个条控制整屏壁纸模糊度（0 = 壁纸清晰，拉高 = 越来越模糊）；侧边栏白雾厚度、聊天区跟随、新会话按钮跟随独立可调；开启时接管侧边栏磨砂与磨砂模糊条（标题栏不接管，按自己的磨砂条，默认透明）
 - **界面虚化（独立分组）**：
   - **虚化对话框**：通用居中窗口 + 聊天输入框（背景磨砂，滚动经过输入框的文字变朦胧）
   - **虚化设置面板**：DSH 设置面板独立开关 + 程度
@@ -27,6 +27,10 @@
 **🎬 镜头与外观**
 - 镜头缩放（10–2000%）与平移、侧边栏/标题栏透出壁纸开关、轻度锐化、Deep diving 背景框
 
+**🧪 Aqua 实验模式（默认全关，不影响原功能）**
+- 可开关的社区方案实验：**统一雾**（全屏遮罩统一雾色，强度独立滑条）、**面板匹配壁纸色**（自动取色 + 强度滑条 + 自定义取色盘）、**自适应文字色 + 蓝色清理**（品牌色统一，带自定义取色盘）、**深底文字可读增强**、**任务列表磨砂**
+- 设置页顶部 Tab 分类切换（来源/外观/统一虚化/界面虚化/透出壁纸/Aqua/其他）
+
 **🚀 大文件混合模式（hybrid）**
 - 开启后 mpkg **流式上传到 DSH 宿主** → 磁盘存储 → HTTP Range 流式播放，**支持 >600MB 的大文件**，内存占用极低
 - 关闭则回到纯浏览器模式（600MB 上限）
@@ -117,47 +121,41 @@
 
 ## 安装
 
-### 方式一：dsh plugin add（推荐）
+插件已发布到 npm（`dsh-mpkg-wallpaper`）。任选一种：
+
+### 方式一：dsh plugin add（推荐，市场可识别）
 
 ```bash
 dsh plugin --profile web add dsh-mpkg-wallpaper
 # 重启 dsh web 后浏览器 Ctrl+F5 生效
 ```
 
-### 方式二：pnpm 安装（profile 是 pnpm workspace 时的标准做法）
-
-```bash
-# 1. 把插件目录放到 profile 的 node_modules 下
-#    （或用 GitHub 下载的 zip 解压）
-git clone https://github.com/XHR666/dsh-mpkg-wallpaper.git $DSH_HOME/profiles/web/node_modules/dsh-mpkg-wallpaper
-#    （若 profile 不在 ~/.dsh/profiles/web，把路径换成你的 profile 目录）
+从 npm 官方仓库安装，会写入 profile 的 `package.json` 依赖表——插件市场自动识别为「已安装」，并可显示下载量、用市场管理更新。
 
-# 2. 在 profile 的 cordis.patch.yml 注册一行：
-#    - insert:
-#        - id: dsh-mpkg-wallpaper
-#          name: dsh-mpkg-wallpaper
+### 方式二：pnpm 手动安装（profile 是 pnpm workspace 时）
 
-# 3. 重启 dsh web，浏览器 Ctrl+F5 生效
+```bash
+# 在 profile 目录下执行（将 <profile> 换成你的 profile 名，如 web）
+pnpm --dir $DSH_HOME/profiles/<profile> add dsh-mpkg-wallpaper
+# 重启 dsh web，浏览器 Ctrl+F5 生效
 ```
 
-> 注：DSH profile 使用 pnpm workspace（`pnpm-workspace.yaml`，`nodeLinker: hoisted`），
-> 插件目录放在 profile 的 `node_modules/` 下即可被 pnpm 的 hoisted 链接识别，
-> 无需手动改 lockfile；若你更习惯 registry 安装，用方式一 `dsh plugin add`。
+同样写入依赖表，市场可识别。若你的环境没有 pnpm，用方式一（`dsh plugin add` 内部就是 pnpm）。
 
-### 方式三：GitHub 克隆
+### 方式三：GitHub 克隆（开发者 / 离线场景）
 
 ```bash
 git clone https://github.com/XHR666/dsh-mpkg-wallpaper.git $DSH_HOME/profiles/node_modules/dsh-mpkg-wallpaper
+# 然后在 profile 的 cordis.patch.yml 注册：
+#   - insert:
+#       - id: dsh-mpkg-wallpaper
+#         name: dsh-mpkg-wallpaper
+# 重启后生效
 ```
 
-卸载：`dsh plugin --profile web remove dsh-mpkg-wallpaper`（或删除挂载行 + 插件目录 + 重启）。
+> 注：方式三是手动放置，**不会**写入依赖表——插件市场不识别为「已安装」（仅影响市场显示，不影响功能）。要市场识别请用方式一/方式二，并移除旧的手动副本（`cordis.patch.yml` 的 insert 行 + 插件目录），避免同一插件被加载两次。
 
-> **为什么插件市场里显示了本插件、但「已安装插件」列表里没有？**
-> 插件市场的已安装检测只读 profile 的 `package.json` 依赖表。方式二/方式三（手动 clone
-> 到 `node_modules` + `cordis.patch.yml` insert）不会被依赖表记录，所以市场判为「未安装」
-> ——不影响壁纸功能，只是市场显示如此。想被市场识别为已安装（并可用市场管理更新），
-> 请用**方式一** `dsh plugin add` 安装，并把旧的手动副本（`cordis.patch.yml` 的 insert 行 +
-> 插件目录）移除，避免同一插件被加载两次。
+卸载：`dsh plugin --profile web remove dsh-mpkg-wallpaper`。
 
 
 ## 官方文档
@@ -197,6 +195,11 @@ dsh-mpkg-wallpaper/
 ```
 
 
+## 致谢
+
+- [Bil812](https://github.com/Bil812) — 在 [PR #2](https://github.com/XHR666/dsh-mpkg-wallpaper/pull/2) 中提出壁纸取色、自适应文字色、全屏统一遮罩等外观方案，并长期维护 fork。其中**壁纸取色、自适应文字色、蓝色清理、取色盘**等思路已吸收为本插件的「Aqua 实验」模式（可开关，默认关）。
+- [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 社区 — 收录与推广。
+
 ## GitHub 发布说明
 
 ### 可移植性（在他人的设备上也能用）