用途:在编写或修改 Docyrus API 逻辑后,按清单逐项扫描改动代码,修复所有发现的问题再视为任务完成。
主要能力:分为三类检查。BUG(B1-B12)覆盖会导致报错的问题,如 .list()/.get() 缺少 columns 参数、limit: 0、子查询或公式键未列入 columns、用 @ 语法做聚合、distinctColumns 与 calculations 混用、公式操作数数量错误、jsonb_build_object 中字符串字面量未显式 cast 等。PERFORMANCE(P1-P8)覆盖聚合查询多余 limit、用 fullCount 仅取总数、仅聚合时多余 columns、过度取列、大 limit 无分页、缺少 expand 导致 N+1、为存在性检查取行、重复重叠查询。CODE QUALITY(Q1-Q8)覆盖响应上的重类型断言、依赖查询缺少 enabled、mutation 无错误处理、mutation 后未失效查询、串行缓存失效、使用已弃用的 expandTypes、硬编码数据源路径、distinctColumns 缺少 orderBy。
使用方式:先找出本次任务中所有含 Docyrus API 调用的改动文件,扫描 .list(、.get(、.create(、.update(、.delete(、client.get(、client.post(、client.patch(、client.delete( 等调用点,依次对照 BUG、PERFORMANCE、CODE QUALITY 检查,从 BUG 类开始修复。详细说明、检测模式与修复前后示例见 references/checklist-details.md。
适用场景:实现或修改 Docyrus API 代码后的自查。
限制:资料未提供安装命令、平台支持、收费与价格信息;不适用项可跳过。