跳至主内容

05 · AI GENERATION RULES

AI 生成强约束清单

当 AI（Claude Code · Cursor · Copilot 等）为 POSX 生成代码或内容时，必须同时满足全部条目。人工 Review 时每一条都是硬性门槛。

§1

颜色

  • 不得在 .tsx 硬编码 HEX；必须用变量时使用 var(--posx-*) 形式
  • 页面底/卡片/边框/正文只用语义 Token（bg-background · bg-card · border-border · text-foreground）
  • 品牌色用 bg-primary / text-primary，自动适配深色
  • 大面积渐变只用 6 条审批渐变，禁止即兴拼色
  • 同一视图禁止出现 2 个以上次级色（teal / gold / rose / azure）
DOclassName="text-posx-purple-600"
DON'Tstyle={{ color: "#6352CE" }}
§2

字体与排版

  • 标题 font-heading（Space Grotesk）· 正文 font-sans（Inter）· 标签/数字 font-mono
  • 字号用规范阶梯，禁止魔法值；Hero 特例除外
  • 金额 / 百分比 / 哈希 / 表格数字必须 tabular-nums
  • Eyebrow 统一 text-[11px] font-mono uppercase tracking-widest
DOclassName="font-mono tabular-nums"
DON'TclassName="text-[15px]"
§3

组件

  • 按钮/卡片/徽章/表单/弹窗必须从 @/components/ui/*（shadcn）引入，不得重新实现
  • 主 CTA 一律 <Button>（default = 品牌紫），一屏只允许一个
  • Logo 一律 <PosxLogo> 组件，禁止复制 SVG 路径或内嵌重画
  • class 合并用 cn()
DOimport { Button } from "@/components/ui/button"
DON'T<div className="..." onClick={...}>按钮</div>
§4

圆角与阴影

  • 圆角用语义类 rounded-sm/md/lg/xl/2xl/full（基于 --radius 派生）
  • 阴影用 shadow-xs/sm/md/lg/xl + --shadow-brand，禁止自定义阴影颜色
§5

暗色模式

  • 颜色优先用语义 Token（自动跟随主题）
  • 需分主题时用 dark: 变体，条件类必须成对出现
  • 不得在 React state 手动判断 theme 切换 className（主题管理组件除外）
DOclassName="bg-card dark:bg-posx-purple-900/40"
DON'Ttheme === "dark" ? "bg-navy-800" : "bg-white"
§6

动效

  • 入场动画包 <Reveal>，同组 delay={i * 0.05}
  • 过渡用 --dur-fast/base/slow + --ease-out
  • 必须兼容 prefers-reduced-motion
  • 禁止引入 GSAP 等大型动效库
§7

可访问性

  • <button> 必须 type="button"（除提交）；icon-only 按钮必须 aria-label
  • SVG：装饰 aria-hidden、语义 role="img" + aria-label
  • 表单 <label htmlFor> + aria-describedby
  • 触控目标 ≥ 44×44px
§8

文件与目录

  • 新组件 → components/ui/*（shadcn 生成）或 components/sections/*（业务区块）
  • 全局样式/新 Token → app/globals.css，必须同时定义 :root 与 .dark
  • 文档源 → docs/ 对应编号目录；资产 → assets/ 对应类目
§9

代码质量

  • TypeScript strict；禁止 any（必要时 unknown + 类型守卫）
  • Props 用 type 而非 interface
  • 服务端组件优先；有状态/浏览器 API 才 "use client"
  • 禁止 Lorem Ipsum 等占位残留
§10

内容合规（POSX 特有）

  • AI 生成的对外文案必须通过营销合规红线校验（无价格预测/收益承诺/多级返佣/虚假合作）
  • AI 生成图像必须标注 "AI-assisted" 并经审批；Prompt 禁用 cinematic / epic / hyperreal
  • 数据引用必须带 Source + As-of，不得编造数字
DO$23.8T（Source: World Bank · As of 2025）
DON'T「上市后预计 3–5 倍」