feat: 完成 UI 基础层与核心页面迁移

2026-08-21 21:47:00 +08:00 · 2026-08-19 17:43:07 +08:00
parent a72ae49e2c
commit e9cc996ebb
62 changed files with 4279 additions and 5178 deletions
@@ -0,0 +1,70 @@
+import { useState } from 'react'
+import { render, screen, waitFor } from '@testing-library/react'
+import userEvent from '@testing-library/user-event'
+import { describe, expect, it, vi } from 'vitest'
+import { FirstUseWelcome } from '../../src/renderer/src/components/FirstUseWelcome'
+
+describe('FirstUseWelcome', () => {
+  it('closes with Escape or the overlay and restores focus to the opener', async () => {
+    const user = userEvent.setup()
+
+    function Harness(): React.ReactElement {
+      const [open, setOpen] = useState(false)
+      return (
+        <>
+          <button type="button" onClick={() => setOpen(true)}>
+            打开新手引导
+          </button>
+          {open && (
+            <FirstUseWelcome
+              onDismiss={() => setOpen(false)}
+              onOpenSearch={vi.fn()}
+              onOpenReport={vi.fn()}
+              onOpenAISettings={vi.fn()}
+            />
+          )}
+        </>
+      )
+    }
+
+    render(<Harness />)
+    const opener = screen.getByRole('button', { name: '打开新手引导' })
+    await user.click(opener)
+    expect(screen.getByRole('dialog', { name: '开始探索你的微信' })).toBeVisible()
+    await user.keyboard('{Escape}')
+    expect(screen.queryByRole('dialog', { name: '开始探索你的微信' })).not.toBeInTheDocument()
+    await waitFor(() => expect(opener).toHaveFocus())
+
+    await user.click(opener)
+    const dialog = screen.getByRole('dialog', { name: '开始探索你的微信' })
+    await user.click(dialog.previousElementSibling as HTMLElement)
+    expect(screen.queryByRole('dialog', { name: '开始探索你的微信' })).not.toBeInTheDocument()
+    await waitFor(() => expect(opener).toHaveFocus())
+  })
+
+  it('keeps the feature callbacks and guide link intact', async () => {
+    const user = userEvent.setup()
+    const onOpenSearch = vi.fn()
+    const onOpenReport = vi.fn()
+    const onOpenAISettings = vi.fn()
+    render(
+      <FirstUseWelcome
+        onDismiss={vi.fn()}
+        onOpenSearch={onOpenSearch}
+        onOpenReport={onOpenReport}
+        onOpenAISettings={onOpenAISettings}
+      />
+    )
+
+    await user.click(screen.getByRole('button', { name: /试试 AI 群聊日报/ }))
+    expect(onOpenReport).toHaveBeenCalledOnce()
+    await user.click(screen.getByRole('button', { name: '问问你的微信' }))
+    expect(onOpenSearch).toHaveBeenCalledOnce()
+    await user.click(screen.getByRole('button', { name: '配置 AI 模型' }))
+    expect(onOpenAISettings).toHaveBeenCalledOnce()
+    expect(screen.getByRole('link', { name: '查看完整使用教程' })).toHaveAttribute(
+      'href',
+      'https://github.com/Wxw-Gu/WechatExplorer/blob/main/docs/user-guide/getting-started.md'
+    )
+  })
+})