核心用法
fe-cli 是面向现代前端工程的脚手架工具，核心功能围绕「项目初始化」与「规范审查」双主线展开：
1. 多类型项目生成
支持 6 种工程形态的智能路由：Web SPA、后台管理(admin)、移动 H5(h5)、Electron 桌面端、SSR(Next.js/Nuxt)、小程序(微信/Taro)。用户可通过自然语言描述（如"React + Tailwind + Zustand 后台项目"）触发快速模式，或直接交互式问答完成配置。
2. 标准化共享层
所有子类型项目自动生成统一的基础设施层：
- 网络层：原生 fetch 封装（非 axios），含请求拦截、结构化日志分级与轮转
- 样式层：SCSS 变量系统 + CSS Reset + 响应式断点定义
- 工具层：Storage 封装、日期/数字格式化、表单校验、深拷贝/防抖等
- 环境配置：四环境变量文件(.env/.development/.test/.production) + Vite 多模式脚本
3. 工程规范审查
可审计已有项目是否符合预设标准，输出「符合/缺失/建议」三级报告，覆盖包管理器(pnpm)、路径别名(@/→src/)、TypeScript 严格配置、AI 可读文档(.ai/PROJECT.md)等 12 项检查点。
4. 开发者体验优化
- 路径别名双端同步(tsconfig + vite)
pnpm.onlyBuiltDependencies自动处理原生依赖- 子模块化的
Logger.child("Module")日志追踪 - 项目根目录生成
.ai/PROJECT.md，便于后续 AI 代理快速理解架构
显著优点
| 维度 | 优势 |
|------|------|
| 技术栈覆盖 | React/Vue/Next.js + Tailwind/Ant Design/MUI + Zustand/Redux + i18n，主流组合全覆盖 |
| 规范一致性 | 强制 pnpm、SCSS、Node 18+、fetch 网络层，减少团队选型争议 |
| 可维护性 | 5MB 自动清理的日志系统、结构化导出、分级输出，生产环境友好 |
| AI 友好 | 自动生成标准化项目文档，降低后续 AI 辅助开发的上下文成本 |
| 降级策略 | 网络失败、目录冲突、版本不存在等场景均有明确 fallback |
潜在局限
1. 生态锁定：强制 pnpm 和原生 fetch，习惯 yarn/npm 或 axios 的项目迁移需适应成本
2. 预设 opinionated：SCSS 为唯一预处理器、@/ 别名不可配置，高度个性化需求可能受限
3. 部署盲区：明确声明仅负责本地初始化，CI/CD 部署流程需额外工具链
4. 小程序/SSR 子技能深度未公开：核心文档聚焦 Web/Admin/H5/Electron，小程序与 SSR 具体实现细节依赖子技能
适合人群
- 中大型企业前端团队：需统一多项目技术栈与目录规范
- 全栈开发者：快速生成前后端分离的前端工程，减少重复配置
- 技术负责人：建立团队级脚手架标准，配套审查机制确保落地
- AI 辅助开发场景：.ai/PROJECT.md 设计便于后续 GPT/Copilot 类工具理解项目
常规风险
| 风险点 | 说明与缓解 |
|--------|-----------|
| Node 版本兼容 | 目标 Node 18+，旧环境需升级或使用 nvm |
| 网络依赖安装失败 | 内置淘宝镜像 fallback 提示，但无离线/镜像自动切换机制 |
| 日志上报占位 | `log-export.ts` 中上报端点为 TBD，生产环境需自行实现 |
| 覆盖误操作 | 目录已存在时询问「覆盖/合并/取消」，但无版本控制保护提醒 |
| 类型检查分离 | `typecheck` 独立脚本，开发者可能遗漏导致运行时 TS 错误 |