二进制优先交付
项目已经切到二进制发布导向,npm 包只带二进制和最小元信息,不暴露运行时 JS 和 sourcemap。
nova-f2c 通过 Figma REST API 拉取节点,生成稳定、可复现、适合 Agent 继续加工的中间产物。 它不把业务编排塞进生成器,而是把结构、样式、资源组织和设计旁路先做扎实。
bun run verify:golden 是日常主门禁
preview.html、design-report.html、page.hints.json
为什么是 nova-f2c
这个项目的核心不是“把所有业务一把梭出来”,而是把 F2C 的一阶产物做稳定: 可复现的结构、样式、资源组织,以及方便后续 Agent 二转的设计旁路。
项目已经切到二进制发布导向,npm 包只带二进制和最小元信息,不暴露运行时 JS 和 sourcemap。
CLI 通过 Figma REST API 拉取节点 JSON,再进入 restapi-adapter 与 emit 链路,不依赖插件宿主运行时。
支持 page.hints.json、design-report.html、节点定位与规则旁路,让第二阶段改造有抓手。
生成链路
当前对外 CLI 聚焦 `web` 目标,但内部已经把 CLI、REST 适配、emit 装配和 hints 旁路分层收口, 不把公共行为写成散乱闭包。
从设计链接提取 file key 与 node-id,作为 CLI 的稳定入口。
通过 Figma REST API 拉取节点 JSON,不依赖插件环境与导出宿主。
经 restapi-adapter 转为内部可渲染会话,再进入 emit wiring 和 platform 输出。
同步生成预览、截图、hints 和设计报告,给验收与二次改造提供同一套事实来源。
产物输出
官网不靠空洞承诺,而是直接展示这个项目今天已经能稳定产出的东西。
preview.html
默认 Web 预览 HTML,是黄金样本和 drift 排查的核心比对对象。
design-report.html
图层、问题、截图与 HTML 高亮联动的设计分析报告,专门给设计评审和整改定位使用。
page.hints.json
节点、区块、规则、语义与交互提示结构化输出,适合作为 Agent 二转的旁路输入。
dist/nova-f2c
编译后的本地二进制。当前主验证链已经切到二进制路径,避免源码直跑与正式发布结果分叉。
二进制与验证
这不是一个“开发时跑 JS、发布时再想办法编 binary”的项目。发布思路从一开始就要求: 测试路径尽量与正式分发路径一致,避免两套结果。
bun run verify:golden 是日常主门禁,用于确认核心输出未发生非预期漂移。
当前 npm 发布白名单已收紧到 dist,闭源分发只保留二进制,不额外暴露源码资产。
规则旁路可通过 --design-rules <path> 导入项目,而不是把业务或评审策略塞进生成器主链。
业务状态、数据、路由、组件体系替换属于二阶工作,应由 Agent 在产物之上继续改,而不是反向污染 F2C 生成器。