GitHub 热榜换血：大爆款退场，四个精准切场景的小项目上位

import json
import openai

# 1. 定义设计质量规则集——这是你自己的"品味"的工程化表达
DESIGN_RULES = {
    "spacing": {
        "description": "所有模块间间距必须是 8px 的倍数（8、16、24、32），内部元素间距为 4px 倍数",
        "severity": "high"
    },
    "color_system": {
        "description": "主色、辅助色、中性色必须来自同一色板，禁止随意取色；文字与背景对比度 ≥ 4.5:1",
        "severity": "high"
    },
    "typography_hierarchy": {
        "description": "最多 3 个字号层级（标题/正文/辅助），标题用粗体，辅助文字用浅色，禁止出现第 4 种字号",
        "severity": "medium"
    },
    "alignment": {
        "description": "所有元素必须对齐到同一网格，不允许'差不多对齐'的情况",
        "severity": "medium"
    },
    "visual_rhythm": {
        "description": "页面必须有明确的视觉节奏：大标题 → 内容区 → 分隔 → 下一块，不能全是平铺列表",
        "severity": "low"
    }
}

# 2. 待检查的设计描述（可以是 AI 生成的，也可以是手写的）
DESIGN_DESCRIPTION = """
一个数据仪表盘页面：
- 顶部用 24px 高的蓝色标题栏，标题字号 18px
- 左侧是 200px 宽的导航，每项间距 12px
- 主区域有 3 个卡片，卡片之间间距 15px
- 卡片内标题 14px 深灰色，数据 20px 黑色，辅助说明 11px 浅灰
- 背景白色，卡片背景 #F5F5F5，标题栏 #1E88E5
"""

# 3. 构造检查 prompt
def build_audit_prompt(rules: dict, design: str) -> str:
    rules_text = "\n".join(
        f"- [{r['severity'].upper()}] {name}: {r['description']}"
        for name, r in rules.items()
    )
    return f"""你是一位资深 UI 设计审查员。请严格按照以下规则集，逐条检查给定的设计描述。

## 规则集
{rules_text}

## 待检查的设计
{design}

## 输出格式
请输出 JSON，格式如下：
{
  "violations": [
    {
      "rule": "规则名称",
      "issue": "具体问题描述",
      "suggestion": "修改建议，给出具体数值或颜色"
    }
  ],
  "overall_score": 0-100的设计质量评分,
  "summary": "一句话总结"
}

只输出 JSON，不要输出其他内容。"""

# 4. 调用 LLM 执行检查
client = openai.OpenAI()  # 需要设置 OPENAI_API_KEY 环境变量

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "system", "content": "你是 UI 设计质量审查 AI，只输出 JSON。"},
        {"role": "user", "content": build_audit_prompt(DESIGN_RULES, DESIGN_DESCRIPTION)}
    ],
    temperature=0.3  # 低温度保证审查一致性
)

# 5. 解析并展示结果
result = json.loads(response.choices[0].message.content)
print(f"设计质量评分: {result['overall_score']}/100")
print(f"总结: {result['summary']}\n")
print("发现的问题：")
for v in result["violations"]:
    print(f"  [{v['rule']}] {v['issue']}")
    print(f"    → 建议: {v['suggestion']}")

pip install openai
export OPENAI_API_KEY="sk-你的key"
python design_audit.py

设计质量评分: 55/100
总结: 间距和字号层级有多个违规，色彩体系基本合理但对比度需验证

发现的问题：
  [spacing] 卡片间距 15px 不是 8px 的倍数
    → 建议: 改为 16px 或 24px
  [typography_hierarchy] 出现 4 种字号（18/14/20/11），超出 3 层级限制
    → 建议: 合并为标题 18px、数据 16px、辅助 12px 三层
  [spacing] 导航项间距 12px 不是 8px 倍数
    → 建议: 改为 16px

def build_fix_prompt(violations: list, original_design: str) -> str:
    issues_text = "\n".join(
        f"- {v['rule']}: {v['issue']}（建议: {v['suggestion']}）"
        for v in violations
    )
    return f"""请根据以下审查问题，修改设计描述。逐条修正，不要遗漏。

## 审查发现的问题
{issues_text}

## 原始设计描述
{original_design}

## 要求
输出修正后的完整设计描述，包含具体的间距值、字号、颜色值。"""

fix_response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "user", "content": build_fix_prompt(result["violations"], DESIGN_DESCRIPTION)}
    ],
    temperature=0.5
)

print("\n修正后的设计描述：")
print(fix_response.choices[0].message.content)