“页面有点卡”无法直接指导优化。一次交互可能同时包含数据解析、状态归并、布局和绘制，平均耗时还会掩盖少量极慢帧。性能面板应记录阶段、分位数和超预算次数，并允许从一次用户操作追到具体任务。

方案面向HarmonyOS 6.1.1 Release SDK（API 24），系统Kit调用进入适配层，命令约束、状态归并和恢复策略进入可测试的业务层。范围包含状态与资源生命周期设计、失败恢复和验收合同，不包含业务内容生产、服务端协议改造以及特定厂商网页或媒体源的兼容承诺。

把卡顿改写成可测量问题

方案准备2000条列表数据，分别执行主线程同步排序和TaskPool计算。每次操作生成traceId，记录prepare、compute、merge和render四个阶段；监控器保留最近200次样本，输出P50、P95、最大值与超出16.7ms预算的次数。

状态数量不是越多越好。每个状态必须回答三个问题：当前允许哪些命令、收到迟到事件怎样处理、页面退出后是否还可以更新UI。下面的状态对象携带operationId，新的操作开始后，旧操作回调会被拒绝。

export enum FrameBudgetState {
  WARMING = 'warming',
  MEASURING = 'measuring',
  AGGREGATING = 'aggregating',
  COMPARING = 'comparing',
  PASS = 'pass',
  OVER_BUDGET = 'over_budget'
}

export interface FrameBudgetSnapshot {
  state: FrameBudgetState;
  progress: number;
  message: string;
  operationId: number;
  updatedAt: number;
}

export type FrameBudgetEvent =
  | { type: 'START'; operationId: number }
  | { type: 'PROGRESS'; operationId: number; progress: number }
  | { type: 'SUCCESS'; operationId: number }
  | { type: 'FAIL'; operationId: number; message: string };

export function acceptEvent(
  snapshot: FrameBudgetSnapshot,
  event: FrameBudgetEvent
): boolean {
  return event.type === 'START' || event.operationId === snapshot.operationId;
}

一次交互使用同一个traceId

测量代码不在每次循环中写日志，只在阶段结束时追加轻量样本。优化实验保持输入、设备、窗口和操作步骤一致；第一次运行作为预热，不进入统计。页面展示原始样本数量，样本不足时不输出“提升百分比”。

这套分层把系统事实和产品行为分开：Kit适配器负责获得事实，领域对象决定是否接受事件，页面只渲染快照。更换API版本或加入真机能力时，只需要替换适配器；状态归并和异常策略仍可在模拟器中重复验证。

平均值为什么会掩盖长尾

下面是主题专属的接入或核心算法代码。示例刻意保留资源创建、前置条件和清理逻辑，因为高频故障往往出现在成功调用之外。

export interface TimingSample {
  traceId: string;
  stage: 'prepare' | 'compute' | 'merge' | 'render';
  durationMs: number;
  createdAt: number;
}

export class TimingWindow {
  private samples: TimingSample[] = [];
  constructor(private capacity: number = 200) {}

  add(sample: TimingSample): void {
    this.samples.push(sample);
    if (this.samples.length > this.capacity) this.samples.shift();
  }

  percentile(stage: TimingSample['stage'], ratio: number): number {
    const values = this.samples
      .filter(item => item.stage === stage)
      .map(item => item.durationMs)
      .sort((a, b) => a - b);
    if (values.length === 0) return 0;
    const index = Math.min(values.length - 1,
      Math.floor((values.length - 1) * ratio));
    return values[index];
  }

  overBudget(limitMs: number): number {
    return this.samples.filter(item => item.durationMs > limitMs).length;
  }
}

代码迁入业务工程时，应把错误码转换为稳定的领域错误，不让页面直接判断系统错误字符串。对于异步回调，还要在写入状态前比较operationId或资源版本；仅检查组件是否存在，无法阻止旧任务污染新页面。

主线程只保留必要归并

异常注入按钮用于稳定复现应用侧恢复路径。真实错误发生时，诊断记录同时保存错误码、权限结果、设备能力和用户可见状态；敏感原始数据不进入日志，截图只呈现与问题直接相关的结果。

优化前后使用同一输入

页面层不直接调用Kit，而是通过动作按钮驱动同一份状态模型。这样既能在系统能力可用时接真实适配器，也能在模拟器缺少硬件时验证错误页面、幂等逻辑和资源清理。

@Component
struct FrameBudgetPanel {
  @State stateText: string = 'WARMING';
  @State progress: number = 0;
  @State logs: string[] = [];

  private append(message: string): void {
    const time = new Date().toLocaleTimeString();
    this.logs = [`${time}  ${message}`, ...this.logs].slice(0, 8);
  }

  private startDemo(): void {
    this.stateText = 'MEASURING';
    this.progress = 20;
    this.append('开始：帧预算监控与卡顿定位');
  }

  private injectFailure(): void {
    this.stateText = 'OVER_BUDGET';
    this.append('已注入可恢复故障');
  }

  build() {
    Column({ space: 12 }) {
      Text('帧预算监控与卡顿定位').fontSize(24).fontWeight(FontWeight.Bold)
      Text(this.stateText).fontSize(18).fontColor('#2563EB')
      Progress({ value: this.progress, total: 100 }).width('100%')
      Row({ space: 12 }) {
        Button('开始实验').onClick(() => this.startDemo())
        Button('注入故障').onClick(() => this.injectFailure())
      }
      ForEach(this.logs, (item: string) => Text(item).fontSize(13))
    }.padding(20).width('100%')
  }
}

用固定2000条数据分别运行同步和并发方案各30次，丢弃首次预热样本。比较compute和merge的P50、P95与超预算次数；快速返回页面后停止采样，确保后台没有继续刷新旧面板。

性能对照还要控制热状态和页面可见性。两组实验交替运行，避免先测的一组全部处于冷启动、后测的一组全部享受缓存。每个traceId只记录一次完整交互，用户中途取消的样本单独分类，不混入成功分位数。优化后如果compute下降但merge上升，结论应指出瓶颈转移，而不是只展示总耗时最好的一次。帧预算面板本身使用低频刷新，统计计算放到采样结束后，避免测量工具改变被测页面的行为。最终报告保留原始样本数量和设备信息，让结果能够在SDK升级后重新对照。列表滚动、页面跳转和首屏加载应分别建基线，因为它们的关键路径和可接受波动并不相同。

验收记录至少包括SDK版本、模拟器系统版本、操作顺序、预期状态、实际状态和截图编号。快速点击、返回再进入、故障后重试和页面销毁是必测项；涉及资源的主题还要显示活动对象计数，涉及异步任务的主题要验证迟到结果不会改变当前页面。

性能结果如何避免自我欺骗

这套方案的技术闭环由“输入约束—状态模型—Kit适配—异常恢复—可观察验收”组成。业务状态不持有系统对象，适配器不直接操作页面，异常路径有明确的恢复动作，后续SDK升级时可以分别回归每一层。

官方资料：PerformanceAnalysisKit相关开发文档