1440×900 · 390×844
https://www.joshwcomeau.com

首屏结构、分享卡片与基础配置

标题层级与首屏入口高信息密度
H1×1 · H2×6
H1
H2
H2
H2
H2
H2
H2
首屏主动作courses
Next.jsTailwindlang=en

正文

1011

操作候选

11

内/外链

59/9

HTML

116 KB

分享预览与标题长度og:image ✓

joshwcomeau.com

Josh W. Comeau

Friendly articles and tutorials for front-end web developers. ❤️

标题字数14 字 · 理想区间
摘要字数64 字 · 理想区间
响应头与资源构成3/6
HTTPS
HSTS
CSP
nosniff
Viewport
JSON-LD
脚本15 ext · 16 inl
图片 Alt 覆盖率0/4 (0%)
第三方域1 个域名

好设计,具体好在哪

鲜明色彩性格与高可读正文兼得

天蓝色只留在页眉营造氛围,进入文章区立刻切回高对比白底黑字,既有趣又不伤阅读体验。

音效与暗色开关体现交互匠心

顶栏显式提供关闭音效与切换暗色模式的无障碍按钮,细节考虑周全。

最值得先改的几件事

  1. 01

    在首屏更清楚地托出旗舰课程入口

    首次访问者视线被最新博客占满,核心付费课程仅藏在顶部小字导航 courses 中。

    在右侧栏或头图下方放置一张克制的课程代表卡片,核对手机端单列重排后的曝光位置。

配色、字体排印与代码变量

浅色底 · 电光蓝 / 青正文对比度 12.3:1 AAA
点击任意色块直接复制 HEX
joshwcomeau.com

Wotfard

ABCDEFGHIJKLMNOPQRSTUVWXYZ · 0123456789

晴空蓝渐变天际、云朵分层与圆润的 Wotfard 字体,让前端技术博客充满手工玩具般的亲和力与愉悦感。

字阶比例

32px / 16px

标题约为正文 2.00×

阅读节奏

行高 24px

字重 700 · 字距 normal

圆角轮廓

0px按钮
0px卡片
/* Extracted design tokens from joshwcomeau.com via VibeCheck */
:root {
  --color-bg: #a0d4ee;
  --color-surface: #fcfcfc;
  --color-ink: #0a0c10;
  --color-accent: #3b5ccc;
  --color-muted: #243c84;
  --font-display: "Wotfard", system-ui, -apple-system, "PingFang SC", "Noto Sans SC", sans-serif;
  --font-body: "Wotfard", system-ui, -apple-system, "PingFang SC", "Noto Sans SC", sans-serif;
  --text-h1: 32px;
  --text-body: 16px;
  --leading-body: 24px;
  --tracking-display: normal;
  --radius-button: 0px;
  --radius-card: 0px;
  --space-section: 0px;
  --space-card: 0px;
  --shadow-surface: rgba(0, 0, 0, 0.02) 0px -5.9px 2.7px 0px, rgba(0, 0, 0, 0.024) 0px -1.2px 6.9px 0px, rgba(0, 0, 0, 0.03) 0px 8px 14.2px 0px, rgba(0, 0, 0, 0.04) 0px 21.9px 29.2px 0px, rgba(0, 0, 0, 0.07) 0px 49px 80px 0px;

  /* Source custom properties sample */
  --syntax-bg: rgb(232, 241, 252);
  --syntax-fn: rgb(62, 91, 254);
  --top-color: rgb(17, 27, 39);
  --color-info: rgb(68, 51, 255);
  --color-text: rgb(10, 12, 16);
  --dark-color: rgb(0, 43, 255);
  --sp-space-1: 4px;
  --sp-space-2: 8px;
}

参数来自页面元素采样,空值表示未取得;不将单个元素的参数当作全站规范。

逐项依据

在首屏更清楚地托出旗舰课程入口

转化

首次访问者视线被最新博客占满,核心付费课程仅藏在顶部小字导航 courses 中。

→ 在右侧栏或头图下方放置一张克制的课程代表卡片,核对手机端单列重排后的曝光位置。

desktop.png: courses appears only as a small top nav item

没有 Content-Security-Policy

上线

CSP 是限制脚本源的标准做法。vibe 页面常常什么都加载,包括被注入的脚本。

→ 先开 report-only CSP,再收成 default-src 'self' 和明确的 script-src。

content-security-policy missing

没有 X-Content-Type-Options

上线

没有 nosniff,浏览器可能按错误类型解释文件。这是一行响应头。

→ 设置 X-Content-Type-Options: nosniff。

x-content-type-options missing

没有 Referrer-Policy

上线

默认 referrer 可能把站内路径和查询串漏给第三方。

→ 设置 Referrer-Policy: strict-origin-when-cross-origin。

referrer-policy missing

直接复制给你的 AI Agent

按需切换修复当前页、做同款参考、导出 DESIGN.md 或保存为项目级 SKILL.md。

粘贴到 Claude Code / Cursor 对话框查看全局品味规范 →
请基于 https://www.joshwcomeau.com 的 2026-11-11T06:46:41.168Z 页面快照优化当前项目。先确认当前实现与快照差异,不要把已变化的内容重新改回旧版。

设计基线
顶部天蓝色插画头图承载手写风标志、分类导航与音效开关,波浪云层自然过渡到白底双栏:左栏按大间距排列深度长文摘要,右栏收纳主题标签与热门教程。
{
  "colors": [
    {
      "role": "bg",
      "hex": "#a0d4ee"
    },
    {
      "role": "surface",
      "hex": "#fcfcfc"
    },
    {
      "role": "ink",
      "hex": "#0a0c10"
    },
    {
      "role": "accent",
      "hex": "#3b5ccc"
    },
    {
      "role": "muted",
      "hex": "#243c84"
    }
  ],
  "fonts": {
    "body": "Wotfard",
    "display": "Wotfard",
    "stack": [
      "Wotfard"
    ]
  },
  "radius": {
    "button": "0px",
    "card": "0px",
    "field": ""
  },
  "space": {
    "section": "0px",
    "card": "0px"
  },
  "type": {
    "h1": "32px",
    "body": "16px",
    "weight": "700",
    "lineHeight": "24px",
    "letterSpacing": "normal"
  }
}
数据来自同次页面采集;字体、圆角和间距为具体元素采样,不代表全站唯一设计规范。空值为未取得。HTML 为源码体积,不是压缩传输量;脚本数为 DOM 标签数,不是请求数。

执行事项
1. 在首屏更清楚地托出旗舰课程入口
在右侧栏或头图下方放置一张克制的课程代表卡片,核对手机端单列重排后的曝光位置。
依据: desktop.png: courses appears only as a small top nav item

2. 没有 Content-Security-Policy
先开 report-only CSP,再收成 default-src 'self' 和明确的 script-src。
依据: content-security-policy missing

3. 没有 X-Content-Type-Options
设置 X-Content-Type-Options: nosniff。
依据: x-content-type-options missing

4. 没有 Referrer-Policy
设置 Referrer-Policy: strict-origin-when-cross-origin。
依据: referrer-policy missing

验收
- 在 1440×900 和 390×844 分别核对文字、布局和主要操作“courses”。
- 保留已有品牌、登录和业务链路,不从静态截图推断交互故障。
- 只修复有证据的项;涉及安全响应头时先用报告模式验证现有资源及认证兼容性。
- 对比修改前后的截图,并执行相关功能测试。不要声称未经测试的功能已通过。
全部气质库 →