feat(event-manager): 添加滚动监听器管理和防抖优化

添加 scrollHandler 和 scrollTimer 私有属性用于管理滚动事件监听器，
实现 registerScrollListener 和 removeAllScrollListener 方法来正确注册
和移除滚动监听器，避免内存泄漏。使用防抖机制优化滚动事件处理性能。

fix(knowledge-chart): 优化知识网络图缩放逻辑避免图表重建

修改 updateChartZoom 方法接受新缩放参数，当图表未创建时只记录目标
缩放值。使用 graphRoam 动作进行相对缩放更新，避免销毁重建图表导致
力导向布局重新计算，提升用户体验。

feat(mobile-doc): 在移动端文档页面组件卸载时清理事件管理器

在 MobileDocPage 组件的 unmounted 生命周期钩子中调用
cancelPendingRender 和 removeAllScrollListener 方法，
确保页面切换时正确清理滚动监听器和待处理渲染任务。

refactor(pwa): 优化 PWA 缓存策略减少首屏加载资源

调整 workbox 配置，预缓存仅包含 index.html，避免首次访问下载全站
约10MB资源。为带哈希的静态资源配置 CacheFirst 策略，文档数据配
置 StaleWhileRevalidate 策略，优化缓存效率。

Author: 0xcaffebabe

src/pages/doc/DocPageEventManager.ts

@@ -21,6 +21,8 @@ class DocPageEventManager {
   private isMobile: boolean;
   private cancelLatexTask: (() => void) | null = null;
   private cancelHighlightTask: (() => void) | null = null;
+  private scrollHandler: ((e: Event) => void) | null = null;
+  private scrollTimer: ReturnType<typeof setTimeout> | undefined;
 
   constructor(docPageInstance: InstanceType<typeof DocPage | typeof MobileDocPage>, isMobile: boolean = false) {
     this.docPageInstance = docPageInstance;
@@ -197,16 +199,17 @@ class DocPageEventManager {
    * @memberof DocPageEventManager
    */
   public registerScrollListener() {
-    let timer: NodeJS.Timeout;
-    document.addEventListener("scroll", (e) => {
+    this.removeAllScrollListener();
+    this.scrollHandler = () => {
       // 限流更新阅读位置
-      clearTimeout(timer);
-      timer = setTimeout(() => {
+      clearTimeout(this.scrollTimer);
+      this.scrollTimer = setTimeout(() => {
         DocService.setDocReadRecrod(this.docPageInstance.doc, window.scrollY);
       }, 1000);
       // 滚动的同时将link-popover隐藏掉
       this.getRef('linkPopover') && (this.getRef('linkPopover') as InstanceType<typeof LinkPopover>).hide();
-    });
+    };
+    document.addEventListener("scroll", this.scrollHandler);
   }
 
 
@@ -259,7 +262,11 @@ class DocPageEventManager {
    * @memberof DocPageEventManager
    */
   public removeAllScrollListener(){
-    document.onscroll = null
+    if (this.scrollHandler) {
+      document.removeEventListener("scroll", this.scrollHandler)
+      this.scrollHandler = null
+    }
+    clearTimeout(this.scrollTimer)
   }
 
 

src/pages/doc/knowledge/KnowledgeNetworkChart.vue

@@ -104,8 +104,7 @@ export default defineComponent({
       this.init();
     },
     zoom(newVal) {
-      this.graphZoom = newVal;
-      this.updateChartZoom();
+      this.updateChartZoom(newVal);
     }
   },
   computed: {
@@ -449,10 +448,25 @@ export default defineComponent({
       });
     },
     
-    updateChartZoom() {
-      // 重新初始化图表以应用新的缩放级别
-      this.$nextTick(() => {
-        this.init(false);
+    updateChartZoom(newZoom: number) {
+      // 图表未创建时只记录目标缩放，等init时生效
+      if (!this.chart) {
+        this.graphZoom = newZoom;
+        return;
+      }
+      // 用相对缩放动作更新，避免销毁重建图表导致力导向布局重跑
+      // this.graphZoom 由 graphRoam 事件回调同步
+      const factor = newZoom / this.graphZoom;
+      if (!isFinite(factor) || factor <= 0 || factor === 1) {
+        return;
+      }
+      const chartDom = document.getElementById(this.id);
+      this.chart.dispatchAction({
+        type: 'graphRoam',
+        seriesIndex: 0,
+        zoom: factor,
+        originX: (chartDom?.clientWidth ?? 0) / 2,
+        originY: (chartDom?.clientHeight ?? 0) / 2,
       });
     },
 

src/pages/doc/mobile/MobileDocPage.vue

@@ -142,6 +142,10 @@ export default defineComponent({
     this.init(this.doc, headingId, kw)
     this.eventManager = new DocPageEventManager(this, true)
     this.eventManager!.registerScrollListener();
+  },
+  unmounted() {
+    this.eventManager!.cancelPendingRender();
+    this.eventManager!.removeAllScrollListener();
   }
 })
 </script>

vite.config.ts

@@ -62,7 +62,31 @@ export default defineConfig({
       registerType: 'autoUpdate', 
       includeAssets: ['favicon.ico'],
       workbox: {
-        globPatterns: ['**/index.html', '**/*.{js,css,json}'],
+        // 只预缓存应用入口，避免首次访问就在后台下载全站约10MB资源
+        // （含mermaid/echarts/cytoscape等懒加载chunk和300+个文档JSON）
+        globPatterns: ['**/index.html'],
+        runtimeCaching: [
+          {
+            // 带内容哈希的静态资源不会变更，缓存优先
+            urlPattern: /\/resource\/.*\.(?:js|css)$/,
+            handler: 'CacheFirst',
+            options: {
+              cacheName: 'hashed-assets',
+              expiration: { maxEntries: 300, maxAgeSeconds: 30 * 24 * 60 * 60 },
+              cacheableResponse: { statuses: [0, 200] },
+            },
+          },
+          {
+            // 文档与统计数据按需缓存，先返回缓存同时后台刷新
+            urlPattern: /\.json$/,
+            handler: 'StaleWhileRevalidate',
+            options: {
+              cacheName: 'doc-data',
+              expiration: { maxEntries: 500 },
+              cacheableResponse: { statuses: [0, 200] },
+            },
+          },
+        ],
       },
       manifest: {
         name: '知识体系',