企业官网建设流程全解析

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[]=[];constopen=newMap<string,Hint>();for(consteofevents){if(e.state==='BEGIN')open.set(e.scene,e);else{conststart=open.get(e.scene);if(!start)errors.push(`END_WITHOUT_BEGIN:${e.scene}`);elseif(e.at<=start.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{constusefulStart=Math.max(f.begin,f.actionAt);constusefulEnd=Math.min(f.end,f.firstFrameAt);returnMath.max(0,usefulEnd-usefulStart);}

证据怎么对齐

为什么采用这条路径

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

上线前复核

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

官方资料

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

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