dlaoshi-outfit 2.1.1 → 2.1.4

package/CHANGELOG.md

@@ -1,16 +1,33 @@
 # Changelog
 
-## 2.1.0 — 2026-10-22
+## 2.1.4 — 2026-10-22
 
-发布到 npm，安装只需一行。
+按 DSH 的「可逆副作用」规范重写挂载流程，支持热重组。
 
-- 包名从 `@local/dsh-fatfish-outfit` 改为 **`dlaoshi-outfit`**（可在 npm 与 DSH 插件市场搜索安装）
-- `cordis.patch.yml` 的插件名同步为 `dlaoshi-outfit`
-- `package.json` 增加 `files` 白名单与 `publishConfig`，npm 包只带运行必需文件
-- README 安装章节改为「一条命令 / GitHub / 手动」三种方式
-- 市场描述关键词调整为：鲸鱼正太、女仆装、二次元
+- 所有副作用都成对：样式表、`html` 皮肤类、主题 token、槽位占用全部由 `ctx.effect` 托管，
+  卸载时逐项回滚，不再依赖页面刷新
+- 二次 `apply()` 幂等：先释放上一批槽位占用再挂载，避免热重组后出现两只桌宠
+- 新增自愈：槽位容器还在、本插件节点消失时（HMR 驱逐），约 5 秒内自动重新挂载
+- 测试新增「重复 apply 不重复占用槽位」断言
 
-> 从 `@local/...` 升级的用户：先卸载旧条目（`dsh plugin remove @local/dsh-fatfish-outfit`），再装 `dlaoshi-outfit`。
+> 注意：全新安装插件仍需重启一次 Host——DSH 的插件图在启动时组合，这不是插件能绕过的。
+
+## 2.1.3 — 2026-10-22
+
+修复：网页端加载失败（`__ModuleLoader__` 未注册）。
+
+- 客户端 bundle 注册的插件 id 从 `@local/dsh-fatfish-outfit` 改为 `dlaoshi-outfit`，
+  与包名/加载器一致；此前网页端会报「导入失败：client-modules 未注册」。
+- 主题 `overrideTokens` 与样式表标记同步改名。
+
+## 2.1.1 — 2026-10-22
+
+发布到 npm：`npm i dlaoshi-outfit` / `dsh plugin add dlaoshi-outfit`。
+
+- 包名改为 `dlaoshi-outfit`，已发布到 npm 公共源
+- `cordis.patch.yml` 插件名同步
+- 市场描述关键词：鲸鱼正太、女仆装、二次元
+- 安装文档改为「一条命令 / GitHub / 手动」三种方式
 
 ## 2.0.1 — 2026-10-22
 

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