dlaoshi-outfit 2.1.3 → 2.1.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 2.1.4 — 2026-10-22
+
+按 DSH 的「可逆副作用」规范重写挂载流程，支持热重组。
+
+- 所有副作用都成对：样式表、`html` 皮肤类、主题 token、槽位占用全部由 `ctx.effect` 托管，
+  卸载时逐项回滚，不再依赖页面刷新
+- 二次 `apply()` 幂等：先释放上一批槽位占用再挂载，避免热重组后出现两只桌宠
+- 新增自愈：槽位容器还在、本插件节点消失时（HMR 驱逐），约 5 秒内自动重新挂载
+- 测试新增「重复 apply 不重复占用槽位」断言
+
+> 注意：全新安装插件仍需重启一次 Host——DSH 的插件图在启动时组合，这不是插件能绕过的。
+
 ## 2.1.3 — 2026-10-22
 
 修复：网页端加载失败（`__ModuleLoader__` 未注册）。

package/README.md

@@ -123,6 +123,36 @@ Copy-Item "C:\Users\你\Documents\dlaoshi-outfit\*" `
 └── examples/              # profile 配置示例
 ```
 
+## 常见问题
+
+### 装完之后没反应 / 第一次启动不生效
+
+**这是 DSH 的加载机制，不是插件的问题。** 本插件已按「可逆副作用」实现：卸载即回滚、重复挂载不会叠加、被 HMR 驱逐后会自动重挂，但**全新安装仍需重启一次 Host**（插件图只在启动时组合）。 DSH 的插件图（loader entries）在 **Host 启动时组合**；热更新只对已经加载过的客户端 bundle 生效。全新安装一个插件等于往插件图里加一个新 entry，**必须完整重启一次 DSH** 才会生效。
+
+排查顺序：
+
+1. 完全退出 DSH（不是关窗口，要从托盘/任务管理器退出）
+2. 重新启动
+3. 设置 → 插件，确认 `dlaoshi-outfit` 存在且已启用
+4. 仍不出现 → 再重启一次（首次安装有时需要两轮：第一轮装包、第二轮组合）
+5. 打开浏览器控制台（F12），看有没有 `__ModuleLoader__` 相关报错
+
+### 桌宠突然消失
+
+通常是客户端热更新（HMR）把插件卸载后没有重新挂载。按 `Ctrl+R` 刷新页面即可；刷新后仍不在就重启 DSH。
+
+### 网页端提示「加载插件失败 / 未注册」
+
+确认安装的是 **2.1.3 或更高版本**。`2.1.0` 和 `2.1.1` 的客户端注册 id 与包名不一致，已被标记 deprecated：
+
+```powershell
+dsh plugin add dlaoshi-outfit@2.1.3
+```
+
+### 开发时想热更新
+
+客户端代码改动只有在 `pnpm run dev:web` 同时运行时才会自动重建并热替换；否则改完 `client.js` 需要重启 DSH。
+
 ## 开发
 
 ```powershell

package/client.js

@@ -78,6 +78,10 @@ window.__ModuleLoader__.load({
       listener(outfitEnabled)
       return () => { outfitListeners.delete(listener) }
     }
+
+    /** Disposer of the currently mounted occupant set, shared across apply()
+     *  calls so a second mount replaces the first instead of stacking on it. */
+    let mountedOccupants = null
     /** Host route that reports the live turn's tokens and think latency. */
     const STATS_PATH = '/fatfish/stats'
   
@@ -1152,18 +1156,34 @@ html.${SKIN_CLASS} body[data-ds-dark-theme] [data-turn-process-answer] {
           window.__petDebug = { starts: 0, ends: 0, happy: 0, sad: 0, balance: null }
         }
 
+        // Reversible, idempotent mount. Every side effect below is paired with a
+        // disposer owned by this plugin's fiber, so the loader can apply this
+        // module again (hot recompose) without a restart and without leaving a
+        // duplicate stylesheet, class or slot occupant behind.
+        if (typeof document.querySelectorAll === 'function') {
+          for (const stale of document.querySelectorAll('style[data-plugin="dlaoshi-outfit"]')) {
+            try { stale.remove() } catch (err) { /* already detached */ }
+          }
+        }
+
         // Apply the remembered outfit state before the stylesheet mounts so the
         // page never flashes the beautified look on a "switched off" session.
         outfitEnabled = readOutfitSetting()
-        applyOutfitClass(outfitEnabled)
+        ctx.effect(() => {
+          applyOutfitClass(outfitEnabled)
+          return () => {
+            try { document.documentElement.classList.remove(SKIN_CLASS) } catch (err) { /* no document */ }
+          }
+        }, 'dlaoshi-pet: skin class')
 
-        const tag = document.createElement('style')
-        tag.dataset.plugin = 'dlaoshi-outfit'
-        tag.textContent = CSS
-        document.head.appendChild(tag)
-        ctx.effect(() => () => {
-          tag.remove()
-          document.documentElement.classList.remove(SKIN_CLASS)
+        ctx.effect(() => {
+          const tag = document.createElement('style')
+          tag.dataset.plugin = 'dlaoshi-outfit'
+          tag.textContent = CSS
+          document.head.appendChild(tag)
+          return () => {
+            try { tag.remove() } catch (err) { /* already detached */ }
+          }
         }, 'dlaoshi-pet: stylesheet')
 
         ctx.effect(() => ctx.theme.overrideTokens('dlaoshi-outfit', TOKENS),
@@ -1172,7 +1192,14 @@ html.${SKIN_CLASS} body[data-ds-dark-theme] [data-turn-process-answer] {
         const occupy = (name, id, order, component) => ctx.slots.inject(name, () =>
           ctx.slots.register({ name, id, order }, component))
 
-        ctx.effect(() => {
+        // A second mount must replace the first, never stack on top of it: the
+        // loader may re-apply this module while a previous occupant set is still
+        // registered (hot recompose), and two pets would otherwise fight.
+        const mountOccupants = () => {
+          if (typeof mountedOccupants === 'function') {
+            try { mountedOccupants() } catch (err) { /* already gone */ }
+            mountedOccupants = null
+          }
           const stop = [
             occupy('shell.overlay', 'dlaoshi-companion', 20, Companion),
             occupy('sidebar.brand.mark', 'dlaoshi-sidebar', 5, SidebarMark),
@@ -1181,7 +1208,36 @@ html.${SKIN_CLASS} body[data-ds-dark-theme] [data-turn-process-answer] {
             occupy('settings.general.item', 'dlaoshi-theme', 40, ThemeSettingsRow),
           ]
           return () => { for (const fn of stop) if (typeof fn === 'function') fn() }
+        }
+
+        mountedOccupants = mountOccupants()
+        ctx.effect(() => () => {
+          if (typeof mountedOccupants === 'function') mountedOccupants()
+          mountedOccupants = null
         }, 'dlaoshi-pet: slot occupants')
+
+        // Self heal for hot recomposition: when the loader evicts this module's
+        // occupants but the overlay slot itself stays mounted, remount instead of
+        // leaving the user with a vanished pet until they refresh.
+        ctx.effect(() => {
+          if (typeof window === 'undefined' || typeof document === 'undefined') return () => {}
+          let misses = 0
+          const timer = setInterval(() => {
+            try {
+              const slot = document.querySelector('[data-slot="shell.overlay"]')
+              if (!slot || typeof slot.querySelector !== 'function') { misses = 0; return }
+              if (slot.querySelector(`.${PREFIX}-pet`)) { misses = 0; return }
+              misses += 1
+              if (misses < 2) return
+              misses = 0
+              mountedOccupants = mountOccupants()
+            } catch (err) {
+              misses = 0
+            }
+          }, 2500)
+          if (timer && typeof timer.unref === 'function') timer.unref()
+          return () => clearInterval(timer)
+        }, 'dlaoshi-pet: hot-recompose self heal')
       },
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dlaoshi-outfit",
-  "version": "2.1.3",
+  "version": "2.1.4",
   "type": "module",
   "description": "Anime whale-boy maid-outfit desktop pet, token/think-time standee and liquid-glass theme for DeepSeek Harness",
   "exports": {