# @drawcall/glts 中文文档

规范地址：https://npmcn.com/package/%40drawcall/glts/

版本：6\.1\.0
npm 元数据更新时间：2026-11-13T13:05:07.667Z
中文译文更新时间：2026-11-12T19:55:46.568Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：804 kB，208 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^22\.18\.0 \|\| \>=24\.11\.0
- 运行依赖：7 个
- peer 依赖：vite \>=6\.0\.0，three \>=0\.186\.0，typegpu ^0\.12\.0，typescript ^5\.0\.0 \|\| ^6\.0\.0
- 首次发布：2026-08-11T19:14:30.235Z
- 最新版本发布：2026-11-13T13:05:07.079Z
- 近 30 天下载量：5364（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 37 个）

## 中文简介

像GLTF,但程序三.js资产.

## 安装

```sh
npm install @drawcall/glts
```

也可以使用：`pnpm add @drawcall/glts`、`yarn add @drawcall/glts`、`bun add @drawcall/glts`

## README

# 枪声

**像GLTF,但程序三.js资产.**

A 类 `.glts` 文件是一个小的TypeScript脚本,它用普通的Tree.js代码构建一个场景. `GLTSLoader` 捡起并运行它 给你一个本地人 `THREE.Scene` 您可以在任何地方添加, 更新每个框架, 热重装, 并处理 .

使用GLTS 当一个资产比模型更容易写作代码时:程序几何,参数化或动画道具,或由AI编码代理所写的资产. 资产可以装入其他资产,通过帮助模块共享代码,实例为Tree.js `InstancedMesh`,导入 npm 包,并带来自己的预览中转和渲染设置.

GLTS 运行脚本作为代码,而不是在沙盒中. 只装入您信任的脚本 .

```sh
pnpm add @drawcall/glts three
```

## 使用量

脚本构建其资产 `scene` 它进口:

```ts
// public/crystal.glts
import * as THREE from "three/webgpu"
import { disposeRecursive, onDispose, onFrame, scene } from "@drawcall/glts"

const crystal = new THREE.Mesh(new THREE.IcosahedronGeometry(), new THREE.MeshNormalMaterial())
scene.add(crystal)

onFrame((delta) => {
  crystal.rotation.y += delta
})

onDispose(() => disposeRecursive(scene))
```

该应用程序像其他任何 Three.js 资产一样加载并使用 WebGPU 制作:

```ts
import { GLTSLoader } from "@drawcall/glts"
import * as THREE from "three/webgpu"

const renderer = new THREE.WebGPURenderer({ canvas })
await renderer.init()

const loader = new GLTSLoader(new THREE.LoadingManager())
const crystal = await loader.loadAsync("/crystal.glts")
scene.add(crystal)

const timer = new THREE.Timer()
renderer.setAnimationLoop((time) => {
  timer.update(time)
  crystal.update(timer.getDelta())
  renderer.render(scene, camera)
})
```

在虚拟应用程序中,添加 `glts()` 从 `@drawcall/glts/vite` 转到插件:公共脚本然后装入预编译并共享应用程序的软件包.

## 国 际

显示 a `.glts` 向巴布亚新几内亚提供资产或将其导出至GLB(节点22.18+或24.11+):

```sh
npx drawcall glts render asset.glts -o preview.png
npx drawcall glts render asset.glts -o views.png --views '[[{"camera":"+x"},{"camera":"persp"}]]'
npx drawcall glts export asset.glts -o asset.glb
```

渲染用途 [@drawcall/webgpu (英语)](https://github.com/drawcall-ai/webgpu),有或没有GPU,并包括预览中转;在节点.js中, `render(file, options)` 从 `@drawcall/glts/node` 返回与字节相同的 PNG。 导出排除并写入支持的几何、材料、纹理、外观和清晰的动画剪辑;程序框回调保留在 `.glts` 文档.

## 代理技能

其他一切(帮助者、构成、进取、渲染、再装入、包件和Vite插件)都记录在 [GLTS 技能](https://github.com/drawcall-ai/glts/blob/main/packages/glts/skills/glts/SKILL.md)。为您的编码代理安装它 :

```sh
npx skills add drawcall-ai/glts --skill glts
```

技术也飞入 `@drawcall/glts` npm 软件包在 `skills/glts/SKILL.md`这样 [技术-npm](https://github.com/antfu/skills-npm) 自动链接 `node_modules`,在您安装的版本中.

## 常见问题

### @drawcall/glts 是什么？

像GLTF,但程序三\.js资产\.

### 如何安装 @drawcall/glts？

在项目目录运行 npm install @drawcall/glts，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：three（\>=0\.186\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 glts，可以用 npx glts 直接运行。

### @drawcall/glts 支持 TypeScript 吗？

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

### @drawcall/glts 支持 ESM 还是 CommonJS？

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

### @drawcall/glts 需要什么版本的 Node\.js？

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

### @drawcall/glts 可以商用吗？

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

### @drawcall/glts 的下载量有多少？

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

### @drawcall/glts 还在维护吗？

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