Files
Enterprise-Knowledge-Base/frontend/src/composables/useTheme.ts
T
Claude 35a5e29a23 fix(frontend): drop infectious preference fallback, add migration latch
QA review of the previous hardening commit identified two cross-user
infection paths created by the smart-fallback read chain (CRIT-1/2),
plus a UI-desync hazard from validation guards in setters (HIGH-1).

- Extracted localStorage helpers and migration logic into
  composables/preferenceStorage.ts as a single source of truth.
- Reads now hit only the active user's namespace - no anon / legacy
  fallback in the hot path. Pre-existing values are migrated **once**
  per active user via migratePreferencesIntoUser, which adopts anon
  and legacy keys into the user namespace and then deletes the source
  keys, so a second user logging into the same browser cannot inherit
  the previous user's preferences.
- Migration latch tracks which user has already been migrated this
  session; auth store's reloadUserPreferences resets the latch on
  setUser/logout so the next active user gets a fresh migration.
- setSansFont / setMonoFont / setFontSize / setTheme now return a
  boolean; GeneralSettings.vue handlers roll the form back to the
  canonical state when validation rejects a value, preventing the
  UI from drifting out of sync with the source of truth.
- safeSetItem now console.warn on persistence failures so quota /
  private-mode issues are at least diagnosable.
- applyFont is diff-aware: only the CSS variables that actually
  changed are written to the root style, avoiding unnecessary style
  recalculation when only one knob is flipped.
- applyTheme caches the last effective mode to skip redundant
  attribute writes and Wails IPC calls.

https://claude.ai/code/session_01S1FVPf4jRfWXkTSnpMmMp7
2026-05-05 00:48:40 +08:00

102 lines
3.0 KiB
TypeScript

import { ref } from 'vue'
import {
loadPreference,
savePreference,
migratePreferencesIntoUser,
} from './preferenceStorage'
export type ThemeMode = 'light' | 'dark' | 'system'
const THEME_KEY = 'theme'
function loadTheme(): ThemeMode {
const v = loadPreference(THEME_KEY)
if (v === 'light' || v === 'dark' || v === 'system') return v
return 'light'
}
// Shared reactive state across all consumers
const currentTheme = ref<ThemeMode>(loadTheme())
let lastEffective: 'light' | 'dark' | null = null
function getSystemTheme(): 'light' | 'dark' {
return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'
}
/** Wails:与原生窗口底色 / 系统深浅色一致,减轻 Ctrl+R 整窗白闪(浅色与 --td-bg-color-page #eee 对齐) */
function syncWailsNativeChrome(effective: 'light' | 'dark') {
const bg = effective === 'dark' ? '#181818' : '#eeeeee'
document.documentElement.style.background = bg
document.documentElement.style.minHeight = '100%'
document.documentElement.style.colorScheme = effective === 'dark' ? 'dark' : 'light'
if (document.body) {
document.body.style.background = bg
document.body.style.minHeight = '100%'
}
const appEl = document.getElementById('app')
if (appEl) {
appEl.style.background = bg
appEl.style.minHeight = '100%'
}
const w = (window as unknown as {
runtime?: {
WindowSetDarkTheme?: () => void
WindowSetLightTheme?: () => void
WindowSetBackgroundColour?: (r: number, g: number, b: number, a: number) => void
}
}).runtime
if (!w?.WindowSetBackgroundColour) return
try {
if (effective === 'dark') {
w.WindowSetDarkTheme?.()
w.WindowSetBackgroundColour(24, 24, 24, 255)
} else {
w.WindowSetLightTheme?.()
w.WindowSetBackgroundColour(238, 238, 238, 255)
}
} catch {
/* 非桌面壳或未注入 runtime */
}
}
function applyTheme(mode: ThemeMode) {
const effective = mode === 'system' ? getSystemTheme() : mode
if (lastEffective === effective) return
lastEffective = effective
document.documentElement.setAttribute('theme-mode', effective)
syncWailsNativeChrome(effective)
}
export function useTheme() {
function setTheme(mode: ThemeMode): boolean {
if (mode !== 'light' && mode !== 'dark' && mode !== 'system') return false
currentTheme.value = mode
savePreference(THEME_KEY, mode)
applyTheme(mode)
return true
}
return { currentTheme, setTheme }
}
/** Call once in main.ts to initialise theme and listen for OS changes. */
export function initTheme() {
currentTheme.value = loadTheme()
applyTheme(currentTheme.value)
// React to OS theme changes when user chose "system"
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
if (currentTheme.value === 'system') {
applyTheme('system')
}
})
}
/** Re-read preferences from storage (call after login / logout). */
export function reloadThemeFromStorage() {
migratePreferencesIntoUser()
currentTheme.value = loadTheme()
applyTheme(currentTheme.value)
}