polish

Polish

仅在授权的目标和范围内进行优化。

优化是精修，而不是暗中重新设计。保留现有的视觉风格、内容、行为以及范围之外的一切。如果概念本身有问题，请明确指出，并建议重新设计或采用 bolder，而不是悄悄替换方案。

检测结果是缺陷的证据，不是质量的证明。请检查实际呈现效果和真实交互路径。

1. 建立设计体系

阅读 DESIGN.md，以及有代表性的设计令牌、共享组件、设计模式和相邻流程。如果没有正式的设计体系，请遵循项目中一致的惯例。

修复前先对每项偏差进行分类：

• 缺少令牌： 设计体系需要一个可复用的值；
• 单次实现： 应使用现有的共享组件或设计模式替换；
• 概念不匹配： 该流程、信息架构或层级与产品中类似区域不同；
• 局部缺陷： 实现本身不完整或不一致。

在最恰当的最小范围内修复根因。如果无法推断某项具有约束力的设计原则，请先询问。

2. 收集证据

在界面的典型尺寸下亲自使用该功能：Web 端需在桌面端和移动端验证；原生平台（ios / android / adaptive）需使用项目支持的验证工具，在模拟器、仿真器或硬件上测试已发布的设备类别。确认：

• 流程在功能上是否完整；
• 预期的质量标准和可用时间；
• 已知限制或有意暂未完成的工作；
• 用户实际会遇到的状态、内容长度、角色和输入方式。

如果有之前的评审意见，请先确认其针对的目标和评估的版本，再参考其中的发现。过时的发现只是需要复查的线索，不是当前缺陷清单。无论如何，都要独立检查一遍。

3. 排定优先级

区分功能缺陷和外观问题，并按以下顺序修复：

1. 任务中断或受阻、数据丢失、状态误导，以及不可访问的路径；
2. 缺少加载、空、错误、成功、禁用和权限状态；
3. 流程、层级、响应式布局和设计体系偏差；
4. 视觉和动效不一致；
5. 代码和资源清理。

不要只打磨一个角落，却让其他部分仍低于相同的质量标准。

4. 打磨完整流程

流程和层级

• 与相邻区域的用户心智模型、术语、信息展开方式、路由、保存行为以及乐观或悲观更新模式保持一致。
• 清楚呈现主要任务和当前状态，但不要让所有元素的视觉权重都变得一样。
• 确保进入、转换、空状态和恢复路径彼此衔接，而不是各自孤立。

布局和排版

• 遵循项目的栅格和间距比例；既要修正几何对齐，也要修正视觉对齐。
• 紧凑组织相关内容，并为不同内容组留出充足间距。
• 确保相同角色的排版一致；测试行宽、换行、本地化后的文本扩展、缩放和字体加载。
• 验证所有受支持的视口，不要只针对当前截图修正。

颜色、图像和图标

• 使用语义化令牌，并确保不同主题下颜色含义一致。
• 验证所有状态下文本、控件和焦点的对比度。
• 确保图标集、线条／粗细、尺寸和视觉对齐协调一致。
• 避免图像造成布局偏移；使用正确的宽高比、响应式图片源和实用的替代文本。

交互和状态

• 每个控件都需要恰当的默认、悬停、焦点、激活、禁用、加载、错误和成功行为。
• 保持键盘焦点可见、Tab 顺序合理、标签清晰，并提供符合平台习惯的触控目标。
• 确保动效协调、可中断且高效。不要仅仅为了让优化效果显眼而添加动画。
• 对于产品可能遇到的内容，验证其在内容过长、缺失、本地化、离线、加载缓慢和权限受限等情况下的表现。

内容与代码

• 确保术语、大小写、标点和事实性文案保持一致。更改声明前先征求确认。
• 移除调试输出、无用代码、未使用的导入、过时的样式以及润色时产生的重复内容。
• 如果系统已提供相应模式，请用共享组件替换自定义实现。
• 将真正可复用的值提取为令牌；不要为单个局部例外创建系统抽象。

5. 验证并完成

再次用鼠标、键盘和触控（如适用）走查完整路径。检查：

• Web 端的移动端、中等和宽屏布局；原生端在两种受支持的屏幕方向下的手机和平板尺寸类别；
• 加载、空、错误、成功、禁用、长内容和内容缺失状态；
• 缩放、对比度、焦点、语义和屏幕阅读器名称；
• 所有环境中的控制台错误、布局偏移、交互延迟和图片加载情况；Web 端支持的浏览器；原生端支持的 OS 版本、运行时警告和丢帧情况；
• 与 DESIGN.md、相邻功能以及用户范围的一致性。

在获准的验证主机上运行项目相关的 QA 命令。 扫描结果干净并不能替代视觉判断。

最后检查源代码差异：移除意外改动、无主代码、冗余值和临时产物。只有当功能完整，并且完整路径上的体验始终完善一致时，才交付。