Agent-Friendly CLI

Figma 设计数据
为 AI Agent 而生

从 Figma 提取平台无关的设计数据 — 节点、组件、变量、样式 — 支持 AI 驱动的跨平台代码生成，覆盖 Web、移动端、桌面端和小程序。

$ echo "//registry.npmjs.org/:_authToken=YOUR_TOKEN" >> ~/.npmrc
$ echo "@nova-infra:registry=https://registry.npmjs.org" >> ~/.npmrc
$ npm install -g @nova-infra/d2c-cli
$ nova-d2c doctor
// 安装

几秒快速上手

1

创建 npm 访问 Token

登录 npmjs.com，在账户设置里创建只读 Token（如果你仍需要安装私有依赖）。

2

配置 npm 认证

echo "//registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN" >> ~/.npmrc
3

配置 npmjs 源

echo "@nova-infra:registry=https://registry.npmjs.org" >> ~/.npmrc
4

安装 CLI

npm install -g @nova-infra/d2c-cli
5

配置 Figma Token（全局）

echo 'export FIGMA_TOKEN=figd_your_token' >> ~/.zshrc && source ~/.zshrc

从 figma.com/developers 获取 Token

// 快捷使用

无需全局安装，直接跑起来

npx 临时执行单次命令，适合试用、CI 或快速验证环境。
npx -y @nova-infra/d2c-cli doctor npx -y @nova-infra/d2c-cli explore "https://www.figma.com/design/xxx"
bunx 如果你已经使用 Bun，可以直接运行同样的命令，无需全局安装。
bunx @nova-infra/d2c-cli doctor bunx @nova-infra/d2c-cli get "https://www.figma.com/design/xxx" --node-id 1:2
doctor 先检查 Token、API 与缓存，再决定是否继续提取。
explore / get / images 核心流程都可以直接通过 npx -y @nova-infra/d2c-cli ... 调用。
🔍

智能发现

nova-d2c explore 分析文件结构并推荐提取节点，减少试错成本。

📦

组件与变量提取

提取组件、变量、样式为平台无关输出，便于下游代码生成与复用。

🖼️

图片导出

导出 PNG/SVG 资源并生成 manifest，便于构建流水线自动化。

⚡

缓存复用

短 TTL 缓存减少重复 API 请求，后续 --only 过滤可直接复用。

🤖

Agent 就绪

结构化输出与自描述能力，适合被自动化 Agent 可靠调用。

🔗

平台无关

覆盖 Web、移动端、桌面端与小程序等多平台 D2C 场景。

// 命令

所需即所得

npx / bunx 无需全局安装，直接运行 doctor、explore、get、images 等命令。
doctor 检查环境配置：Token、API 连通性、缓存状态。
explore <url> 分析文件结构，输出推荐节点与建议下一步命令。
get <url> 提取设计数据；支持 --only 过滤与 --resolved 内联样式。
images <url> 导出 PNG/SVG 资源，带 manifest，适合自动化资源管线。
--describe 输出 CLI 能力 Schema（YAML/JSON/MD），供 Agent 自动发现。