每行一个车牌，也支持空格、逗号或分号分隔

<div className="v2-batch-search-summary" role="status"><span>已识别 <strong>{terms.length}</strong> 辆，重复项已自动去除</span><em>最多 {MAX_MONITOR_SEARCH_TERMS} 辆</em></div>
    </div>
  </WorkspaceSideSheet>;
}

type AddressCoordinate = { longitude: number; latitude: number; key: string };

function hasRealtimeLocation(vehicle: VehicleRealtimeRow) {
  if (vehicle.locationAvailable != null) return vehicle.locationAvailable;
  return Number.isFinite(vehicle.longitude) && Number.isFinite(vehicle.latitude)
    && Math.abs(vehicle.longitude) <= 180 && Math.abs(vehicle.latitude) <= 90
    && (vehicle.longitude !== 0 || vehicle.latitude !== 0);
}

function hasRealtimeSpeed(vehicle: VehicleRealtimeRow) {
  return vehicle.speedAvailable ?? hasRealtimeLocation(vehicle);
}

function hasRealtimeMileage(vehicle: VehicleRealtimeRow) {
  return vehicle.mileageAvailable ?? hasRealtimeLocation(vehicle);
}

function hasTodayMileage(vehicle: VehicleRealtimeRow): vehicle is VehicleRealtimeRow & { todayMileageKm: number } {
  return vehicle.todayMileageAvailable === true && vehicle.todayMileageKm != null;
}

function hasRealtimeSOC(vehicle: VehicleRealtimeRow) {
  return vehicle.socAvailable ?? (vehicle.primaryProtocol === 'GB32960' || vehicle.primaryProtocol === 'YUTONG_MQTT');
}

if (!current) return <span className="v2-monitor-address-empty">暂无实时位置</span>;
  if (!requested) return <Button className="v2-monitor-address-action" size="small" theme="light" type="primary" icon={<IconMapPin />} aria-label={`解析${vehicle.plate || vehicle.vin}位置`} title="按需调用高德地址解析，不随实时数据刷新" onClick={() => setRequested(current)}>解析位置</Button>;
  if (addressQuery.isFetching && !addressQuery.data) return <span className="v2-monitor-address-loading"><Spin size="small" />解析中</span>;
  if (addressQuery.isError) return <Button className="v2-monitor-address-action is-error" size="small" theme="light" type="danger" aria-label={`${vehicle.plate || vehicle.vin}位置解析失败，重试`} onClick={() => void addressQuery.refetch()}>解析失败，重试</Button>;
  return <div className="v2-monitor-address-result"><span title={addressQuery.data?.formattedAddress}>{addressQuery.data?.formattedAddress || '暂无地址'}</span><small>{addressQuery.dataUpdatedAt ? `解析于 ${new Date(addressQuery.dataUpdatedAt).toLocaleTimeString('zh-CN', { hour12: false, hour: '2-digit', minute: '2-digit' })}` : ''}</small>{moved ? <Button className="v2-monitor-address-update" size="small" theme="borderless" type="warning" title="车辆已移动，按需更新地址" onClick={() => setRequested(current)}>位置已移动 · 更新</Button> : null}</div>;
});

const MemoFleetMap = memo(FleetMap);

export default function MonitorPage() {
  const [routeParams, setRouteParams] = useSearchParams();
  const pageRef = useRef<HTMLDivElement>(null);
  const initialContextRef = useRef(parseMonitorRouteContext(routeParams));
  const initialContext = initialContextRef.current;
  const mobileLayout = useMobileLayout(760);
  const [mode, setMode] = useState<'map' | 'list'>(initialContext.mode);
  const [mobileEntryOpen, setMobileEntryOpen] = useState(false);
  const [listOffset, setListOffset] = useState(initialContext.listOffset);
  const [listLimit, setListLimit] = useState(initialContext.listLimit);
  const [keyword, setKeyword] = useState(initialContext.keyword);
  const [batchSearchOpen, setBatchSearchOpen] = useState(false);
  const [filtersCollapsed, setFiltersCollapsed] = useState(true);
  const deferredKeyword = useDeferredValue(keyword);
  const searchTerms = useMemo(() => parseMonitorSearchTerms(keyword), [keyword]);
  const [protocol, setProtocol] = useState(initialContext.protocol);
  const [status, setStatus] = useState(initialContext.status);
  const [selectedVin, setSelectedVin] = useState(initialContext.selectedVin);
  const [detailOpen, setDetailOpen] = useState(initialContext.detailOpen);
  const [viewport, setViewport] = useState<MonitorViewport>(initialContext.viewport);
  const updateViewport = useCallback((next: MonitorViewport) => {
    setViewport((current) => current.zoom === next.zoom && current.bounds === next.bounds ? current : next);
  }, []);
  const filters = useMemo(() => ({ keyword: deferredKeyword, protocol, status }), [deferredKeyword, protocol, status]);
  const monitorReturn = useMemo(() => buildMonitorPath({
    mode, keyword, protocol, status, selectedVin, detailOpen, viewport, listOffset, listLimit
  }), [detailOpen, keyword, listLimit, listOffset, mode, protocol, selectedVin, status, viewport]);
  useEffect(() => {
    const next = new URL(monitorReturn, 'https://vehicle-platform.invalid').searchParams;
    if (next.toString() !== routeParams.toString()) setRouteParams(next, { replace: true });
  }, [monitorReturn, routeParams, setRouteParams]);
  const listScope = useMemo(() => monitorFilterScope(filters), [filters]);
  const listParams = useMemo(() => {
    const params = monitorQueryParams(filters, listLimit);
    params.set('offset', String(listOffset));
    return params;
  }, [filters, listLimit, listOffset]);
  const trackedVin = mode === 'map' ? selectedVin : '';
  const { summary, vehicles, map, selectedVehicle } = useMonitorData(filters, viewport, trackedVin, mode === 'map', mode === 'map');
  const realtimeListQuery = useQuery<Page<VehicleRealtimeRow>>({
    queryKey: ['monitor', 'vehicle-list', listScope, listLimit, listOffset],
    queryFn: ({ signal }) => api.vehicleRealtime(listParams, signal),
    enabled: mode === 'list', placeholderData: retainPreviousPageWithinScope<Page<VehicleRealtimeRow>>(listScope, 2), refetchInterval: mode === 'list' ? MONITOR_REFRESH.fleet : false,
    gcTime: QUERY_MEMORY.highVolumeGcTime,
    ...LIVE_QUERY_POLICY
  });
  const rows = useMemo(() => {
    const data = vehicles.data?.items ?? [];
    if (status === 'driving' || status === 'idle') return data.filter((vehicle) => vehicleStatus(vehicle) === status);
    return data;
  }, [status, vehicles.data?.items]);
  const listRows = realtimeListQuery.data?.items ?? EMPTY_VEHICLES;
  const activeBatchRows = mode === 'map' ? rows : listRows;
  const activeBatchQuery = mode === 'map' ? vehicles : realtimeListQuery;
  const filterTransitionPending = keyword !== deferredKeyword || activeBatchQuery.isLoading;
  const batchSearchPending = searchTerms.length > 1 && filterTransitionPending;
  const batchMatch = useMemo(() => {
    const identities = new Set<string>();
    for (const vehicle of activeBatchRows) {
      identities.add(vehicle.vin.toLocaleUpperCase());
      if (vehicle.plate) identities.add(vehicle.plate.toLocaleUpperCase());
    }
    const missing = searchTerms.filter((term) => !identities.has(term));
    return { matched: searchTerms.length - missing.length, missing };
  }, [activeBatchRows, searchTerms]);
  const visibleRows = filterTransitionPending ? [] : rows;
  const batchStatus = batchSearchPending
    ? `正在查找 ${searchTerms.length} 辆`
    : batchMatch.missing.length
      ? `已找到 ${batchMatch.matched}/${searchTerms.length} · 未找到 ${batchMatch.missing.length} 辆`
      : `已找到 ${batchMatch.matched}/${searchTerms.length}`;
  const batchStatusTitle = batchMatch.missing.length
    ? `未找到：${batchMatch.missing.join('、')}`
    : searchTerms.join('、');
  const visibleListRows = filterTransitionPending ? EMPTY_VEHICLES : listRows;
  const visibleListTotal = filterTransitionPending ? 0 : (realtimeListQuery.data?.total ?? 0);
  const selected = selectedVin
    ? rows.find((vehicle) => vehicle.vin === selectedVin) ?? selectedVehicle.data?.items[0]
    : undefined;
  const resetMonitorScroll = useCallback(() => {
    const scrollOwner = pageRef.current?.closest<HTMLElement>('.v2-content');
    if (scrollOwner) scrollOwner.scrollTop = 0;
  }, []);
  const selectVehicle = useCallback((vin: string) => {
    resetMonitorScroll();
    setSelectedVin(vin);
    setDetailOpen(true);
    setMode('map');
  }, [resetMonitorScroll]);
  const clearSelection = useCallback(() => {
    setSelectedVin('');
    setDetailOpen(false);
  }, []);
  const selectMapVehicle = useCallback((vehicle: VehicleRealtimeRow) => selectVehicle(vehicle.vin), [selectVehicle]);
  const collapseDetail = useCallback(() => setDetailOpen(false), []);
  const expandDetail = useCallback(() => setDetailOpen(true), []);
  const changeMonitorMode = useCallback((nextMode: 'map' | 'list') => {
    resetMonitorScroll();
    setMode(nextMode);
    if (nextMode === 'list') setDetailOpen(false);
  }, [resetMonitorScroll]);
  const clearFilters = useCallback(() => {
    setKeyword('');
    setProtocol('');
    setStatus('');
    setListOffset(0);
  }, []);
  const activeFilterCount = Number(Boolean(keyword.trim())) + Number(Boolean(protocol)) + Number(Boolean(status));
  const driving = rows.filter((vehicle) => vehicleStatus(vehicle) === 'driving').length;
  const idle = rows.filter((vehicle) => vehicleStatus(vehicle) === 'idle').length;
  const offline = rows.filter((vehicle) => vehicleStatus(vehicle) === 'offline').length;
  const totalVehicleCount = summary.data?.totalVehicles ?? vehicles.data?.total ?? rows.length;
  const onlineVehicleCount = summary.data?.onlineVehicles ?? rows.length - offline;
  const offlineVehicleCount = summary.data?.offlineVehicles ?? offline;
  const drivingVehicleCount = summary.data?.drivingVehicles ?? driving;
  const idleVehicleCount = summary.data?.idleVehicles ?? idle;
  const alertVehicleCount = summary.data?.alertDataAvailable ? summary.data.alertVehicles : undefined;
  const monitorMetrics: WorkspaceQueueMetricRailItem[] = [
    {
      label: '车辆总数',
      value: <>{formatNumber(totalVehicleCount)}<i className="v2-monitor-summary-unit">辆</i></>,
      note: '授权车辆',
      tone: 'primary',
      emphasis: 'primary'
    },
    {
      label: '当前在线',
      value: <>{formatNumber(onlineVehicleCount)}<i className="v2-monitor-summary-unit">辆</i></>,
      note: '当前可用',
      tone: 'success',
      emphasis: 'primary'
    },
    {
      label: '行驶车辆',
      value: <>{formatNumber(drivingVehicleCount)}<i className="v2-monitor-summary-unit">辆</i></>,
      note: '实时行驶',
      tone: 'primary',
      emphasis: 'primary'
    },
    {
      label: '当前离线',
      value: <>{formatNumber(offlineVehicleCount)}<i className="v2-monitor-summary-unit">辆</i></>,
      note: '无在线来源',
      tone: 'neutral',
      emphasis: 'secondary'
    },
    {
      label: '静止车辆',
      value: <>{formatNumber(idleVehicleCount)}<i className="v2-monitor-summary-unit">辆</i></>,
      note: '在线静止',
      tone: 'success',
      emphasis: 'secondary'
    },
    {
      label: '告警车辆',
      value: <>{alertVehicleCount == null ? '—' : formatNumber(alertVehicleCount)}<i className="v2-monitor-summary-unit">辆</i></>,
      note: alertVehicleCount == null ? '数据未开放' : '需要关注',
      tone: alertVehicleCount ? 'danger' : 'neutral',
      emphasis: 'primary'
    }
  ];
  const viewportLoad = mode === 'map'
    ? (map.data?.clusters.length
      ? `${map.data.clusters.length} 个聚合 · ${map.data.points.length} 个车辆点`
      : `${map.data?.points.length ?? 0} 个车辆点`)
    : `${realtimeListQuery.data?.items.length ?? 0} / ${realtimeListQuery.data?.total ?? 0} 辆`;
  const lastSyncAt = vehicles.dataUpdatedAt ? new Date(vehicles.dataUpdatedAt) : undefined;

return (
    <div ref={pageRef} className={`v2-monitor-page is-${mode}-mode`}>
      <Card className="v2-filterbar" bodyStyle={{ padding: 0 }} aria-label="车辆筛选">
        <div id="monitor-filter-fields" className={`v2-monitor-filter-fields${filtersCollapsed ? ' is-mobile-collapsed' : ''}`} aria-label="筛选条件">
          <div className={`v2-search-field${searchTerms.length > 1 ? ' is-batch' : ''}`}>
            <Input
              aria-label="搜索车辆"
              prefix={<IconSearch />}
              value={keyword}
              onChange={(value) => { setKeyword(value); setListOffset(0); }}
              onPaste={(event) => {
                const pastedTerms = parseMonitorSearchTerms(event.clipboardData.getData('text'));
                if (pastedTerms.length <= 1) return;
                event.preventDefault();
                setKeyword(pastedTerms.join('，'));
                setListOffset(0);
              }}
              placeholder="车牌 / VIN；可批量粘贴车牌"
              suffix={<Button className="v2-search-batch-action" size="small" theme="borderless" onClick={() => setBatchSearchOpen(true)}>批量</Button>}
            />
            {searchTerms.length > 1 ? <span className={`v2-search-batch-count${batchMatch.missing.length && !batchSearchPending ? ' has-missing' : ''}`} aria-live="polite" title={searchTerms.length === MAX_MONITOR_SEARCH_TERMS ? `最多支持 ${MAX_MONITOR_SEARCH_TERMS} 条；${batchStatusTitle}` : batchStatusTitle}>{batchSearchPending ? `已识别 ${searchTerms.length} 辆` : `已找到 ${batchMatch.matched}/${searchTerms.length}`}</span> : null}
          </div>
          <span className="v2-sr-only" id="monitor-protocol-filter-label">协议</span>
          <Select value={protocol} onChange={(value) => { setProtocol(String(value)); setListOffset(0); }} aria-labelledby="monitor-protocol-filter-label" optionList={protocols.map((item) => ({ value: item, label: item || '全部协议' }))} />
          <span className="v2-sr-only" id="monitor-status-filter-label">在线状态</span>
          <Select value={status} onChange={(value) => { setStatus(String(value)); setListOffset(0); }} aria-labelledby="monitor-status-filter-label" optionList={statuses.map((item) => ({ value: item, label: item === 'no_location' ? '无实时位置' : item ? statusLabel(item as never) : '全部状态' }))} />
          <Button className="v2-filter-reset" icon={<IconRefresh />} disabled={activeFilterCount === 0} onClick={clearFilters}>清空</Button>
        </div>
        <div className="v2-monitor-filter-actions" aria-label="监控操作">
          {mobileLayout ? <Button
            className={`v2-monitor-filter-toggle${activeFilterCount ? ' has-filters' : ''}`}
            theme="light"
            icon={<IconFilter />}
            aria-controls="monitor-filter-fields"
            aria-expanded={!filtersCollapsed}
            aria-label={`${filtersCollapsed ? '展开' : '收起'}车辆筛选，当前 ${activeFilterCount} 个条件`}
            onClick={() => setFiltersCollapsed((value) => !value)}
          >
            {filtersCollapsed ? '筛选' : '收起'}{activeFilterCount ? <b>{activeFilterCount}</b> : null}
          </Button> : <span
            className={`v2-filter-live-status${activeFilterCount ? ' has-filters' : ''}`}
            role="status"
            aria-label={`搜索和筛选条件修改后自动生效，已启用 ${activeFilterCount} 个条件`}
            title="搜索和筛选条件修改后自动生效"
          >
            <IconFilter aria-hidden="true" />
            <span className="v2-filter-live-status-label">自动生效</span>
            {activeFilterCount ? <b>{activeFilterCount}</b> : null}
          </span>}
          <SegmentedTabs
            ariaLabel="监控视图"
            className="v2-monitor-mode"
            value={mode}
            items={MONITOR_VIEW_ITEMS}
            onChange={changeMonitorMode}
            variant="filled"
          />
          <Button className="v2-monitor-mobile-entry" theme="light" icon={<IconQrCode />} aria-label="打开手机端入口" onClick={() => setMobileEntryOpen(true)}><span className="v2-monitor-mobile-entry-label">手机端</span></Button>
        </div>
      </Card>
      {batchSearchOpen ? <BatchVehicleSearchDialog initialValue={searchTerms.join('\n')} mobile={mobileLayout} onClose={() => setBatchSearchOpen(false)} onApply={(value) => { setKeyword(value); setListOffset(0); setBatchSearchOpen(false); }} /> : null}

<WorkspaceMetricRail
        variant="queue"
        ariaLabel="车辆整体统计"
        className="v2-monitor-summary-rail"
        items={monitorMetrics}
        context={<div className="v2-monitor-summary-support">
          <span><small>今日上报</small><strong>{formatNumber(summary.data?.frameToday ?? 0)}<i>条</i></strong><em>数据活跃度</em></span>
          <span><small>无实时位置</small><strong>{formatNumber(summary.data?.noLocationVehicles ?? 0)}<i>辆</i></strong><em>辅助排查</em></span>
        </div>}
      />

{vehicles.isError ? <InlineError message={vehicles.error instanceof Error ? vehicles.error.message : '车辆数据加载失败'} onRetry={() => vehicles.refetch()} /> : null}
      {mode === 'list' && realtimeListQuery.isError ? <InlineError message={realtimeListQuery.error instanceof Error ? realtimeListQuery.error.message : '车辆列表加载失败'} onRetry={() => realtimeListQuery.refetch()} /> : null}
      {mode === 'map' ? <section className={`v2-monitor-workspace${selected && detailOpen ? ' is-detail-open' : ''}${selected && !detailOpen ? ' is-detail-collapsed' : ''}`}>
        <div className="v2-vehicle-rail">
          <header><strong>车辆列表</strong><span>{batchSearchPending ? '查询中' : `${formatNumber(vehicles.data?.total ?? visibleRows.length)} 辆`}</span></header>
          <div className={`v2-rail-search${batchMatch.missing.length && !batchSearchPending ? ' has-missing' : ''}`} title={searchTerms.length > 1 ? batchStatusTitle : undefined}><IconSearch /><span>{searchTerms.length > 1 ? batchStatus : deferredKeyword ? `正在筛选“${deferredKeyword}”` : '按最新上报排序'}</span></div>
          <div className="v2-vehicle-scroll">
            {vehicles.isLoading || batchSearchPending ? <div className="v2-list-loading"><span className="v2-spinner" />{batchSearchPending ? `正在查找 ${searchTerms.length} 辆车` : '加载车辆'}</div> : null}
            {!vehicles.isLoading && !batchSearchPending && visibleRows.length === 0 ? <EmptyState /> : null}
            {visibleRows.map((vehicle) => <VehicleRow key={vehicle.vin} vehicle={vehicle} selected={vehicle.vin === selectedVin} onSelect={selectVehicle} />)}
          </div>
          <footer>{searchTerms.length > 1 && !batchSearchPending ? batchStatus : `当前载入 ${visibleRows.length} / ${vehicles.data?.total ?? visibleRows.length} 辆`}</footer>
        </div>
        <MemoFleetMap
          vehicles={visibleRows}
          monitorMap={filterTransitionPending ? undefined : map.data}
          selectedVin={selectedVin || undefined}
          onSelect={selectMapVehicle}
          onSelectVin={selectVehicle}
          onViewportChange={updateViewport}
          initialViewport={initialContext.hasViewport ? initialContext.viewport : undefined}
        />
        {selected && detailOpen ? (
          <Suspense fallback={<Card className="v2-vehicle-detail v2-detail-loading-card" bodyStyle={{ padding: 0 }}><div role="status"><Spin size="small" />正在加载车辆详情</div></Card>}>
            <VehicleDetailCard
              vehicle={selected}
              monitorReturn={monitorReturn}
              onCollapse={collapseDetail}
              onClear={clearSelection}
            />
          </Suspense>
        ) : null}
        {selected && !detailOpen ? (
          <Card className="v2-detail-peek" bodyStyle={{ padding: 0 }}>
            <Button theme="borderless" type="tertiary" aria-label="展开车辆详情" title={`展开 ${selected.plate || selected.vin} 的车辆详情`} onClick={expandDetail}>
              <IconChevronLeft />
              <i className={`v2-status-dot is-${vehicleStatus(selected)}`} />
              <span>{selected.plate || '未绑定车牌'}</span>
            </Button>
          </Card>
        ) : null}
      </section> : <MonitorVehicleTable rows={visibleListRows} total={visibleListTotal} page={Math.floor(listOffset / listLimit) + 1} totalPages={Math.max(1, Math.ceil(visibleListTotal / listLimit))} limit={listLimit} loading={filterTransitionPending || realtimeListQuery.isFetching} mobile={mobileLayout} onSelect={selectVehicle} onPage={(page) => setListOffset((page - 1) * listLimit)} onLimit={(next) => { setListLimit(next); setListOffset(0); }} />}

<Card className="v2-event-strip" bodyStyle={{ padding: 0 }} aria-label="实时数据状态">
        <div className="v2-event-sync">
          <Tag className="v2-monitor-live-tag" color="green" type="light" size="small"><IconRefresh aria-hidden="true" />{vehicles.isFetching ? '正在同步' : '数据已同步'}</Tag>
          <span><strong>实时数据</strong><small>{visibleRows.length.toLocaleString('zh-CN')} 辆已载入</small></span>
        </div>
        <div className="v2-event-load"><small>{mode === 'map' ? '地图载荷' : '列表载荷'}</small><span>{viewportLoad}</span></div>
        <div className="v2-refresh-cadence">
          <Tag color="blue" type="light" size="small"><IconRefresh aria-hidden="true" />智能刷新</Tag>
          <span>重点 {MONITOR_REFRESH.selected / 1000}s · 车队 {MONITOR_REFRESH.fleet / 1000}s · 统计 {MONITOR_REFRESH.summary / 1000}s</span>
        </div>
        <time dateTime={lastSyncAt?.toISOString()}><span><small>最近同步</small><b>{lastSyncAt ? lastSyncAt.toLocaleTimeString('zh-CN', { hour12: false }) : '等待数据'}</b></span></time>
      </Card>
      {mobileEntryOpen ? <MobileEntry mobile={mobileLayout} onClose={() => setMobileEntryOpen(false)} /> : null}
    </div>
  );
}