工具与配置
前端实践
来源:AGY Hub 工程复盘
用 Google Stitch DESIGN.md + Starwind UI 治好前端「AI 味」
为什么只靠长提示词做不好页面?复盘 AGY Hub 从手写深蓝霓虹到 Stitch Tonal Layering + 零 React Astro 静态架构的实战经验。
AI 生成前端为什么总是一股模板味?
未受约束的编码助手很容易默认滑向三件套:深青紫渐变背景 + 1px 发光边框 + 卡套卡弹窗。仅仅在对话里写「请做高级一点」,过几轮迭代就会失效。
社区验证有效的三层约束
- 一份可校验的
DESIGN.md契约:把 Surface 层级(surface→surface-container-lowest→surface-container-low)、字阶与 No-Line Rule(能用背景色阶分层就不画硬边框) 写进根目录,并通过官方 CLI 校验对比度与导出 CSS@theme:
bash
pnpm run design:lint
pnpm run design:export- 避免 Tailwind v4 令牌命名踩坑:
DESIGN.md里的spacing键名应使用语意前缀(如gutter-lg),不要使用 barelg,否则导出的--spacing-lg会覆盖max-w-lg弹窗宽度。 - 能静态就不要强行上重框架:对于比价表、文档与快讯门户,采用 Astro + Tailwind v4 + Starwind UI 原生
.astro组件,搭配几 KB 的原生 ESM + Cloudflare Worker 动态 JSON 下发,首屏与总 JS 体积可控制在 60 KB 以内,同时完美吃满 Cloudflare 免费无限流量 CDN。