dsh-wisp 1.26.0 → 1.28.0

package/tools/smoke.mjs

@@ -224,23 +224,42 @@ const cornerMenu = await page.evaluate(() => {
 })
 check(cornerMenu !== null, 'a menu can be opened near the bottom of her body',
   cornerMenu ? `pointer at y=${cornerMenu.pointerY}` : 'no candidate point hit her silhouette')
-check(cornerMenu !== null && cornerMenu.naiveBottom > 900,
-  'the case actually needs clamping (otherwise the next check is vacuous)',
-  cornerMenu ? `unclamped bottom would be ${cornerMenu.naiveBottom} > 900` : 'n/a')
+/* 顶层只有 7 项，"靠近底部"未必真的需要夹取 —— 原来那条 naiveBottom > 900 的守卫
+   在菜单变矮之后自己就失效了。改成：展开一个分组把菜单撑高，再验证同一个性质。
+   顺带这也是真浏览器里第一次验证折叠分组。 */
+const tallMenu = await page.evaluate(() => {
+  const row = [...document.querySelectorAll('.wisp-menu-item')].find((i) => i.dataset && i.dataset.group)
+  if (!row) return null
+  row.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true }))
+  const menu = document.querySelector('.wisp-menu')
+  if (!menu) return null
+  const r = menu.getBoundingClientRect()
+  return {
+    items: menu.querySelectorAll('.wisp-menu-item').length,
+    left: r.left, top: r.top, right: r.right, bottom: r.bottom,
+    vw: window.innerWidth, vh: window.innerHeight,
+  }
+})
+check(tallMenu !== null && tallMenu.items > 7, 'a group expands inside the real menu',
+  tallMenu ? `${tallMenu.items} 项` : '没找到分组行')
+check(tallMenu !== null && tallMenu.left >= 0 && tallMenu.top >= 0
+  && tallMenu.right <= tallMenu.vw && tallMenu.bottom <= tallMenu.vh,
+  'and the expanded menu still stays inside the viewport',
+  tallMenu ? JSON.stringify(tallMenu) : 'n/a')
 check(cornerMenu !== null && cornerMenu.inside,
   'and the menu is clamped back inside the viewport',
   cornerMenu ? `bottom ${cornerMenu.bottom} (was ${cornerMenu.naiveBottom}), right ${cornerMenu.right}` : 'n/a')
 
 const menu = await openMenu()
-// 项数从皮肤数推导（13 项固定 + 每套皮肤一项），不写死：加一套皮肤不该让测试变红 ——
+// 项数从皮肤数推导（14 项固定 + 每套皮肤一项），不写死：加一套皮肤不该让测试变红 ——
 // 那是数据的错，不是行为的错。
 // api.skins 是**数组**；用 Object.keys 数数组只是碰巧数对（预检里踩过这个坑，这里一并对齐）。
 const skinCount = await page.evaluate(() => {
   const s = window.__wisp.skins
   return Array.isArray(s) ? s.length : Object.keys(s ?? {}).length
 })
-check(menu !== null && menu.items.length === 13 + skinCount, 'the menu lists every entry',
-  `${menu?.items.length} items = 13 + ${skinCount} skin(s)`)
+check(menu !== null && menu.items.length === 7, 'the menu lists every entry',
+  `${menu?.items.length} items at the top level`)
 
 // 键盘：打开即聚焦第一项，方向键移动，Esc 关闭并把焦点还给她
 const kbd = await page.evaluate(() => {
@@ -266,6 +285,9 @@ check(kbd.focusAfter === 'wisp-body', 'and focus lands back on her, not on <body
 const openedAgain = await openMenu()
 check(openedAgain !== null, 'the menu reopens for the activation check')
 const zoomed = await page.evaluate(() => {
+  /* 大小两项收在「外观」组里：先展开，再点。 */
+  const group = [...document.querySelectorAll('.wisp-menu-item')].find((i) => i.dataset && i.dataset.group === '外观')
+  if (group) group.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true }))
   const item = [...document.querySelectorAll('.wisp-menu-item')].find((i) => i.textContent === '放大一点')
   if (!item) return { missing: true }
   item.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true }))
@@ -274,6 +296,58 @@ const zoomed = await page.evaluate(() => {
 check(zoomed.width === '630px' && zoomed.menuGone, 'a menu item runs and closes the menu',
   zoomed.missing ? 'the item was not found' : `width=${zoomed.width}`)
 
+/* 两个弹窗在真浏览器里的样子 —— 可见性、图片真的解码出来，这些假 DOM 测不到。
+   注意位置：必须放在键盘那一段**之后**。放前面会扰动它依赖的焦点状态
+   （实测：键盘段会退化成"焦点在哪都行"然后连挂三条）。 */
+const aboutView = await page.evaluate(() => {
+  window.__wisp.openAbout()
+  const card = document.querySelector('.wisp-dialog')
+  const back = document.querySelector('.wisp-dialog-backdrop')
+  if (!card) return { missing: true }
+  const r = card.getBoundingClientRect()
+  const text = [...card.querySelectorAll('.wisp-dialog-p, .wisp-dialog-foot-l, .wisp-dialog-foot-r')]
+    .map((el) => el.textContent).join(' ')
+  return {
+    visible: r.width > 200 && r.height > 80,
+    inView: r.left >= 0 && r.top >= 0 && r.right <= window.innerWidth && r.bottom <= window.innerHeight,
+    hasBackdrop: back !== null,
+    text,
+  }
+})
+check(aboutView.visible === true && aboutView.inView === true, 'the about dialog is really on screen',
+  JSON.stringify(aboutView))
+check(aboutView.hasBackdrop === true && (aboutView.text || '').includes('DeepSeek娘'),
+  'with a backdrop and her name in it', String((aboutView.text || '').slice(0, 48)))
+
+const actionsView = await page.evaluate(async () => {
+  window.__wisp.openActions()
+  const cells = [...document.querySelectorAll('.wisp-cell')]
+  await new Promise((resolve) => setTimeout(resolve, 400))
+  const loaded = cells.filter((c) => {
+    const im = c.querySelector('img')
+    return im && im.complete && im.naturalWidth > 0
+  }).length
+  const r = document.querySelector('.wisp-dialog').getBoundingClientRect()
+  return {
+    cells: cells.length, loaded,
+    inView: r.left >= 0 && r.top >= 0 && r.right <= window.innerWidth && r.bottom <= window.innerHeight,
+  }
+})
+check(actionsView.cells === 8, 'the action preview lists eight cells', String(actionsView.cells))
+check(actionsView.loaded === 8, 'and every sprite in it actually decoded',
+  actionsView.loaded + '/' + actionsView.cells)
+check(actionsView.inView === true, 'and it fits on screen', String(actionsView.inView))
+
+const previewed = await page.evaluate(() => {
+  const cell = [...document.querySelectorAll('.wisp-cell')].find((c) => c.dataset.mood === 'proud')
+  cell.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true }))
+  return { dialog: window.__wisp.dialog, mood: window.__wisp.currentMood }
+})
+check(previewed.dialog === null && previewed.mood === 'proud',
+  'clicking a cell closes the dialog and poses her', JSON.stringify(previewed))
+
+
+
 /* 键盘入口：假 DOM 证明不了原生按键处理与事件冒泡（窗口上的捕获监听会先看到 keydown），
    所以这里用真实按键事件走一遍。 */
 const focusHer = await page.evaluate(() => {

package/verify-wisp.mjs

@@ -304,10 +304,22 @@ function createHarness(options = {}) {
   }
   const pendingNode = {}
 
+  const documentListeners = Object.create(null)
   const documentShim = {
     body: bodyEl,
     head: headEl,
     get activeElement() { return activeEl },
+    /* 真 document 有事件接口，替身也得有 —— 否则"插件是否正确处理文档级 Esc"根本测不到，
+       而且少一个方法会让插件在替身里整个起不来（这坑踩过一次）。 */
+    addEventListener(type, fn) { (documentListeners[type] ??= []).push(fn) },
+    removeEventListener(type, fn) {
+      const list = documentListeners[type]
+      if (!list) return
+      const at = list.indexOf(fn)
+      if (at >= 0) list.splice(at, 1)
+    },
+    dispatch(type, event) { for (const fn of [...(documentListeners[type] ?? [])]) fn(event ?? {}) },
+    get documentListenerCount() { return Object.values(documentListeners).reduce((n, l) => n + l.length, 0) },
     createElement: (t) => makeEl(t),
     getElementById: (id) => created.find((e) => e.id === id && !e.removed) ?? null,
     /* 采样点上的元素栈：按"最上面优先"返回。窗口背景那一段要靠它判断
@@ -476,7 +488,8 @@ function createHarness(options = {}) {
       // 默认不给 —— 这样"没有 host 时降级"才测得到；要测检查更新就传 hostCall。
       const hostSeat = typeof options.hostCall === 'function' ? { call: options.hostCall } : undefined
       // eslint-disable-next-line no-new-func
-      new Function('window', 'document', 'host', ...TRAPPED, src)(
+      /* 追加 sourceURL：new Function 里的代码否则在堆栈里是 anonymous，定位不到行。 */
+      new Function('window', 'document', 'host', ...TRAPPED, src + '\n//# sourceURL=wisp-client-half.js')(
         win, documentShim, hostSeat, ...TRAPPED.map((name) => traps[name]),
       )
     },
@@ -1350,6 +1363,132 @@ if (clientSrc !== null) {
     care.win.__wisp.destroy()
     active = keepCare
 
+    /* ---------------- 3d-octodecies. 干饭 ----------------------------------- */
+    head('3d-octodecies. she gets hungry and says so (the rice thing)')
+
+    /* 这是社区的设定里最像"她"的一条：白米饭是算力的硬通货。行为本身很简单 ——
+       连续活动够久就该吃一碗 —— 但要测的是**判据**：别一回来就喊饿、别连着喊、
+       能关掉。careAfterMs 关掉，免得住坐提醒和它互相干扰。 */
+    const eat = createHarness({ timer: true, composerText: '在打字' })
+    const keepEat = active
+    active = eat
+    eat.evaluate(clientSrc)
+    eat.module().default.apply(eat.ctx, {
+      reactions: true, wander: false, celebrate: false,
+      careAfterMs: 0, hungerMs: 600000, sleepAfterMs: 3600000,
+    })
+    eat.advance(1300, 100)
+    const eatApi = eat.win.__wisp
+    const eatMood = () => eat.find('wisp-root').dataset.mood
+    const eatUntil = (limitMs, chunk = 1000) => {
+      for (let left = limitMs; left > 0; left -= chunk) {
+        eat.advance(Math.min(chunk, left), 200)
+        if (eatMood() === 'eat') return true
+      }
+      return false
+    }
+    const bubbleIsEat = () => {
+      const text = eat.all('wisp-say').at(-1)?.textContent
+      return Array.isArray(linesInBundle()?.eat) && linesInBundle().eat.includes(text)
+    }
+
+    check(Array.isArray(linesInBundle()?.eat) && linesInBundle().eat.length >= 8,
+      'the rice pool exists and has some lines in it', `${linesInBundle()?.eat?.length ?? '?'} 句`)
+    check(eatApi.doctor().hunger.enabled === true && eatApi.doctor().hunger.everyMs === 600000,
+      'doctor reports the hunger setting', JSON.stringify(eatApi.doctor().hunger))
+
+    // 9 分钟：还没到
+    let sawEarlyEat = false
+    for (let left = 9 * 60000; left > 0; left -= 1000) {
+      eat.advance(1000, 200)
+      if (eatMood() === 'eat') { sawEarlyEat = true; break }
+    }
+    check(!sawEarlyEat, 'nine minutes in she is not hungry yet', eatMood())
+
+    check(eatUntil(200000), 'past the threshold she gets a bowl out')
+    check(bubbleIsEat(), 'and the line comes from the rice pool',
+      (eat.all('wisp-say').at(-1)?.textContent ?? '(无)'))
+    check(eatMood() === 'eat' && eatApi.currentMood === 'eat',
+      'and both the DOM and the reported mood say eat', `${eatMood()} / ${eatApi.currentMood}`)
+
+    // 稳态轮询不能把它抹掉
+    eat.advance(1000, 100)
+    check(eatMood() === 'eat', 'the reaction poll does not overwrite the meal', eatMood())
+
+    // 吃完自己回去（EAT_MS = 5.2 秒）
+    for (let left = 8000; left > 0; left -= 500) eat.advance(500, 100)
+    check(eatMood() === 'alert', 'and the meal ends on its own, back to alert', eatMood())
+
+    // 不该连着说
+    let saidAgain = false
+    for (let left = 60000; left > 0; left -= 1000) {
+      eat.advance(1000, 200)
+      if (eatMood() === 'eat') { saidAgain = true; break }
+    }
+    check(!saidAgain, 'she does not ask for rice again a minute later', eatMood())
+    check(eatUntil(600000), 'but another full stretch does bring it back')
+
+    // 离开很久之后回来：不该一进门就喊饿
+    eat.win.__wisp.configure({ hungerMs: 300000 })
+    eat.state.composerText = null
+    eat.advance(20 * 60000, 5000)
+    eat.state.composerText = '回来了'
+    eat.advance(1300, 100)
+    let instantHunger = false
+    for (let left = 120000; left > 0; left -= 1000) {
+      eat.advance(1000, 200)
+      if (eatMood() === 'eat') { instantHunger = true; break }
+    }
+    check(!instantHunger, 'after a long absence she does not ask for rice the moment you return', eatMood())
+    check(eatUntil(300000), 'only a fresh full stretch makes her hungry')
+    /* 让这一顿吃完（EAT_MS = 5.2 秒）再测关闭 —— 否则"还停在 eat"会被误判成"关不掉"。
+       （这个坑久坐提醒那节也踩过，同样用一段推进收尾。） */
+    eat.advance(8000, 500)
+
+    // 关掉这个行为（两种关法）
+    eat.win.__wisp.configure({ hungerMs: 0 })
+    let offByZero = false
+    for (let left = 20 * 60000; left > 0; left -= 5000) {
+      eat.advance(5000, 500)
+      if (eatMood() === 'eat') { offByZero = true; break }
+    }
+    check(!offByZero, 'hungerMs: 0 turns it off', eatMood())
+    eat.win.__wisp.configure({ hungerMs: 300000, hungry: false })
+    let offByFlag = false
+    for (let left = 20 * 60000; left > 0; left -= 5000) {
+      eat.advance(5000, 500)
+      if (eatMood() === 'eat') { offByFlag = true; break }
+    }
+    check(!offByFlag, 'and hungry: false turns it off even with a live timer', eatMood())
+    check(eatApi.config.hungry === false, 'and the config says so', String(eatApi.config.hungry))
+
+    // 菜单开关：先把菜单叫出来（菜单项是开菜单时才建的），点一下就该翻转
+    /* 主菜单的入口是 .wisp-body 上的 keydown（Enter / 空格 / ContextMenu / Shift+F10），
+       不是 contextmenu —— 后者只挂在"躲起来"之后的迷你标签上。事件对象同样自建：
+       ctxEvent 定义在文件后半部分，在这里用就是 TDZ。 */
+    eat.win.__wisp.configure({ hungry: true })
+    const eatBody = eat.find('wisp-root').querySelector('.wisp-body')
+    const openEatMenu = () => eatBody.dispatch('keydown', {
+      type: 'keydown', key: 'Enter', shiftKey: false, defaultPrevented: false,
+      preventDefault() { this.defaultPrevented = true }, stopPropagation() {},
+    })
+    const eatLive = () => eat.all('wisp-menu-item').filter((el) => el.removed !== true)
+    openEatMenu()
+    /* 开关在「行为」组里：先展开（分组行带着 data-group） */
+    const groupRowOf = (name) => eatLive().find((el) => el.dataset && el.dataset.group === name)
+    groupRowOf('行为').dispatch('click', { preventDefault() {}, stopPropagation() {} })
+    const eatToggle = eatLive().find((el) => (el.textContent || '').includes('饿了'))
+    check(Boolean(eatToggle), 'the menu carries a rice toggle',
+      eat.all('wisp-menu-item').filter((el) => el.removed !== true).length + ' 项')
+    if (eatToggle) {
+      /* 元素上的点击走 harness 的 dispatch(type, event) —— 不是浏览器的 dispatchEvent（没有那个方法）。 */
+      eatToggle.dispatch('click', { preventDefault() {}, stopPropagation() {} })
+      check(eat.win.__wisp.config.hungry === false, 'and clicking it turns the behaviour off',
+        String(eat.win.__wisp.config.hungry))
+    }
+    eat.win.__wisp.destroy()
+    active = keepEat
+
     /* 睡着了也得被叫醒：这条单独测，因为它需要 sleepAfterMs 很短 */
     const sleepCare = createHarness({ timer: true, composerText: '在打字' })
     const keepSleepCare = active
@@ -2118,17 +2257,52 @@ if (clientSrc !== null) {
     check(menuOf() !== null, 'the right-click opens a context menu')
     check(menuOf()?.getAttribute('role') === 'menu', 'the menu carries menu semantics')
     /* 项数从皮肤数**推导**，不写死：加一套皮肤不该让测试变红（那是数据的错，不是行为的错）。
-       固定部分 = 6 个动作 + 3 个开关 + 4 个角落 = 13；其余是每套皮肤一项。 */
+       固定部分 = 6 个动作 + 4 个开关 + 4 个角落 = 14；其余是每套皮肤一项。 */
     /* api.skins 是数组（SKIN_IDS 的拷贝），不是对象 —— 用 Object.keys 只是碰巧数对了。 */
     const skinCount = Array.isArray(api.skins) ? api.skins.length : Object.keys(api.skins ?? {}).length
-    check(itemsOf().length === 13 + skinCount,
-      'the menu lists fixed actions and corners plus exactly one entry per skin',
-      `${itemsOf().length} items = 13 + ${skinCount} skin(s)`)
+    /* ---- 结构：顶层只放动作，其余收进可折叠分组 ----------------------------
+       原来 19 个条目全平铺、只靠三行不可点的头部标签分区 —— 那不是结构，是排版。
+       现在顶层 7 项，外观 / 行为 / 位置 三组各自折叠。 */
+    const topLevel = itemsOf()
+    check(topLevel.length === 7, 'the top level holds seven entries, not nineteen',
+      `${topLevel.length} 项：${topLevel.map((i) => i.textContent).join(' | ')}`)
+    const groupRow = (name) => itemsOf().find((i) => i.dataset && i.dataset.group === name)
+    const groupNames = ['外观', '行为', '位置']
+    check(groupNames.every((n) => groupRow(n) !== undefined), 'the three groups are there',
+      groupNames.map((n) => `${n}=${groupRow(n) ? '有' : '无'}`).join(' '))
+    check(groupNames.every((n) => groupRow(n).dataset.open === 'false'),
+      'and they start collapsed', groupNames.map((n) => groupRow(n).dataset.open).join(','))
+    check(groupNames.every((n) => groupRow(n).getAttribute('aria-expanded') === 'false'),
+      'with aria-expanded telling assistive tech the same thing')
+    /* 展开一个分组：点它一下，菜单在原地重开，条目多出这一组的孩子 */
+    /* 展开/收起**只从 DOM 判断**：分组行自己带着 data-open 与 aria-expanded，
+       而 api 这个绑定是第一个替身的（728 行），不是这一节的实例 —— 拿它读菜单状态
+       会得到"菜单明明开着、API 却说没开"的假失败（踩过）。 */
+    const expand = (name) => {
+      const row = groupRow(name)
+      if (!row) return false
+      row.dispatch('click', itemEvent())
+      return groupRow(name) !== undefined && groupRow(name).dataset.open === 'true'
+    }
+    const collapse = (name) => {
+      const row = groupRow(name)
+      if (!row) return false
+      row.dispatch('click', itemEvent())
+      return groupRow(name) !== undefined && groupRow(name).dataset.open === 'false'
+    }
+    check(expand('外观'), 'clicking a group expands it in place',
+      `row=${JSON.stringify(groupRow('外观') ? groupRow('外观').dataset : null)} 项=${itemsOf().length}`)
+    check(itemsOf().length === 7 + skinCount + 2,
+      'the skins and the two size entries appear once it is open',
+      `${itemsOf().length} 项 = 7 + ${skinCount} 皮肤 + 2 大小`)
+    check(collapse('外观'), 'clicking it again collapses it')
+    check(itemsOf().length === 7, 'and the menu is back to seven entries', String(itemsOf().length))
+    /* 换一套皮肤之后，展开的分组要自动收起（closeMenu 会清掉 activeGroup） */
     const byText = (t) => itemsOf().filter((i) => i.textContent.includes(t))
-    const heads = menuOf().querySelectorAll('.wisp-menu-head')
-    check(heads.length === 3, 'the behaviour, position and skin sections each get a header', `${heads.length} headers`)
-    check(heads[0].textContent === '行为' && heads[1].textContent === '位置' && heads[2].textContent === '皮肤',
-      'the headers name their sections', heads.map((x) => x.textContent).join(' / '))
+    expand('外观')
+    check(groupRow('外观').getAttribute('aria-expanded') === 'true',
+      'and aria-expanded follows the expansion')
+    /* 皮肤现在在「外观」组里 —— 上一步已经把该组展开了。 */
     /* 从 API 派生，**不写死皮肤名**。写死过「初版女仆」，改名成「素绘女仆」之后
        三条断言当场全炸，其中一条 undefined.dispatch 还把整个套件截断了。 */
     /* 既有 API 的形状是**有序数组** [{id,label}]，不是 id→label 的对象。 */
@@ -2146,6 +2320,7 @@ if (clientSrc !== null) {
       'the menu lives beside her body, not inside it', 'inside it would be mirrored and scale with her')
 
     /* ---- 三个行为开关（原本在设置页里，那页撤掉后落到菜单） -------------- */
+    check(expand('行为'), 'the behaviour group opens')   /* 开关都在这一组里 */
     const toggleItem = (label) => itemsOf().find((i) => i.textContent.replace(/^[✓　]\s*/, '') === label)
     const togglesPresent = ['自己溜达', '跟随状态', '跑完撒花'].every((l) => toggleItem(l) !== undefined)
     check(togglesPresent, 'all three behaviour toggles are in the menu',
@@ -2157,6 +2332,8 @@ if (clientSrc !== null) {
     check(fifth.config.wander === !wanderBefore, 'clicking a toggle really flips the config',
       `${wanderBefore} -> ${fifth.config.wander}`)
     body5.dispatch('contextmenu', rightClickOnHer().ev)
+    /* 重开菜单＝一次新手势，所以分组回到收起状态（这是设计）。要再点开关就得再展开。 */
+    check(expand('行为'), 'reopening the menu collapses the groups again')
     const reopened = toggleItem('自己溜达')
     check(reopened !== undefined && reopened.textContent.startsWith('　'),
       'and reopening the menu shows the new state',
@@ -2170,6 +2347,7 @@ if (clientSrc !== null) {
     // 自己开菜单，不依赖上一节留下的状态 —— 隐含的跨节状态是测试脆弱性的常见来源。
     body5.dispatch('contextmenu', rightClickOnHer().ev)
     check(menuOf() !== null, 'the menu opens for the skin checks')
+    check(expand('外观'), 'and the skins group can be opened')
     const skinBefore = fifth.skin
     const posBefore = fifth.position
     const srcBeforeSkin = h.srcs[h.srcs.length - 1]
@@ -2192,9 +2370,9 @@ if (clientSrc !== null) {
     check(fifth.configure({ skin: 'deepsea' }) && fifth.skin === 'deepsea',
       'configure({skin}) goes through the same path as the menu', String(fifth.skin))
 
-    // 点「放大一点」—— 真改尺寸，并且菜单自己关掉
+    // 点「放大一点」—— 真改尺寸，并且菜单自己关掉（大小两项在「外观」组里，先展开）
     body5.dispatch('contextmenu', rightClickOnHer().ev)
-    const menuItems = itemsOf()
+    check(expand('外观'), 'the size entries need the appearance group open')
     byText('放大一点')[0].dispatch('click', itemEvent())
     check(fifth.element.style.width === '630px' && fifth.element.style.height === '945px',
       'a menu action runs (zoom one step up)', `${fifth.element.style.width}x${fifth.element.style.height}`)
@@ -2204,6 +2382,7 @@ if (clientSrc !== null) {
     const secondClick = rightClickOnHer()
     body5.dispatch('contextmenu', secondClick.ev)
     check(menuOf() !== null, 'the menu reopens')
+    check(expand('位置'), 'the corners live in the position group')
     byText('右下角')[0].dispatch('click', itemEvent())
     const homed = fifth.position
     check(homed.x === secondClick.homeX && homed.y === secondClick.homeY,
@@ -2230,7 +2409,7 @@ if (clientSrc !== null) {
     })
     check(kbd().at !== null && kbd().at.tagName === 'BUTTON',
       'opening the menu focuses its first item', kbd().label)
-    check(kbd().at?.className === 'wisp-menu-item' && kbd().label === '说句话',
+    check(kbd().at?.className === 'wisp-menu-item' && kbd().label === '关于她…',
       'and the focus lands on the first real action', kbd().label)
     check(kbd().zero === 1, 'exactly one item is in the tab order (roving tabindex)', `${kbd().zero}`)
     check(itemsOf()[0].getAttribute('aria-selected') === 'true',
@@ -2406,6 +2585,16 @@ if (clientSrc !== null) {
       found[0].dispatch('click', itemEvent())
       return true
     }
+    /* 菜单改成分组之后，组里的条目要先把组展开才看得见。
+       这个 helper 让"点某个分组里的东西"是一次调用，而不是每处各写一遍。 */
+    const openGroupOn = (inst, name) => {
+      const host = inst.element.parentNode
+      const row = host.querySelectorAll('.wisp-menu-item').find((i) => i.dataset && i.dataset.group === name)
+      if (!row) return false
+      row.dispatch('click', itemEvent())
+      return host.querySelectorAll('.wisp-menu-item')
+        .some((i) => i.dataset && i.dataset.group === name && i.dataset.open === 'true')
+    }
     // 四个角落。期望值按【当前】尺寸算 —— 写死尺寸的话，一旦尺寸变了断言会
     // 指着正确的实现说它错。
     const cur = boxOf(pinned)
@@ -2417,6 +2606,7 @@ if (clientSrc !== null) {
     }
     for (const [label, want] of Object.entries(EXPECT)) {
       openMenuOn(pinned)
+      openGroupOn(pinned, '位置')     // 四个角落现在收在「位置」组里
       const hit = pickExact(pinned, label)
       check(hit && pinned.position.x === want.x && pinned.position.y === want.y,
         `the ${label} item puts her there`, `${pinned.position.x},${pinned.position.y} (want ${want.x},${want.y})`)
@@ -2584,6 +2774,7 @@ if (clientSrc !== null) {
     active = keepSoak
   } catch (error) {
     bad('browser half executes', `${error.constructor.name}: ${error.message}`)
+    if (error && error.stack) console.log(String(error.stack).split('\n').slice(0, 6).map((l) => '        ' + l.trim()).join('\n'))
     console.log(error.stack)
   } finally {
     active = null
@@ -2591,6 +2782,93 @@ if (clientSrc !== null) {
   }
 }
 
+/* ================================================== 3y. dialogs ============ */
+head('3y. dialogs: about her, and the action preview')
+
+/* 菜单顶层只留动作，"她是谁"和"她有哪些动作"放进弹窗。这里测的就是这两个弹窗：
+   能不能开、内容对不对、三种关法，以及**反复开合不会把文档级监听越堆越多**
+   （那是真写进去过的 bug：清理函数是个空壳）。 */
+{
+  const dlg = createHarness({ timer: true, composerText: '' })
+  const keepDlg = active
+  active = dlg
+  dlg.evaluate(clientSrc)
+  dlg.module().default.apply(dlg.ctx, { reactions: true, wander: false, celebrate: false })
+  dlg.advance(1300, 100)
+  const dlgApi = dlg.win.__wisp
+  const bundleVersion = /const VERSION = '([^']+)'/.exec(clientSrc)?.[1] ?? null
+
+  /* 替身的 find() 会把已移除的节点也返回（它自己的约定），所以要显式认 removed。 */
+  const dialogGone = () => {
+    const el = dlg.find('wisp-dialog')
+    return el === null || el.removed === true
+  }
+  /* 按段落/页脚类读文本：简化 DOM 不会汇总子节点 textContent，读卡片本身只会得到空串。 */
+  const dialogText = () => [].concat(
+    dlg.all('wisp-dialog-p').filter((el) => el.removed !== true).map((el) => String(el.textContent)),
+    dlg.all('wisp-dialog-foot-l').filter((el) => el.removed !== true).map((el) => String(el.textContent)),
+    dlg.all('wisp-dialog-foot-r').filter((el) => el.removed !== true).map((el) => String(el.textContent)),
+  ).join('\n')
+
+  check(dlgApi.dialog === null, 'nothing is open at the start', String(dlgApi.dialog))
+  check(dialogGone(), 'and no dialog sits in the DOM before it is asked for')
+
+  dlgApi.openAbout()
+  check(dlgApi.dialog === 'about', 'asking about her opens the about dialog', String(dlgApi.dialog))
+  const card = dlg.find('wisp-dialog')
+  check(card !== null, 'the dialog card is in the DOM')
+  check(dlg.find('wisp-dialog-backdrop') !== null, 'with a backdrop behind it')
+  const aboutText = dialogText()
+  check(aboutText.includes('DeepSeek娘'), 'it says who she is')
+  check(bundleVersion !== null && aboutText.includes(bundleVersion),
+    'and which version this is', `${bundleVersion} / 文本里找得到: ${aboutText.includes(String(bundleVersion))}`)
+  check(aboutText.includes('社区'), 'and credits the community the look comes from')
+  check(aboutText.includes('非官方'), 'and says plainly that it is unofficial')
+
+  dlg.document.dispatch('keydown', { key: 'Escape', preventDefault() {} })
+  check(dlgApi.dialog === null && dialogGone(), 'Escape closes it',
+    `dialog=${String(dlgApi.dialog)} 监听数=${dlg.document.documentListenerCount}`)
+  check(dlg.document.documentListenerCount === 1,
+    'exactly one document-level key listener exists', String(dlg.document.documentListenerCount))
+
+  dlgApi.openActions()
+  check(dlgApi.dialog === 'actions', 'the action preview opens', String(dlgApi.dialog))
+  const cells = dlg.all('wisp-cell').filter((el) => el.removed !== true)
+  check(cells.length === 8, 'and lists eight actions — one per mood', `${cells.length} 格`)
+  check(cells.every((c) => typeof c.dataset.mood === 'string' && c.dataset.mood !== ''),
+    'each cell names its mood', cells.map((c) => c.dataset.mood).join(','))
+  check(cells.every((c) => c.querySelector('img') !== null), 'each cell carries a sprite')
+
+  const eatCell = cells.find((c) => c.dataset.mood === 'eat')
+  eatCell.dispatch('click', { preventDefault() {}, stopPropagation() {} })
+  check(dlgApi.dialog === null, 'clicking an action closes the dialog so you can see her')
+  check(dlgApi.currentMood === 'eat', 'and she takes that pose', String(dlgApi.currentMood))
+  dlg.advance(1500, 100)
+  check(dlgApi.currentMood === 'eat',
+    'the reaction poll leaves the preview alone while it lasts', String(dlgApi.currentMood))
+  dlg.advance(9000, 500)
+  check(dlgApi.currentMood !== 'eat', 'and the preview does not stick forever', String(dlgApi.currentMood))
+
+  dlgApi.openActions()
+  const x = dlg.find('wisp-dialog-x')
+  check(x !== null, 'the close button is there')
+  x.dispatch('click', { preventDefault() {} })
+  check(dlgApi.dialog === null, 'and it closes the dialog')
+
+  dlgApi.openAbout()
+  dlg.find('wisp-dialog-backdrop').dispatch('pointerdown', {})
+  check(dlgApi.dialog === null, 'clicking the backdrop closes it too')
+
+  for (let i = 0; i < 3; i++) { dlgApi.openAbout(); dlgApi.closeDialog() }
+  check(dlg.document.documentListenerCount === 1,
+    'opening and closing repeatedly does not stack listeners', String(dlg.document.documentListenerCount))
+
+  dlgApi.openAbout()
+  dlgApi.destroy()
+  check(dlgApi.dialog === null, 'destroy() takes the dialog with it')
+  active = keepDlg
+}
+
 /* ================================================== 3z. generation audit ==== */
 head('3z. every shipped sprite traces back to a text-only call')
 
@@ -2661,7 +2939,8 @@ if (clientSrc !== null) {
       const skins = Object.keys(value)
       const missing = []
       for (const skin of skins) {
-        for (const mood of ['idle', 'happy', 'sleepy', 'work', 'attn', 'poked']) {
+        /* 八个情绪：加了 eat（干饭）之后这里也要跟上 —— 漏一个就会让"每套皮肤都齐"变成假绿。 */
+        for (const mood of ['idle', 'happy', 'sleepy', 'work', 'attn', 'poked', 'proud', 'eat']) {
           const uri = value[skin]?.[mood]
           if (typeof uri !== 'string' || uri.indexOf('data:image/') !== 0) missing.push(`${skin}/${mood}`)
         }
@@ -2672,8 +2951,8 @@ if (clientSrc !== null) {
       skinReport = `table does not evaluate: ${error.message}`
     }
   }
-  if (skinsOk) ok('every skin carries all five moods as data URIs', skinReport)
-  else bad('every skin carries all five moods as data URIs', skinReport)
+  if (skinsOk) ok('every skin carries all eight moods as data URIs', skinReport)
+  else bad('every skin carries all eight moods as data URIs', skinReport)
 
   if (clientSrc.includes('__SPRITES__')) bad('no leftover build placeholder', 'run `node build.mjs`')
   else ok('no leftover build placeholder')