refactor: remove meaningless comments

Remove 50+ noise comments across the codebase:
- AI-generated verbose prose (💡 emoji, '超进化', '大闸', etc.)
- Comments that restate what the code obviously does
- Comments about deleted code
- Import-level noise comments
- Overly verbose Chinese section markers

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
雨霖铃
2026-05-28 20:37:52 +08:00
parent b79fe7dd49
commit e140af7698
34 changed files with 32 additions and 242 deletions
+5 -12
View File
@@ -7,7 +7,7 @@ import {
useMemo,
useState,
} from 'react';
import { browser } from 'wxt/browser'; // 💡 1. 规范回归:引入 WXT 标准多端一致性代理,消灭裸奔的 chrome 空间
import { browser } from 'wxt/browser';
import { storageUtil } from '@/utils/chromeStorage';
export type ThemeMode = 'light' | 'dark' | 'system';
@@ -59,18 +59,15 @@ export function ThemeModeProvider({ children }: ThemeModeProviderProps) {
mode === 'system' ? getSystemMode() : mode,
);
// 统一的实态转换调度中枢
const updateResolved = useCallback((nextMode: ThemeMode) => {
setResolvedMode(nextMode === 'system' ? getSystemMode() : nextMode);
}, []);
// 主动切流触发大闸
const setMode = useCallback(
(next: ThemeMode) => {
setModeState(next);
updateResolved(next);
// 💡 修复点:对异步微任务链追加标准的显式 void 断链安全隔离,彻底净化 Linter 悬空 Promise 警告
void storageUtil.set(THEME_MODE_KEY, next).catch((err) => {
console.error('[Theme Storage Error] Failed to persistent theme state:', err);
});
@@ -84,7 +81,7 @@ export function ThemeModeProvider({ children }: ThemeModeProviderProps) {
[updateResolved],
);
// 副作用 1:冷启动时异步对齐来自长期存储的权威配置,自愈快照偏差
// Sync theme from storage on mount
useEffect(() => {
let cancelled = false;
storageUtil
@@ -104,7 +101,7 @@ export function ThemeModeProvider({ children }: ThemeModeProviderProps) {
};
}, [updateResolved]);
// 副作用 2:当处于跟随系统模式下,动态监听操作系统级别的高级霓虹换色
// Listen for system theme changes when in system mode
useEffect(() => {
if (mode !== 'system') return;
const mq = window.matchMedia('(prefers-color-scheme: dark)');
@@ -115,15 +112,12 @@ export function ThemeModeProvider({ children }: ThemeModeProviderProps) {
return () => mq.removeEventListener('change', handler);
}, [mode]);
// 副作用 3:跨上下文广播事件同步大闸(Popup <-> Sidepanel 联动核心)
// Sync theme across extension contexts (popup <-> sidepanel)
useEffect(() => {
// 💡 2. 强类型对齐修复:对齐标准的 browser.storage.onChanged.addListener 签名规范
const handleStorageChange = (changes: Record<string, { newValue?: unknown }>) => {
if (changes[THEME_MODE_KEY]) {
const next = changes[THEME_MODE_KEY].newValue;
if (isValidMode(next)) {
// 💡 3. 架构解耦:改用函数式状态更新,彻底将本 Effect 从当前的 [mode] 依赖中解脱出来!
// 这能保证多视口监听器在初始化时【只注册一次】,彻底消灭高频切流时的事件撕裂与重复注销。
setModeState((currentMode) => {
if (next !== currentMode) {
updateResolved(next);
@@ -139,9 +133,8 @@ export function ThemeModeProvider({ children }: ThemeModeProviderProps) {
return () => {
browser.storage.onChanged.removeListener(handleStorageChange);
};
}, [updateResolved]); // 👈 完美剔除 mode 脏依赖!
}, [updateResolved]);
// 副作用 4:宿主 DOM 的 class 样式原子映射注入(一帧直出)
useEffect(() => {
if (typeof document !== 'undefined') {
document.documentElement.classList.toggle('dark', resolvedMode === 'dark');