@ama-styling/figma-extractor

中文文档
15.3.1发布于 2026/11/10BSD-3-Clause构建来源已验证近 30 天下载 3290

从 Figma 文件提取 Design Token 的工具

中文使用文档
文档目录6 节
  1. 说明
  2. 如何执行
  3. 常见选项
  4. 提取单个图像文件
  5. 提取图像工程
  6. 设置自动化

Otter 图片解析器

Super cute Otter!

此软件包是 Otter 框架模块。 。 。 .

说明

Stable Version Bundle Size

此模块将提取 设计托肯 来自给定的 Figma 文件的元数据 .

如何执行

软件包暴露于命令: extract-file 财务报告和审定财务报表 extract-project。 。 。 .
两个命令提取 设计托肯斯 从一个文件但 extract-project 将会根据文件名图案和从中提取的版本来确定要提取的文件.

常见选项

选项信封变量说明
-- 帮助显示帮助
-一个, (中文(简体) ), -- 访问源 [弦]斐济语NAME访问 Token 读取 Figma 文件信息
- 欧, (中文(简体) ), --产出 [弦]图形图解要提取 Design Token 的文件夹
-没有, (中文(简体) ), 名称 [弦]FIGMA DT NAME (英语)设计托肯收藏的名称( 默认 ): "设计托肯斯"(中文(简体) )
动词确定日志是否显示调试信件( 默认 ): 虚假(中文(简体) )
- q (英语), (中文(简体) ), --静音确定是否在控制台中忽略信件( 默认 ): 虚假(中文(简体) )
- g, (中文(简体) ), -- 遗传软件包请求生成国家防范机制软件包.json(默认: 虚假(中文(简体) )
-- 包装Name [弦]Design Token收藏的版本(如果不提供 name 选项值将被使用)

提取单个图像文件

提取 设计托肯斯 从一个Figma文件.

npx @ama-styling/figma-extractor extract-file <fileKey> [options]

提取图像工程

提取 设计托肯斯 从一个工程的 Figma 文件部分.

npx @ama-styling/figma-extractor extract-project <projectKey> [options]

以下选项专门用于: extract-project 命令 :

选项信封变量说明
- 临, (中文(简体) ), -- 文件名 [弦](原始内容存档于2018-09-26). FIGMA PROJECT FILENAME MATCHER文件名的模式, 抓取其版本, 在工程中匹配( 默认 : "(?:[0-9]+\.]#0,2] [0-9]+(?:-[^]+?)$"(中文(简体) )
-- 版本范围要考虑的文件限制版本范围
项目关键 [弦](原始内容存档于2013-10-12). FIGMA PROJECT KEYFigma 工程密钥, 要提取的文件在哪里

设置自动化

完整文件可上网查阅 Figma 提取文档

版本与发布记录

@ama-styling/figma-extractor 共发布 693 个版本,首次发布于 2025/08/22;过去 12 个月发布了 543 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
15.3.1latest2026/11/10今天
15.4.0-prerelease.9prerelease2026/11/091 天前
15.4.0-prerelease.82026/11/073 天前
15.4.0-prerelease.72026/11/073 天前
15.3.0-rc.2rc2026/11/064 天前
15.4.0-prerelease.62026/11/064 天前

其他发布通道:next → 14.0.0-next.14,v13-updated → 13.5.13,v14-updated → 14.5.4,v15-updated → 15.1.3,rc → 15.3.0-rc.2,prerelease → 15.4.0-prerelease.9。

关于 @ama-styling/figma-extractor 的常见问题

@ama-styling/figma-extractor 是什么?

从 Figma 文件提取 Design Token 的工具

如何安装 @ama-styling/figma-extractor?

在项目目录运行 npm install @ama-styling/figma-extractor,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@ama-sdk/core(~15.3.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 figma-extractor,可以用 npx figma-extractor 直接运行。

@ama-styling/figma-extractor 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ama-styling__figma-extractor 是否存在。

@ama-styling/figma-extractor 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.22.3 || ^24.15.0 || ^26.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ama-styling/figma-extractor 可以商用吗?

@ama-styling/figma-extractor 使用 BSD-3-Clause 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括,不构成法律意见,请以许可原文为准。

@ama-styling/figma-extractor 的下载量有多少?

根据 npm 官方下载统计,@ama-styling/figma-extractor 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,290 次,日均约 110 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ama-styling/figma-extractor 还在维护吗?

最新版本 15.3.1 发布于 2026/11/10(今天);至今共发布 693 个版本,其中过去 12 个月发布了 543 个;首次发布于 2025/08/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。