feat(task-logs): 优化任务中心日志前端展示

- 引入 @tanstack/vue-virtual 实现虚拟滚动，仅渲染可见区域日志行
- 添加自动滚动开关，用户可手动控制是否自动滚动
- 实现用户滚动检测，向上滚动时暂停自动滚动，滚到底部时恢复
- 优化日志面板头部布局，添加自动滚动开关 UI

关联 PR: #119

frontend/components.d.ts

@@ -20,6 +20,7 @@ declare module 'vue' {
     ElInputNumber: typeof import('element-plus/es')['ElInputNumber']
     ElOption: typeof import('element-plus/es')['ElOption']
     ElSelect: typeof import('element-plus/es')['ElSelect']
+    ElSwitch: typeof import('element-plus/es')['ElSwitch']
     ElTable: typeof import('element-plus/es')['ElTable']
     ElTableColumn: typeof import('element-plus/es')['ElTableColumn']
     RouterLink: typeof import('vue-router')['RouterLink']

frontend/package-lock.json

@@ -9,6 +9,7 @@
       "version": "0.1.0",
       "dependencies": {
         "@element-plus/icons-vue": "^2.1.0",
+        "@tanstack/vue-virtual": "^3.13.34",
         "axios": "^1.5.0",
         "element-plus": "^2.3.12",
         "pinia": "^2.1.4",
@@ -735,9 +736,6 @@
         "arm"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -752,9 +750,6 @@
         "arm"
       ],
       "dev": true,
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -769,9 +764,6 @@
         "arm64"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -786,9 +778,6 @@
         "arm64"
       ],
       "dev": true,
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -803,9 +792,6 @@
         "loong64"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -820,9 +806,6 @@
         "loong64"
       ],
       "dev": true,
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -837,9 +820,6 @@
         "ppc64"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -854,9 +834,6 @@
         "ppc64"
       ],
       "dev": true,
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -871,9 +848,6 @@
         "riscv64"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -888,9 +862,6 @@
         "riscv64"
       ],
       "dev": true,
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -905,9 +876,6 @@
         "s390x"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -922,9 +890,6 @@
         "x64"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -939,9 +904,6 @@
         "x64"
       ],
       "dev": true,
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1032,6 +994,32 @@
         "win32"
       ]
     },
+    "node_modules/@tanstack/virtual-core": {
+      "version": "3.17.6",
+      "resolved": "https://registry.npmjs.org/@tanstack/virtual-core/-/virtual-core-3.17.6.tgz",
+      "integrity": "sha512-h0/Ebo18CkOrChlQIhNtQkM5ySUnh/GumQ/D1st3hG2HWUPEF+ILUc2k29UtivCi/9G7w7G3/f7Xyd5cCFbKBw==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      }
+    },
+    "node_modules/@tanstack/vue-virtual": {
+      "version": "3.13.34",
+      "resolved": "https://registry.npmjs.org/@tanstack/vue-virtual/-/vue-virtual-3.13.34.tgz",
+      "integrity": "sha512-CBqbCcnVsKpl9IJ7frPnbBmAqmc7JttSySg04kgLYJ4yYuC8JsAbtUHP0yLtWGLyByjihN3SwaDCgHQ+Z4iPoA==",
+      "license": "MIT",
+      "dependencies": {
+        "@tanstack/virtual-core": "3.17.6"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      },
+      "peerDependencies": {
+        "vue": "^2.7.0 || ^3.0.0"
+      }
+    },
     "node_modules/@types/estree": {
       "version": "1.0.9",
       "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",

frontend/package.json

@@ -9,19 +9,20 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "vue": "^3.3.4",
-    "vue-router": "^4.2.4",
-    "pinia": "^2.1.4",
-    "element-plus": "^2.3.12",
     "@element-plus/icons-vue": "^2.1.0",
-    "axios": "^1.5.0"
+    "@tanstack/vue-virtual": "^3.13.34",
+    "axios": "^1.5.0",
+    "element-plus": "^2.3.12",
+    "pinia": "^2.1.4",
+    "vue": "^3.3.4",
+    "vue-router": "^4.2.4"
   },
   "devDependencies": {
     "@vitejs/plugin-vue": "^5.2.4",
     "typescript": "^5.2.2",
-    "vite": "^6.4.3",
-    "vue-tsc": "^2.2.12",
     "unplugin-auto-import": "^0.16.6",
-    "unplugin-vue-components": "^0.25.2"
+    "unplugin-vue-components": "^0.25.2",
+    "vite": "^6.4.3",
+    "vue-tsc": "^2.2.12"
   }
 }

frontend/src/views/task/TaskCenter.vue

@@ -54,11 +54,38 @@
             <span class="selected-name">{{ selectedTaskName }}</span>
             <span v-if="isStreaming" class="streaming-indicator">● 实时更新中</span>
           </h3>
-          <span class="meta">{{ selectedTaskMeta }}</span>
+          <div class="panel-actions">
+            <el-switch
+              v-model="autoScroll"
+              active-text="自动滚动"
+              class="auto-scroll-switch"
+            />
+            <span class="meta">{{ selectedTaskMeta }}</span>
+          </div>
         </div>
-        <div class="panel-body log-stream">
+        <div
-          <div v-for="(log, index) in logs" :key="index" :class="['task-log-line', log.class]">
+          ref="logContainerRef"
-            <span class="t">{{ log.time }}</span>{{ log.message }}
+          class="panel-body log-stream"
+          @scroll="handleScroll"
+        >
+          <!-- 虚拟滚动容器 -->
+          <div
+            :style="{ height: `${virtualizer.getTotalSize()}px`, position: 'relative' }"
+          >
+            <div
+              v-for="virtualRow in virtualizer.getVirtualItems()"
+              :key="String(virtualRow.key)"
+              :class="['task-log-line', logs[virtualRow.index].class]"
+              :style="{
+                position: 'absolute',
+                top: 0,
+                left: 0,
+                width: '100%',
+                transform: `translateY(${virtualRow.start}px)`,
+              }"
+            >
+              <span class="t">{{ logs[virtualRow.index].time }}</span>{{ logs[virtualRow.index].message }}
+            </div>
           </div>
           <div v-if="loadingLogs" class="task-log-line">
             <span class="t">...</span>加载中
@@ -73,10 +100,11 @@
 </template>
 
 <script setup lang="ts">
-import { computed, onMounted, onUnmounted, ref, watch } from 'vue'
+import { computed, nextTick, onMounted, onUnmounted, ref, watch } from 'vue'
 import { taskLogApi, createTaskLogStream, type TaskLogLine, type TaskLogSummary } from '@/api/taskLog'
 import { useBusinessLineStore } from '@/stores/businessLine'
 import { useBusinessLineMockProfile } from '@/utils/businessLineMock'
+import { useVirtualizer } from '@tanstack/vue-virtual'
 
 const { currentName } = useBusinessLineMockProfile()
 const businessLineStore = useBusinessLineStore()
@@ -90,6 +118,16 @@ const loadingLogs = ref(false)
 const lastLoadedAt = ref<Date | null>(null)
 const isStreaming = ref(false)
 let eventSource: EventSource | null = null
+const autoScroll = ref(true)
+const logContainerRef = ref<HTMLDivElement | null>(null)
+
+// 虚拟滚动配置
+const virtualizer = useVirtualizer({
+  count: logs.value.length,
+  getScrollElement: () => logContainerRef.value,
+  estimateSize: () => 20,
+  overscan: 5,
+})
 
 const selectedTask = computed(() => tasks.value.find((task) => task.id === selectedTaskId.value))
 const selectedTaskName = computed(() => selectedTask.value?.name || '未选择')
@@ -169,13 +207,28 @@ function stopStream() {
 }
 
 function scrollToBottom() {
-  // 延迟滚动，等待 DOM 更新
+  if (!autoScroll.value) return
-  setTimeout(() => {
+
-    const logStream = document.querySelector('.log-stream')
+  nextTick(() => {
-    if (logStream) {
+    if (logContainerRef.value) {
-      logStream.scrollTop = logStream.scrollHeight
+      logContainerRef.value.scrollTop = logContainerRef.value.scrollHeight
     }
-  }, 50)
+  })
+}
+
+function handleScroll() {
+  if (!logContainerRef.value) return
+
+  const { scrollTop, scrollHeight, clientHeight } = logContainerRef.value
+  const distanceFromBottom = scrollHeight - scrollTop - clientHeight
+
+  // 距离底部小于 50px 时认为在底部，恢复自动滚动
+  if (distanceFromBottom < 50) {
+    autoScroll.value = true
+  } else if (distanceFromBottom > 100) {
+    // 用户向上滚动超过 100px 时暂停自动滚动
+    autoScroll.value = false
+  }
 }
 
 function selectTask(taskId: string) {
@@ -302,6 +355,7 @@ onUnmounted(() => {
 
 .task-log-panel .panel-head {
   gap: 14px;
+  flex-wrap: wrap;
 }
 
 .task-log-panel .panel-head h3 {
@@ -311,6 +365,10 @@ onUnmounted(() => {
   gap: 10px;
 }
 
+.task-log-panel .panel-head .panel-actions {
+  margin-left: auto;
+}
+
 .selected-name {
   color: var(--text-dim);
   font-weight: 500;
@@ -327,6 +385,16 @@ onUnmounted(() => {
   50% { opacity: 0.5; }
 }
 
+.panel-actions {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+
+.auto-scroll-switch {
+  --el-switch-on-color: var(--accent);
+}
+
 .log-stream {
   max-height: calc(100vh - 210px);
   min-height: 520px;