# 前端工具平台审查与改造任务 请在当前项目中使用 Impeccable 和 UI UX Pro Max,完成前端工具/SaaS 平台的审查与改造。技能不存在时,报告缺失及替代方法,不得声称已经使用,不自行安装技能、依赖或执行远程脚本。 ## 本次上下文 - 项目目录:【填写项目路径;已绑定工作区时使用当前项目】 - 主要用户与核心任务:【填写;缺失时先从路由、产品文档与代码形成假设】 - 本轮目标:【填写具体页面/流程;默认先审查,避免全站重写】 - 使用范围:【填写桌面/移动/浏览器要求;未确认的范围不要扩写成已完成】 - 当前阶段:**A,只读审查。不得修改项目文件。** - 已有约束:保留业务逻辑、API 合同、路由、权限及现有组件库;不得迁移框架或擅自增加依赖。 先阅读适用的项目说明与设计规范。仅对会改变实现方向的缺失信息提问;能从代码核实的先自行核实。不要把以下规范当作新增业务、迁移框架或引入所有技术的授权。 ## A. 本轮先输出审查报告和计划 ### 1. 建立项目事实 识别并给出证据路径: - 框架及版本、构建工具、组件库、状态管理、路由、已有测试与启动命令。 - 入口、公共布局、页面、组件、composable、API 层的边界和复用情况。 - CSS 组织、主题变量、字号/间距/颜色/状态规范;区分全局和局部样式。 - 最重要的一条业务链:用户输入 → 请求 → 服务端状态 → 页面反馈 → 后续操作。 - 加载、提交、成功、失败、空、无权限、结果未知等状态及允许的转换。 - 现有性能基线、错误监控、部署/缓存方式。不存在或无法运行时如实标注。 不要读取或输出密钥、凭证、真实个人数据。截图和日志使用脱敏示例。 ### 2. 按功能选场景,不把清单机械套到所有页面 先列“适用 / 不适用 / 待核实”及理由。 - 数据表格:搜索、组合筛选、排序、分页、刷新、选中范围、跨页行为、批量操作。 - 表单:新增/编辑、默认值、约束、脏数据、离开提示、保存、字段错误、重复提交。 - 后台任务:排队、进度、部分结果、成功、失败、取消、重试、刷新后恢复。 - 上传/导出:仅在存在时检查大小/类型/编码/进度/取消/失败/大文件/文件名与内容安全。 - 账号/多租户:仅在存在时检查会话过期、角色、对象权限、切换工作区和缓存隔离。 - 实时数据/图表:仅在存在时检查断线重连、过期状态、时区单位、数据为空和频率。 - 支付/审批/协作/富文本:仅在存在时补齐其业务一致性、冲突和安全检查;不要顺便开发。 ### 3. 视觉与交互规范 - 专业工具以完成任务为目标;保持合理密度,不改成营销落地页。 - 用字号、字重、间距、对齐及少量分隔线建立层级。表格长标题、长数字、缺失字段、不同语言都要能读。 - 保留已有组件库的标准行为和可访问性语义,统一按钮、字段、状态标签、表格和反馈。 - 默认不添加图标。左侧导航图标只有在项目已有统一图标体系、且确实帮助识别稳定功能入口时才保留;同级入口的尺寸、线宽、对齐和含义保持一致,不给个别菜单单独加图标来装饰或制造主次。 - 操作图标只用于含义明确、无需猜测的常见动作;陌生操作配文字,图标不能代替状态说明。标题、概览、卡片和空状态不为填空添加装饰图标。 - 禁止闪电、火箭、星光、魔法棒、机器人等泛化科技装饰,也禁止用 emoji、混搭风格图标或换一种装饰图案来规避要求。 - 优先复用项目现有图标组件和图标集;项目没有时使用文字,不新增图标库或其他依赖。 - 不用彩色左/右竖线强调卡片、提示和列表;不用无意义渐变、动画、阴影堆叠或等权卡片网格。 - 状态不能只靠颜色;主操作、危险操作、不可用原因和下一步清楚可见。 - 加载不等于无数据;刷新不无故清空已有内容;错误不冒充空列表。 - 字段有可见标签,错误就近解释;键盘可完成核心流程,焦点可见、弹层可退出并合理返回。 - 文字和控件对比按实际颜色验证;不要只写“符合无障碍”。 ### 4. 鲁棒性与稳定性 逐项检查实际代码并说明前后端分工: - 搜索防抖、请求乱序、过期响应、筛选/分页联动与取消清理。请求取消后也要防止旧结果覆盖新状态。 - 列表、详情、重试响应之间的一致性:旧的详情轮询不能覆盖刚完成的状态变更。优先使用已有请求版本/更新版本机制。 - 请求超时、断网、5xx、无效响应、缺字段、401/403/404/409/422/429分别有什么用户反馈和恢复入口。 - 创建请求超时后,结果可能未知:先查状态/幂等查询,不把“未收到响应”直接当成“未创建”。 - 按钮锁定只防本页连点;后端幂等和状态校验另行核实。写操作不能盲目自动重试。 - 读重试有次数、退避、抖动和限流响应处理,不无限重试;失败时保留用户输入。 - 轮询避免请求重叠;按任务终态、页面离开、后台标签与网络状态适当暂停/降频并在返回时重验。 - 所有页面退出/组件卸载时清理定时器、监听、订阅和待处理请求;下载 Blob URL 在适当时机释放。 - 错误信息可理解且不暴露内部细节;日志可关联任务/请求,不记录凭证和敏感表单。 - 对数据丢失、重复任务、越权、错误取消等危险后果优先处理;“取消 HTTP 请求”不得冒充“取消服务端任务”。 ### 5. 性能:先测量,再选择优化 - 分开评估首次加载、交互响应、列表更新、请求和后端耗时,保留同条件前后数据。 - 记录测试设备、浏览器、页面、数据规模、网络条件、样本数及统计口径;构建耗时不等于用户响应时间。 - 大列表先评估服务端分页;只有 DOM/渲染确有瓶颈才考虑虚拟列表,不设武断的通用条数阈值。 - 检查重复请求、响应体大小、稳定 key、响应式范围、昂贵 computed/watch、重复排序和全量遍历。 - 路由/模块按需加载、依赖与图标按需引入、图片尺寸与懒加载;不为了优化添加未经批准的包。 - 重计算确实阻塞 UI 时,再评估 Worker/分块或后端处理;不要把大文件先全部读进前端内存。 - 缓存按用户/租户/查询隔离,定义失效策略;不能以缓存速度换取串数据或过期写入。 - Core Web Vitals 是可参考的页面体验指标;实验室结果不能冒充真实用户 P75,单次打开不证明达标。 - 性能预算按产品目标提出建议,等待确认;未测量时写“待测”,不编造评分或承诺提升比例。 ### 6. 安全边界 - 浏览器输入与参数均不可信;后端校验类型、长度、业务状态、对象所属及权限。 - 前端隐藏按钮、路由守卫、CORS、Origin 检查均不能代替服务端授权;多租户任务/文件访问逐对象验证。 - 默认文本渲染;不把用户内容当 Vue 模板,不直接交给 v-html/innerHTML/eval。必要富文本使用经批准的消毒方案,并检查 URL 协议和外链行为。 - 构建产物和前端环境变量均可被用户读取,不能放服务密钥。日志、埋点、错误追踪、截图也要脱敏。 - 沿用已批准的认证方案;Cookie 会话检查 HttpOnly/Secure/SameSite 及适配的 CSRF 防护。不要自动搬迁 token 存储或改变认证流程。 - 客户端文件校验只是体验:上传由后端检查类型、大小、内容、存储路径与权限;下载检查访问权与响应类型。 - CSV 不只转义引号,还需按目标软件和用途处理公式注入风险;无一套对所有下游都安全的通用转义。 - 检查已有 CSP、安全响应头与依赖漏洞;先报告影响,不为让功能跑通放宽保护或自动升级大版本。 - 不新增公网暴露、遥测、第三方 CDN 或数据外发。安全验证仅用本机/授权测试环境和无害样本。 ### 7. 交付只读报告 输出: 1. 项目事实与证据路径。 2. 核心流程、状态和场景适用表。 3. 问题表:优先级、触发条件、用户影响、证据、建议、负责层、回归方式。 4. 初步 Design System:颜色职责、字体/密度、布局、状态、图标纪律和可复用组件。 5. 一个最值得优先改造的页面,以及分批计划、影响范围、风险、验证和回滚方式。 6. 已验证 / 仅代码判断 / 未验证 / 不适用;不得用“全部通过”掩盖缺项。 优先级按影响确定:P0 为安全越权、数据损坏或主流程不可用;P1 为高频正确性/恢复/效率问题;P2 为低影响一致性和视觉细节。若某风险只在上线或多租户时成立,写清条件,不把本地演示直接判成生产事故。 报告后等待我确认,不修改文件。