FAST perfHint 调了却没提速：BEGIN/END、SceneType 与 tids 三个边界

页面切换时调用了 schedulingOptimization.perfHint，埋点也显示成功，卡顿曲线却几乎没变化。最常见的原因不是接口“没用”，而是提示覆盖错了时间段：BEGIN 在页面创建前发出，END 却在异步图片完成后才到；或者只把主线程放进 tids，真正做解码和绘制准备的工作线程完全不在范围内。

验证范围：本文依据华为开发者官网截至 2026-09-22 的公开资料整理。当前本机 DevEco SDK 为 API 24，且没有连接 HDC 真机；涉及 API 26 的接口片段用于说明接入与排障边界，不宣称已经完成 API 26 编译或真机验证。文中的时间戳校验、状态机、坐标换算、去重合并与资源预算逻辑已通过 Node.js 宿主测试，正式上线仍需在 API 26 SDK 和目标设备上补齐编译、权限、异常分支与性能验收。

先把误判停下来

perfHint 是场景提示，不是给任意代码强制提频的开关。HarmonyOS 7 API 26 的系统性能优化能力要求调用方说明场景类型、开始与结束状态、预计持续时间以及关联线程。范围写得过大，会把无关阶段一起包进去；范围写得过小，又覆盖不到真正的瓶颈。

type Hint = { scene: string; state: 'BEGIN' | 'END'; tids: number[]; at: number };

function validateHintPair(events: Hint[]): string[] {
  const errors: string[] = [];
  const open = new Map<string, Hint>();
  for (const e of events) {
    if (e.state === 'BEGIN') open.set(e.scene, e);
    else {
      const start = open.get(e.scene);
      if (!start) errors.push(`END_WITHOUT_BEGIN:${e.scene}`);
      else if (e.at <= start.at) errors.push(`NON_POSITIVE_WINDOW:${e.scene}`);
      else open.delete(e.scene);
    }
  }
  for (const scene of open.keys()) errors.push(`MISSING_END:${scene}`);
  return errors;
}

案例一：把页面切换写成 PAGE_LOAD

从列表进入详情页，点击后先发生路由转场，再发起数据请求。若把整个过程都标成 PAGE_LOAD，转场阶段的卡顿和数据阶段的慢请求会被混在一起。更清楚的做法是：可见转场只覆盖 PAGE_TRANSITION，首屏数据和布局完成覆盖 PAGE_LOAD，两段分别记录响应时延与完成时延。

案例二：线程 ID 只传了主线程

媒体封面页的主线程只提交任务，实际工作发生在解码线程。此时 tids 只有主线程，提示与热点线程不一致。先用性能工具确认关键路径，再传递真实参与线程；线程池任务结束后也不能复用旧的线程集合。

interface WindowFact { begin: number; end: number; actionAt: number; firstFrameAt: number }
function hintCoverage(f: WindowFact): number {
  const usefulStart = Math.max(f.begin, f.actionAt);
  const usefulEnd = Math.min(f.end, f.firstFrameAt);
  return Math.max(0, usefulEnd - usefulStart);
}

证据怎么对齐

观察项	错误做法	可复核做法
场景类型	所有阶段都用 APP_LAUNCH	按启动、切换、加载、绘制分别标记
时间窗口	BEGIN 后忘记 END	同一业务 ID 成对记录并设超时兜底
线程集合	固定写主线程	从性能证据中确认真正热点线程
效果判断	只看一次主观感受	同设备同数据对比 P50/P95

为什么采用这条路径

优先把提示窗口缩到用户动作与首个稳定结果之间，再核对 SceneType 和 tids。只有证据链稳定后才比较开启前后的指标，否则性能变化无法归因。

上线前复核

• BEGIN 与 END 按业务 ID 成对出现。
• 场景类型与真实阶段一致，不用一个枚举包办全链路。
• tids 来自当前任务，不缓存已经退出的线程。
• 记录响应时延、完成时延和 P95，不只记录平均值。
• 异常、取消和页面退出都会补发 END。

官方资料

• FAST Kit 简介
• FAST Kit API 26 Beta2 变更
• HarmonyOS 应用时延体验建议

perfHint 真正需要管理的是“场景事实”。BEGIN/END、场景和线程三者对齐，性能提示才有可解释的输入与可复核的结果。