SuperAPI AI 工具集

codeprobe-performance

编程与开发

查看项目

更新于 10-29 17:14

技能介绍

codeprobe-performance 是 codeprobe 工具集的性能与可扩展性审计子技能,专门用于在代码库中定位性能瓶颈与扩展性隐患。

一、独立运行方式 当该技能被直接调用(不经过编排器)时,需要先读取 ../codeprobe/shared-preamble.md(相对本 SKILL.md 所在目录的兄弟 codeprobe 目录解析,而非用户项目目录),以获取输出契约、执行模式与约束;再根据项目技术栈从 ../codeprobe/references/ 加载适用的参考文件。除非用户另有说明,默认使用完整模式。

二、检测范围

  1. N+1 查询:循环内访问 ORM 关联而未预加载(如 foreach 中访问 $order->items、$user->profile);Django queryset 逐次访问、SQLAlchemy 懒加载、Prisma 在 .map() 中访问关联;Blade、Jinja2 或 React 组件在渲染期间触发查询。
  2. 缺失索引:WHERE/ORDER BY 使用未索引列、外键缺少索引、多条 where() 或 where()+orderBy() 组合需要复合索引。
  3. 无界查询:Model::all()、::all()、findAll()、无 LIMIT 的 SELECT *;大数据集处理缺少 cursor()、chunk()、lazy() 等流式方式。
  4. 内存:对用户上传或大文件使用 file_get_contents()、fs.readFileSync()、无大小限制的 open().read();循环内无界数组累积;本可用生成器/yield/惰性集合却返回完整数组。
  5. 缓存:同一请求内重复执行相同查询;Cache::put()、cache.set()、Redis SET 无过期时间;写操作(create/update/delete)后未清除或更新相关缓存。
  6. 算法效率:热路径中的嵌套循环 O(n²);循环内调用 sort()、usort() 等排序;在循环中用 in_array()、.includes()、.indexOf()、list.index() 做线性查找而本可先建 Set/dict/哈希表。
  7. 并发:读-改-写无锁(计数器递增、余额更新、标志切换);队列任务缺少幂等检查或唯一约束;异步处理中访问全局/模块级可变状态。
  8. 前端性能:缺少 React.memo、useMemo、useCallback 导致昂贵重渲染,JSX 属性中内联创建对象/数组;整体导入大型库(如 import _ from 'lodash'、moment);路由级缺少 React.lazy()/动态 import() 代码分割。

三、不标记的情形 不在非热路径代码上做过早优化;不标记仅开发用的调试查询(种子、开发命令、调试端点);不标记有意全量处理的批处理脚本(迁移、数据回填);不标记小于 100 项的有界小集合上的 O(n²);不标记前端 SSR/构建期代码。

四、严重级别与编号 发现按严重程度标注 Critical、Major、Minor,全部以 PERF- 前缀顺序编号(PERF-001、PERF-002……)。当编排器运行 /codeprobe audit 并提供 scripts/complexity_scorer.py 输出时,可将被评为 high 或 very_high 且处于热路径(请求处理、循环体、高频工具函数)的函数作为算法效率线索。

五、修复提示示例 每条发现可附带具体修复建议,例如:在 OrderController@index 的 Order::query() 上添加 ->with('items','customer') 修复 N+1;将 Product::all() 改为 paginate(25) 或 cursor();在嵌套循环前用 groupBy 构建 $ordersByCustomerId 哈希表;将 import _ from 'lodash' 改为按需导入 lodash/debounce 以减小包体积。

六、适用场景与限制 适用于对采用 Laravel、Django、SQLAlchemy、Prisma、React 等技术栈的项目做性能审计,尤其适合请求处理链路、数据库访问密集与前端交互密集的代码。其判断依赖对迁移文件与 schema 的交叉比对,若无 schema 信息则索引类检测受限;对非热路径代码会主动跳过,避免过度优化建议;该技能只输出检测与修复提示,不自动改写代码。