文件级
先看结构,不要盲取节点
从文件级 overview 开始,把页面、组件、样式和变量先摸清楚,再决定真正要抽取哪个节点。
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
CLI 的职责被故意收得很窄:只做设计上下文,不把实现、预览、评分混在一起。这样边界清楚,输出也更稳。
从文件级 overview 开始,把页面、组件、样式和变量先摸清楚,再决定真正要抽取哪个节点。
先 `nodes explore` / `nodes resolve` 找目标,再 `nodes get` / `tree get` / `tokens` 取精确结果,脚本里更好编排。
最终交付不是散乱字段,而是整理好的 handoff 目录,方便进入真正的实现流程。
这条链路是当前产品的主路径:检查环境,发现目标,抽取上下文,导出资源,再把 handoff 接进后续实现流程。
对外只保留设计上下文相关命令,不再保留旧 `explore / get / images` 的兼容叙述,也不承载代码生成闭环。
$ 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
$ 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
这里最容易被误解。nova-d2c 不是在 CLI 里直接写 React / Vue 页面,而是把 Figma 设计信息整理成实现阶段真正需要的上下文。