getdesign

什么是 getdesign？

getdesign 可以从公开网站中提取设计系统。它会在真实浏览器中打开网站，读取网站的 CSS 并捕获渲染后的页面，然后将颜色、字体、间距和组件写入一个基于网站实际 CSS 的 design.md 文件。输出内容可作为样式指南阅读，也可在构建界面时作为上下文提供给编码代理。

该工具提供五种使用方式，它们共享同一个代理核心，此外还有一个可在编码代理内运行的 Skill。目前处于测试阶段，托管运行依赖你自己的提供商密钥，而不是 getdesign API 密钥。

如何使用 getdesign？

网页仪表盘

登录仪表盘，在「账户」中保存你的 Daytona 和 OpenAI 密钥，然后将公开网站 URL 粘贴到「代理」中以生成 design.md。你也可以在不运行提供商的情况下浏览缓存的示例。

API

在 api.getdesign.app 上调用 GET /v1/design 可返回 Markdown 或 JSON。需要 WorkOS 持有者身份验证和提供商密钥。

CLI

在 Bun 上运行 bunx @getdesign/cli，并提供你的 Daytona 和 OpenAI 密钥。它会将 design.md 写入本地文件。

SDK

使用 bun add @getdesign/sdk 安装 @getdesign/sdk，即可在 Bun 上进程内运行代理，获得带类型的结果和进度事件，并使用你的提供商密钥。

Skill

使用 skills add MohtashamMurshid/getdesign 添加可移植的 SKILL.md。它可在 Claude Code、Codex 或 Cursor 内运行，使用代理自带的工具。

getdesign 的核心功能

设计系统提取

getdesign 读取公开网站的 CSS 令牌，在浏览器中捕获页面，并生成涵盖颜色、字体、间距和组件的设计文档。

design.md 输出

结果以描述网站设计系统的 Markdown 文档形式提供。可视化运行还会包含捕获的截图。

多种访问方式

Web、API、CLI 和 TypeScript SDK 访问同一个代理核心；Skill 在你自己的编码代理内运行。CLI 和 SDK 在 Bun 上本地运行，而 HTTP API 支持托管运行。

私有运行与可选发布

仪表盘中的运行在发布前保持私有。发布后会创建一个任何人都可以查看和下载设计文档及截图的链接；你可以将运行重新设为私有以关闭未来访问，但已下载的副本仍保留在接收者手中。

getdesign 的用例

从线上网站生成样式指南

从公开网站生成可读的设计文档，描述其颜色、字体、间距和组件。

为编码代理提供设计上下文

将生成的 design.md 及其截图传递给编码代理，或安装 Skill，让代理使用自己的工具提取设计上下文。

在本地或托管工作流中运行提取

使用 CLI 或 TypeScript SDK 在 Bun 上进行本地运行，或使用 HTTP API 进行托管运行并返回 Markdown 或 JSON。

分享设计文档

发布仪表盘运行以创建链接，其他人可通过该链接查看和下载设计文档及截图。

关于 getdesign 的常见问题

什么是 design.md 文件？

design.md 是描述网站设计系统的 Markdown 文档。你可以将其作为样式指南阅读，或在构建界面时将其作为上下文提供给编码代理。可视化运行还会包含捕获的截图。

如何提取网站的颜色和字体？

在「账户」中保存你的 Daytona 和 OpenAI 密钥，然后将公开网站 URL 粘贴到「代理」中。getdesign 会读取 CSS 令牌，在浏览器中捕获页面，并生成可下载的设计文档。你也可以在不运行提供商的情况下浏览缓存的示例。

我可以将 getdesign 与编码代理一起使用吗？

可以。将生成的 design.md 及其截图提供给编码代理，或安装 getdesign Skill，使用代理自己的工具提取设计上下文。CLI 和 TypeScript SDK 也可在 Bun 上本地运行，HTTP API 支持托管运行。

是否需要身份验证或付费层级？

仪表盘使用 WorkOS 登录。托管运行需要你自己的 Daytona 和 OpenAI 密钥；V1 中没有 getdesign API 密钥。V1 不对 getdesign 运行计费。你需要为浏览器捕获向 Daytona 付费，为模型使用向 OpenAI 付费。

我的设计运行是公开的吗？

你的仪表盘运行在发布前是私有的。发布后会创建一个链接，任何人都可以通过该链接查看和下载设计文档及截图。你可以将运行重新设为私有以关闭未来访问，但已下载的副本仍保留在接收者手中。