post: unraid array-stop swapfile hang root cause + User Scripts fix (en+zh, OG+banner)

scripts/banner-gen/generate.mjs

@@ -358,6 +358,24 @@ const BANNERS = {
         { n: '5', label: 'fixed ✓' },
       ],
     },
+
+    'unraid-stop-array-hangs-on-swapfile': {
+      titlebar: 'root@unraid — array stop incident',
+      lines: [
+        { t: 'prompt', text: '$' }, { t: 'cmd', text: 'WebUI → Stop array · swapfile lives on /mnt/cache (btrfs RAID1)' },
+        { t: 'prompt', text: 'WARN' }, { t: 'err', text: 'Retry unmounting user shares… · umount: target is busy (every 5s, forever)' },
+        { t: 'prompt', text: 'WARN' }, { t: 'err', text: '/proc/swaps lists /dev/loop0 — grep swapfile never matches' },
+        { t: 'prompt', text: '$' }, { t: 'cmd', text: 'fix = User Scripts: swapoff -a + losetup -j/-d at stopping_svcs · swapon at disks_mounted' },
+        { t: 'prompt', text: '' }, { t: 'ok', text: '→ clean unmount on first try · swap survives stop/start ✓' },
+      ],
+      flow: [
+        { n: '1', label: 'stop array' },
+        { n: '2', label: 'EBUSY loop', err: true },
+        { n: '3', label: 'losetup -j' },
+        { n: '4', label: 'swapoff hook' },
+        { n: '5', label: 'clean stop ✓' },
+      ],
+    },
   };
 
   const DEFAULT_BANNER = {

scripts/og-gen/generate.mjs

@@ -123,6 +123,11 @@ const TERMINALS = {
     <div class="line"><span class="prompt">$</span><span class="cmd">CDP → shopee search "used phone" · client marketplace monitor</span></div>
     <div class="line"><span class="prompt">&nbsp;</span><span class="err">/verify captcha · empty product cards</span></div>
     <div class="line"><span class="prompt">$</span><span class="cmd">warm session · 7s pacing · sweep.py</span><span class="fix">→ 20+ listings ✓</span></div>`,
+
+  'unraid-stop-array-hangs-on-swapfile': `
+    <div class="line"><span class="prompt">$</span><span class="cmd">unraid → stop array · swapfile on /mnt/cache</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="err">umount: target is busy · /proc/swaps says /dev/loop0</span></div>
+    <div class="line"><span class="prompt">$</span><span class="cmd">swapoff -a + losetup -j at stopping_svcs</span><span class="fix">→ clean stop ✓</span></div>`,
 };
 
 const DEFAULT_TERMINAL = `