# @all3dp/material-structure 中文文档

规范地址：https://npmcn.com/package/%40all3dp/material-structure/

版本：2\.32\.0
npm 元数据更新时间：2022-04-04T13:31:25.678Z
中文译文更新时间：2026-11-06T05:50:29.654Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40all3dp/material-structure
原文对照：https://npmcn.com/package/%40all3dp/material-structure/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.4 MB，599 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：6 个
- 首次发布：2018-01-03T15:56:30.196Z
- 最新版本发布：2020-03-19T06:24:18.209Z
- 近 30 天下载量：4651（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：121（近 12 个月 0 个）

## 中文简介

所有3dp 物质结构

## 安装

```sh
npm install @all3dp/material-structure
```

也可以使用：`pnpm add @all3dp/material-structure`、`yarn add @all3dp/material-structure`、`bun add @all3dp/material-structure`

## README

# 材料结构

## 编辑

整个材料结构被保存在./材料结构文件夹内. 请在这里编辑文件 .

## 进程

请只在特性分支上编辑, 绝不直接编辑主机 。 向主控程序提交拉动请求 . 如果您想要释放结构, 退出主机并运行 `npm run release major | minor | patch`。 。 。 . 这打倒了版本并创造了新的发行. 然后Travis将其部署到npm.

## 使用

输入的文件 `export` 应当由服务器导入.

## 结构

这个 `material-structure` 文件夹包含所有材料组。 都存起来了 输入 `material-groups` 文件夹. 每个材料组由一个文件夹代表,例如:. `metals`每个文件夹代表 一个材料组包含一个 `index.yml` 拥有该物质组的数据.

```
name: Metals
```

每个材料组包含一个 `materials` 文件夹持有此组内的所有材料 譬如说. `brass`。每个材料文件夹中又有一个 `index.yml` 代表联合国 物质.

```
name: Nylon
description: >-
  Nylon (polyamide) is a fantastic all-round material with great monetary value.
  Thanks to its strength and flexibility, it’s extremely versatile, suitable for functional parts, jewelry, and many more applications.
  When thin, it’s flexible enough for springs – when thick, it’s strong enough for functional parts.
  It comes in many colors, and its surface can be polished and dyed.
  This material is 3D printed on industrial grade 3D printers, offering the highest quality, using a process called selective laser sintering (SLS).
featuredImage: gallery/material-sf.jpg
descriptionShort: 'Best, cheap all-round material'
```

还有个文件夹 `finish-groups` 拥有属于 材料,例如: `polished`。完成组文件夹中也有一个 `index.yml` 表示 它的数据.

```
properties:
  printingMethod: Selective Laser Sintering (SLS)
  printingMethodShort: SLS
  printingServiceName:
    shapeways: Strong Flexible Plastic
    imaterialise: Polyamide (SLS)
    sculpteo: Nylon PA12
  materialSpec: EOS PA 2200 (PA 12)
  flexibility: 4
  levelOfDetail: 3
  freedomOfDesign: 4
  postProcessing: 4
  waterproof: false
  foodSafe: false
  dishwasherSafe: true
  interlockingAndEnclosedParts: true
  recyclable: false
materialName: Nylon
name: Raw
featuredImage: gallery/material-sf.jpg
description: >-
  Professionally 3D printed nylon, raw and dyed, with natural color options available.
descriptionShort: 'Solid or dyed nylon with a raw surface'
```

在完成组里有一个 `material-configs` 文件夹保存所有材料配置 为这组。 此文件夹中的所有文件都代表一个材料配置, 例如 .

```
name: Natural
color: Natural Multicolor
colorCode: '#98A0A3'
colorImage: color_images/sandstone_full_color.jpg
legacyId: '{}'
printingService:
  sculpteo:
    productionTimeFast: 2
    productionTimeSlow: 4
    materialId: color_plastic
    printingMethodShort: Binder Jetting
    printingMethod: Binder Jetting (Bronze Infusion)
    materialName: Composite Multicolor
  shapeways:
    productionTimeFast: 6
    productionTimeSlow: 8
    materialId: '26'
    printingMethodShort: Binder Jetting
    printingMethod: Binder Jetting (Bronze Infusion)
    materialName: Full Color Sandstone
  imaterialise:
    productionTimeFast: 6
    productionTimeSlow: 8
    materialId: 38cb671d-4df6-458c-9f17-85cf3d28b990
    finishId: cb1b1042-aff5-4c6c-af2a-96dfbbfcfa58
    printingMethodShort: Binder Jetting
    printingMethod: Binder Jetting (Bronze Infusion)
    materialName: Multicolor

```

## 模板

每个级别上都有文件开始表示下划线(`_`) (中文(简体) ). 这些模板继承了所有儿童的价值观.

例如文件 `_material.yml` 继承每个材料的所有属性 在此文件夹下的结构中.

## 订货材料

命令文件前缀为字符串 `1-...`。 。 。 .

## 重要

### 空的 YAML 文件

空文件需要包含内容 `{}` 这是雅姆尔的代表 空对象.

## 常见问题

### @all3dp/material-structure 是什么？

所有3dp 物质结构

### 如何安装 @all3dp/material-structure？

在项目目录运行 npm install @all3dp/material-structure，或使用 pnpm add / yarn add / bun add。

### @all3dp/material-structure 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/all3dp\_\_material-structure 是否存在。

### @all3dp/material-structure 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @all3dp/material-structure 可以商用吗？

@all3dp/material-structure 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @all3dp/material-structure 的下载量有多少？

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

### @all3dp/material-structure 还在维护吗？

最新版本 2\.32\.0 发布于 2020/03/19（6 年前）；至今共发布 121 个版本，其中过去 12 个月发布了 0 个；首次发布于 2018/01/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。