# @chestnutlabs/gcode-parser 中文文档

规范地址：https://npmcn.com/package/%40chestnutlabs/gcode-parser/

版本：0\.21\.1
npm 元数据更新时间：2026-11-04T01:31:29.380Z
中文译文更新时间：2026-11-09T12:41:38.108Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40chestnutlabs/gcode-parser
原文对照：https://npmcn.com/package/%40chestnutlabs/gcode-parser/?lang=original
项目主页：https://github.com/ChestnutLabs/gcode-preview#readme
源码仓库：https://github.com/ChestnutLabs/gcode-preview

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

- 包体积（解压后）：227 kB，37 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2026-07-24T01:23:30.081Z
- 最新版本发布：2026-11-04T01:31:29.049Z
- 近 30 天下载量：3075（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

工人安全 G-code 剖析生成 ToolpathIR (DD-003)的核心.

## 安装

```sh
npm install @chestnutlabs/gcode-parser
```

也可以使用：`pnpm add @chestnutlabs/gcode-parser`、`yarn add @chestnutlabs/gcode-parser`、`bun add @chestnutlabs/gcode-parser`

## README

# @ chestnutlabs/ gcode-parser (英语)

栗子实验室 G 代码预览堆栈的工人安全 G 代码剖析核心和会话客户端 (设计:DD-003). 参数 `.gcode` 编号 : `.gcode.3mf` **关闭主线** 输入 [`ToolpathIR`](https://npmcn.com/package/%40chestnutlabs/toolpath-core/README.md),带有流出输入,大型的渐进部分预览 档案 资源限制 取消 以及背后的对抗性输入.

```ts
import { GcodeParseSession } from '@chestnutlabs/gcode-parser';

const session = new GcodeParseSession(); // batteries worker: all dialects + .gcode.3mf
const result = await session.parse(bytes, {
  onPartial: (ir) => render(ir), // progressive preview
  onProgress: (p) => bar(p)
});
render(result.ir);
session.dispose();
```

> **字节被交给工人,而不是复制.** A 类 `Uint8Array` 转至 `parse()` 有缓冲器 被转移给劳动者,所以它是空的`byteLength === 0`)后来。 分析同一文件 ,例如用 `{ plate: 1 }`,保留副本并经过 `bytes.slice()` 每次都这样 通过已转移的字节拒绝 `E_POST_FAILED`; 会话保留 可用 .

## 工人

-   **电池默认值( 0 设置) :** 会议通过捆绑者本土创建自己的工人 `new Worker(new URL('./worker.js', import.meta.url))` 模式——所有支持的方言适配器 加号 `.gcode.3mf` 集装箱支持。 Vite解析出盒子(CI测试).
-   **滑动/ 自定义 :** (没有方言/容器),你自己的 通过 `createWorkerHandler(...)`,其他捆绑者,或严格的CSP环境.

电线选项接受方言选择、容器/平板选择(`plate` 用于多平台 `.gcode.3mf`),以及资源限制。 大部分应用程序应该通过 [`@chestnutlabs/gcode-preview-core`](https://npmcn.com/package/%40chestnutlabs/gcode-preview-core/README.md) 或框架适配器,而不是 直接说.

部分 [栗子实验室 G 代码预览](https://npmcn.com/package/README.md) 麻省理工学院

## 常见问题

### @chestnutlabs/gcode-parser 是什么？

工人安全 G-code 剖析生成 ToolpathIR \(DD-003\)的核心\.

### 如何安装 @chestnutlabs/gcode-parser？

在项目目录运行 npm install @chestnutlabs/gcode-parser，或使用 pnpm add / yarn add / bun add。

### @chestnutlabs/gcode-parser 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @chestnutlabs/gcode-parser 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @chestnutlabs/gcode-parser 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @chestnutlabs/gcode-parser 可以商用吗？

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

### @chestnutlabs/gcode-parser 的下载量有多少？

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

### @chestnutlabs/gcode-parser 还在维护吗？

最新版本 0\.21\.1 发布于 2026/11/04（5 天前）；至今共发布 25 个版本，其中过去 12 个月发布了 25 个；首次发布于 2026/07/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。