@nova-infra/d2c 把 Figma 设计信息整理成稳定、可复用的实现输入

把设计稿整理成稳定的实现上下文

nova-d2c 负责把 Figma 文件、节点、树、tokens、资源和 handoff 包稳定导出来,方便直接接入实现、评审、脚本和交付流程,也适合复用到 Web、Mobile、Desktop 和内部工具链。

快速开始
$ npm install -g @nova-infra/d2c
$ nova-d2c doctor
$ nova-d2c --json handoff build "https://www.figma.com/design/xxx" --node-id 1:2 --out ./handoff
你最终拿到
结构化 JSONfile, node, tree, tokens
稳定资源assets export + manifest
handoff 包直接进入后续实现流程
清晰命令面可脚本化,可组合,可缓存
为什么用它

不是“看图猜 UI”,而是把设计事实抽出来

CLI 的职责被故意收得很窄:只做设计上下文,不把实现、预览、评分混在一起。这样边界清楚,输出也更稳。

文件级

先看结构,不要盲取节点

从文件级 overview 开始,把页面、组件、样式和变量先摸清楚,再决定真正要抽取哪个节点。

节点级

resolve 与 get 分开,发现和提取职责清楚

先 `nodes explore` / `nodes resolve` 找目标,再 `nodes get` / `tree get` / `tokens` 取精确结果,脚本里更好编排。

交付级

直接可交付的 handoff 包

最终交付不是散乱字段,而是整理好的 handoff 目录,方便进入真正的实现流程。

Workflow

从 Figma 文件到 handoff 包

这条链路是当前产品的主路径:检查环境,发现目标,抽取上下文,导出资源,再把 handoff 接进后续实现流程。

输入 文件与目标节点
files get文件级摘要、页面结构、组件和全局信息
nodes explore / resolve发现候选节点,解决 node-id 对齐问题
nodes get / tree get / tokens提取节点上下文、树结构和样式变量
输出 可交付上下文
assets export把图片资源和 manifest 拉平,便于实现阶段复用
handoff build生成可直接进入后续流程的 handoff 目录结构
request get / --describe用来做自描述、探测和平台集成
Commands

当前命令面

对外只保留设计上下文相关命令,不再保留旧 `explore / get / images` 的兼容叙述,也不承载代码生成闭环。

discover + extract
$ nova-d2c doctor
$ nova-d2c init

$ nova-d2c --json files get <figma-url|file-key>
$ nova-d2c --json nodes explore <figma-url|file-key>
$ nova-d2c --json nodes resolve <figma-url|file-key> --name "login button"
$ nova-d2c --json nodes get <figma-url|file-key> --node-id 1:2
assets + handoff
$ nova-d2c --json tree get <figma-url|file-key> --node-id 1:2
$ nova-d2c --json tokens styles <figma-url|file-key> --node-id 1:2
$ nova-d2c --json tokens variables <figma-url|file-key> --node-id 1:2
$ nova-d2c --json assets export <figma-url|file-key> --node-id 1:2 --out ./assets
$ nova-d2c --json handoff build <figma-url|file-key> --node-id 1:2 --out ./handoff
$ nova-d2c --describe --format skill
Boundary

边界清楚,接入才稳定

这里最容易被误解。nova-d2c 不是在 CLI 里直接写 React / Vue 页面,而是把 Figma 设计信息整理成实现阶段真正需要的上下文。

CLI 做的事

  • 对文件和节点做稳定抽取
  • 输出 tree、tokens、assets、handoff
  • 保持平台无关,方便接任意目标工程

CLI 不做的事

  • 不在命令里耦合具体框架代码生成
  • 不内置 dev server、视觉打分、自动迭代闭环
  • 不把“半成品编排器”伪装成 D2C 成品
Docs

首页讲定位,文档讲细节

文档页已经同步到 `@nova-infra/d2c` 当前命令面,包含完整命令表、选项说明和典型命令组合。

文档页包含 docs.html
doctor / init环境检查与本地配置初始化
files / nodes / tree从 discover 到 extract 的完整主流程
tokens / assets / handoff样式变量、资源导出与 handoff 交付
request / --describe自描述、探测与集成能力
立即打开 docs

需要具体命令、参数、命令表和示例时,直接进文档页,不用再翻 README。