一、确定的功能性 Bug（改完功能才正常）#

二、性能问题（影响流畅度）#

• diary.astro 计数用 filter 嵌套遍历，O(n*m) → 单次遍历或 Map 统计，降到 O(n+m)。
• projects.astro 分类计数每次映射都重新过滤 → 预计算计数映射表。
• GridScripts.astro 多次 void document.body.offsetHeight 强制重排 → 合并 DOM 操作，减少强制同步布局。
• MobileTOC.svelte scroll 事件里频繁 document.querySelectorAll → 缓存结果或用 requestAnimationFrame 节流。
• BackToTop.astro scroll 监听未节流 → 加 throttle/debounce 或 requestAnimationFrame。
• useFloatingTOC.ts 每次滚动全量遍历标题 → 二分查找或缓存标题位置。
• GridScripts.astro 重复 DOM 查询 → 缓存 getElementById/querySelector 结果。
• NavMenuPanel.astro 动态新增元素没绑事件 → 用事件委托。

三、内存泄漏（未清理的定时器/监听器，站点越用越卡的根源）#

以下文件都存在「事件监听器 / 定时器 / IntersectionObserver / MutationObserver 未在组件卸载时清理」的问题，统一改法：在 onDestroy / cleanup 里补 clearInterval、clearTimeout、removeEventListener、observer.disconnect()。

• MusicPlayer.svelte — startVolumeDrag 的 mousemove/mouseup 未移除。
• GridScripts.astro — setupSwupLayoutSync 的 setInterval 未 clear。
• SharePoster.svelte — MutationObserver 未 disconnect。
• MobileTOC.svelte — swup:enable 监听器未移除。
• Calendar.svelte — 每分钟日期检查定时器未清除。
• code-collapse.js — debounceTimer 未 clearTimeout、MutationObserver 未 disconnect。
• FloatingTOC.astro — window.scroll/resize 监听未移除。
• FullscreenWallpaper.astro — setInterval 未清除。
• LastModified.astro — setInterval 未清除。
• Icon.astro — MutationObserver 未 disconnect。
• scroll-handler.ts — ScrollHandler 无 destroy 方法。
• responsive-sidebar.ts — resize 监听未清理。
• CustomScrollbar.astro — MutationObserver + scroll/resize 监听未移除。
• navigation-utils.ts — IntersectionObserver + waitForSwup 监听未移除。
• Markdown.astro — document 监听 + 定时器未清理。
• Giscus.astro — observer_theme 未 disconnect。
• animation-utils.ts — IntersectionObserver 未 disconnect。
• anime-filter-handler.ts — 事件监听重复添加、IntersectionObserver 未断开。
• site-stats/SiteStats.astro — setInterval 未清除。
• LayoutSwitch.svelte — mediaQueryList + swup 监听未移除。
• card-toc/CardTOC.astro — 事件重复绑定、WeakMap 未清理。
• panel-handler.ts — 点击外部监听重复绑定、boundClickHandlers 未清理。
• ThemeSwitch.svelte — setTimeout 未清理。
• Pio.svelte — pioInstance 未销毁、setTimeout 可能无限重试。
• SidebarMusicClient.svelte — 事件监听可能重复注册。
• useVolumeControl.ts — rafId 未 cancelAnimationFrame。
• usePlayerState.ts — showErrorMessageUI 的 setTimeout 未清理。
• post-lastmodified.ts / animation-test.js — setInterval 未清除。
• BackToHome.astro — document 监听未清理。
• useTocScroll.ts — scroll 监听未移除。
• tocManager.ts / toc-utils.ts — IntersectionObserver 未断开旧实例。

四、空值/边界校验缺失（特定输入下崩溃）#

• content-utils.ts post.data.category 为 null 时直接 trim() → 先判空。
• SiteStats.astro posts 空数组直接 posts[0] → 判空或给默认值。
• devices.astro devices[brands[0]] 未判 brands 空 → 先查 length。
• Profile.astro links[0] 未判空、== 应改 ===、重试未设上限。
• useAudioPlayer.ts audio 未判 undefined 就 play/pause、audio.duration 可能 NaN → 补 if (!audio) return 和 NaN 检查。
• SidebarTrackInfo.svelte event.currentTarget 可能 null、音量未 clamp、拖拽没绑到 document → 补判空 + Math.max(0, Math.min(1, v)) + 事件绑 document。
• useVolumeControl.ts rect.width 为 0 会除零 → 判 width > 0。
• SidebarProgress.svelte rect.width 为 0 除零 → 判 width > 0。
• PostListItem.astro published 非 Date 时 toDateString() 崩 → 先转 Date 或校验。
• TechStack.astro techStack 为 null 时 .map() 崩 → techStack ?? []。
• Giscus.astro config.lang 未定义时 replace 崩 → (config.lang || "")。
• IconifyLoader.astro 错误事件被当加载完成 → 区分 error/load。
• YearPicker.svelte minYear > maxYear 可能死循环 → 先校验范围。
• widget-manager.ts / responsive-sidebar.ts / SideBar.astro 空引用访问 → 补存在性检查。
• toc-utils.ts / useMobileTOC.ts rootMargin: -80% 疑似笔误（应为像素）→ 改 -80px 或 0px；h1Count 超数组长度时 badge 为 undefined → 补边界检查。
• FriendCard.astro new URL(siteurl) 无效 URL 崩 → try-catch。
• setting-utils.ts / PostList.svelte parseInt 未指定基数、前导零问题 → 指定基数 10 或用 Number()。
• SkillCard.astro ${skillColor}20 十六进制拼接错误 → 用 rgba() 或 8 位 hex。

备注#

• 上一份评审里 styles\wikoo.css 的 3 条意见对应文件在源码中不存在（30B 幻觉），本轮已剔除。
• 全部条目都定位到 E:\yrlwa-web\Mizuki-master\src\ 下的真实文件，可直接对照修改。