refactor: 移除启动页逻辑，新增全局组件与偏好设置系统

1. 移除旧版启动页分流逻辑，直接跳转首页 2. 新增返回顶部、章节标题、导航栏等全局组件 3. 重构偏好设置系统，实现站点默认与本地差异分层管理 4. 删除冗余的测试mock、插件模块与样式文件 5. 优化文章卡片与评论组件样式，更新全局主题色 6. 清理废弃的请求参数与配置项
2026-09-12 16:40:40 +08:00 · 2026-09-03 22:36:26 +08:00
parent cf9c02cfc3
commit 902faa70e7
49 changed files with 3170 additions and 4288 deletions
@@ -0,0 +1,193 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { DefaultAppSettings } from '@/config/appSettings'
+import type { IAppSettings } from '@/config/appSettings'
+import {
+  LOCAL_PREFS_KEY,
+  clearLocalPrefs,
+  collectSiteDefaults,
+  isLocalOverride,
+  mergeWithDefaults,
+  migrateLegacyLocalPrefs,
+  readLocalPrefs,
+  updateLocalPrefs,
+} from './preference'
+
+/** 内存版 uni storage(与 utils/storage 的 {data,time,expire} 包装配合) */
+const mem = new Map<string, string>()
+
+function setupUniStorageMock() {
+  vi.mocked(uni.getStorageSync).mockImplementation((key: string) => mem.get(key) ?? null)
+  vi.mocked(uni.setStorageSync).mockImplementation((key: string, val: unknown) => {
+    mem.set(key, val as string)
+  })
+  vi.mocked(uni.removeStorageSync).mockImplementation((key: string) => {
+    mem.delete(key)
+  })
+}
+
+describe('preference 基础读写', () => {
+  beforeEach(() => {
+    mem.clear()
+    setupUniStorageMock()
+  })
+
+  it('readLocalPrefs：无数据时返回空对象', () => {
+    expect(readLocalPrefs()).toEqual({})
+  })
+
+  it('updateLocalPrefs：嵌套字段增量合并', () => {
+    updateLocalPrefs({ layout: { home: 'h_row_col2' } })
+    updateLocalPrefs({ layout: { cardType: 'tb_image_text' } })
+    expect(readLocalPrefs()).toEqual({
+      layout: { home: 'h_row_col2', cardType: 'tb_image_text' },
+    })
+  })
+
+  it('updateLocalPrefs：null 删除该键(回退跟随站点默认)', () => {
+    updateLocalPrefs({ layout: { home: 'h_row_col2', cardType: 'tb_image_text' } })
+    updateLocalPrefs({ layout: { home: null } })
+    expect(readLocalPrefs()).toEqual({ layout: { cardType: 'tb_image_text' } })
+  })
+
+  it('updateLocalPrefs(null)：整体清空差异', () => {
+    updateLocalPrefs({ layout: { home: 'h_row_col2' } })
+    updateLocalPrefs(null)
+    expect(readLocalPrefs()).toEqual({})
+    expect(mem.has(LOCAL_PREFS_KEY)).toBe(false)
+  })
+
+  it('clearLocalPrefs：删除存储键', () => {
+    updateLocalPrefs({ layout: { home: 'h_row_col2' } })
+    clearLocalPrefs()
+    expect(readLocalPrefs()).toEqual({})
+  })
+
+  it('isLocalOverride：按路径判断是否被本地覆盖', () => {
+    updateLocalPrefs({ gallery: { useWaterfull: false } })
+    expect(isLocalOverride(readLocalPrefs(), ['gallery', 'useWaterfull'])).toBe(true)
+    expect(isLocalOverride(readLocalPrefs(), ['banner', 'useDot'])).toBe(false)
+  })
+})
+
+describe('mergeWithDefaults / collectSiteDefaults', () => {
+  it('默认值兜底：无站点默认无本地差异时等于内置默认', () => {
+    expect(mergeWithDefaults()).toEqual(DefaultAppSettings)
+  })
+
+  it('本地优先于站点默认，站点默认优先于内置默认', () => {
+    const merged = mergeWithDefaults(
+      { layout: { home: 'h_row_col1' }, gallery: { useWaterfull: true } },
+      { layout: { home: 'h_row_col2' } },
+    )
+    expect(merged.layout.home).toBe('h_row_col2')
+    expect(merged.gallery.useWaterfull).toBe(true)
+    expect(merged.isAvatarRadius).toBe(DefaultAppSettings.isAvatarRadius)
+  })
+
+  it('collectSiteDefaults：banner 站点默认映射(showIndicator→useDot)', () => {
+    const site = collectSiteDefaults({
+      pageConfig: {
+        homeConfig: {
+          bannerConfig: { showIndicator: false, dotPosition: 'bottom' },
+        },
+      },
+    })
+    expect(site.banner).toEqual({ useDot: false, dotPosition: 'bottom' })
+  })
+
+  it('collectSiteDefaults：preferences(L0)映射到 layout.home/cardType/isAvatarRadius', () => {
+    const site = collectSiteDefaults({
+      preferences: {
+        homeListLayout: 'h_row_col2',
+        articleCardType: 'tb_image_text',
+        avatarRadius: true,
+      },
+    })
+    expect(site.layout).toEqual({ home: 'h_row_col2', cardType: 'tb_image_text' })
+    expect(site.isAvatarRadius).toBe(true)
+  })
+
+  it('preferences L0 参与合并,本地未覆盖时跟随站点默认', () => {
+    const site = collectSiteDefaults({
+      preferences: {
+        homeListLayout: 'h_row_col2',
+        articleCardType: 'tb_image_text',
+        avatarRadius: true,
+      },
+    })
+    const merged = mergeWithDefaults(site, {})
+    expect(merged.layout.home).toBe('h_row_col2')
+    expect(merged.layout.cardType).toBe('tb_image_text')
+    expect(merged.isAvatarRadius).toBe(true)
+  })
+
+  it('preferences L0 可被本地差异覆盖,重置后回退站点默认', () => {
+    const site = collectSiteDefaults({
+      preferences: {
+        homeListLayout: 'h_row_col2',
+        articleCardType: 'tb_image_text',
+        avatarRadius: true,
+      },
+    })
+    const merged = mergeWithDefaults(site, { layout: { home: 'h_row_col1' }, isAvatarRadius: false })
+    expect(merged.layout.home).toBe('h_row_col1')
+    expect(merged.layout.cardType).toBe('tb_image_text')
+    expect(merged.isAvatarRadius).toBe(false)
+  })
+
+  it('站点 banner 默认参与合并,本地未覆盖时跟随站点默认', () => {
+    const site = collectSiteDefaults({
+      pageConfig: {
+        homeConfig: {
+          bannerConfig: { showIndicator: false, dotPosition: 'bottom' },
+        },
+      },
+    })
+    const merged = mergeWithDefaults(site, {})
+    expect(merged.banner.useDot).toBe(false)
+    expect(merged.banner.dotPosition).toBe('bottom')
+    expect(merged.layout.home).toBe(DefaultAppSettings.layout.home)
+  })
+
+  it('未知枚举值不回退抛错(跟随默认)', () => {
+    const merged = mergeWithDefaults({}, { layout: { home: 'not-exist' } })
+    expect(merged.layout.home).toBe('not-exist')
+  })
+})
+
+describe('migrateLegacyLocalPrefs', () => {
+  beforeEach(() => {
+    mem.clear()
+    setupUniStorageMock()
+  })
+
+  it('旧 persist 存在时仅迁移被改过的叶子字段', () => {
+    const legacySettings: IAppSettings = JSON.parse(JSON.stringify(DefaultAppSettings))
+    legacySettings.layout.home = 'h_row_col2'
+    legacySettings.gallery.useWaterfull = false
+    mem.set('setting', JSON.stringify({ settings: legacySettings }))
+
+    expect(migrateLegacyLocalPrefs()).toBe(true)
+    expect(readLocalPrefs()).toEqual({
+      layout: { home: 'h_row_col2' },
+      gallery: { useWaterfull: false },
+    })
+  })
+
+  it('已存在新差异键时不再重复迁移', () => {
+    updateLocalPrefs({ layout: { home: 'h_row_col1' } })
+    const legacySettings = JSON.parse(JSON.stringify(DefaultAppSettings)) as IAppSettings
+    legacySettings.layout.home = 'h_row_col2'
+    mem.set('setting', JSON.stringify({ settings: legacySettings }))
+
+    expect(migrateLegacyLocalPrefs()).toBe(false)
+    expect(readLocalPrefs()).toEqual({ layout: { home: 'h_row_col1' } })
+  })
+
+  it('无旧键或格式异常时返回 false 且不写新键', () => {
+    expect(migrateLegacyLocalPrefs()).toBe(false)
+    mem.set('setting', 'not-json{')
+    expect(migrateLegacyLocalPrefs()).toBe(false)
+    expect(mem.has(LOCAL_PREFS_KEY)).toBe(false)
+  })
+})