孤儿文件与无效代码清理（Find Orphans）

系统化分析项目中的孤儿文件、未使用的组件和无效代码，帮助清理历史遗留。

触发场景

• 用户说「清理无用代码」「查找孤儿文件」「删除未使用的文件」「项目瘦身」
• 重构前的准备工作、代码审计
• 项目历史遗留清理

执行流程

1. 项目结构分析

读取 package.json，识别：

• 框架类型（React/Vue/Angular/Next.js）
• 构建工具（Vite/Webpack/Rollup）
• 入口文件（main 字段、scripts.dev/build 指向的文件）

扫描目录结构，识别：

• 源码目录：src/、app/、lib/
• 组件目录：components/、views/、pages/
• 工具目录：utils/、helpers/、hooks/
• 样式目录：styles/、css/

2. 孤儿文件检测

步骤一：收集所有源码文件

用 Glob 扫描所有 .ts、.tsx、.vue、.js、.jsx、.css、.scss 文件，排除：

• node_modules/、dist/、build/、.next/
• .config.、*.d.ts
• .test.、.spec.（除非用户要求包含）

步骤二：提取所有 import 引用

用 Grep 搜索所有 import/require 语句，将相对路径解析为绝对路径，构建「被引用文件集合」。

步骤三：比对找出孤儿

所有源码文件 - 入口文件 - 被引用文件集合 = 孤儿文件

特殊检测：

• 路由孤儿：读取路由配置文件（router/index.ts、routes.ts），找出 pages/ 目录下未在路由中注册的组件
• 样式孤儿：检查 .css/.scss/.less 是否被任何文件 import 或在 HTML 中 引用
• 资源孤儿：检查 assets/ 中的图片/字体是否在代码或样式中被引用

3. 未使用组件检测

导入但未使用：

对每个文件，提取 import 的标识符，检查该标识符是否在文件其余部分出现（排除 import 行本身）：

• React：检查是否出现在 JSX 标签中（）
• Vue：检查是否在 components: {} 注册且在