@363045841yyt/klinechart-core 0.9.0-alpha.0 → 0.9.0-alpha.2

package/src/engine/state/interactionState.ts

@@ -27,77 +27,30 @@ export interface InteractionDeps {
   scheduleDraw: (level?: unknown) => void
 }
 
-function computeCrosshairIndex(
-  crosshairPos: { x: number; y: number } | null,
-  kLinePositions: number[] | null,
-  kWidthPx: number | null,
-  visibleRange: { start: number; end: number } | null,
-  scrollLeftLogical: number,
-  dpr: number,
-): number | null {
-  if (!crosshairPos || !kLinePositions || !kWidthPx || !visibleRange) return null
-  const kWidthLogical = kWidthPx / dpr
-  const worldX = scrollLeftLogical + crosshairPos.x
-  const positions = kLinePositions
-
-  let lo = 0
-  let hi = positions.length
-  while (lo < hi) {
-    const mid = (lo + hi) >> 1
-    if (positions[mid]! < worldX) lo = mid + 1
-    else hi = mid
-  }
-  let localIdx = lo
-  if (lo > 0 && lo < positions.length) {
-    const prevCenter = positions[lo - 1]! + kWidthLogical / 2
-    const currCenter = positions[lo]! + kWidthLogical / 2
-    if (Math.abs(worldX - prevCenter) < Math.abs(worldX - currCenter)) {
-      localIdx = lo - 1
-    }
-  } else if (lo === positions.length && positions.length > 0) {
-    localIdx = positions.length - 1
-  }
-  return localIdx + visibleRange.start
-}
-
-export function createInteractionState(deps: InteractionDeps) {
-  const { signals, readonly } = createSubState(
-    {
-      crosshairPos: null as { x: number; y: number } | null,
-      crosshairPrice: null as number | null,
-      hoveredIndex: null as number | null,
-      activePaneId: null as string | null,
-      isDragging: false,
-      dragMode: 'none' as DragMode,
-      hoveredSeparatorUpperPaneId: null as string | null,
-      hoveredRightAxisPaneId: null as string | null,
-      tooltipPos: { x: 0, y: 0 },
-      tooltipAnchorPlacement: 'right-bottom' as 'right-bottom' | 'left-bottom',
-      hoveredMarkerData: null as MarkerEntity | null,
-      hoveredCustomMarker: null as CustomMarkerEntity | null,
-      hoveredMarkerId: null as string | null,
-      kLinePositions: null as number[] | null,
-      kLineCenters: null as number[] | null,
-      kWidthPx: null as number | null,
-    },
-    {
-      crosshairIndex: (s) => {
-        if (!s.crosshairPos()) return null
-        return computeCrosshairIndex(
-          s.crosshairPos(),
-          s.kLinePositions(),
-          s.kWidthPx(),
-          deps.visibleRange$(),
-          deps.scrollLeftLogical$(),
-          deps.dpr$(),
-        )
-      },
-    },
-  )
+/**
+ * 交互业务态（kernel）。
+ * 帧几何 kLinePositions/centers/kWidth 不在此模块，由 InteractionController 私有持有。
+ */
+export function createInteractionState(_deps: InteractionDeps) {
+  const { signals, readonly } = createSubState({
+    crosshairPos: null as { x: number; y: number } | null,
+    crosshairPrice: null as number | null,
+    /** 由 controller 在 flush hover 时写入，不再从几何 signal 推导 */
+    crosshairIndex: null as number | null,
+    hoveredIndex: null as number | null,
+    activePaneId: null as string | null,
+    isDragging: false,
+    dragMode: 'none' as DragMode,
+    hoveredSeparatorUpperPaneId: null as string | null,
+    hoveredRightAxisPaneId: null as string | null,
+    tooltipPos: { x: 0, y: 0 },
+    tooltipAnchorPlacement: 'right-bottom' as 'right-bottom' | 'left-bottom',
+    hoveredMarkerData: null as MarkerEntity | null,
+    hoveredCustomMarker: null as CustomMarkerEntity | null,
+    hoveredMarkerId: null as string | null,
+  })
 
-  // ── 带引用缓存 + deps 收紧的 interactionSnapshot ──
-  // crosshairPos 为 null 时跳过 visibleRange$/scrollLeftLogical$ 读取，
-  // 避免滚动事件触发无十字线状态下的虚假重算
+  // ── 带引用缓存的 interactionSnapshot ──
   let _cachedSnapshot: InteractionSnapshot | null = null
   const cachedInteractionSnapshot = computed<InteractionSnapshot>(() => {
     const crosshairPos = readonly.crosshairPos()
@@ -106,20 +59,9 @@ export function createInteractionState(deps: InteractionDeps) {
     const hoveredSep = readonly.hoveredSeparatorUpperPaneId()
     const hoveredRight = readonly.hoveredRightAxisPaneId()
 
-    const crosshairIndex = crosshairPos
-      ? computeCrosshairIndex(
-          crosshairPos,
-          readonly.kLinePositions(),
-          readonly.kWidthPx(),
-          deps.visibleRange$(),
-          deps.scrollLeftLogical$(),
-          deps.dpr$(),
-        )
-      : null
-
     const next: InteractionSnapshot = {
       crosshairPos,
-      crosshairIndex,
+      crosshairIndex: readonly.crosshairIndex(),
       crosshairPrice: readonly.crosshairPrice(),
       hoveredIndex,
       activePaneId: readonly.activePaneId(),
@@ -168,13 +110,39 @@ export function createInteractionState(deps: InteractionDeps) {
     readonly: mergedReadonly,
 
     actions: {
-      updateCrosshair(pos: { x: number; y: number } | null, price: number | null) {
+      /**
+       * 更新十字线位置与价格。坐标结构相等时保留旧对象引用。
+       * @param index 可选；传入时同步写入 crosshairIndex（与几何同帧）
+       */
+      updateCrosshair(
+        pos: { x: number; y: number } | null,
+        price: number | null,
+        index?: number | null,
+      ) {
+        const prevPos = signals.crosshairPos.peek()
+        const prevPrice = signals.crosshairPrice.peek()
+        const prevIndex = signals.crosshairIndex.peek()
+        const nextIndex = index === undefined ? prevIndex : index
+        const posUnchanged =
+          prevPos === pos ||
+          (prevPos === null && pos === null) ||
+          (prevPos !== null &&
+            pos !== null &&
+            prevPos.x === pos.x &&
+            prevPos.y === pos.y)
+        if (posUnchanged && prevPrice === price && prevIndex === nextIndex) return
         batch(() => {
-          signals.crosshairPos.set(pos)
-          signals.crosshairPrice.set(price)
+          if (!posUnchanged) signals.crosshairPos.set(pos)
+          if (prevPrice !== price) signals.crosshairPrice.set(price)
+          if (prevIndex !== nextIndex) signals.crosshairIndex.set(nextIndex)
         })
       },
 
+      setCrosshairIndex(index: number | null) {
+        if (signals.crosshairIndex.peek() === index) return
+        signals.crosshairIndex.set(index)
+      },
+
       updateHover(index: number | null, paneId: string | null) {
         batch(() => {
           signals.hoveredIndex.set(index)
@@ -190,18 +158,6 @@ export function createInteractionState(deps: InteractionDeps) {
         signals.activePaneId.set(paneId)
       },
 
-      updateFramePositions(
-        positions: number[] | null,
-        centers: number[] | null,
-        kWidthPx: number | null,
-      ) {
-        batch(() => {
-          signals.kLinePositions.set(positions)
-          signals.kLineCenters.set(centers)
-          signals.kWidthPx.set(kWidthPx)
-        })
-      },
-
       startDrag(mode: DragMode) {
         batch(() => {
           signals.isDragging.set(true)
@@ -228,13 +184,29 @@ export function createInteractionState(deps: InteractionDeps) {
         signals.hoveredRightAxisPaneId.set(paneId)
       },
 
+      /**
+       * 更新 tooltip。位置与锚点均未变时跳过写入。
+       */
       updateTooltip(
         pos: { x: number; y: number },
         placement: 'right-bottom' | 'left-bottom',
       ) {
+        const prevPos = signals.tooltipPos.peek()
+        const prevPlacement = signals.tooltipAnchorPlacement.peek()
+        if (
+          prevPos.x === pos.x &&
+          prevPos.y === pos.y &&
+          prevPlacement === placement
+        ) {
+          return
+        }
         batch(() => {
-          signals.tooltipPos.set(pos)
-          signals.tooltipAnchorPlacement.set(placement)
+          if (prevPos.x !== pos.x || prevPos.y !== pos.y) {
+            signals.tooltipPos.set(pos)
+          }
+          if (prevPlacement !== placement) {
+            signals.tooltipAnchorPlacement.set(placement)
+          }
         })
       },
 
@@ -254,6 +226,7 @@ export function createInteractionState(deps: InteractionDeps) {
         batch(() => {
           signals.crosshairPos.set(null)
           signals.crosshairPrice.set(null)
+          signals.crosshairIndex.set(null)
           signals.hoveredIndex.set(null)
           signals.activePaneId.set(null)
           signals.isDragging.set(false)
@@ -273,6 +246,7 @@ export function createInteractionState(deps: InteractionDeps) {
       batch(() => {
         signals.crosshairPos.set(null)
         signals.crosshairPrice.set(null)
+        signals.crosshairIndex.set(null)
         signals.hoveredIndex.set(null)
         signals.activePaneId.set(null)
         signals.isDragging.set(false)
@@ -284,9 +258,6 @@ export function createInteractionState(deps: InteractionDeps) {
         signals.hoveredMarkerData.set(null)
         signals.hoveredCustomMarker.set(null)
         signals.hoveredMarkerId.set(null)
-        signals.kLinePositions.set(null)
-        signals.kLineCenters.set(null)
-        signals.kWidthPx.set(null)
       })
     },
   }

package/src/engine/state/rendererState.ts

@@ -0,0 +1,32 @@
+import type { RendererBackendRuntime } from '../../rendering/render/rendererHost'
+import { createSubState } from '../../foundation/reactivity/signal'
+
+function snapshot(runtime: RendererBackendRuntime): Readonly<RendererBackendRuntime> {
+  return Object.freeze({ ...runtime })
+}
+
+function equal(left: RendererBackendRuntime, right: RendererBackendRuntime): boolean {
+  return (
+    left.effective === right.effective && left.status === right.status && left.error === right.error
+  )
+}
+
+export function createRendererState(initial: RendererBackendRuntime) {
+  const initialSnapshot = snapshot(initial)
+  const { signals, readonly } = createSubState({ runtime: initialSnapshot })
+
+  return {
+    readonly,
+    actions: {
+      setRuntime(runtime: RendererBackendRuntime): void {
+        if (equal(signals.runtime.peek(), runtime)) return
+        signals.runtime.set(snapshot(runtime))
+      },
+    },
+    dispose(): void {
+      signals.runtime.set(initialSnapshot)
+    },
+  }
+}
+
+export type RendererStateModule = ReturnType<typeof createRendererState>

package/src/engine/state/themeState.ts

@@ -1,23 +1,30 @@
 import { createSubState } from '../../foundation/reactivity/signal'
 
-export function createThemeState() {
+/**
+ * 系统主题（OS / matchMedia）注入点。
+ * 用户偏好在 settings.theme（含 auto）；生效主题由 kernel effectiveTheme computed 推导。
+ */
+export function createSystemThemeState() {
   const { signals, readonly } = createSubState({
-    theme: 'light' as 'light' | 'dark',
+    systemTheme: 'light' as 'light' | 'dark',
   })
 
   return {
     readonly,
-
     actions: {
-      setTheme(theme: 'light' | 'dark') {
-        signals.theme.set(theme)
+      setSystemTheme(theme: 'light' | 'dark') {
+        if (signals.systemTheme.peek() === theme) return
+        signals.systemTheme.set(theme)
       },
     },
-
     dispose() {
-      signals.theme.set('light')
+      signals.systemTheme.set('light')
     },
   }
 }
 
-export type ThemeStateModule = ReturnType<typeof createThemeState>
+export type SystemThemeStateModule = ReturnType<typeof createSystemThemeState>
+
+/** @deprecated 使用 createSystemThemeState；偏好主题在 settingsState */
+export const createThemeState = createSystemThemeState
+export type ThemeStateModule = SystemThemeStateModule

package/src/engine/state/viewportState.ts

@@ -256,11 +256,14 @@ export function createViewportState(signalDeps: ViewportSignalDeps) {
   let webglEffect: (() => void) | null = null
   let scrollDomEffect: (() => void) | null = null
 
+  /**
+   * 写入请求 scrollLeft；与当前值相等时跳过，避免 pan 重复事件空通知。
+   */
   const setRequestedScrollLeft = (value: number): void => {
     const normalized = Number.isFinite(value) ? value : 0
-    batch(() => {
-      signals.requestedScrollLeft.set(Math.max(0, Math.min(normalized, maxScrollLeft.peek())))
-    })
+    const clamped = Math.max(0, Math.min(normalized, maxScrollLeft.peek()))
+    if (signals.requestedScrollLeft.peek() === clamped) return
+    signals.requestedScrollLeft.set(clamped)
   }
 
   const syncFromDomScroll = () => {

package/src/engine/subPaneManager.ts

@@ -4,7 +4,6 @@ import type {
   RendererPluginWithHost,
   RenderContext,
 } from '../foundation/plugin/index'
-import { createLayerFromPlugin } from '../rendering/scene/createLayerFromPlugin'
 import type { Layer } from '../rendering/scene/types'
 import type { IndicatorScheduler } from './indicators/scheduler'
 import { findIndicator } from './renderers/Indicator/indicatorCatalog'
@@ -192,11 +191,8 @@ export class SubPaneManager {
         definition,
         params: { ...entry.params },
       })
+      // useRenderer：注册表 + 唯一 Scene Layer
       ctx.useRenderer(renderer, { ...entry.params })
-      ctx.setRendererEnabled(entry.rendererName, false)
-      ctx.addLayer(
-        createLayerFromPlugin(renderer, () => ctx.getRenderContext(entry.paneId), entry.paneId),
-      )
     }
     this.mountScaleRenderer(ctx, entry)
   }
@@ -232,10 +228,6 @@ export class SubPaneManager {
         : null
     if (!plugin) return
     ctx.useRenderer(plugin)
-    ctx.setRendererEnabled(entry.scaleRendererName, false)
-    ctx.addLayer(
-      createLayerFromPlugin(plugin, () => ctx.getRenderContext(entry.paneId), entry.paneId),
-    )
   }
 
   private mountPaneTitleRenderer(ctx: SubPaneContext, entry: ProjectedSubPaneEntry): void {
@@ -254,10 +246,6 @@ export class SubPaneManager {
       params: { ...entry.params },
     })
     ctx.useRenderer(renderer)
-    ctx.setRendererEnabled(entry.paneTitleRendererName, false)
-    ctx.addLayer(
-      createLayerFromPlugin(renderer, () => ctx.getRenderContext(entry.paneId), entry.paneId),
-    )
   }
 
   private updateParams(ctx: SubPaneContext, resources: SubPaneResources, spec: SubPaneSpec): void {
@@ -271,13 +259,11 @@ export class SubPaneManager {
   }
 
   private unmount(ctx: SubPaneContext, entry: SubPaneResources, preserveTitle = false): void {
+    // removeRenderer 已同步卸 Scene Layer + Manager onUninstall，勿再 removeLayer
     ctx.removeRenderer(entry.rendererName)
     ctx.removeRenderer(entry.scaleRendererName)
-    ctx.removeLayer(entry.layerId)
-    ctx.removeLayer(entry.scaleLayerId)
     if (!preserveTitle) {
       ctx.removeRenderer(entry.paneTitleRendererName)
-      ctx.removeLayer(entry.paneTitleLayerId)
     }
   }
 

package/src/foundation/config/__tests__/chartSettings.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, it } from 'vitest'
+
+import { migrateStoredSettings, resolveSettings } from '../chartSettings'
+
+describe('chart renderer settings', () => {
+  it('defaults to WebGL', () => {
+    expect(resolveSettings().rendererBackend).toBe('webgl')
+  })
+
+  it('migrates the old WebGL toggle without retaining it', () => {
+    expect(migrateStoredSettings({ enableWebGLRendering: true, showGridLines: false })).toEqual({
+      rendererBackend: 'webgl',
+      showGridLines: false,
+    })
+    expect(migrateStoredSettings({ enableWebGLRendering: false })).toEqual({
+      rendererBackend: 'canvas',
+    })
+  })
+
+  it('prefers an existing rendererBackend during migration', () => {
+    expect(
+      migrateStoredSettings({ rendererBackend: 'webgpu', enableWebGLRendering: false }),
+    ).toEqual({ rendererBackend: 'webgpu' })
+  })
+})

package/src/foundation/config/chartSettings.ts

@@ -44,9 +44,6 @@ export function getDeviceType(): 'mobile' | 'tablet' | 'desktop' {
   return 'desktop'
 }
 
-/** 移动端（含平板）默认不开启 WebGL */
-const ENABLE_WEBGL_DEFAULT = getDeviceType() === 'desktop'
-
 /** 默认设置配置 */
 export const DEFAULT_SETTINGS = [
   { key: 'showGridLines', label: '显示网格', type: 'boolean', default: true, group: 'main' },
@@ -96,11 +93,16 @@ export const DEFAULT_SETTINGS = [
     group: 'style',
   },
   {
-    key: 'enableWebGLRendering',
-    label: '启用 WebGL 硬件加速渲染',
-    type: 'boolean',
-    default: ENABLE_WEBGL_DEFAULT,
+    key: 'rendererBackend',
+    label: '渲染后端',
+    type: 'select',
+    default: 'webgl',
     group: 'main',
+    options: [
+      { value: 'webgl', label: 'WebGL' },
+      { value: 'webgpu', label: 'WebGPU' },
+      { value: 'canvas', label: 'Canvas' },
+    ],
   },
   {
     key: 'theme',
@@ -171,6 +173,21 @@ export function resolveSettings(partial?: Partial<ChartSettings>): ChartSettings
   return result as ChartSettings
 }
 
+/** 将旧版持久设置迁移为 rendererBackend，返回结果不保留旧字段。 */
+export function migrateStoredSettings(stored: Record<string, unknown>): Partial<ChartSettings> {
+  const { enableWebGLRendering, rendererBackend, ...rest } = stored
+  const validBackend =
+    rendererBackend === 'webgpu' || rendererBackend === 'webgl' || rendererBackend === 'canvas'
+      ? rendererBackend
+      : typeof enableWebGLRendering === 'boolean'
+        ? enableWebGLRendering
+          ? 'webgl'
+          : 'canvas'
+        : undefined
+
+  return validBackend ? { ...rest, rendererBackend: validBackend } : rest
+}
+
 /** localStorage 存储键名 */
 export const SETTINGS_STORAGE_KEY = 'kline-chart-settings'
 import {

package/src/foundation/plugin/index.ts

@@ -16,4 +16,3 @@ export { ConfigManager } from './ConfigManager'
 
 // 渲染器插件
 export { RendererPluginManager } from './rendererPluginManager'
-export type { RendererErrorEvent } from './rendererPluginManager'

package/src/foundation/plugin/rendererPluginManager.ts

@@ -2,24 +2,13 @@
  * 渲染器插件管理器
  */
 
-import { UpdateLevel } from '../../engine/layout/pane'
-
 import type {
   RendererPlugin,
-  RenderContext,
   PaneInfo,
   RendererPluginWithHost,
   PluginHost,
 } from './types'
 
-/** 渲染器错误事件（裁剪后，不含大数据） */
-export interface RendererErrorEvent {
-  name: string
-  error: { message: string; stack?: string }
-  paneId: string
-  timestamp: number
-}
-
 /** 内部缓存 key（模块私有，避免与外部 paneId 冲突） */
 const GLOBAL_CACHE_KEY = Symbol('renderer:global-cache')
 
@@ -256,78 +245,6 @@ export class RendererPluginManager {
     return cached
   }
 
-  /** 获取指定 pane 的渲染器（已缓存，无穿透） */
-  getRenderers(paneId: string): RendererPlugin[] {
-    const cached = this.getMergedRenderers(paneId)
-
-    // 根据启用状态过滤，同时排除系统渲染器
-    return cached.filter((p) => {
-      // 系统渲染器不通过 getRenderers 返回，只能通过 renderPlugin 单独渲染
-      if (p.isSystem) return false
-      return this.isRendererEnabled(p)
-    })
-  }
-
-  /** 渲染指定 pane（带错误隔离，支持按 UpdateLevel 过滤） */
-  render(paneId: string, context: RenderContext, level?: UpdateLevel): RendererErrorEvent[] {
-    const renderers = this.getRenderers(paneId)
-    const errors: RendererErrorEvent[] = []
-
-    for (const renderer of renderers) {
-      // UpdateLevel 过滤：未传 level 或为 All 时不过滤
-      if (level) {
-        const rendererLayer = renderer.layer ?? 'main'
-        if (level === UpdateLevel.Overlay && rendererLayer !== 'overlay') {
-          continue // Overlay 更新时跳过非 overlay 渲染器
-        }
-        if (level === UpdateLevel.Main && rendererLayer === 'overlay') {
-          continue // Main 更新时跳过 overlay 渲染器
-        }
-      }
-
-      try {
-        renderer.draw(context)
-      } catch (e) {
-        const error = e instanceof Error ? e : new Error(String(e))
-        console.error(`[RendererPlugin] ${renderer.name} draw error:`, error)
-        // 裁剪错误事件，不含大数据
-        errors.push({
-          name: renderer.name,
-          error: { message: error.message, stack: error.stack },
-          paneId: context.pane.id,
-          timestamp: Date.now(),
-        })
-      }
-    }
-
-    return errors
-  }
-
-  /** 渲染指定名称的插件（带错误隔离，用于系统渲染器） */
-  renderPlugin(name: string, context: RenderContext): RendererErrorEvent[] {
-    const plugin = this.plugins.get(name)
-    if (!plugin) return []
-
-    // 检查启用状态
-    if (!this.isRendererEnabled(plugin)) return []
-
-    const errors: RendererErrorEvent[] = []
-    try {
-      plugin.draw(context)
-    } catch (e) {
-      const error = e instanceof Error ? e : new Error(String(e))
-      console.error(`[RendererPlugin] ${name} draw error:`, error)
-      errors.push({
-        name,
-        error: { message: error.message, stack: error.stack },
-        paneId: context.pane.id,
-        timestamp: Date.now(),
-      })
-    }
-
-    return errors
-  }
-
   /** 启用/禁用渲染器（修改独立状态，不影响原始插件对象） */
   setEnabled(name: string, enabled: boolean): void {
     if (!this.plugins.has(name)) return
@@ -355,22 +272,6 @@ export class RendererPluginManager {
     return this.plugins.get(name) as T | undefined
   }
 
-  /* 调用 onDataUpdate 钩子通知数据更新 */
-  notifyDataUpdate(data: unknown[], range: { start: number; end: number }): void {
-    for (const plugin of this.plugins.values()) {
-      if (!plugin.onDataUpdate) continue
-
-      // 检查启用状态，跳过禁用的插件
-      if (!this.isRendererEnabled(plugin)) continue
-
-      try {
-        plugin.onDataUpdate(data, range)
-      } catch (e) {
-        console.error(`[RendererPlugin] ${plugin.name} onDataUpdate error:`, e)
-      }
-    }
-  }
-
   /** 通知尺寸变化 */
   notifyResize(paneId: string, pane: PaneInfo): void {
     const renderers = this.getMergedRenderers(paneId).filter((renderer) =>

package/src/foundation/plugin/types.ts

@@ -2,10 +2,6 @@
  * 插件系统核心类型定义
  */
 
-import type {
-  CandleWebGLSurface,
-  LineWebGLSurface,
-} from '../../engine/renderers/webgl/candleSurface'
 import type { KLineData } from '../types/price'
 
 /** 插件生命周期状态 */
@@ -313,10 +309,11 @@ export interface RenderContext {
   borderCtx?: CanvasRenderingContext2D
   /** 覆盖层 Canvas 上下文（用于十字线、Tooltip 等动态内容） */
   overlayCtx?: CanvasRenderingContext2D
-  /** price pane 可选的 WebGL candle surface */
-  candleWebGLSurface?: CandleWebGLSurface
-  /** line indicator 可选的 WebGL line surface */
-  lineWebGLSurface?: LineWebGLSurface
+  /**
+   * Scene 本帧 Renderer（createLayerFromPlugin 注入）。
+   * 业务绘制经 drawInstances / drawLines；失败 fail-closed 走 2D。
+   */
+  sceneRenderer?: import('../../rendering/render/Renderer').Renderer
   /** 当前缩放级别（1 ~ zoomLevels） */
   zoomLevel?: number
   /** 总缩放级别数 */
@@ -516,26 +513,22 @@ export interface RendererPlugin {
   enabled?: boolean
 
   /**
-   * 是否为系统渲染器
-   * 系统渲染器不会通过 getRenderers() 返回，只能通过 renderPlugin() 单独渲染
-   * 用于时间轴、全局边框等需要单独控制渲染时机的场景
+   * 是否为系统渲染器（时间轴等）。
+   * 调度由 Scene Layer 负责；Manager 仅作注册表。
    */
   isSystem?: boolean
 
   /**
-   * 渲染器所属层，决定 UpdateLevel 过滤行为
-   * - 'main': 低频/静态内容，随主画布一起渲染
-   * - 'overlay': 高频/动态内容，可在 overlay-only 更新时独立重绘
-   * 未指定时默认为 'main'（向后兼容）
+   * 渲染器所属层，供 Scene role 过滤
+   * - 'main': 低频/静态内容
+   * - 'overlay': 高频/动态内容
+   * 未指定时默认为 'main'
    */
   layer?: 'main' | 'overlay'
 
   /** 渲染方法 */
   draw(context: RenderContext): void
 
-  /** 数据更新时回调 */
-  onDataUpdate?(data: unknown[], range: { start: number; end: number }): void
-
   /** 容器尺寸变化时回调 */
   onResize?(pane: PaneInfo): void