项目2026-11-12 · 智涌AI

designlang 是什么:把网站设计规范量出来交给 Agent

designlang 头图:终端演示提取设计规范、slop 模板感打分、verify-ui 三档宽度比对和接入 MCP 的命令,标注 17 个以上输出文件、verify_ui 85 分及格、13.4.1 于 11 月 11 日发布

designlang 是一个开源命令行工具:给它一个网址,它用无头浏览器打开页面,从实际渲染的 DOM 里读出颜色、字体、间距、圆角、阴影、动效,导出成 DTCG Token、Tailwind 配置、shadcn 主题、Figma 变量和一份给 AI 看的 DESIGN.md。11 月初的 13.4 版本给它加了两样东西:slop 给页面的「AI 生成感」打分,verify-ui 拿你的品牌规范检查 Agent 刚写出来的界面。它同时提供 MCP 服务和 Agent Skill,MIT 许可,不用注册,也不要 API key。

它是什么

designlang 主体是一个 Node.js 命令行工具,底层用 Playwright 驱动 Chromium。按 README 的说明,它等页面网络空闲、字体加载完成后,在页面里一次遍历最多 5,000 个元素,每个元素取 25 项以上计算样式,再经 17 个提取模块去重、聚类、分类,最后由十几个格式化模块输出文件。同一套能力还做成了 MCP 服务、Agent Skill(extract-design)、Claude Code 插件,以及 VS Code、Figma、Raycast、Chrome 扩展和 GitHub Action。

仓库github.com/Manavarya09/design-extract(npm 包名 designlang)
作者Manav Arya Singh(个人项目)
许可证MIT
热度GitHub 5,051 星(GitHub API,2026-11-12 15:10 北京时间);npm 周下载 2,488 次(11-04 至 11-10);skills.sh 上 extract-design 累计安装 3.4K
运行要求Node.js 20 及以上;Chromium(designlang install-browser 下载,或回退到本机已装的 Chrome)
最新版本13.4.1(npm 发布于 2026-11-11 19:21,北京时间);13.4.0 带来 slop、verify-ui 和 MCP verify_ui

解决什么问题

让 Agent 写界面,最常见的毛病是风格对不上。你说「按我们官网的风格做个定价页」,它多半给你一个靛蓝紫渐变、居中大标题加三张卡片的通用页面,因为它根本不知道你的官网用几号圆角、主色是哪个十六进制值、间距是 4px 还是 8px 一档。

designlang 先把这些规范从线上页面里量出来,写成机器能读的 Token 和一份 DESIGN.md,Agent 照着写;写完再用 verify-ui 量一遍,列出哪里偏了、期望值是多少、实际值是多少。

slop 管的是另一件事:页面看起来有多「模板」。源码里列了十条可测的特征,包括靛蓝到紫色的渐变、全站只用 Inter 或系统字体、居中 Hero 下面跟三张一样的功能卡、零偏移大模糊的彩色发光阴影、卡片左侧粗色条、用 emoji 当图标、所有组件同一个圆角、「Supercharge your」这类套话标题、直接用 Tailwind 默认色板、整页文字居中。分数 0 到 100,越高越像模板。CHANGELOG 写明这套打分用 40 个手工网站和 30 个 AI 生成页面校准过。

先把规范量出来交给 Agent,写完再量一遍,偏差按像素和色值列出来。

怎么用

不装也能跑,第一次用先下浏览器:

npm i -g designlang
designlang install-browser          # 裸 Linux 加 --with-deps
designlang doctor                   # 检查 Node、Playwright、Chromium、网络

常用的几条命令:

npx designlang https://你的官网.com                           # 全量提取,输出到 ./design-extract-output/
npx designlang slop https://你的官网.com                      # 模板感打分,逐条列出命中的特征
npx designlang verify-ui localhost:3000 --brand DESIGN.md      # 本地页面对照品牌规范
npx designlang site 你的官网.com --max-pages 8                 # 多页合成一套规范 + 一致性评分
npx designlang apply 你的官网.com --dir .                      # 提取后直接写进当前项目

加 --emit-agent-rules 会额外生成 Cursor、Claude Code、CLAUDE.md、agents.md 的规则文件。需要登录才能看的页面,用 --cookie、--cookie-file 或 --header 传凭据。

接进 Agent 有三种方式,任选其一:

# 1. MCP(Claude Code)
claude mcp add designlang -- npx -y designlang mcp
# 2. Agent Skill(Cursor、Codex 等 40 多种 Agent)
npx skills add Manavarya09/design-extract
# 3. Claude Code 插件(/extract /grade /verify 等斜杠命令)
/plugin install Manavarya09/design-extract

MCP 的用法是异步任务:extract_design(url) 返回任务 id,用 get_job_status 轮询,完成后用 get_tokens、get_colors、get_typography、get_components、get_findings 取结果,compute_drift 对比两次提取,export 导出 dtcg、tailwind、shadcn、figma、css 或 design-md。启动时加 --output-dir ./design-extract-output,磁盘上已有的提取结果也会作为资源提供出来。

顺手的用法是:先对自家官网跑一次提取,把 DESIGN.md 放进仓库;在 CLAUDE.md 或 AGENTS.md 里写一句「写完页面调用 verify_ui 对照 DESIGN.md,直到 pass」。工具描述里说明每次检查耗时 20 到 60 秒。

源码与注意事项

我们读了仓库源码,src 和 bin 里没有找到遥测上报。主动联网的地方有两处:doctor 会请求一次 api.github.com 检查网络,--smart 模式会调用你配置的大模型接口(OpenAI、Anthropic 或赞助商 Atlas Cloud),不加这个参数就不会调用。

命令输入输出适合放在
designlang <url>任意网址Token、Tailwind、shadcn、Figma、DESIGN.md 等 17+ 文件项目开始前
slop网址0–100 模板感分数 + 命中特征设计评审
verify-ui网址 + DESIGN.md 或 Tokenpass/fail、品牌分、逐条偏差Agent 交付后、CI
site域名多页合成规范 + 一致性评分整理现有设计系统

适合谁 / 不适合谁

适合已经有官网或设计规范、想让 Agent 写出来的页面别跑偏的团队,以及想在 CI 里加一道「界面是否符合品牌」检查的前端。它和 Impeccable、Hallmark 这类设计 Skill 可以搭配:那些负责教 Agent 审美,designlang 负责测量和对照。

还没有任何设计规范、从零做品牌的项目,它能量的东西有限,先用 Taste Skill 这类工具定方向更合适。只想要一个配色板的话,这套工具偏重了。

最后

先对自己的网站跑一次 npx designlang slop https://你的网址,看看命中了哪几条模板特征,再决定要不要把 DESIGN.md 和 verify_ui 接进 Agent。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。