用途:该技能为某一 React 前端仓库提供 TypeScript 编码规范,供编写或修改 TypeScript/React 代码、创建组件、集成 MSAL 鉴权时使用。
主要能力与约定:启用 strict、noImplicitAny、strictNullChecks,避免 any;使用函数组件、hooks 与显式类型化 props。MSAL 采用先静默获取令牌、失败再弹窗的流程。环境变量须在模块顶层访问(构建时替换),如 import.meta.env.VITE_ENTRA_SPA_CLIENT_ID 与 VITE_ENTRA_TENANT_ID。状态管理优先 useState 或 Context API,并对昂贵计算与回调使用 useMemo、useCallback 保持引用稳定。API 调用需携带 Authorization 头并使用 async/await,非 ok 响应抛错。
开发工作流:前端由 Vite HMR 运行,保存文件即自动更新浏览器;通过 VS Code 任务“Frontend: React Vite”启动 npm run dev;可用 Playwright 访问 http://localhost:5173 检查控制台与网络请求。提交依赖变更前用 npm ci 校验锁文件同步。frontend/.npmrc 已设 legacy-peer-deps=true,需显式补充 peer 依赖。
项目专有部分:包含基于 Context + useReducer 的状态管理、SSE 流式聊天与取消、引用标注解析(支持【4:0†source】等格式)、文件上传校验(单文件 5MB、最多 5 个)、ChatService 方法与无障碍清单。
限制:资料仅针对该特定仓库,未提供通用安装命令、版本兼容性、定价或性能数据。