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 的系统性能优化能力要求调用方说明场景类型、开始与结束状态、预计持续时间以及关联线程。范围写得过大会把无关阶段一起包进去范围写得过小又覆盖不到真正的瓶颈。typeHint{scene:string;state:BEGIN|END;tids:number[];at:number};functionvalidateHintPair(events:Hint[]):string[]{consterrors:string[][];constopennewMapstring,Hint();for(consteofevents){if(e.stateBEGIN)open.set(e.scene,e);else{conststartopen.get(e.scene);if(!start)errors.push(END_WITHOUT_BEGIN:${e.scene});elseif(e.atstart.at)errors.push(NON_POSITIVE_WINDOW:${e.scene});elseopen.delete(e.scene);}}for(constsceneofopen.keys())errors.push(MISSING_END:${scene});returnerrors;}案例一把页面切换写成 PAGE_LOAD从列表进入详情页点击后先发生路由转场再发起数据请求。若把整个过程都标成PAGE_LOAD转场阶段的卡顿和数据阶段的慢请求会被混在一起。更清楚的做法是可见转场只覆盖PAGE_TRANSITION首屏数据和布局完成覆盖PAGE_LOAD两段分别记录响应时延与完成时延。案例二线程 ID 只传了主线程媒体封面页的主线程只提交任务实际工作发生在解码线程。此时tids只有主线程提示与热点线程不一致。先用性能工具确认关键路径再传递真实参与线程线程池任务结束后也不能复用旧的线程集合。interfaceWindowFact{begin:number;end:number;actionAt:number;firstFrameAt:number}functionhintCoverage(f:WindowFact):number{constusefulStartMath.max(f.begin,f.actionAt);constusefulEndMath.min(f.end,f.firstFrameAt);returnMath.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、场景和线程三者对齐性能提示才有可解释的输入与可复核的结果。