dsh-mpkg-wallpaper 3.3.1 → 3.3.2

package/lib/client.js

@@ -1427,10 +1427,12 @@ window.__ModuleLoader__.load({
 				wrap.style.setProperty("--mpw-lensY", String(section.lensY !== void 0 ? section.lensY : 0) + "px");
 				wrap.classList.toggle("mpw-sharp", section.sharp !== void 0 ? !!section.sharp : DEFAULT_SHARP);
 				// ⑯ 磨砂模糊条 → 壁纸层 blur（0 = 完全清晰）。
-				// ①(修正) 壁纸 blur 归谁管：
-				//  - 统一虚化开 + chatFollow 开 → unifyAmount 接管（整屏统一模糊）
-				//  - 统一虚化开 + chatFollow 关 → 磨砂条控制壁纸 blur；侧边栏/标题栏毛玻璃
-				//    由壁纸层 blur + 表面半透明提供（见 frostedLayers 注释）
+				// ①(修正) 壁纸 blur 归谁管（用户澄清：chatFollow=聊天区跟随整屏虚化）：
+				//  - 统一虚化开 + chatFollow 开 → unifyAmount 接管**壁纸层 blur**
+				//    （聊天区也跟随整屏虚化）
+				//  - 统一虚化开 + chatFollow 关 → **壁纸层 blur 由磨砂条控制（聊天区
+				//    不跟随）**；侧边栏/标题栏的虚化由 buildCss 的 backdrop blur
+				//    (unifyAmount) 单独提供（见 G 块）
 				//  - 统一虚化关 → 磨砂条控制
 				const unifyTintApply = section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT;
 				const chatFollowApply = section.chatFollow !== void 0 ? !!section.chatFollow : DEFAULT_CHAT_FOLLOW;
@@ -1456,6 +1458,7 @@ window.__ModuleLoader__.load({
 				else document.body.removeAttribute("data-mpw-sblur");
 			} catch {}
 			try { setupSblurObserver(); } catch {}
+			try { setupHeaderBlurWatch(); } catch {}
 			try { setupAquaThemeWatch(); } catch {}
 			// ①(新) 主题颜色：body 门控 + CSS 变量（控制侧边栏/标题栏/新会话/设置弹窗底色）
 			try {
@@ -1973,8 +1976,8 @@ window.__ModuleLoader__.load({
 			// ①(新) 侧边栏磨砂（Aqua 方案：sidebarCol 自身 backdrop-filter）
 			const sidebarBlur = section.sidebarBlur !== void 0 ? !!section.sidebarBlur : DEFAULT_SIDEBAR_BLUR;
 			const sidebarBlurAmount = section.sidebarBlurAmount !== void 0 ? section.sidebarBlurAmount : DEFAULT_SIDEBAR_BLUR_AMOUNT;
-			// ②(修正) chatFollow（统一虚化开时聊天区是否跟随整屏虚化）：
-			// 关 → 聊天区壁纸由磨砂条控制，侧边栏/标题栏背后仍需跟随整屏虚化度
+			// ②(修正) chatFollow（统一虚化开时聊天区是否跟随整屏虚化）：关 → 聊天区
+			// 壁纸由磨砂条控制，侧边栏/标题栏虚化由 G 块 backdrop blur(unifyAmount) 提供
 			const chatFollowInCss = section.chatFollow !== void 0 ? !!section.chatFollow : DEFAULT_CHAT_FOLLOW;
 			// ②(新) 弹层虚化（菜单/提示/遮罩）独立于对话框虚化
 			const popoverBlur = section.popoverBlur !== void 0 ? !!section.popoverBlur : DEFAULT_POPOVER_BLUR;
@@ -2201,12 +2204,16 @@ ${frostedLayers}
 				// ①(修正) 标题栏磨砂。**绝不能给 header 本体加 backdrop-filter**——
 				// header 有 fixed 子元素（子代理展开面板/后台任务条），backdrop-filter 会成为
 				// 它们的 containing block，导致面板定位错乱（用户实测 bug）。
-				// ①(修正) 标题栏雾底：unify 开 → **透明**（session log 按钮/标准模式标签
-				// 后的白框 = 标题栏白底，用户两次要求去掉；标题栏直接透出模糊壁纸）；
-				// unify 关 → 按「标题栏磨砂程度」条（默认 0=透明，需要雾底自行拉高）。
-				// 侧边栏白雾由「侧边栏/标题栏透明度」条控制（仅侧边栏）。
+				// ①(修正) 标题栏雾底与**统一虚化联动**：unify 开 → 标题栏与侧边栏同款
+				// 白雾厚度（U(panel)=sidebarAlpha「侧边栏/标题栏透明度」），两个条
+				// （unifyAmount 壁纸模糊 + sidebarAlpha 白雾）同时作用于标题栏与侧边栏
+				// （用户实测：统一虚化只能控侧边栏，标题栏不变——此前 headerBlurAmount
+				// 与 unify 脱节）。unify 关 → 按「标题栏磨砂程度」条（headerBlurAmount，
+				// 0=透明透出壁纸，拉高=白雾）。
+				// 标题栏内部按钮/logo 白框在 unify 下保持透明（用户此前要求去白框，
+				// 靠 hover 交互态保留可读性）。
 				const hblurAmt = section.headerBlurAmount !== void 0 ? section.headerBlurAmount : DEFAULT_HEADER_BLUR_AMOUNT;
-				const hdrAlpha = unifyTint ? 0 : Math.max(0, Math.min(100, hblurAmt));
+				const hdrAlpha = unifyTint ? U(panel) : Math.max(0, Math.min(100, hblurAmt));
 				const hdrBg = `color-mix(in srgb, var(--dsw-static-neutral-bluish-950) ${hdrAlpha}%, transparent)`;
 				css += `
 .wSkVaW_header {
@@ -2443,23 +2450,23 @@ html body[data-mpw-sblur][data-mpw-sblur-off] [class*="sidebarCol"] {
 }
 `;
 			}
-			// ── F. 统一虚化 + 聊天区不跟随：侧边栏背后叠加整屏虚化度 ──
-			// chatFollow 关 → 壁纸层 blur = 磨砂条（frostBlur）供聊天区；
-			// 侧边栏背后再叠 backdrop blur(unifyAmt)，调整「整屏虚化程度」即可改变
-			// 侧边栏背后的虚化（用户实测：当前关了 chatFollow 后 unifyAmount 失效）。
-			// 弹窗打开时 body[data-mpw-sblur-off] 摘除（复用侧边栏磨砂的摘除机制，
-			// backdrop-filter 会困住 fixed 弹窗）。unify 关时不输出。
-			// ①(修正) **绝不把 header 放进这条规则**——header 内有 absolute 的
-			// 子代理/后台任务展开面板（h8S2Va_menu / JObwrW_panel），backdrop-filter
-			// 会成为它们的 containing block → 面板定位错乱、z-index 失效，
-			// 被聊天文字盖住（用户实测：悬浮+统一虚化组合下标题栏展开的
-			// 子代理/后台任务名称叠到对话框文字下面）。header 无 backdrop-filter。
+			// ── G. 统一虚化 + 聊天区不跟随：侧边栏/标题栏叠加整屏虚化度 ──
+			// chatFollow 关 → 壁纸层 blur = 磨砂条（聊天区不跟随，用户澄清）；
+			// 侧边栏/标题栏的"虚化程度"由这里的 backdrop blur(unifyAmount) 提供——
+			// 调「整屏虚化程度」即可改变它们背后的模糊（用户实测：chatFollow 关时
+			// unifyAmount 只控侧边栏、标题栏不变 → 之前 F 块排除了 header）。
+			// ①(修正) **标题栏 backdrop blur 只在无展开面板时生效**：header 内有
+			// absolute 的子代理/后台任务展开面板（JObwrW_panel），backdrop-filter 会成为
+			// 它们的 containing block → 面板定位错乱、z-index 失效。展开面板出现时
+			// JS 打 data-mpw-header-blur-off 摘除（见 setupHeaderBlurWatch）。
+			// 弹窗打开时 body[data-mpw-sblur-off] 同样摘除（复用侧边栏磨砂机制）。
 			if (unifyTint && !chatFollowInCss && unifyAmount > 0 && bdSupported) {
 				css += `
-/* ── 统一虚化 + 聊天区不跟随：侧边栏背后叠加整屏虚化度（header 除外，
-   见上：backdrop-filter 会困住标题栏展开面板） ── */
-html body:not([data-mpw-sblur-off]) .pI_x6G_sidebarCol,
-html body:not([data-mpw-sblur-off]) [class*="sidebarCol"] {
+/* ── 统一虚化 + 聊天区不跟随：侧边栏/标题栏背后叠加整屏虚化度（标题栏展开面板
+   出现时由 data-mpw-header-blur-off 摘除，防困住面板） ── */
+html body:not([data-mpw-sblur-off]):not([data-mpw-header-blur-off]) .pI_x6G_sidebarCol,
+html body:not([data-mpw-sblur-off]):not([data-mpw-header-blur-off]) [class*="sidebarCol"],
+html body:not([data-mpw-sblur-off]):not([data-mpw-header-blur-off]) .wSkVaW_header {
 	backdrop-filter: blur(${unifyAmount}px) !important;
 	-webkit-backdrop-filter: blur(${unifyAmount}px) !important;
 }
@@ -2538,10 +2545,21 @@ ${unifyTint ? `body:not([data-ds-dark-theme]) [data-cordis-panel] [class*="row"]
 [data-sidebar-collapsed] .pI_x6G_sidebarCol { border-right-color: transparent !important; }
 [data-sidebar-collapsed] [class*="sidebarCol"] { border-right-color: transparent !important; }
 /* 区域5b: 收起后 rail 内部面（logoRow/newSession/footArea）透出模糊壁纸：
-   同样不加 backdrop-filter（root 是弹层祖先，会困住 fixed 弹层） */
-[data-sidebar-collapsed] [class*="root"] {
+   同样不加 backdrop-filter（root 是弹层祖先，会困住 fixed 弹层）。
+   ①(修正) 必须限定在 sidebarCol 内——data-sidebar-collapsed 挂在 frame 上，
+   原写法 [class*="root"] 会命中**全应用**所有 class 含 root 的元素
+   （聊天区 todo 卡片等），侧边栏收起时把它们背景强制透明
+   （用户实测：收起时 todo list 变透明，展开恢复）。 */
+[data-sidebar-collapsed] [class*="sidebarCol"] [class*="root"],
+[data-sidebar-collapsed] .pI_x6G_sidebarCol [class*="root"] {
 	background-color: transparent !important;
 }
+/* ②(修正) 收起态悬浮外壳**绝不设 position/z-index**：设置面板（sidebar.settings
+   的 full-viewport fixed overlay，z-index:1000）渲染在 sidebarCol 内，一旦给
+   sidebarCol 设 position:relative + z-index，就创建包含块/层叠上下文 → overlay
+   的 fixed 定位被侧边栏困住，对话框叠在设置上、位置错乱（用户实测：悬浮开 +
+   侧边栏收起时点设置，对话框盖在设置面板上方）。悬浮只做 margin/圆角/边框，
+   层叠交给 DSH 自己（overlay z-index:1000 恒在 rail 内容之上）。 */
 `;
 			}
 			// ①(修正) 遮罩虚化无条件生效（不依赖是否有壁纸——无壁纸时弹窗遮罩也要模糊，
@@ -3011,13 +3029,27 @@ body[data-mpw-float] [data-sidebar-collapsed] [class*="sidebarCol"] {
 	border-radius: 12px;
 	border: 1px solid rgba(19,45,83,0.26);
 	overflow: visible;
-	position: relative;
-	z-index: 5;
+	/* ②(修正) 不设 position/z-index：设置面板 fixed overlay 在 sidebarCol 内，
+	   设了会被困住叠在设置上（见区域5b 注释） */
 	transition: margin 0.18s ease, padding 0.18s ease, border-radius 0.18s ease, border-color 0.18s ease;
 }
 body[data-mpw-float] body[data-ds-dark-theme] [data-sidebar-collapsed] .pI_x6G_sidebarCol,
 body[data-mpw-float] body[data-ds-dark-theme] [data-sidebar-collapsed] [class*="sidebarCol"] {
 	border-color: rgba(148,180,220,0.32);
+}
+/* ②(修正) 设置面板打开时（data-mpw-float-off，见 setupSblurObserver）：悬浮外壳
+   完全让位——sidebarCol 回到 DSH 默认布局（无 margin/padding/圆角/overflow），
+   设置面板 full-viewport fixed overlay 正常全屏，输入框/todo 不再浮到设置面上。
+   悬浮只影响外观，设置面板打开期间不叠加任何布局干扰。 */
+body[data-mpw-float-off] body[data-mpw-float] .pI_x6G_sidebarCol,
+body[data-mpw-float-off] body[data-mpw-float] [class*="sidebarCol"] {
+	margin: 0; padding: 0; border: none; border-radius: 0; overflow: visible;
+}
+body[data-mpw-float-off] body[data-mpw-float] .wSkVaW_header {
+	margin: 0; padding: 0; border: none; border-radius: 0;
+}
+body[data-mpw-float-off] body[data-mpw-float] [data-mpw-sidebar-root] {
+	width: auto !important; background: transparent !important; border-radius: 0;
 }` : ""}
 /* ③(修正) 弹窗打开时：背后的设置面板只去掉 backdrop-filter（不再让字晕染），
    背景保持原来的半透明（透出壁纸）——绝不整体改成深色（会导致设置界面变黑）。
@@ -3618,12 +3650,17 @@ body[data-mpw-modal] [role="dialog"] {
 					setUpdState(d.ok ? d : { error: String(d.error || "fail") });
 				} catch (err) { setUpdState({ error: String(err && err.message || err) }); }
 			};
-			// ①(新) 一键热更新（host 从 GitHub 下载最新代码写回）
+			// ①(新) 一键热更新（host 从 GitHub 下载最新代码写回；仅限本地开发/可写安装）
 			const applyUpdate = async () => {
 				setUpdState({ applying: true });
 				try {
 					const r = await fetch(HOST_BASE + "/update-apply", { method: "POST" });
 					const d = await r.json();
+					// ①(修正) 市场安装（pnpm store 只读）→ host 返回 readonly → 提示走市场更新
+					if (d && d.readonly) {
+						setUpdState({ error: t("update.readonly") });
+						return;
+					}
 					setUpdState(d.ok ? { applied: true } : { error: String(d.error || "fail") });
 				} catch (err) { setUpdState({ error: String(err && err.message || err) }); }
 			};
@@ -5909,7 +5946,7 @@ body[data-mpw-modal] [role="dialog"] {
 			"sec.blur": "界面虚化",
 			"sec.blur.desc": "各类弹层/面板打开时的背景虚化：对话框（通用居中窗口+聊天输入框）、设置面板、下载确认弹窗各自独立；弹层=菜单/下拉/提示；遮罩=弹层背后的全屏背景；侧边栏磨砂=侧边栏自身玻璃化",
 			"sec.unify": "统一虚化",
-			"sec.unify.desc": "整屏所有控件的模糊感由一组设置统一管理（一个条全管侧边栏/标题栏/聊天区）；开启后「界面虚化」里的侧边栏磨砂被接管（标题栏不再接管，按自己的磨砂条）。关闭则各区域单独调节",
+			"sec.unify.desc": "整屏所有控件的模糊感由一组设置统一管理：虚化程度=壁纸模糊度，透明度=侧边栏/标题栏白雾厚度（标题栏也跟随，不再单独调节）；开启后「界面虚化」里的侧边栏磨砂被接管。关闭则各区域单独调节",
 			"sec.show": "透出壁纸",
 			"sec.show.desc": "控制对应区域是否显示壁纸：关=纯色不透明",
 			"sec.other": "其他",
@@ -6023,6 +6060,7 @@ body[data-mpw-modal] [role="dialog"] {
 			"update.fail": "检查失败：",
 			"update.market": "去插件市场更新",
 			"update.gotoMarket": "已提示：请到插件市场（dshmarket）更新此插件（推荐，避免与市场版本检测冲突）",
+			"update.readonly": "当前为市场安装（插件目录只读），无法内置更新——请到插件市场或 dsh plugin update 更新",
 			"update.chooseTitle": "更新方式确认",
 			"update.chooseBody": "推荐先到插件市场更新（semver 检测与市场一致）。确认仍用本插件的直接更新（拉取 GitHub 代码写回本地）吗？版本 ",
 			"roundCompat.desc": "给其他插件注入界面的矩形容器补圆角（不覆盖插件自己的样式）；如与某插件冲突可关闭",
@@ -6237,7 +6275,7 @@ body[data-mpw-modal] [role="dialog"] {
 			"sec.blur": "UI blur",
 			"sec.blur.desc": "Backdrop blur when each popup layer opens: dialogs (generic center windows + chat input), the settings panel, and download/confirm popups each have their own switch; popovers = menus/dropdowns/tooltips; mask = the full-screen dim behind popups; sidebar frost = the sidebar itself becomes glass",
 			"sec.unify": "Unified blur",
-			"sec.unify.desc": "One set of controls rules the frosted feel of every surface (sidebar/titlebar/chat via one slider); when on, sidebar frost below is taken over (the title bar is not taken over - it follows its own frost slider). Off = each area adjusts separately",
+			"sec.unify.desc": "One set of controls rules the frosted feel of every surface: blur degree = wallpaper blur, transparency = sidebar/title-bar fog thickness (the title bar follows it too). When on, the sidebar frost below is taken over. Off = each area adjusts separately",
 			"sec.show": "Show wallpaper",
 			"sec.show.desc": "Whether the corresponding area shows the wallpaper: off = solid color, opaque",
 			"sec.other": "Other",
@@ -6343,6 +6381,7 @@ body[data-mpw-modal] [role="dialog"] {
 			"update.fail": "Check failed: ",
 			"update.market": "Update from plugin market",
 			"update.gotoMarket": "Go update it in the plugin market (dshmarket) instead (recommended, matches the market version check)",
+			"update.readonly": "Installed via the market (plugin dir is read-only), so in-place update is unavailable — update from the plugin market or via dsh plugin update",
 			"update.chooseTitle": "Choose update method",
 			"update.chooseBody": "Prefer updating from the plugin market (semver check matches the market). Still update directly via this plugin (pull GitHub code and write it back locally)? v",
 			"roundCompat.desc": "Adds border-radius to rectangular containers injected by other plugins (does not override their own styles); turn off if it conflicts",
@@ -6446,7 +6485,11 @@ body[data-mpw-modal] [role="dialog"] {
 
 		let styleEl = null;
 		function getStyleEl() {
-			if (!styleEl) {
+			// ①(修正) 同源 web 壁纸 iframe 的 JS 可能操作父页面 document.head（星野类壁纸
+			// 假设独占页面），把我们的 <style> 清掉 → 插件 UI 全部失去样式（开关文字堆叠、
+			// 导航图标错位显示默认图标——用户实测：导入 web 地址后出现，Chrome/Firefox 都有）。
+			// 每次取用时检查 isConnected，脱离 DOM 就重建重挂，样式自愈。
+			if (!styleEl || !styleEl.isConnected) {
 				styleEl = document.createElement("style");
 				styleEl.setAttribute("data-plugin", "dsh-mpkg-wallpaper");
 				(document.head || document.documentElement).appendChild(styleEl);
@@ -6479,8 +6522,18 @@ body[data-mpw-modal] [role="dialog"] {
 					const hasDlg = !!document.querySelector(
 						'[class*="sidebarCol"] [role="dialog"], [class*="sidebarCol"] [role="alertdialog"]'
 					);
-					if (hasDlg) document.body.setAttribute("data-mpw-sblur-off", "");
-					else document.body.removeAttribute("data-mpw-sblur-off");
+					if (hasDlg) {
+						document.body.setAttribute("data-mpw-sblur-off", "");
+						// ②(修正) 设置面板打开时悬浮外壳一并让位：悬浮给 sidebarCol 加
+						// margin/圆角/overflow，设置面板（full-viewport fixed overlay）渲染在
+						// sidebarCol 内，悬浮外壳会让 overlay 布局错乱 → 输入框/todo 浮到
+						// 设置面上（用户实测：侧边栏收起 + 设置页开关悬浮后出现）。打
+						// data-mpw-float-off，悬浮 CSS 让位（见 buildUiCss float-off 规则）。
+						document.body.setAttribute("data-mpw-float-off", "");
+					} else {
+						document.body.removeAttribute("data-mpw-sblur-off");
+						document.body.removeAttribute("data-mpw-float-off");
+					}
 				} catch {}
 			};
 			try {
@@ -6490,6 +6543,31 @@ body[data-mpw-modal] [role="dialog"] {
 			check();
 		}
 
+		// ①(新) 标题栏 backdrop blur 摘除：G 块给 header 加 blur(unifyAmount)（聊天区
+		// 不跟随时的标题栏虚化），但 header 内有 absolute 展开面板（子代理/后台任务，
+		// JObwrW_panel），backdrop-filter 会变成它们的 containing block → 面板定位错乱
+		//（之前用户实测 bug）。展开面板出现在 header 内时打 data-mpw-header-blur-off
+		// 摘除 header 的 backdrop-filter，面板关闭即恢复。只作用于 header 内面板，
+		// 不动侧边栏（sidebarCol 无此问题）。
+		let headerBlurWatch = null;
+		function setupHeaderBlurWatch() {
+			if (headerBlurWatch !== null) return;
+			const check = () => {
+				try {
+					const hasPanel = !!document.querySelector(
+						'[class*="wSkVaW_header"] [class*="panel"], [class*="wSkVaW_header"] [class*="menu"], [class*="wSkVaW_header"] [role="menu"], [class*="wSkVaW_header"] [data-surface]'
+					);
+					if (hasPanel) document.body.setAttribute("data-mpw-header-blur-off", "");
+					else document.body.removeAttribute("data-mpw-header-blur-off");
+				} catch {}
+			};
+			try {
+				headerBlurWatch = new MutationObserver(check);
+				headerBlurWatch.observe(document.body, { childList: true, subtree: true });
+			} catch { headerBlurWatch = null; }
+			check();
+		}
+
 		// ⑲(修正) Aqua 主题切换监听：深色/浅色切换时重算遮罩色与自适应文字色
 		//（用户实测：aquaInk 开时切换主题，文字色卡在旧主题——黑字黑底/白字白底看不清）。
 		let aquaThemeWatch = null;
@@ -6537,6 +6615,37 @@ body[data-mpw-modal] [role="dialog"] {
 			// 不该丢 webUrl。故让 webUrl 持久（刷新后正常恢复，卡了手动刷新即可）。
 			// 若确需"刷新后不自动重载"，可改成只标记、不清 persisted webUrl。（此处保持持久）
 			try { applyFromStorage(); } catch (err) { console.warn("[dsh-mpkg-wallpaper] boot 应用背景失败:", err); }
+			// ①(修正) 样式自愈：同源 web 壁纸 iframe 的 JS 可能清掉父页面 <head> 里的
+			// 本插件 <style>（星野类壁纸假设独占页面）→ 插件 UI 全部失样式（开关文字堆叠、
+			// 导航图标错位）。监听 head 子节点移除：检测到我们的 style 消失立即重建并重写。
+			try {
+				if (!window.__mpwStyleWatch) {
+					window.__mpwStyleWatch = new MutationObserver((muts) => {
+						try {
+							// 只看 removedNodes 是否含我们的 style（或整个 head 被清空重建）
+							let oursGone = false;
+							for (const m of muts) {
+								const rn = m.removedNodes || [];
+								for (let i = 0; i < rn.length; i++) {
+									const n = rn[i];
+									if (!n || n.nodeType !== 1) continue;
+									if (n.getAttribute && n.getAttribute("data-plugin") === "dsh-mpkg-wallpaper") { oursGone = true; break; }
+									if (n.querySelector && n.querySelector('[data-plugin="dsh-mpkg-wallpaper"]')) { oursGone = true; break; }
+								}
+								if (oursGone) break;
+							}
+							if (!oursGone) return; // 其他 style 增删不重写（避免无谓全量重建）
+							const el = getStyleEl(); // isConnected 检查：脱离则重建重挂
+							if (el) {
+								const s = readSection();
+								el.textContent = buildCss(s.enabled === false ? Object.assign({}, s, { image: "" }) : s);
+							}
+						} catch {}
+					});
+					const head = document.head || document.documentElement;
+					if (head) window.__mpwStyleWatch.observe(head, { childList: true, subtree: true });
+				}
+			} catch {}
 			// ⑤(新) 宿主端设置持久化：异步拉取 host /settings（优先于 localStorage），
 			// 拉到后重应用（配置跨端口/清浏览器数据不丢；host 不可用时回退 localStorage）。
 			try { initHostSettings(); } catch {}

package/lib/index.js

@@ -979,6 +979,18 @@ function apply(ctx) {
       handler: async (req, res) => {
         try {
           const dir = new URL('./', import.meta.url);
+          // ①(修正) 市场安装（pnpm store/全局/容器）包目录只读 → 写回必失败（EACCES），
+          // 且写回后 DSH 客户端 bundle 元数据不热更、npm 重装即还原——对市场用户无效甚至有害。
+          // 写前探测可写性：失败直接返回明确提示，引导走 `dsh plugin update` / 插件市场，
+          // 不再让用户看到笼统的 500「更新失败」。
+          try {
+            const probe = new URL('./.update-write-test', dir);
+            writeFileSync(probe, 'ok', 'utf8');
+            unlinkSync(probe);
+          } catch (writeErr) {
+            json(res, 200, { ok: false, readonly: true, error: String(writeErr && writeErr.code || 'EACCES') });
+            return;
+          }
           const client = await fetchRaw('lib/client.js');
           const index = await fetchRaw('lib/index.js');
           if (!client.includes('dsh-mpkg-wallpaper') || !index.includes('dsh-mpkg-wallpaper')) { json(res, 400, { ok: false, error: 'invalid payload' }); return; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mpkg-wallpaper",
-  "version": "3.3.1",
+  "version": "3.3.2",
   "description": "DSH Web 壁纸引擎 Wallpaper Engine mpkg 背景插件：浏览器内直接解析 .mpkg（preview.gif 动态背景/内嵌 mp4 视频/多时段切换），整屏统一虚化/对话框/弹层/遮罩独立虚化、镜头缩放平移、时钟、冲突检测。",
   "private": false,
   "type": "module",