dsh-folia 1.5.1 → 1.6.1

package/README.md

@@ -1,10 +1,31 @@
 # dsh-folia
 
-DSH Desktop 的壁纸插件。基于 [dsh-plugin-wallpaper-engine](https://www.npmjs.com/package/dsh-plugin-wallpaper-engine)（MIT，© 2026 elysia395）二次开发，**保留其全部功能**，并增加一个自建站点数据源。
+DSH Desktop 的壁纸插件。基于 [dsh-plugin-wallpaper-engine](https://www.npmjs.com/package/dsh-plugin-wallpaper-engine)（MIT，© 2026 elysia395）二次开发：**保留其全部功能**，并增加一个自建站点数据源。
+
+**不依赖上游插件**——装这一个包就能用。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-folia
+```
+
+安装后重启 DSH Desktop。
+
+## 两个包
+
+| 包 | 作用 |
+| :-- | :-- |
+| `dsh-folia` | 主包：浏览器半边（31k 行客户端）+ `cordis.patch.yml` + 站点数据源补丁 |
+| `dsh-folia-host` | 宿主包：把主包的宿主半边重新导出成独立插件，提供 `wallpaperEngineHost` 服务 |
+
+为什么需要宿主包：`cordis.patch.yml` 里宿主那一行（`id: wallpaper-engine`）的 `name` **不能指向 patch 自己所属的 bundle 包名**——会被加载器当成重复项跳过，导致 `wallpaperEngineHost` 服务不被注册，7 个子模块永久停留在 `pending`。所以宿主行必须指向另一个包名，这就是 `dsh-folia-host` 存在的唯一理由。
+
+主包把 `dsh-folia-host` 列为依赖，因此安装时两个包会自动一起装上。
 
 ## 与上游的差异
 
-**全仓库只有一处功能改动**，位于 `lib/routes/inventory.js`：
+功能改动**只有一处**，位于 `lib/routes/inventory.js`：
 
 ```js
 const payload = await buildInventory();
@@ -14,21 +35,19 @@ const merged = remote.length
   : payload;
 ```
 
-`foliaRemote()` 负责把站点上的视频壁纸转成插件认识的条目形状，并带 60 秒缓存。站点不可达时返回空数组，**不影响本地 Wallpaper Engine 库**。
+`foliaRemote()` 把站点上的视频壁纸转成插件认识的条目形状，60 秒缓存。站点不可达时返回空数组，**不影响本地 Wallpaper Engine 库**。
 
-其余 143 个文件与上游 1.4.0 完全一致。
+其余文件与上游 1.4.0 逐字节一致。
 
 ## 站点数据源
 
-默认地址：`https://folia-major-3t6.pages.dev`
-
-可通过环境变量覆盖：
+默认 `https://folia-major-3t6.pages.dev`，可用环境变量覆盖：
 
 ```bash
 DSH_FOLIA_SITE=https://your-site.pages.dev
 ```
 
-站点需要提供 `/manifest.json`：
+站点需提供 `/manifest.json`：
 
 ```json
 {
@@ -47,25 +66,11 @@ DSH_FOLIA_SITE=https://your-site.pages.dev
 
 只注入 `kind: "video"`（或 `.mp4` / `.webm` 后缀）的条目——上游没有静态图片的渲染管线。
 
-## 安装
-
-```bash
-dsh plugin --profile web add dsh-folia-wallpaper
-```
-
-或从本仓库安装：
-
-```bash
-dsh plugin --profile web add github:lehua-art/dsh-folia
-```
-
-安装后重启 DSH Desktop。
-
 ## 功能（全部来自上游）
 
-- 场景壁纸实时渲染（WebWallGL，WebGL）
+- 场景壁纸实时渲染（WebWallGL / WebGL）
 - 视频壁纸播放
-- 玻璃材质、可读性地板、透明度/模糊调节
+- 玻璃材质、可读性地板、透明度与模糊调节
 - 壁纸库面板：列表/卡片、标签、排序、属性
 - 播放列表、轮播、遮挡暂停、自动画质
 - 字体系统、视差层、特效层、吉祥物头像、媒体桥
@@ -78,6 +83,7 @@ dsh plugin --profile web add github:lehua-art/dsh-folia
 | `lib/webwallgl/` | 场景渲染页（引擎为 npm 依赖 `webwallgl`） |
 | `lib/routes/inventory.js` | **唯一改动的文件** |
 | `cordis.patch.yml` | 插件行注册（8 个宿主行） |
+| `packages/dsh-folia-host/` | 宿主包装包的源码（发布为 `dsh-folia-host`） |
 
 ## 许可
 

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# dsh-plugin-wallpaper-engine bundle patch.
+# dsh-folia bundle patch.
 #
 # Applied over the dsh-web-app layer. This bundle contributes EIGHT host rows:
 #   - four owned by the main package: the plugin that scans Wallpaper Engine and
@@ -36,7 +36,7 @@
     # row `name` is now the real package name (resolved through <profile>/node_modules,
     # same as the fx / parallax / fonts rows below). The `id` is frozen.
     - id: wallpaper-engine-about-notice
-      name: 'dsh-plugin-wallpaper-engine-about-notice'
+      name: 'dsh-folia-about-notice'
     # Third row: the `mascot-avatar` component's host half (C6, P2-2) — the custom
     # mascot image (/mascot) and the two session avatars (/avatar/<side>). Same
     # shape as the row above (independent plugin, re-enters `applyComponent`);
@@ -45,7 +45,7 @@
     # row `name` is now the real package name (resolved through <profile>/node_modules,
     # same as the fx / parallax / fonts rows below). The `id` is frozen.
     - id: wallpaper-engine-mascot-avatar
-      name: 'dsh-plugin-wallpaper-engine-mascot-avatar'
+      name: 'dsh-folia-mascot-avatar'
     # Fourth row: the `media-bridge` component's host half (third component) — the
     # system media integration (now playing / spectrum / artwork / reverse control)
     # and its backend (the media-bridge child process with the built-in fallback).
@@ -57,7 +57,7 @@
     # row `name` is now the real package name (resolved through <profile>/node_modules,
     # same as the fx / parallax / fonts rows below). The `id` is frozen.
     - id: wallpaper-engine-media-bridge
-      name: 'dsh-plugin-wallpaper-engine-media-bridge'
+      name: 'dsh-folia-media-bridge'
       # webServer is a hard dependency (`inject = ['webServer']` in lib/index.js):
       # the Loader waits for the HTTP server to mount, so a headless/TUI profile
       # without one does not load this bundle at all.
@@ -68,20 +68,20 @@
     # 解析不到就**大声抛错**（宿主对行级失败是静默的 —— §4.1 I5）。
     # 可选桌宠联动；没有 dsh-pet 或首次准备未完成时保留吉祥物原生行为。
     - id: wallpaper-engine-pet-link
-      name: 'dsh-plugin-wallpaper-engine-pet-link'
+      name: 'dsh-folia-pet-link'
     # fx：点击拖尾 + 特效扩展（src/fx-layer.js、src/ext-fx.js），浏览器半边在本包自己的产物里。
     - id: wallpaper-engine-fx
-      name: 'dsh-plugin-wallpaper-engine-fx'
+      name: 'dsh-folia-fx'
     # parallax：3D 视差层（src/parallax-layer.js、src/ext-parallax.js），同上。
     - id: wallpaper-engine-parallax
-      name: 'dsh-plugin-wallpaper-engine-parallax'
+      name: 'dsh-folia-parallax'
     # fonts：整个字体系统（P-C 之后宿主半边 + 浏览器半边都在本包）
     #   · 宿主半边：lib/routes/fontsets.js、lib/routes/system-fonts.js 两条路由族；
     #   · 浏览器半边：外观页签第六节「全局字体」+ 字体集编辑器 ⇒ 产物 lib/client.fonts.js。
     # 注意（§6.1 = A / ADR-0013 D20）：随包走的只是**渲染器与描述符**；字体的键、默认值、
     # 消毒与持久化仍在主包 lib/settings-schema.js（FONTSET_KEYS）与 fontsets/<id>.json。
     - id: wallpaper-engine-fonts
-      name: 'dsh-plugin-wallpaper-engine-fonts'
+      name: 'dsh-folia-fonts'
     # ── 内置桌宠本体：已解耦（2026-10-20）────────────────────────────────────────
     # `packages/pet`（`dsh-we-pet-builtin`）与它的 `wallpaper-engine-pet` 行**已从本包移除**：
     # 它把 `electron`（optional）带进安装树，而 electron 42+ 在缺少 `dist/` 时会在

package/lib/client.js

@@ -1,5 +1,5 @@
 window.__ModuleLoader__.load({
-	id: "dsh-plugin-wallpaper-engine",
+	id: "dsh-folia",
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
@@ -5870,7 +5870,7 @@ window.__ModuleLoader__.load({
 				let weSidebarOpenFn = null; // 官方态的 openTab 调用（抽屉态为 null）
 				let weSidebarCtrl = null;   // 官方态控制器（isExpanded/active/toggleExpanded 的宿主面）
 				const WE_SIDEBAR_KIND = "wallpaper-library";
-				const WE_SIDEBAR_ID = "dsh-plugin-wallpaper-engine/library";
+				const WE_SIDEBAR_ID = "dsh-folia/library";
 
 				function sidebarRightMode() {
 				  return weSidebarMode;
@@ -31313,7 +31313,7 @@ window.__ModuleLoader__.load({
 		};
 
 		// ── 跨包浏览器半边通道（BUNDLE-SPLIT §6.2「宿主注入显式键集」）──────────────────────────
-		// 子包产物由 loader 用 `require("dsh-plugin-wallpaper-engine")` 取本 bundle 的导出面。
+		// 子包产物由 loader 用 `require("dsh-folia")` 取本 bundle 的导出面。
 		// 这里挂的是**显式键集**，不是整个 module.exports：子包要什么就登记什么，多给一个键就是多
 		// 一条没人维护的隐式契约。键集与 packages/{fx,parallax,fonts}/src/client.js 的
 		// *_HOST_REQUIRED 逐字对齐（缺键那三包自己会大声抛），判据见 test/verify-subpackage-client-half.mjs

package/lib/index.js

@@ -103,10 +103,10 @@ import { registerCacheDirRoutes } from './routes/cache-dir.js';
 // 实现），**不是**跨包通道 —— 跨包通道只有 `ctx.wallpaperEngineHost`（ADR-0014 S5.1/S5.2）；
 // 该边随 §12 的发布形态（主包精确依赖子包）成立，开发期由根 `devDependencies` 的
 // `file:packages/<组件>` 提供。
-import { applyImpl as applyAboutNoticeImpl } from 'dsh-plugin-wallpaper-engine-about-notice';
-import { applyImpl as applyMascotAvatarImpl } from 'dsh-plugin-wallpaper-engine-mascot-avatar';
+import { applyImpl as applyAboutNoticeImpl } from 'dsh-folia-about-notice';
+import { applyImpl as applyMascotAvatarImpl } from 'dsh-folia-mascot-avatar';
 // 第三件组件（媒体桥入包）：路由族、后端实现与 macOS 音频 tap 源码随包走 ⇒ 门面只剩分发点。
-import { applyImpl as applyMediaBridgeImpl } from 'dsh-plugin-wallpaper-engine-media-bridge';
+import { applyImpl as applyMediaBridgeImpl } from 'dsh-folia-media-bridge';
 // 组件行**浏览器可见面**的声明单一真源（ADR-0013 D3②）：宿主侧持有"组件名 → 浏览器渲染落点"，
 // 浏览器侧只持有 gate（`COMPONENT_GATE` 指向的那一个判定函数）；对账在
 // `test/verify-component-visibility.mjs`。这里**再导出**一次，使它落在 import 图上 ——
@@ -393,7 +393,7 @@ export function apply(ctx) {
   });
 
   // 6b. 字体集族路由（list / get / put / delete / activate / import / export）**已出户**到子包行
-  //     `dsh-plugin-wallpaper-engine-fonts`（P-A，packages/fonts/lib/routes/fontsets.js，
+  //     `dsh-folia-fonts`（P-A，packages/fonts/lib/routes/fontsets.js，
   //     patch 里 `id: wallpaper-engine-fonts`）。一个 `prefix` 注册覆盖七个端点；客户端半边
   //     （设置面板的字体段）仍留主 bundle —— §7.1「P-A 不动设置面板」。
   //     门面**不再**有这条调用点：那一行的 c 面由 `lib/subpackage-boot.js` 的冻结键集喂
@@ -425,7 +425,7 @@ export function apply(ctx) {
   //     按运行时注册逐条对账；全表与每族条数用 `node test/tools/host-route-index.mjs` 现算。
 
   // 6c′. 本机字体清单（设置页「全局字体 / 终端字体」下拉里那一组）**已出户**到同一子包行
-  //      `dsh-plugin-wallpaper-engine-fonts`（packages/fonts/lib/routes/system-fonts.js）。
+  //      `dsh-folia-fonts`（packages/fonts/lib/routes/system-fonts.js）。
   //      三平台各一条权威来源（system_profiler / PowerShell / fc-list），拿不到时按文件名推
   //      并**如实标 approximate**；一次扫描很贵（macOS 实测 ~10s）⇒ 双层缓存 + 过期先回旧值。
   //      扫描**不在启动期**发生：第一次请求这条路才触发（族文件头的不变量）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-folia",
-  "version": "1.5.1",
+  "version": "1.6.1",
   "description": "Folia 壁纸引擎：在 dsh-plugin-wallpaper-engine（MIT, elysia395）基础上增加自建站点数据源",
   "type": "module",
   "engines": {
@@ -78,14 +78,14 @@
   "dependencies": {
     "webwallgl": "^3.0.0",
     "x11": "^4.3.1",
-    "dsh-plugin-wallpaper-engine-about-notice": "1.4.0",
-    "dsh-plugin-wallpaper-engine-fonts": "1.4.0",
-    "dsh-plugin-wallpaper-engine-fx": "1.4.0",
-    "dsh-plugin-wallpaper-engine-mascot-avatar": "1.4.0",
-    "dsh-plugin-wallpaper-engine-media-bridge": "1.4.0",
-    "dsh-plugin-wallpaper-engine-parallax": "1.4.0",
-    "dsh-plugin-wallpaper-engine-pet-link": "1.4.0",
-    "dsh-folia-host": "1.5.1"
+    "dsh-folia-about-notice": "1.5.1",
+    "dsh-folia-fonts": "1.5.1",
+    "dsh-folia-fx": "1.5.1",
+    "dsh-folia-mascot-avatar": "1.5.1",
+    "dsh-folia-media-bridge": "1.5.1",
+    "dsh-folia-parallax": "1.5.1",
+    "dsh-folia-pet-link": "1.5.1",
+    "dsh-folia-host": "1.6.1"
   },
   "overrides": {
     "js-yaml": "4.3.2"