fix(shell): 修复页面按钮全失效（param 名不能叫 args）+ -NoExclude 不再成为默认；README 补验证方法与踩坑

README.md

@@ -106,6 +106,37 @@ shell\run-float.cmd -Action pin                      # 给正在运行的实例
 5. **`CoreWebView2Environment.CreateAsync` 的参数顺序是 `(browserExecutableFolder, userDataFolder, options)`**，传错会得到 "Couldn't find a compatible Webview2 Runtime"。
 6. **高 DPI**：WinForms 会把逻辑尺寸按缩放放大，位置要按真实 `Width/Height` 夹回屏幕内。
 7. `.ps1` 里出现中文时**必须存成 UTF-8 with BOM**，否则 PowerShell 5.1 按 GBK 读会把脚本解析坏（`tools/fix-bom.ps1` 专门干这个）。
+8. **cordis：`ctx.set` 之前必须 `ctx.provide`**。漏了会抛 `cannot set property "floatWindow" without provide`，后果不是"少个功能"而是**整个插件树加载失败、DSH 进程直接退出**。本轮就是在隔离实例里实测复现后修掉的。
+9. **PowerShell 事件处理器里参数不能叫 `$args`**：它是自动变量，会把整个事件参数数组占住，于是 `$e.TryGetWebMessageAsString()` 变成"数组没有这个方法"——表现为**页面所有按钮（含右下角缩放、置顶、锁定、全屏、设置）全部失效**。正确写法是 `param($s, $e)`。
+10. **profile 的 `package.json` 不能带 BOM**：Node 读 JSON 会报 `SyntaxError: Unexpected token '锘?`。用 `[IO.File]::WriteAllText(..., UTF8Encoding($false))` 写。
+
+## 怎么验证（可复现）
+
+不需要动你正在用的 DSH：
+
+```powershell
+# 1) 造一个隔离的 DSH_HOME，profile 只装 base + web-app + 本插件
+$t = '.runtime\testhome'
+New-Item -ItemType Directory -Force -Path "$t\profiles\web\node_modules" | Out-Null
+# package.json(bundles 只留三个) + cordis.yml/cordis.patch.yml 见 README 上文
+cmd /c mklink /J "$t\profiles\web\node_modules\dsh-float-window" "$PWD"
+
+# 2) 起第二个实例（8099），观察插件是否被加载
+$env:DSH_HOME = (Resolve-Path $t)
+node <dsh bin.js> web --port 8099
+#   -> 出现 endpoint.json 且无 "plugin tree failed to load" 即通过
+
+# 3) 直接打插件路由
+curl http://127.0.0.1:8099/dsh-float-window/health
+curl http://127.0.0.1:8099/dsh-float-window/state
+curl -N http://127.0.0.1:8099/dsh-float-window/events     # SSE，每秒一帧
+
+# 4) 让浮窗连到这个测试实例（看视觉效果时再加 -NoExclude）
+shell\run-float.cmd -DshHome $t -NoExclude
+#   标题栏应变成绿点 + 127.0.0.1:8099
+```
+
+`tools/smoke-host.mjs` 则是更轻的一层：假 ctx 直接调 `apply()`，验证路由/SSE/工具注册不抛异常。
 
 ## 配置