dsh-wisp 1.27.0 → 1.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-wisp",
-  "version": "1.27.0",
+  "version": "1.29.0",
   "description": "DeepSeek娘 — an unofficial floating desktop companion for the DeepSeek Harness UI. Zero dependencies; sprites inlined as data URIs; schedules on the Client timer service instead of the trapped browser timer globals.",
   "type": "module",
   "main": "lib/index.js",

package/tools/smoke.mjs

@@ -224,9 +224,28 @@ 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')
@@ -239,8 +258,8 @@ 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 === 14 + skinCount, 'the menu lists every entry',
-  `${menu?.items.length} items = 14 + ${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,23 @@ 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) },
+    documentListenerCountOf(type) { return (documentListeners[type] ?? []).length },
     createElement: (t) => makeEl(t),
     getElementById: (id) => created.find((e) => e.id === id && !e.removed) ?? null,
     /* 采样点上的元素栈：按"最上面优先"返回。窗口背景那一段要靠它判断
@@ -476,7 +489,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]),
       )
     },
@@ -1455,12 +1469,16 @@ if (clientSrc !== null) {
        ctxEvent 定义在文件后半部分，在这里用就是 TDZ。 */
     eat.win.__wisp.configure({ hungry: true })
     const eatBody = eat.find('wisp-root').querySelector('.wisp-body')
-    eatBody.dispatch('keydown', {
+    const openEatMenu = () => eatBody.dispatch('keydown', {
       type: 'keydown', key: 'Enter', shiftKey: false, defaultPrevented: false,
       preventDefault() { this.defaultPrevented = true }, stopPropagation() {},
     })
-    const eatToggle = eat.all('wisp-menu-item').filter((el) => el.removed !== true)
-      .find((el) => (el.textContent || '').includes('饿了'))
+    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) {
@@ -2243,14 +2261,49 @@ if (clientSrc !== null) {
        固定部分 = 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 === 14 + skinCount,
-      'the menu lists fixed actions and corners plus exactly one entry per skin',
-      `${itemsOf().length} items = 14 + ${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 的对象。 */
@@ -2268,6 +2321,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',
@@ -2279,6 +2333,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',
@@ -2292,6 +2348,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]
@@ -2314,9 +2371,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}`)
@@ -2326,6 +2383,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,
@@ -2352,7 +2410,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',
@@ -2528,6 +2586,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)
@@ -2539,6 +2607,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})`)
@@ -2706,6 +2775,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
@@ -2713,6 +2783,287 @@ 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.documentListenerCountOf('keydown') === 1,
+    'exactly one document-level key listener exists', String(dlg.document.documentListenerCountOf('keydown')))
+  check(dlg.document.documentListenerCountOf('visibilitychange') === 1,
+    'and exactly one visibility listener (added for the come-back greeting)',
+    String(dlg.document.documentListenerCountOf('visibilitychange')))
+
+  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.documentListenerCountOf('keydown') === 1,
+    'opening and closing repeatedly does not stack listeners',
+    String(dlg.document.documentListenerCountOf('keydown')))
+
+  dlgApi.openAbout()
+  dlgApi.destroy()
+  check(dlgApi.dialog === null, 'destroy() takes the dialog with it')
+  active = keepDlg
+}
+
+/* ============================== 3y-2. night / come back / streak =========== */
+head('3y-2. night nagging, coming back, and the streak')
+
+/* 这三件事都靠**可配置的时间**，所以不需要伪造时钟：
+   把深夜窗口套在当前那个小时上，行为就该发生；套偏一个小时，就不该发生。 */
+{
+  const hourNowReal = new Date().getHours()
+  const mk = (options) => {
+    const h = createHarness(Object.assign({ timer: true, composerText: '在打字' }, options))
+    h.evaluate(clientSrc)
+    return h
+  }
+  const liveSaid = (h) => h.all('wisp-say').filter((el) => el.removed !== true).map((el) => el.textContent)
+  const saidLines = (h) => liveSaid(h)
+  /* 推进 ms，把过程中出现过的每一句话都收集起来。 */
+  const watch = (h, ms, step = 250) => {
+    const seen = new Set(liveSaid(h))
+    for (let left = ms; left > 0; left -= step) {
+      h.advance(Math.min(step, left), Math.min(step, 200))
+      for (const t of liveSaid(h)) seen.add(t)
+    }
+    return [...seen]
+  }
+  const inPool = (pool, text) => Array.isArray(pool) && pool.includes(text)
+
+  /* ---- 深夜劝睡 ---------------------------------------------------------- */
+  const night = mk()
+  const keepNight = active
+  active = night
+  night.module().default.apply(night.ctx, {
+    reactions: true, wander: false, celebrate: false,
+    careAfterMs: 0, hungerMs: 0, sleepAfterMs: 3600000,
+    /* 让"现在"落在深夜窗口里：从当前小时开始，到下一个小时结束 */
+    bedtimeHour: hourNowReal, wakeHour: (hourNowReal + 1) % 24, nightMs: 60000,
+  })
+  night.advance(1300, 100)
+  const nightApi = night.win.__wisp
+  check(nightApi.doctor().night.enabled === true
+    && nightApi.doctor().night.deepFrom === (hourNowReal + 2) % 24,
+    'doctor reports the night window and where the deeper register starts',
+    JSON.stringify(nightApi.doctor().night))
+  const nightSaid = watch(night, 70000)
+  check(nightSaid.some((t) => inPool(linesInBundle()?.nightLate, t)),
+    'inside the window she speaks up, from the late pool',
+    nightSaid.slice(-2).join(' / ') || '(没说)')
+  check(nightApi.doctor().night.lastAt > 0, 'and the check time is recorded',
+    String(nightApi.doctor().night.lastAt))
+
+  /* 窗口外不该说话 */
+  const day = mk()
+  const keepDay = active
+  active = day
+  day.module().default.apply(day.ctx, {
+    reactions: true, wander: false, celebrate: false,
+    careAfterMs: 0, hungerMs: 0, sleepAfterMs: 3600000,
+    bedtimeHour: (hourNowReal + 3) % 24, wakeHour: (hourNowReal + 4) % 24, nightMs: 60000,
+  })
+  day.advance(1300, 100)
+  const daySaid = watch(day, 200000)
+  check(!daySaid.some((t) => inPool(linesInBundle()?.nightLate, t) || inPool(linesInBundle()?.nightDeep, t)),
+    'outside the window she says nothing about bedtime', saidLines(day).slice(-2).join(' / ') || '(没说)')
+  day.win.__wisp.destroy()
+  active = keepDay
+
+  /* 深度深夜：把 bedtime 往前挪两小时，当前小时就落进"嘴硬心软"那一档 */
+  const deep = mk()
+  const keepDeep = active
+  active = deep
+  deep.module().default.apply(deep.ctx, {
+    reactions: true, wander: false, celebrate: false,
+    careAfterMs: 0, hungerMs: 0, sleepAfterMs: 3600000,
+    bedtimeHour: (hourNowReal + 22) % 24, wakeHour: (hourNowReal + 1) % 24, nightMs: 60000,
+  })
+  deep.advance(1300, 100)
+  const deepSaid = watch(deep, 70000)
+  check(deepSaid.some((t) => inPool(linesInBundle()?.nightDeep, t)),
+    'two hours past bedtime the register changes', deepSaid.slice(-2).join(' / ') || '(没说)')
+
+  /* 两种关法 */
+  const nightLines = () => [].concat(linesInBundle()?.nightLate ?? [], linesInBundle()?.nightDeep ?? [])
+  deep.win.__wisp.configure({ night: false })
+  check(!watch(deep, 300000).some((t) => nightLines().includes(t)),
+    'night: false turns the whole thing off')
+  deep.win.__wisp.configure({ night: true, nightMs: 0 })
+  check(!watch(deep, 300000).some((t) => nightLines().includes(t)), 'so does nightMs: 0')
+  deep.win.__wisp.destroy()
+  active = keepDeep
+
+  /* ---- 离开又回来 -------------------------------------------------------- */
+  const back = mk()
+  const keepBack = active
+  active = back
+  back.module().default.apply(back.ctx, {
+    reactions: true, wander: false, celebrate: false, careAfterMs: 0, hungerMs: 0,
+    sleepAfterMs: 3600000, backAfterMs: 60000,
+  })
+  back.advance(1300, 100)
+  const backApi = back.win.__wisp
+  /* 替身没有 visibilityState，直接摆上再派发事件 —— 这正是真浏览器里发生的事。 */
+  back.document.visibilityState = 'hidden'
+  back.document.dispatch('visibilitychange', {})
+  back.advance(120000, 1000)
+  back.document.visibilityState = 'visible'
+  back.document.dispatch('visibilitychange', {})
+  const shortBack = watch(back, 400)
+  check(shortBack.some((t) => inPool(linesInBundle()?.backSoon, t)),
+    'coming back after a short while gets the short line', shortBack.slice(-2).join(' / ') || '(没说)')
+
+  back.document.visibilityState = 'hidden'
+  back.document.dispatch('visibilitychange', {})
+  back.advance(30 * 60000, 5000)
+  back.document.visibilityState = 'visible'
+  back.document.dispatch('visibilitychange', {})
+  const longBack = watch(back, 400)
+  check(longBack.some((t) => inPool(linesInBundle()?.backLong, t)),
+    'a long absence gets the other line', longBack.slice(-2).join(' / ') || '(没说)')
+
+  /* 走开一小会儿不该说话（只看"回来池"，别把别的行为的话算进来） */
+  const backLines = () => [].concat(linesInBundle()?.backSoon ?? [], linesInBundle()?.backLong ?? [])
+  back.document.visibilityState = 'hidden'
+  back.document.dispatch('visibilitychange', {})
+  back.advance(5000, 1000)
+  back.document.visibilityState = 'visible'
+  back.document.dispatch('visibilitychange', {})
+  check(!watch(back, 600).some((t) => backLines().includes(t)),
+    'a blink of absence is not worth a line')
+
+  back.win.__wisp.configure({ backAfterMs: 0 })
+  back.document.visibilityState = 'hidden'
+  back.document.dispatch('visibilitychange', {})
+  back.advance(30 * 60000, 5000)
+  back.document.visibilityState = 'visible'
+  back.document.dispatch('visibilitychange', {})
+  check(!watch(back, 600).some((t) => backLines().includes(t)),
+    'backAfterMs: 0 turns the greeting off')
+  back.win.__wisp.destroy()
+  active = keepBack
+
+  /* ---- 连续天数 ---------------------------------------------------------- */
+  /* 用 localStorage 直接种一段连续的记录：今天 + 往前三天 = 连续 4 天。 */
+  const keyFor = (offset) => {
+    const d = new Date(Date.now() - offset * 86400000)
+    return d.getFullYear() + '-' + (d.getMonth() + 1) + '-' + d.getDate()
+  }
+  const memorySeed = {
+    'dsh-wisp:memory:v1': JSON.stringify({
+      days: [keyFor(3), keyFor(2), keyFor(1), keyFor(0)],
+      said: [], corners: {}, skins: {}, remarkDay: keyFor(0),
+    }),
+  }
+  const streak = mk({ storageSeed: memorySeed })
+  const keepStreak = active
+  active = streak
+  streak.module().default.apply(streak.ctx, {
+    reactions: true, wander: false, celebrate: false, careAfterMs: 0, hungerMs: 0, sleepAfterMs: 3600000,
+  })
+  const streakSaid = watch(streak, 5000)
+  const streakApi = streak.win.__wisp
+  check(streakApi.doctor().streak === 4, 'doctor reports a four-day streak', String(streakApi.doctor().streak))
+  const streakPool = [].concat(linesInBundle()?.streak ?? [], linesInBundle()?.milestone ?? [])
+    .map((t) => t.split('{n}').join('4'))
+  check(streakSaid.some((t) => streakPool.includes(t)),
+    'and she mentions it the next time you meet', streakSaid.slice(-3).join(' / ') || '(没说)')
+  streak.win.__wisp.destroy()
+  active = keepStreak
+
+  /* 断了就从头数：今天之前缺一天 */
+  const brokenSeed = {
+    'dsh-wisp:memory:v1': JSON.stringify({
+      days: [keyFor(5), keyFor(4), keyFor(0)], said: [], corners: {}, skins: {}, remarkDay: keyFor(0),
+    }),
+  }
+  const broken = mk({ storageSeed: brokenSeed })
+  const keepBroken = active
+  active = broken
+  broken.module().default.apply(broken.ctx, {
+    reactions: true, wander: false, celebrate: false, careAfterMs: 0, hungerMs: 0, sleepAfterMs: 3600000,
+  })
+  const brokenSaid = watch(broken, 5000)
+  check(broken.win.__wisp.doctor().streak === 1,
+    'a gap resets it to one (and one is not worth mentioning)',
+    String(broken.win.__wisp.doctor().streak))
+  const streakPool2 = [].concat(linesInBundle()?.streak ?? [], linesInBundle()?.milestone ?? [])
+    .map((t) => t.split('{n}').join('1'))
+  check(!brokenSaid.some((t) => streakPool2.includes(t)),
+    'so she stays quiet about it', brokenSaid.slice(-2).join(' / ') || '(没说)')
+  broken.win.__wisp.destroy()
+  active = keepBroken
+}
+
 /* ================================================== 3z. generation audit ==== */
 head('3z. every shipped sprite traces back to a text-only call')