SuperAPI AI 工具集

console-frontend-review

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:该技能针对 depot console 这一 React/TypeScript 网页应用提供全面的前端代码审查,该应用用于车队运维与 BVR 漫游车实时遥操作。技术栈为 React 19 + Vite、TypeScript 严格模式、Zustand 单 store、Tailwind CSS v4、React Three Fiber + drei、Radix UI、React Router v7,使用 ESM 构建。

审查重点:

  1. 状态管理(store.ts):单 store 按 fleet、connection、telemetry、input、camera、video 划分域;要求不可变更新、无 Redux 式 action、避免组件中选取整个 state、派生值不应存入 state。
  2. TypeScript 模式(types.ts):枚举用 as const 派生类型别名、对象用 interface、禁止 any、严格空值检查、提供 UI 标签映射。
  3. WebSocket 与二进制协议(protocol.ts、useRoverConnection.ts):命令 0x01-0x0F、遥测 0x10-0x1F、视频 0x20-0x2F;使用 DataView 小端编码、读取前做边界检查;连接须设 binaryType="arraybuffer"、自动重连(指数退避)、卸载时清理;遥操作 twist 以 100Hz 发送、心跳 10Hz,断开时不得发送命令。
  4. 安全特性:监听 document.visibilityState,标签页隐藏时清零输入并停止命令;提供醒目的 E-Stop 按钮并即时发送急停命令。
  5. 输入处理(useGamepad.ts、useKeyboard.ts):手柄用 requestAnimationFrame 轮询、应用死区、轴归一化到 [-1,1];键盘用全局监听与按键集合跟踪,输入归一化,避免拦截文本框输入,卸载时移除监听。

适用场景:对上述仓库中遥操作前端代码进行评审、发现状态管理/协议/安全缺陷。限制:资料未提供安装或运行命令,未说明收费、价格、平台兼容性及具体使用步骤;部分内容(如键盘输入转换)在资料中未完整给出。