用途:审查 Web、移动端与后端代码库的架构,发现结构性债务、逻辑泄漏和单体组件。优先级为 P1(HIGH)。
主要能力:
- 发现结构重复:通过搜索冗余目录模式定位被拆分的事实来源,例如比较 Service.ts、ServiceNew.ts、ServiceV2.ts,检查 /v1、/v2 或 “Refactor” 文件夹。
- 按生态检测逻辑泄漏:Web(React/Next.js/Vue)用 grep -rE "useEffect|useState|useMemo" components --include=".tsx" | wc -l,若 components 中 hook 数量超过 hooks/ 目录 20 倍则判定架构单体化;移动端(Flutter/React Native)用 grep -rE "http.|dio.|socket." lib/widgets --include=".dart" | wc -l,若 build() 中 I/O 或状态修改超过 5 行则记为高债务;后端(NestJS/Go/Spring)用 grep -rE "Repository.|Query.|db." src/controllers --include="*.ts" | wc -l,控制器应只处理请求解析与响应格式化。
- 识别单体:标记违反单一职责原则的超大文件,UI 超过 500 行为中等、超过 1000 行为严重,后端服务超过 1500 行视为 “God Class”。
- 审计资源性能:检查影响 IDE 性能与二进制体积的大型元数据或常量,资源超过 1000 行需要拆分。
评分影响:UI/控制器层每处业务逻辑违规扣 15 分;每个重复的遗留实体扣 10 分;每个超过 1000 行的单元扣 10 分。
反模式:不得用通用模式覆盖项目特定规则,应尊重既有架构约束;不得忽略错误处理与边界情况,审计须覆盖边界条件。
限制:资料未提供具体安装方式、平台支持范围、收费模式及自动修复能力,暂未提供。