设计优化原则

网站离线缓存不生效，无法离线访问

1. 检查 Service Worker 注册是否成功，是否缓存资源；2. 修复缓存策略，确保关键资源被缓存；3. 清除旧的 Service Worker，更新缓存；4. 测试离线状态下的页面加载，确保功能正常

网站 OCR 识别文字重复或缺失

1. 检查图片清晰度，确保文字无模糊、遮挡；2. 修复 OCR 接口的识别参数，调整识别精度；3. 核实图片是否倾斜，先进行校正再识别；4. 处理识别结果后处理，去重或补全缺失文字

网站时间选择器无法选择特定时间段

1. 核实时间选择器的 disabledHours/disabledMinutes 配置是否正确；2. 修复时间段限制逻辑，确保允许的时间段正确；3. 确保时间选择器插件支持时间段限制功能；4. 处理动态调整时间段的场景，实时更新限制

网站表单文件上传进度不显示

1. 检查上传进度监听逻辑是否正确；2. 修复进度条渲染，确保百分比准确；3. 确保上传接口支持分片上传，返回进度；4. 测试不同文件大小，确保进度更新流畅

网站时间选择器无法选择 24 点以后的时间

1. 检查时间选择器的时间范围配置，是否限制了最大时间；2. 修复时间格式处理，24 点应转换为次日 0 点或特殊处理；3. 核实是否存在业务逻辑限制，不允许 24 点后操作；4. 调整时间选择器的显示格式，明确时间范围

网站第三方登录授权页面提示 “应用未审核”

1. 检查第三方平台（微信 / QQ）的应用审核状态，完成未审核流程；2. 核实应用的经营范围、回调地址是否与审核信息一致；3. 修复应用配置中的错误参数（如 APPID、APPSecret）；4. 测试沙箱环境授权是否正常，排查正式环境配置问题

网站支付宝支付后回调页面无法访问

1. 检查回调地址是否公网可访问，无防火墙拦截；2. 核实回调地址是否正确配置在支付宝商户平台；3. 修复回调接口的权限校验，确保仅支付宝服务器可访问；4. 处理回调参数的签名验证，避免伪造回调

网站视频画中画功能失效

1. 检查浏览器是否支持画中画 API；2. 修复画中画按钮事件逻辑；3. 确保视频元素满足画中画要求；4. 处理画中画切换时的状态保存

网站打印功能异常，样式错乱

1. 编写打印专用 CSS（@media print），优化打印样式；2. 隐藏打印无关元素（如导航、广告）；3. 确保打印内容完整，不被截断；4. 测试不同浏览器打印效果，统一优化