react-terminal-viewer-cicd 3.0.0-beta.43 → 3.0.0-beta.45

package/dist/esm/Addon/WorkerLog/LogWorker.js

@@ -1,7 +1,7 @@
 function LogWorker() {
   var workerPath = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '/worker';
   var worker = null;
-  var version = "3.0.0-beta.43" || '0.0.0';
+  var version = "3.0.0-beta.45" || '0.0.0';
   var path = workerPath.includes('http') ? "".concat(workerPath, "/log.worker.js") : "".concat(window.location.origin).concat(workerPath, "/log.worker.js");
   var blob = new Blob(["importScripts(\"".concat(path, "?v=").concat(version, "\")")], {
     type: 'application/javascript'

package/dist/esm/PipelineLogViewer/PipelineLogViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PipelineLogViewer.d.ts","sourceRoot":"","sources":["../../../src/PipelineLogViewer/PipelineLogViewer.tsx"],"names":[],"mappings":"AAoBA,OAAO,KASN,MAAM,OAAO,CAAC;AAef,OAAO,cAAc,CAAC;AACtB,OAAO,KAAK,EAGV,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAwEjB,QAAA,MAAM,iBAAiB,qGAoxCtB,CAAC;AAIF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"PipelineLogViewer.d.ts","sourceRoot":"","sources":["../../../src/PipelineLogViewer/PipelineLogViewer.tsx"],"names":[],"mappings":"AAoBA,OAAO,KASN,MAAM,OAAO,CAAC;AAiBf,OAAO,cAAc,CAAC;AACtB,OAAO,KAAK,EAGV,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAwEjB,QAAA,MAAM,iBAAiB,qGAkzCtB,CAAC;AAIF,eAAe,iBAAiB,CAAC"}

package/dist/esm/PipelineLogViewer/PipelineLogViewer.js

@@ -36,14 +36,14 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import React, { forwardRef, useCallback, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from 'react';
 import { Virtuoso } from 'react-virtuoso';
 import { GroupHeader, LogRow, SearchBar, StickyHeader } from "./components";
-import { BOUNDARY_PREFETCH_INDEX_MARGIN, DEFAULT_MAX_MEMORY_LINES, DEFAULT_PAGE_SIZE, DEFAULT_VIRTUOSO_ITEM_HEIGHT } from "./constants";
+import { BOUNDARY_PREFETCH_INDEX_MARGIN, DEFAULT_MAX_MEMORY_LINES, DEFAULT_PAGE_SIZE, DEFAULT_VIRTUOSO_ITEM_HEIGHT, IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL, IGNORE_BOUNDARY_FETCH_MS_FIRST_SCREEN } from "./constants";
 import useDisplayLogs from "./hooks/useDisplayLogs";
 import useGroupManager from "./hooks/useGroupManager";
 import useLogFetcher from "./hooks/useLogFetcher";
 import useLogSearch from "./hooks/useLogSearch";
 import useStickyHeader from "./hooks/useStickyHeader";
 import "./index.less";
-import { getGlobalVisibleLineNumberLabel } from "./utils/groupLineNumber";
+import { getPipelineGroupedLineNumberLabel } from "./utils/groupLineNumber";
 import normalizeGroupsForPipelineStatus from "./utils/normalizeGroupsForPipelineStatus";
 import { applyBoundaryScrollCompensation } from "./utils/virtuosoBoundaryScroll";
 import { firstVisibleIndexFromRenderedItems, lastVisibleIndexFromRenderedItems } from "./utils/virtuosoVisibleItems";
@@ -137,7 +137,9 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
     groupStatusIcons = _ref2.groupStatusIcons,
     onCollapsedChange = _ref2.onCollapsedChange,
     serverOffsetTime = _ref2.serverOffsetTime,
-    highlightOptions = _ref2.highlightOptions;
+    highlightOptions = _ref2.highlightOptions,
+    _ref2$showLogTime = _ref2.showLogTime,
+    showLogTime = _ref2$showLogTime === void 0 ? true : _ref2$showLogTime;
   // ===================================================================
   // 一、分组数据
   // ===================================================================
@@ -350,12 +352,13 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
   useEffect(function () {
     if (initializedRef.current) return;
     initializedRef.current = true;
+    ignoreBoundaryFetchRef.current = Date.now() + IGNORE_BOUNDARY_FETCH_MS_FIRST_SCREEN;
     Promise.all([fetchGroups().then(function (groupData) {
       if (groupData && groupData.length > 0) {
         setGroups(normalizeGroupsForPipelineStatus(groupData, status));
       }
     }), initLoadRef.current()]).then(function () {
-      ignoreBoundaryFetchRef.current = Date.now() + 500;
+      ignoreBoundaryFetchRef.current = Math.max(ignoreBoundaryFetchRef.current, Date.now() + IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL);
       requestAnimationFrame(function () {
         var _virtuosoRef$current;
         (_virtuosoRef$current = virtuosoRef.current) === null || _virtuosoRef$current === void 0 || _virtuosoRef$current.scrollToIndex({
@@ -389,7 +392,7 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
     boundaryFetchingRef.current = false;
     pendingScrollAfterPrevRef.current = null;
     pendingScrollAfterNextRef.current = null;
-    ignoreBoundaryFetchRef.current = Date.now() + 500;
+    ignoreBoundaryFetchRef.current = Date.now() + IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL;
   }, [fetchLogs, logFetcherResult.reset, groupManager.expandAll, logSearchResult.clearSearch, status]);
   /* eslint-enable react-hooks/exhaustive-deps */
 
@@ -555,7 +558,7 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
       var prepended = prependedCountFromPrevRef.current;
       pendingScrollAfterPrevRef.current = null;
       displayLogsLenBeforeLoadPrevRef.current = null;
-      ignoreBoundaryFetchRef.current = Date.now() + 500;
+      ignoreBoundaryFetchRef.current = Date.now() + IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL;
       if (boundaryIgnoreFollowUpTimeoutRef.current) {
         clearTimeout(boundaryIgnoreFollowUpTimeoutRef.current);
       }
@@ -577,26 +580,39 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
     }
     var anchorRowNext = pendingScrollAfterNextRef.current;
     if (anchorRowNext !== null) {
+      var _scrollerDomRef$curre3, _scrollerDomRef$curre4;
       var _lenBefore = displayLogsLenBeforeLoadNextRef.current;
       var _sameLength = _lenBefore !== null && _lenBefore === displayLogs.length && displayLogs.length > 0;
       var headRemoved = headRemovedFromNextRef.current;
       pendingScrollAfterNextRef.current = null;
       displayLogsLenBeforeLoadNextRef.current = null;
-      ignoreBoundaryFetchRef.current = Date.now() + 500;
-      var comp = applyBoundaryScrollCompensation(v, anchorRowNext, displayLogs, {
+
+      // 极大缩短屏蔽窗口（原本500ms）：仅用 50ms 屏蔽当前帧由于 scrollTop 重置引起的乱序 rangeChanged。
+      // 不再长时间屏蔽，使得用户在快速下滚时 rangeChanged 依然灵敏，消除“触底发呆/卡顿”感。
+      ignoreBoundaryFetchRef.current = Date.now() + 50;
+
+      // 因为不再有漫长的屏蔽期，无需跟进定时器补偿，直接清理
+      if (boundaryIgnoreFollowUpTimeoutRef.current) {
+        clearTimeout(boundaryIgnoreFollowUpTimeoutRef.current);
+        boundaryIgnoreFollowUpTimeoutRef.current = null;
+      }
+
+      // 读取当前实时 scrollTop，而非请求前快照的 scrollTopBeforeLoadNextRef，
+      // 避免用户在 API 请求期间继续滚动导致补偿基准过时（跳屏）。
+      var realTimeScrollTop = (_scrollerDomRef$curre3 = (_scrollerDomRef$curre4 = scrollerDomRef.current) === null || _scrollerDomRef$curre4 === void 0 ? void 0 : _scrollerDomRef$curre4.scrollTop) !== null && _scrollerDomRef$curre3 !== void 0 ? _scrollerDomRef$curre3 : scrollTopBeforeLoadNextRef.current;
+      applyBoundaryScrollCompensation(v, anchorRowNext, displayLogs, {
         sameLength: _sameLength && headRemoved > 0,
         sameLengthPixelDeltaCount: headRemoved,
         scrollTopBefore: scrollTopBeforeLoadNextRef.current,
+        // 保留接口签名所需，但已被 currentScrollTop 覆盖作用
         defaultItemHeight: DEFAULT_VIRTUOSO_ITEM_HEIGHT,
-        mode: 'appendHeadSlice'
+        mode: 'appendHeadSlice',
+        currentScrollTop: realTimeScrollTop
       });
-      if (comp.kind === 'anchorMissing') {
-        v.scrollToIndex({
-          index: 'LAST',
-          align: 'end',
-          behavior: 'auto'
-        });
-      }
+
+      // 注意：这里不再添加 scrollIntoView 精修对齐。
+      // 实测在用户连续滚动滑轮/触摸板时，scrollIntoView 会强行接管视口，打断浏览器的滚动动量（momentum），
+      // 导致体感上每翻 5000 行截断时就会“硬卡一下”。仅做单纯的 scrollTop 像素增减，能保持滚动的平滑。
     }
   }, [displayLogs]);
 
@@ -740,7 +756,7 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
       if (groupActionRef.current) return;
       if (collapseAirdropActiveRef.current) return;
       if (userStoppedFollowingRef.current) return;
-      ignoreBoundaryFetchRef.current = Date.now() + 500;
+      ignoreBoundaryFetchRef.current = Date.now() + IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL;
       (_virtuosoRef$current4 = virtuosoRef.current) === null || _virtuosoRef$current4 === void 0 || _virtuosoRef$current4.scrollToIndex({
         index: 'LAST',
         align: 'end',
@@ -758,7 +774,7 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
   // ===================================================================
   var scheduleScrollToDisplayIndex = useCallback(function (displayIndex) {
     var align = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'center';
-    ignoreBoundaryFetchRef.current = Date.now() + 500;
+    ignoreBoundaryFetchRef.current = Date.now() + IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL;
     requestAnimationFrame(function () {
       var v = virtuosoRef.current;
       if (!v || displayLogsRef.current.length === 0) return;
@@ -916,7 +932,7 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
         if (newIndex !== -1) {
           var _virtuosoRef$current5;
           // 勿用更短的窗口覆盖分组操作已设置的较长忽略期
-          ignoreBoundaryFetchRef.current = Math.max(ignoreBoundaryFetchRef.current, Date.now() + 800);
+          ignoreBoundaryFetchRef.current = Math.max(ignoreBoundaryFetchRef.current, Date.now() + IGNORE_BOUNDARY_FETCH_MS_FIRST_SCREEN);
           (_virtuosoRef$current5 = virtuosoRef.current) === null || _virtuosoRef$current5 === void 0 || _virtuosoRef$current5.scrollToIndex({
             index: newIndex,
             align: 'start'
@@ -965,14 +981,20 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
       });
       if (group) {
         if (airdropExpandInFlightRef.current.has(name)) return;
-        suppressFollowForGroupAction();
-        if (group.status === 'running') {
-          // --- Running 分组：展开后跳到最新日志并恢复跟随 ---
+
+        /**
+         * 运行中、失败的分组从收起展开：始终 initLoad（倒序最后一页 = 当前最新日志窗口），
+         * 再展开并滚到底，避免仍停留在历史缓冲而看不到尾部输出。
+         * 此处不置 userStoppedFollowing / isUserBrowsingHistory，以便置底后继续 followOutput。
+         */
+        if (group.status === 'running' || group.status === 'failure') {
+          collapseAirdropActiveRef.current = false;
+          suppressFollowForGroupAction();
           airdropExpandInFlightRef.current.add(name);
           setLoadingGroupNames(function (prev) {
             return prev.includes(name) ? prev : [].concat(_toConsumableArray(prev), [name]);
           });
-          var runExpandToLatest = /*#__PURE__*/function () {
+          var runRunningExpandToTail = /*#__PURE__*/function () {
             var _ref9 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
               return _regeneratorRuntime().wrap(function _callee5$(_context5) {
                 while (1) switch (_context5.prev = _context5.next) {
@@ -986,11 +1008,8 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
                       silent: true
                     });
                   case 5:
+                    ignoreBoundaryFetchRef.current = Math.max(ignoreBoundaryFetchRef.current, Date.now() + IGNORE_BOUNDARY_FETCH_MS_FIRST_SCREEN);
                     groupManager.toggleGroup(name);
-                    userStoppedFollowingRef.current = false;
-                    collapseAirdropActiveRef.current = false;
-                    logFetcherResult.setIsUserBrowsingHistory(false);
-                    ignoreBoundaryFetchRef.current = Date.now() + 500;
                     requestAnimationFrame(function () {
                       var _virtuosoRef$current6;
                       (_virtuosoRef$current6 = virtuosoRef.current) === null || _virtuosoRef$current6 === void 0 || _virtuosoRef$current6.scrollToIndex({
@@ -998,102 +1017,108 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
                         align: 'end',
                         behavior: 'auto'
                       });
+                      // 未走「停跟」分支时仍可能带着此前的查阅历史态，置底后显式恢复跟随
+                      userStoppedFollowingRef.current = false;
+                      logFetcherResult.setIsUserBrowsingHistory(false);
                     });
-                  case 11:
-                    _context5.prev = 11;
+                    _context5.next = 13;
+                    break;
+                  case 10:
+                    _context5.prev = 10;
+                    _context5.t0 = _context5["catch"](0);
+                    console.error('[PipelineLogViewer] running group expand to tail failed:', _context5.t0);
+                  case 13:
+                    _context5.prev = 13;
                     airdropExpandInFlightRef.current.delete(name);
                     setLoadingGroupNames(function (prev) {
                       return prev.filter(function (n) {
                         return n !== name;
                       });
                     });
-                    return _context5.finish(11);
-                  case 15:
+                    return _context5.finish(13);
+                  case 17:
                   case "end":
                     return _context5.stop();
                 }
-              }, _callee5, null, [[0,, 11, 15]]);
+              }, _callee5, null, [[0, 10, 13, 17]]);
             }));
-            return function runExpandToLatest() {
+            return function runRunningExpandToTail() {
               return _ref9.apply(this, arguments);
             };
           }();
-          runExpandToLatest();
-        } else {
-          var _group$end2;
-          // --- 非 running 分组：展开后跳到分组最后一行 ---
-          var groupEnd = (_group$end2 = group.end) !== null && _group$end2 !== void 0 ? _group$end2 : group.start;
-          var _logFetcherResult$cur3 = logFetcherResult.cursor,
-            bufStart = _logFetcherResult$cur3.currentStartRow,
-            bufEnd = _logFetcherResult$cur3.currentEndRow;
-          var groupEndInBuffer = bufStart <= groupEnd && groupEnd <= bufEnd;
-          userStoppedFollowingRef.current = true;
-          logFetcherResult.setIsUserBrowsingHistory(true);
-          if (!groupEndInBuffer) {
-            airdropExpandInFlightRef.current.add(name);
-            setLoadingGroupNames(function (prev) {
-              return prev.includes(name) ? prev : [].concat(_toConsumableArray(prev), [name]);
-            });
-            var runAirdropThenExpand = /*#__PURE__*/function () {
-              var _ref10 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
-                var ok;
-                return _regeneratorRuntime().wrap(function _callee6$(_context6) {
-                  while (1) switch (_context6.prev = _context6.next) {
-                    case 0:
-                      _context6.prev = 0;
-                      _context6.next = 3;
-                      return waitForFetchUnlock();
-                    case 3:
-                      _context6.next = 5;
-                      return logFetcherResult.airdropLoad(groupEnd, {
-                        window: 'center',
-                        silent: true
-                      });
-                    case 5:
-                      ok = _context6.sent;
-                      if (ok) {
-                        groupManager.toggleGroup(name);
-                        pendingScrollAlignRef.current = 'center';
-                        pendingScrollRowRef.current = groupEnd;
-                      }
-                    case 7:
-                      _context6.prev = 7;
-                      airdropExpandInFlightRef.current.delete(name);
-                      setLoadingGroupNames(function (prev) {
-                        return prev.filter(function (n) {
-                          return n !== name;
+          runRunningExpandToTail();
+          return;
+        }
+        suppressFollowForGroupAction();
+        userStoppedFollowingRef.current = true;
+        logFetcherResult.setIsUserBrowsingHistory(true);
+        var _logFetcherResult$cur3 = logFetcherResult.cursor,
+          bufStart = _logFetcherResult$cur3.currentStartRow,
+          bufEnd = _logFetcherResult$cur3.currentEndRow;
+        // 当前内存窗口是否已包含 group.start（重复展开同一分组时不重复空降）
+        var groupStartInBuffer = bufStart <= group.start && group.start <= bufEnd;
+        if (!groupStartInBuffer) {
+          airdropExpandInFlightRef.current.add(name);
+          setLoadingGroupNames(function (prev) {
+            return prev.includes(name) ? prev : [].concat(_toConsumableArray(prev), [name]);
+          });
+          var runAirdropThenExpand = /*#__PURE__*/function () {
+            var _ref10 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
+              var ok;
+              return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+                while (1) switch (_context6.prev = _context6.next) {
+                  case 0:
+                    _context6.prev = 0;
+                    _context6.next = 3;
+                    return logFetcherResult.airdropLoad(group.start, {
+                      window: 'fromStart',
+                      silent: true
+                    });
+                  case 3:
+                    ok = _context6.sent;
+                    if (!ok) {
+                      _context6.next = 7;
+                      break;
+                    }
+                    _context6.next = 7;
+                    return new Promise(function (resolve) {
+                      requestAnimationFrame(function () {
+                        requestAnimationFrame(function () {
+                          maintainScrollPosition(function () {
+                            groupManager.toggleGroup(name);
+                          });
+                          resolve();
                         });
                       });
-                      return _context6.finish(7);
-                    case 11:
-                    case "end":
-                      return _context6.stop();
-                  }
-                }, _callee6, null, [[0,, 7, 11]]);
-              }));
-              return function runAirdropThenExpand() {
-                return _ref10.apply(this, arguments);
-              };
-            }();
-            runAirdropThenExpand();
-          } else {
+                    });
+                  case 7:
+                    _context6.prev = 7;
+                    airdropExpandInFlightRef.current.delete(name);
+                    setLoadingGroupNames(function (prev) {
+                      return prev.filter(function (n) {
+                        return n !== name;
+                      });
+                    });
+                    return _context6.finish(7);
+                  case 11:
+                  case "end":
+                    return _context6.stop();
+                }
+              }, _callee6, null, [[0,, 7, 11]]);
+            }));
+            return function runAirdropThenExpand() {
+              return _ref10.apply(this, arguments);
+            };
+          }();
+          runAirdropThenExpand().catch(function (err) {
+            console.error('[PipelineLogViewer] airdrop expand failed:', err);
+          });
+        } else {
+          // 缓冲内展开：用当前视口锚点重定位，避免原先 scrollToIndex(group.start) 把起点硬拉到顶，
+          // running 等大分组展开时整屏上跳；与折叠分支一致走 maintainScrollPosition。
+          maintainScrollPosition(function () {
             groupManager.toggleGroup(name);
-            ignoreBoundaryFetchRef.current = Date.now() + 500;
-            requestAnimationFrame(function () {
-              var currentLogs = displayLogsRef.current;
-              var displayIndex = currentLogs.findIndex(function (l) {
-                return l.absoluteRow === groupEnd;
-              });
-              if (displayIndex >= 0) {
-                var _virtuosoRef$current7;
-                (_virtuosoRef$current7 = virtuosoRef.current) === null || _virtuosoRef$current7 === void 0 || _virtuosoRef$current7.scrollToIndex({
-                  index: displayIndex,
-                  align: 'center',
-                  behavior: 'auto'
-                });
-              }
-            });
-          }
+          });
         }
         return;
       }
@@ -1143,27 +1168,7 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
     return map;
   }, [groups]);
 
-  /** START/END 控制行绝对行号集合（用于行号体系扣减，不参与分组边界判断） */
-  var controlMarkerRows = useMemo(function () {
-    var set = new Set();
-    var _iterator2 = _createForOfIteratorHelper(displayLogs),
-      _step2;
-    try {
-      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-        var line = _step2.value;
-        if (isPipelineEndMarkerText(line.text) || isPipelineStartMarkerText(line.text)) {
-          set.add(line.absoluteRow);
-        }
-      }
-    } catch (err) {
-      _iterator2.e(err);
-    } finally {
-      _iterator2.f();
-    }
-    return set;
-  }, [displayLogs]);
-
-  /** 整条流水线日志起算绝对行号（用于全局连续行号） */
+  /** 整条流水线日志起算绝对行号（早于该行的缓冲内容行号展示回退） */
   var pipelineMinAbsoluteRow = useMemo(function () {
     return groups.length > 0 ? Math.min.apply(Math, _toConsumableArray(groups.map(function (g) {
       return g.start;
@@ -1181,8 +1186,6 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
   handleToggleGroupRef.current = handleToggleGroup;
   var lineNumberWidthRef = useRef(lineNumberWidth);
   lineNumberWidthRef.current = lineNumberWidth;
-  var controlMarkerRowsRef = useRef(controlMarkerRows);
-  controlMarkerRowsRef.current = controlMarkerRows;
   var pipelineMinAbsoluteRowRef = useRef(pipelineMinAbsoluteRow);
   pipelineMinAbsoluteRowRef.current = pipelineMinAbsoluteRow;
 
@@ -1198,7 +1201,7 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
     return {};
   },
   // eslint-disable-next-line react-hooks/exhaustive-deps
-  [groupManager.collapsedGroups, logSearchResult.searchState, lineNumberWidth, currentStartRow, highlightOptions, groups, loadingGroupNames]);
+  [groupManager.collapsedGroups, logSearchResult.searchState, lineNumberWidth, currentStartRow, highlightOptions, groups, loadingGroupNames, showLogTime]);
   var itemContent = useCallback(function (index) {
     var _groupsForHeader;
     var currentDisplayLogs = displayLogsRef.current;
@@ -1236,14 +1239,20 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
     var showLogRow = !line.isFoldedGroupStart && !line.isEmptyGroupStart;
     var isControlEndMarker = isPipelineEndMarkerText(line.text);
     var isControlStartMarker = isPipelineStartMarkerText(line.text);
-    /** 仅压扁 START/END 控制行；行号体系也仅基于控制行扣减 */
+    /** 仅压扁 START/END 控制行；行号规则见 getPipelineGroupedLineNumberLabel */
     var collapseGroupEdgeLog = showLogRow && !line.isEmptyGroupStart && (isControlEndMarker || isControlStartMarker);
-    var lineNumberLabel = groups.length > 0 && showLogRow ? getGlobalVisibleLineNumberLabel(line.absoluteRow, controlMarkerRowsRef.current, pipelineMinAbsoluteRowRef.current) : undefined;
+    var rowGroup = currentGroupManager.getGroupByRow(line.absoluteRow);
+    var rowGroupIndex = rowGroup ? groups.findIndex(function (g) {
+      return g.name === rowGroup.name;
+    }) : -1;
+    var isControlMarkerRow = showLogRow && !line.isEmptyGroupStart && (isControlEndMarker || isControlStartMarker);
+    var lineNumberLabel = groups.length > 0 && showLogRow ? getPipelineGroupedLineNumberLabel(line.absoluteRow, rowGroup, rowGroupIndex, isControlMarkerRow, pipelineMinAbsoluteRowRef.current) : undefined;
     var logRow = /*#__PURE__*/React.createElement(LogRow, {
       absoluteRow: line.absoluteRow,
       lineNumberLabel: lineNumberLabel,
       text: line.text,
       logTime: line.logTime,
+      showLogTime: showLogTime,
       isMatched: isMatched,
       isActiveMatch: isActiveMatch,
       lineNumberWidth: lineNumberWidthRef.current,
@@ -1291,7 +1300,7 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
                 }))) : 0;
                 bufStart = logFetcherResult.cursor.currentStartRow;
                 needsTopWindow = bufStart > globalFirstRow;
-                ignoreBoundaryFetchRef.current = Date.now() + 500;
+                ignoreBoundaryFetchRef.current = Date.now() + IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL;
                 if (!needsTopWindow) {
                   _context7.next = 21;
                   break;
@@ -1321,8 +1330,8 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
                 return _context7.abrupt("return");
               case 21:
                 requestAnimationFrame(function () {
-                  var _virtuosoRef$current8;
-                  (_virtuosoRef$current8 = virtuosoRef.current) === null || _virtuosoRef$current8 === void 0 || _virtuosoRef$current8.scrollToIndex({
+                  var _virtuosoRef$current7;
+                  (_virtuosoRef$current7 = virtuosoRef.current) === null || _virtuosoRef$current7 === void 0 || _virtuosoRef$current7.scrollToIndex({
                     index: 0,
                     align: 'start',
                     behavior: 'auto'
@@ -1345,30 +1354,33 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
           return _regeneratorRuntime().wrap(function _callee8$(_context8) {
             while (1) switch (_context8.prev = _context8.next) {
               case 0:
+                _context8.next = 2;
+                return waitForFetchUnlock();
+              case 2:
                 groupManager.expandAll();
                 userStoppedFollowingRef.current = false;
                 collapseAirdropActiveRef.current = false;
                 needsFetch = status !== 'running' && !logFetcherResult.boundaryLock.isLastPage || status === 'running' && logFetcherResult.isUserBrowsingHistory;
                 if (!needsFetch) {
-                  _context8.next = 8;
+                  _context8.next = 10;
                   break;
                 }
-                _context8.next = 7;
+                _context8.next = 9;
                 return logFetcherResult.initLoad();
-              case 7:
+              case 9:
                 logFetcherResult.updateBoundaryLock({
                   isFirstPage: false
                 });
-              case 8:
-                ignoreBoundaryFetchRef.current = Date.now() + 500;
+              case 10:
+                ignoreBoundaryFetchRef.current = Date.now() + IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL;
                 setTimeout(function () {
-                  var _virtuosoRef$current9;
-                  (_virtuosoRef$current9 = virtuosoRef.current) === null || _virtuosoRef$current9 === void 0 || _virtuosoRef$current9.scrollToIndex({
+                  var _virtuosoRef$current8;
+                  (_virtuosoRef$current8 = virtuosoRef.current) === null || _virtuosoRef$current8 === void 0 || _virtuosoRef$current8.scrollToIndex({
                     index: 'LAST',
                     align: 'end'
                   });
                 }, 50);
-              case 10:
+              case 12:
               case "end":
                 return _context8.stop();
             }
@@ -1425,7 +1437,7 @@ var PipelineLogViewer = /*#__PURE__*/forwardRef(function (_ref2, ref) {
     group: stickyHeader.stickyGroup,
     collapsed: stickyHeader.stickyGroup ? groupManager.collapsedGroups.has(stickyHeader.stickyGroup.name) : false,
     loading: stickyHeader.stickyGroup != null && loadingGroupNames.includes(stickyHeader.stickyGroup.name),
-    onToggle: handleToggleGroup,
+    onToggle: handleToggleGroupRef.current,
     groupStatusIcons: groupStatusIcons,
     serverOffsetTime: serverOffsetTime
   }), /*#__PURE__*/React.createElement(Virtuoso, {

package/dist/esm/PipelineLogViewer/components/LogRow.d.ts

@@ -17,6 +17,8 @@ interface LogRowProps {
     lineNumberWidth: number;
     /** 是否显示行号 */
     showLineNumber?: boolean;
+    /** 是否显示日志时间列（默认 true） */
+    showLogTime?: boolean;
     /** 关键字规则高亮；搜索命中时不会应用 */
     highlightOptions?: IHighlightOptions[];
     /** 当前搜索关键字（非空且本行命中时在 HTML 内包裹 mark，仅高亮关键字） */

package/dist/esm/PipelineLogViewer/components/LogRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LogRow.d.ts","sourceRoot":"","sources":["../../../../src/PipelineLogViewer/components/LogRow.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AA4BlD,UAAU,WAAW;IACnB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACvC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;;AAiED,wBAAkC"}
+{"version":3,"file":"LogRow.d.ts","sourceRoot":"","sources":["../../../../src/PipelineLogViewer/components/LogRow.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AA4BlD,UAAU,WAAW;IACnB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACvC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;;AAkED,wBAAkC"}

package/dist/esm/PipelineLogViewer/components/LogRow.js

@@ -40,6 +40,8 @@ var LogRow = function LogRow(_ref) {
     lineNumberWidth = _ref.lineNumberWidth,
     _ref$showLineNumber = _ref.showLineNumber,
     showLineNumber = _ref$showLineNumber === void 0 ? true : _ref$showLineNumber,
+    _ref$showLogTime = _ref.showLogTime,
+    showLogTime = _ref$showLogTime === void 0 ? true : _ref$showLogTime,
     highlightOptions = _ref.highlightOptions,
     _ref$searchKeyword = _ref.searchKeyword,
     searchKeyword = _ref$searchKeyword === void 0 ? '' : _ref$searchKeyword;
@@ -69,7 +71,7 @@ var LogRow = function LogRow(_ref) {
     style: {
       minWidth: "".concat(lineNumberWidth, "px")
     }
-  }, lineNumberLabel === null ? '' : lineNumberLabel !== null && lineNumberLabel !== void 0 ? lineNumberLabel : absoluteRow), logTime != null && logTime > 0 && /*#__PURE__*/React.createElement("span", {
+  }, lineNumberLabel === null ? '' : lineNumberLabel !== null && lineNumberLabel !== void 0 ? lineNumberLabel : absoluteRow), showLogTime && logTime != null && logTime > 0 && /*#__PURE__*/React.createElement("span", {
     className: "pipeline-log-row__log-time"
   }, formatLogTime(logTime)), /*#__PURE__*/React.createElement("span", {
     className: "pipeline-log-row__text",

package/dist/esm/PipelineLogViewer/constants.d.ts

@@ -10,6 +10,16 @@ export declare const DEFAULT_VIRTUOSO_ITEM_HEIGHT = 20;
  * 而不是用户刚看到的行（如 7571 在顶时 startIndex 可能已是 21，却满足不了 <=10）。
  */
 export declare const BOUNDARY_PREFETCH_INDEX_MARGIN = 400;
+/**
+ * 首屏 init / 新日志源首包：屏蔽 rangeChanged 边界预取时长 (ms)。
+ * 略长于普通窗口，避免弹窗首帧、scrollToIndex(LAST) 前误判触顶触发 loadPrev。
+ */
+export declare const IGNORE_BOUNDARY_FETCH_MS_FIRST_SCREEN = 800;
+/**
+ * 程序化滚动、loadPrev/loadNext 补偿、scrollToTop/Bottom 等之后：
+ * 屏蔽 rangeChanged 边界预取时长 (ms)。
+ */
+export declare const IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL = 500;
 /** running 态轮询间隔 (默认值，单位 ms) */
 export declare const DEFAULT_POLL_INTERVAL = 1000;
 /** running→结束态：收尾 initLoad 之后追加 loadNext 的次数 */

package/dist/esm/PipelineLogViewer/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/PipelineLogViewer/constants.ts"],"names":[],"mappings":"AAKA,mBAAmB;AACnB,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,qBAAqB;AACrB,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,gCAAgC;AAChC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,gDAAgD;AAChD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,iCAAiC;AACjC,eAAO,MAAM,mCAAmC,OAAO,CAAC;AAExD,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD,oBAAoB;AACpB,eAAO,MAAM,wBAAwB,gBAAgB,CAAC;AAEtD,cAAc;AACd,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,cAAc;AACd,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,oBAAoB;AACpB,eAAO,MAAM,mBAAmB,YAAY,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/PipelineLogViewer/constants.ts"],"names":[],"mappings":"AAKA,mBAAmB;AACnB,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,qBAAqB;AACrB,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,qCAAqC,MAAM,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,qCAAqC,MAAM,CAAC;AAEzD,gCAAgC;AAChC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,gDAAgD;AAChD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,iCAAiC;AACjC,eAAO,MAAM,mCAAmC,OAAO,CAAC;AAExD,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD,oBAAoB;AACpB,eAAO,MAAM,wBAAwB,gBAAgB,CAAC;AAEtD,cAAc;AACd,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,cAAc;AACd,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,oBAAoB;AACpB,eAAO,MAAM,mBAAmB,YAAY,CAAC"}

package/dist/esm/PipelineLogViewer/constants.js

@@ -19,6 +19,18 @@ export var DEFAULT_VIRTUOSO_ITEM_HEIGHT = 20;
  */
 export var BOUNDARY_PREFETCH_INDEX_MARGIN = 400;
 
+/**
+ * 首屏 init / 新日志源首包：屏蔽 rangeChanged 边界预取时长 (ms)。
+ * 略长于普通窗口，避免弹窗首帧、scrollToIndex(LAST) 前误判触顶触发 loadPrev。
+ */
+export var IGNORE_BOUNDARY_FETCH_MS_FIRST_SCREEN = 800;
+
+/**
+ * 程序化滚动、loadPrev/loadNext 补偿、scrollToTop/Bottom 等之后：
+ * 屏蔽 rangeChanged 边界预取时长 (ms)。
+ */
+export var IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL = 500;
+
 /** running 态轮询间隔 (默认值，单位 ms) */
 export var DEFAULT_POLL_INTERVAL = 1000;
 

package/dist/esm/PipelineLogViewer/hooks/useStickyHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useStickyHeader.d.ts","sourceRoot":"","sources":["../../../../src/PipelineLogViewer/hooks/useStickyHeader.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,UAAU,sBAAsB;IAC9B,WAAW;IACX,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,UAAU,qBAAqB;IAC7B,0CAA0C;IAC1C,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AAqCD;;GAEG;AACH,iBAAS,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CA0B/E;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"useStickyHeader.d.ts","sourceRoot":"","sources":["../../../../src/PipelineLogViewer/hooks/useStickyHeader.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,UAAU,sBAAsB;IAC9B,WAAW;IACX,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,UAAU,qBAAqB;IAC7B,0CAA0C;IAC1C,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AA6CD;;GAEG;AACH,iBAAS,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAsC/E;AAED,eAAe,eAAe,CAAC"}

package/dist/esm/PipelineLogViewer/hooks/useStickyHeader.js

@@ -15,6 +15,14 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 // ============================================================================
 
 import { useCallback, useEffect, useState } from 'react';
+/** 提前探测行数：让吸顶分组在边界前更早感知切换趋势 */
+var STICKY_LEAD_ROWS = 2;
+/**
+ * 新分组头仍在视口可见区时，暂不渲染吸顶，避免出现「吸顶头 + 列表头」双头重影。
+ * 该窗口用绝对行号近似：Top 仍落在 group.start 附近时，优先显示列表内真实头。
+ */
+var STICKY_SUPPRESS_ROWS_NEAR_GROUP_START = 1;
+
 /** 与 useDisplayLogs 折叠区间算法一致的有效上界（用于判断行是否落在该组） */
 function effectiveGroupEnd(group, gi, groups, bufferEnd) {
   var start = group.start,
@@ -68,7 +76,19 @@ function useStickyHeader(options) {
       setStickyGroup(null);
       return;
     }
-    setStickyGroup(findStickyGroup(groups, absoluteTopRow, bufferEnd));
+    var stickyProbeRow = Math.max(0, absoluteTopRow + STICKY_LEAD_ROWS);
+    var nextStickyGroup = findStickyGroup(groups, stickyProbeRow, bufferEnd);
+    if (!nextStickyGroup) {
+      setStickyGroup(null);
+      return;
+    }
+    // 边界抑制：提前命中新分组时，其真实 GroupHeader 常仍在视口内，
+    // 这时渲染吸顶会出现双头。让列表内头部先过顶，再接管吸顶展示。
+    if (absoluteTopRow <= nextStickyGroup.start + STICKY_SUPPRESS_ROWS_NEAR_GROUP_START) {
+      setStickyGroup(null);
+      return;
+    }
+    setStickyGroup(nextStickyGroup);
   }, [groups]);
   return {
     stickyGroup: stickyGroup,

package/dist/esm/PipelineLogViewer/index.less

@@ -232,7 +232,7 @@ input.pipeline-log-search-bar__input {
 
 .pipeline-log-search-bar__dirty-hint,
 .pipeline-log-search-bar__nav-hint {
-  margin-right: 4px;
+  margin: 0 4px;
   color: #959da5bf;
   font-size: 11px;
   line-height: 1.2;
@@ -335,7 +335,7 @@ input.pipeline-log-search-bar__input {
 }
 
 .pipeline-log-search-bar__result-count {
-  margin-right: 4px;
+  margin: 0 4px;
   font-size: 12px;
 }
 

package/dist/esm/PipelineLogViewer/types.d.ts

@@ -92,6 +92,10 @@ export interface PipelineLogViewerProps {
     highlightOptions?: IHighlightOptions[];
     /** 服务器当前时间 (ms) 与本地 Date.now() 的偏移时间差 */
     serverOffsetTime?: number;
+    /**
+     * 是否展示每行日志时间列；默认 true。
+     */
+    showLogTime?: boolean;
 }
 /** 日志游标状态 —— 标识内存中日志块的物理边界 */
 export interface LogCursor {

package/dist/esm/PipelineLogViewer/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/PipelineLogViewer/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/PipelineLogViewer/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/PipelineLogViewer/utils/groupLineNumber.d.ts

@@ -1,11 +1,13 @@
+import type { GroupData } from '../types';
 /**
- * 全局连续行号（隐藏各分组首尾边界行后，从 1 递增）。
+ * 流水线分组场景下的左侧行号。
  *
- * 对非边界行 R：序号 = 1 + |{ r | pipelineMinRow ≤ r < R 且 r 不在 edgeRows }|
- * 即：absoluteRow - pipelineMinRow - (落在 [pipelineMinRow, absoluteRow) 内的边界行个数) + 1
+ * 规则（与产品约定一致）：
+ * - 每个分组在日志流中有 START / END 两行控制标识，各占一个绝对行号。
+ * - 第一个分组（groups[0]）：非控制行展示 **绝对行号** `absoluteRow`。
+ * - 第 n 个分组（n = groups 下标，且 n ≥ 1）：非控制行展示 `absoluteRow - (2n)`， 不是 2n -1 是因为第一个分组第1行才是有效日志，把整体行号往前推了1。
+ * - START/END 控制行：左侧不展示数字（返回 null）。
  *
- * pipelineMinRow 取各分组 start 的最小值，作为整条流水日志的起算行。
- *
- * @returns null 表示当前行为分组首尾占位行，左侧不展示数字；undefined 表示早于流水线起点，沿用绝对行号
+ * @returns null = 控制行不占位数字；undefined = 无法归类或早于 pipeline 起点，由 LogRow 回退为 absoluteRow
  */
-export declare function getGlobalVisibleLineNumberLabel(absoluteRow: number, edgeRows: Set<number>, pipelineMinRow: number): number | null | undefined;
+export declare function getPipelineGroupedLineNumberLabel(absoluteRow: number, group: GroupData | undefined, groupIndex: number, isControlMarkerRow: boolean, pipelineMinRow: number): number | null | undefined;

package/dist/esm/PipelineLogViewer/utils/groupLineNumber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"groupLineNumber.d.ts","sourceRoot":"","sources":["../../../../src/PipelineLogViewer/utils/groupLineNumber.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EACrB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,GAAG,SAAS,CAQ3B"}
+{"version":3,"file":"groupLineNumber.d.ts","sourceRoot":"","sources":["../../../../src/PipelineLogViewer/utils/groupLineNumber.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,OAAO,EAC3B,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,GAAG,SAAS,CAS3B"}

package/dist/esm/PipelineLogViewer/utils/groupLineNumber.js

@@ -1,34 +1,22 @@
-function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
-/* eslint-disable no-plusplus */
 /* eslint-disable import/prefer-default-export */
-/* eslint-disable no-restricted-syntax */
+
 /**
- * 全局连续行号（隐藏各分组首尾边界行后，从 1 递增）。
+ * 流水线分组场景下的左侧行号。
  *
- * 对非边界行 R：序号 = 1 + |{ r | pipelineMinRow ≤ r < R 且 r 不在 edgeRows }|
- * 即：absoluteRow - pipelineMinRow - (落在 [pipelineMinRow, absoluteRow) 内的边界行个数) + 1
+ * 规则（与产品约定一致）：
+ * - 每个分组在日志流中有 START / END 两行控制标识，各占一个绝对行号。
+ * - 第一个分组（groups[0]）：非控制行展示 **绝对行号** `absoluteRow`。
+ * - 第 n 个分组（n = groups 下标，且 n ≥ 1）：非控制行展示 `absoluteRow - (2n)`， 不是 2n -1 是因为第一个分组第1行才是有效日志，把整体行号往前推了1。
+ * - START/END 控制行：左侧不展示数字（返回 null）。
  *
- * pipelineMinRow 取各分组 start 的最小值，作为整条流水日志的起算行。
- *
- * @returns null 表示当前行为分组首尾占位行，左侧不展示数字；undefined 表示早于流水线起点，沿用绝对行号
+ * @returns null = 控制行不占位数字；undefined = 无法归类或早于 pipeline 起点，由 LogRow 回退为 absoluteRow
  */
-export function getGlobalVisibleLineNumberLabel(absoluteRow, edgeRows, pipelineMinRow) {
-  if (edgeRows.has(absoluteRow)) return null;
+export function getPipelineGroupedLineNumberLabel(absoluteRow, group, groupIndex, isControlMarkerRow, pipelineMinRow) {
+  if (isControlMarkerRow) return null;
   if (absoluteRow < pipelineMinRow) return undefined;
-  var edgeBefore = 0;
-  var _iterator = _createForOfIteratorHelper(edgeRows),
-    _step;
-  try {
-    for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      var e = _step.value;
-      if (e >= pipelineMinRow && e < absoluteRow) edgeBefore++;
-    }
-  } catch (err) {
-    _iterator.e(err);
-  } finally {
-    _iterator.f();
+  if (!group || groupIndex < 0) return undefined;
+  if (groupIndex === 0) {
+    return absoluteRow;
   }
-  return absoluteRow - pipelineMinRow - edgeBefore + 1;
+  return absoluteRow - 2 * groupIndex;
 }

package/dist/esm/PipelineLogViewer/utils/virtuosoBoundaryScroll.d.ts

@@ -8,7 +8,9 @@ export type BoundaryScrollResult = {
 };
 /**
  * 滑动窗口 totalCount 不变时，Virtuoso 不会自动补偿 scrollTop。
- * 用像素粗调 + scrollIntoView 对齐到锚点行（与 loadPrev/loadNext 对称）。
+ * - prepend 模式：像素粗调 + scrollIntoView 对齐到锚点行。
+ * - appendHeadSlice 模式：仅用当前实时 scrollTop 减去截断行的像素偏移量。
+ *   不做锚点行定位，避免用户在 API 请求期间继续滚动时被强行拉回旧位置（跳屏）。
  */
 export declare function applyBoundaryScrollCompensation(v: VirtuosoHandle, anchorRow: number, rowsWithAbsolute: Array<{
     absoluteRow: number;
@@ -19,4 +21,9 @@ export declare function applyBoundaryScrollCompensation(v: VirtuosoHandle, ancho
     scrollTopBefore: number;
     defaultItemHeight: number;
     mode: BoundaryScrollMode;
+    /**
+     * appendHeadSlice 专用：当前实时 scrollTop（从 scroller DOM 读取）。
+     * 优先于 scrollTopBefore 使用，避免请求期间用户继续滚动导致补偿基准过时。
+     */
+    currentScrollTop?: number;
 }): BoundaryScrollResult;

package/dist/esm/PipelineLogViewer/utils/virtuosoBoundaryScroll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtuosoBoundaryScroll.d.ts","sourceRoot":"","sources":["../../../../src/PipelineLogViewer/utils/virtuosoBoundaryScroll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,CAAC,EAAE,cAAc,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,EAC5D,OAAO,EAAE;IACP,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,kBAAkB,CAAC;CAC1B,GACA,oBAAoB,CAgCtB"}
+{"version":3,"file":"virtuosoBoundaryScroll.d.ts","sourceRoot":"","sources":["../../../../src/PipelineLogViewer/utils/virtuosoBoundaryScroll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAE9E;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,CAAC,EAAE,cAAc,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,EAC5D,OAAO,EAAE;IACP,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,kBAAkB,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,oBAAoB,CAyDtB"}

package/dist/esm/PipelineLogViewer/utils/virtuosoBoundaryScroll.js

@@ -2,9 +2,51 @@
 
 /**
  * 滑动窗口 totalCount 不变时，Virtuoso 不会自动补偿 scrollTop。
- * 用像素粗调 + scrollIntoView 对齐到锚点行（与 loadPrev/loadNext 对称）。
+ * - prepend 模式：像素粗调 + scrollIntoView 对齐到锚点行。
+ * - appendHeadSlice 模式：仅用当前实时 scrollTop 减去截断行的像素偏移量。
+ *   不做锚点行定位，避免用户在 API 请求期间继续滚动时被强行拉回旧位置（跳屏）。
  */
 export function applyBoundaryScrollCompensation(v, anchorRow, rowsWithAbsolute, options) {
+  var sameLength = options.sameLength,
+    sameLengthPixelDeltaCount = options.sameLengthPixelDeltaCount,
+    scrollTopBefore = options.scrollTopBefore,
+    defaultItemHeight = options.defaultItemHeight,
+    mode = options.mode;
+
+  // -----------------------------------------------------------------------
+  // appendHeadSlice（loadNext 满载截断头部）：
+  // 仅做像素偏移补偿，不做锚点行定位。
+  //
+  // 原理：head 截断 N 行后，所有 item 的 index 减小了 N，
+  // 视觉上内容整体上移了 N * itemHeight 像素。
+  // 要保持用户看到的内容不变，scrollTop 需减去同样的像素量。
+  //
+  // 使用 currentScrollTop（实时值）而非 scrollTopBefore（请求前快照），
+  // 解决用户在 API 请求期间继续滚动导致的跳屏问题。
+  // -----------------------------------------------------------------------
+  if (mode === 'appendHeadSlice') {
+    if (sameLength && sameLengthPixelDeltaCount > 0) {
+      var _options$currentScrol;
+      var baseScrollTop = (_options$currentScrol = options.currentScrollTop) !== null && _options$currentScrol !== void 0 ? _options$currentScrol : scrollTopBefore;
+      var delta = -sameLengthPixelDeltaCount * defaultItemHeight;
+      var top = Math.max(0, baseScrollTop + delta);
+      v.scrollTo({
+        top: top,
+        behavior: 'auto'
+      });
+    }
+    // 不管有没有像素补偿，都不再用锚点行做 scrollIntoView，
+    // 避免强行拉回旧位置。
+    return {
+      kind: 'ok'
+    };
+  }
+
+  // -----------------------------------------------------------------------
+  // prepend（loadPrev 满载截断尾部）：
+  // 像素粗调 + scrollIntoView 锚点行精确对齐。
+  // prepend 场景下用户通常在最顶部等待加载，scrollTopBefore 不会过时。
+  // -----------------------------------------------------------------------
   var newIndex = rowsWithAbsolute.findIndex(function (l) {
     return l && l.absoluteRow === anchorRow;
   });
@@ -13,22 +55,17 @@ export function applyBoundaryScrollCompensation(v, anchorRow, rowsWithAbsolute,
       kind: 'anchorMissing'
     };
   }
-  var sameLength = options.sameLength,
-    sameLengthPixelDeltaCount = options.sameLengthPixelDeltaCount,
-    scrollTopBefore = options.scrollTopBefore,
-    defaultItemHeight = options.defaultItemHeight,
-    mode = options.mode;
   if (sameLength && sameLengthPixelDeltaCount > 0) {
-    var delta = mode === 'prepend' ? sameLengthPixelDeltaCount * defaultItemHeight : -sameLengthPixelDeltaCount * defaultItemHeight;
-    var top = Math.max(0, scrollTopBefore + delta);
+    var _delta = sameLengthPixelDeltaCount * defaultItemHeight;
+    var _top = Math.max(0, scrollTopBefore + _delta);
     v.scrollTo({
-      top: top,
+      top: _top,
       behavior: 'auto'
     });
     requestAnimationFrame(function () {
       v.scrollIntoView({
         index: newIndex,
-        align: mode === 'prepend' ? 'start' : 'end',
+        align: 'start',
         behavior: 'auto'
       });
     });
@@ -38,7 +75,7 @@ export function applyBoundaryScrollCompensation(v, anchorRow, rowsWithAbsolute,
   }
   v.scrollToIndex({
     index: newIndex,
-    align: mode === 'prepend' ? 'start' : 'end',
+    align: 'start',
     behavior: 'auto'
   });
   return {

package/dist/worker/src/PipelineLogViewer/components/LogRow.d.ts

@@ -17,6 +17,8 @@ interface LogRowProps {
     lineNumberWidth: number;
     /** 是否显示行号 */
     showLineNumber?: boolean;
+    /** 是否显示日志时间列（默认 true） */
+    showLogTime?: boolean;
     /** 关键字规则高亮；搜索命中时不会应用 */
     highlightOptions?: IHighlightOptions[];
     /** 当前搜索关键字（非空且本行命中时在 HTML 内包裹 mark，仅高亮关键字） */

package/dist/worker/src/PipelineLogViewer/constants.d.ts

@@ -10,6 +10,16 @@ export declare const DEFAULT_VIRTUOSO_ITEM_HEIGHT = 20;
  * 而不是用户刚看到的行（如 7571 在顶时 startIndex 可能已是 21，却满足不了 <=10）。
  */
 export declare const BOUNDARY_PREFETCH_INDEX_MARGIN = 400;
+/**
+ * 首屏 init / 新日志源首包：屏蔽 rangeChanged 边界预取时长 (ms)。
+ * 略长于普通窗口，避免弹窗首帧、scrollToIndex(LAST) 前误判触顶触发 loadPrev。
+ */
+export declare const IGNORE_BOUNDARY_FETCH_MS_FIRST_SCREEN = 800;
+/**
+ * 程序化滚动、loadPrev/loadNext 补偿、scrollToTop/Bottom 等之后：
+ * 屏蔽 rangeChanged 边界预取时长 (ms)。
+ */
+export declare const IGNORE_BOUNDARY_FETCH_MS_AFTER_SCROLL = 500;
 /** running 态轮询间隔 (默认值，单位 ms) */
 export declare const DEFAULT_POLL_INTERVAL = 1000;
 /** running→结束态：收尾 initLoad 之后追加 loadNext 的次数 */

package/dist/worker/src/PipelineLogViewer/types.d.ts

@@ -92,6 +92,10 @@ export interface PipelineLogViewerProps {
     highlightOptions?: IHighlightOptions[];
     /** 服务器当前时间 (ms) 与本地 Date.now() 的偏移时间差 */
     serverOffsetTime?: number;
+    /**
+     * 是否展示每行日志时间列；默认 true。
+     */
+    showLogTime?: boolean;
 }
 /** 日志游标状态 —— 标识内存中日志块的物理边界 */
 export interface LogCursor {

package/dist/worker/src/PipelineLogViewer/utils/groupLineNumber.d.ts

@@ -1,11 +1,13 @@
+import type { GroupData } from '../types';
 /**
- * 全局连续行号（隐藏各分组首尾边界行后，从 1 递增）。
+ * 流水线分组场景下的左侧行号。
  *
- * 对非边界行 R：序号 = 1 + |{ r | pipelineMinRow ≤ r < R 且 r 不在 edgeRows }|
- * 即：absoluteRow - pipelineMinRow - (落在 [pipelineMinRow, absoluteRow) 内的边界行个数) + 1
+ * 规则（与产品约定一致）：
+ * - 每个分组在日志流中有 START / END 两行控制标识，各占一个绝对行号。
+ * - 第一个分组（groups[0]）：非控制行展示 **绝对行号** `absoluteRow`。
+ * - 第 n 个分组（n = groups 下标，且 n ≥ 1）：非控制行展示 `absoluteRow - (2n)`， 不是 2n -1 是因为第一个分组第1行才是有效日志，把整体行号往前推了1。
+ * - START/END 控制行：左侧不展示数字（返回 null）。
  *
- * pipelineMinRow 取各分组 start 的最小值，作为整条流水日志的起算行。
- *
- * @returns null 表示当前行为分组首尾占位行，左侧不展示数字；undefined 表示早于流水线起点，沿用绝对行号
+ * @returns null = 控制行不占位数字；undefined = 无法归类或早于 pipeline 起点，由 LogRow 回退为 absoluteRow
  */
-export declare function getGlobalVisibleLineNumberLabel(absoluteRow: number, edgeRows: Set<number>, pipelineMinRow: number): number | null | undefined;
+export declare function getPipelineGroupedLineNumberLabel(absoluteRow: number, group: GroupData | undefined, groupIndex: number, isControlMarkerRow: boolean, pipelineMinRow: number): number | null | undefined;

package/dist/worker/src/PipelineLogViewer/utils/virtuosoBoundaryScroll.d.ts

@@ -8,7 +8,9 @@ export type BoundaryScrollResult = {
 };
 /**
  * 滑动窗口 totalCount 不变时，Virtuoso 不会自动补偿 scrollTop。
- * 用像素粗调 + scrollIntoView 对齐到锚点行（与 loadPrev/loadNext 对称）。
+ * - prepend 模式：像素粗调 + scrollIntoView 对齐到锚点行。
+ * - appendHeadSlice 模式：仅用当前实时 scrollTop 减去截断行的像素偏移量。
+ *   不做锚点行定位，避免用户在 API 请求期间继续滚动时被强行拉回旧位置（跳屏）。
  */
 export declare function applyBoundaryScrollCompensation(v: VirtuosoHandle, anchorRow: number, rowsWithAbsolute: Array<{
     absoluteRow: number;
@@ -19,4 +21,9 @@ export declare function applyBoundaryScrollCompensation(v: VirtuosoHandle, ancho
     scrollTopBefore: number;
     defaultItemHeight: number;
     mode: BoundaryScrollMode;
+    /**
+     * appendHeadSlice 专用：当前实时 scrollTop（从 scroller DOM 读取）。
+     * 优先于 scrollTopBefore 使用，避免请求期间用户继续滚动导致补偿基准过时。
+     */
+    currentScrollTop?: number;
 }): BoundaryScrollResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-terminal-viewer-cicd",
-  "version": "3.0.0-beta.43",
+  "version": "3.0.0-beta.45",
   "author": "https://gitee.com/gitee-frontend",
   "license": "MIT",
   "keywords": [