2026年8月12日

performance Skill——面向设计与评审的优化模式

performance skill 如何为 Datarim 智能体提供一份简明参考,涵盖懒加载、缓存、批处理、数据库索引和前端打包优化,用于在设计或评审时关注性能。

性能问题往往出现得较晚,而此时修复它们的成本很高。缺失的索引是在生产环境高负载下才被发现的。N+1 查询是在负载测试中才被捕获的。一个需要六秒才能解析的打包产物会阻塞每一次首页访问。performance skill 会在设计和评审阶段加载这些模式,赶在问题被固化进代码之前。

该 skill 涵盖三个层面:通用优化模式、数据库专项指导以及前端专项指导。每个层面针对性能决策的不同环节。

优化模式

有三种模式广泛适用于整个技术栈。第一种是懒加载:仅在需要时才加载资源或模块。在顶层导入的模块总是要付出代价;按需加载的模块只有在用户到达需要它的代码路径时才付出代价。

第二种是缓存。对于计算结果昂贵且足够稳定、可以复用的操作——数据库查询、外部 API 调用、计算型聚合——像 Redis 或内存存储这样的缓存层可以避免重复执行这些工作。该 skill 并不规定具体的 TTL 或失效策略;这些取决于数据变化的频率以及应用能容忍多大的陈旧度。

第三种是批处理。当应用在循环中发起许多小的数据库或 API 调用时,用一次获取全部数据的单一调用替换它们,可以消除每次调用的开销。对每个条目都调用一次数据库的循环就是批处理的候选对象。

数据库

两条数据库规则覆盖了大多数查询性能问题。第一:确保出现在查询过滤条件和连接中的列上存在索引。对大表进行全表扫描是慢查询最常见的原因;解决办法是加索引,而不是重写查询逻辑。

第二:避免 N+1 查询。当代码加载 N 条记录的列表,然后为每条记录额外发起一次查询以获取关联资源时,就会发生 N+1 查询。解决办法是预加载——要么在 ORM 调用中使用 include 子句,要么采用在单次查询中获取所有关联记录的批量加载模式。

前端

有三种前端模式适用于构建和渲染阶段。打包体积决定了浏览器在页面变为可交互之前解析和执行 JavaScript 所需的时间。保持打包体积小——通过 tree-shaking、代码分割,以及避免使用体积大、有更轻量替代方案的依赖——会直接影响首次加载时间。

图片优化意味着以 WebP 格式提供图片并懒加载它们。在同等视觉质量下,WebP 生成的文件比 JPEG 或 PNG 更小。懒加载会推迟初始视口之外图片的下载,直到用户滚动到它们,从而减少首次加载时传输的数据量。

对于渲染长列表的页面——搜索结果、信息流条目、交易历史——虚拟化只渲染可见的行,而不是完整列表。为用户一次只能看到二十条的列表渲染一万个 DOM 节点会造成布局和绘制开销,而虚拟化可以消除这些开销。

阅读什么是 Datarim以了解更广泛的背景,或查看关于network-exposure-baseline skill的相关文章,了解另一个在设计阶段检查比事后修复成本更低的约束示例。