impeccable:23个命令优化AI生成网页视觉,32.6k星

GitHub精选

AI生成的网页长得都一样?impeccable给出了23个命令的解决方案

用AI生成网页的开发者大概都遇到过这个问题:不管怎么调提示词,出来的东西总是同一个味道——Inter字体、紫蓝渐变、卡片套卡片、灰色文字配彩色背景、每个标题上面都顶着个圆角方块图标。这不是巧合,而是因为大多数模型都是在同一批SaaS模板上训练出来的。

Paul Bakaus创建的impeccable项目就是冲着这个问题来的。它本质上是一套设计语言系统,包含7个领域参考文件、23个命令和27条确定性反模式规则,旨在让AI生成的页面摆脱”模板味”。项目在GitHub已获32,600颗star,采用Apache 2.0许可证。

impeccable设计工具的反模式检测与修复示意图
impeccable通过23个命令帮助AI生成更具设计感的网页

七个参考文件覆盖前端设计的全部维度

impeccable的底层是七个领域参考文件,每次命令执行时都会加载。排版(typography)模块处理字体系统和模块化比例尺;色彩对比(color-and-contrast)模块使用OKLCH色彩空间,支持着色中性色和暗黑模式;空间设计(spatial-design)处理间距系统和视觉层级;动态设计(motion-design)关注缓动曲线和动画编排;交互设计(interaction-design)覆盖表单、焦点状态和加载模式;响应式设计(responsive-design)从移动端优先和容器查询入手;UX文案(ux-writing)则处理按钮标签和错误提示。

这七个参考文件配合一个”品牌与产品”语域调节器,能根据项目是品牌展示类还是产品工具类自动调整默认参数。

23个命令构成了与AI协作的设计词汇表。craft是完整的从规划到构建流程;audit跑技术质量检查(无障碍、性能、响应式);critique做设计评审;polish是发布前的最终打磨;bolder让平淡的设计更有冲击力,quieter则反过来降温;animate添加有目的的动效。每个命令都可以指定具体页面区域,比如/impeccable audit the header只检查页头。

27条反模式规则直接对标AI生成物的通病

反模式检测是impeccable最实用的功能之一。它明确列出了AI生成网页的常见病症并逐一提供修复方案:不要用被滥用的字体(Arial、Inter、系统默认);不要在彩色背景上用灰色文字;不要用纯黑或纯灰(始终加一点色彩倾向);不要把所有内容都包在卡片里或让卡片嵌套卡片;不要用弹跳缓动(bounce easing),因为它看起来已经过时了。

检测方式分两层:27条确定性规则通过CLI和浏览器扩展运行,不需要大模型参与,也不需要API密钥,纯靠正则和模式匹配。另外还有12条LLT评判规则,需要大模型进行语义层面的分析。独立的CLI命令npx impeccable detect src/可以直接扫描目录、单个HTML文件甚至URL,输出JSON格式的检测报告。

反模式检测才是impeccable最值得抄走的部分

Paul Bakaus曾在Google担任开发者关系工程师,后加入Vercel负责设计工具。他在项目中把AI生成物”长得都一样”这个问题拆解成了可操作的技术方案,而不是停留在”AI设计不够好”的笼统抱怨上。

27条确定性反模式规则的思路尤其值得其他工具借鉴:把”审美判断”转化成”可检测的模式”。比如”不要用弹跳缓动”可以精确匹配CSS中的cubic-bezier值,”不要在彩色背景上用灰色文字”可以通过计算前景色和背景色的对比度来自动判定。这种把主观设计偏好客观化的做法,远比让AI”做得好看一点”要有效。

不过impeccable也有它的局限。它的核心依赖是加载大量参考文件来引导AI行为,这意味着额外的token消耗。对于已经建立了完善设计系统的大型团队来说,这些参考文件可能与现有规范冲突,反而增加维护成本。但对于独立开发者和AI重度用户来说,这确实是目前解决”AI出图千篇一律”问题最系统化的尝试。


参考链接