# 3dtiles-inspector 中文文档

规范地址：https://npmcn.com/package/3dtiles-inspector/

版本：0\.3\.3
npm 元数据更新时间：2026-08-31T03:35:19.275Z
中文译文更新时间：2026-11-07T00:03:34.921Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/3dtiles-inspector
原文对照：https://npmcn.com/package/3dtiles-inspector/?lang=original
项目主页：https://github.com/WilliamLiu-1997/3DTiles-Inspector#readme
源码仓库：https://github.com/WilliamLiu-1997/3DTiles-Inspector

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

- 包体积（解压后）：6 MB，75 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：1 个
- 首次发布：2026-04-23T12:53:09.891Z
- 最新版本发布：2026-08-31T03:35:18.914Z
- 近 30 天下载量：2138（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）

## 中文简介

在交互式浏览器会话中检查,对齐,并保存本地的3D平面根会变.

## 安装

```sh
npm install 3dtiles-inspector
```

也可以使用：`pnpm add 3dtiles-inspector`、`yarn add 3dtiles-inspector`、`bun add 3dtiles-inspector`

## README

# 3名DTILES-检查员

[![npm version](https://img.shields.io/npm/v/3dtiles-inspector)](https://www.npmjs.com/package/3dtiles-inspector) [![CI](https://github.com/WilliamLiu-1997/3DTiles-Inspector/actions/workflows/ci.yml/badge.svg)](https://github.com/WilliamLiu-1997/3DTiles-Inspector/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://npmcn.com/package/3dtiles-inspector/LICENSE)

![3DTiles-Inspector](https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/3DTiles-Inspector.png)

`3dtiles-inspector` 是一个 Node.js 软件包和 CLI ,用于在浏览器检查器中打开一个本地的 3D 平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平.

要求节点.js 18或更新.

## 内建于

该项目基于并综合了以下工作:

-   [威廉·柳-1997/3D-Tiles-渲染器JS-3DGS-Plugin](https://github.com/WilliamLiu-1997/3D-Tiles-RendererJS-3DGS-Plugin)
-   [威廉·柳-1997/高士-斯柏特-利特](https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite)
-   [美国航天局-AMMOS/3 DTILESRENderJS](https://github.com/NASA-AMMOS/3DTilesRendererJS)

## 安装

```bash
npm install 3dtiles-inspector
```

## 国 际

```bash
3dtiles-inspector <tileset_json>
```

```bash
npx 3dtiles-inspector <tileset_json>
```

从克隆寄存器 :

```bash
npm run cli -- <tileset_json>
```

CLI 启动本地host HTTP 服务器, 将已建检查员资产复制到临时目录中, 打开默认浏览器, 并持续运行, 直到您停止它 `Ctrl+C`。 。 。 .

`<tileset_json>` 可以是:

-   例如,根平板 JSON 文件 `out_tiles/tileset.json`
-   包含 `tileset.json`

## 节点 API

```js
const { runInspector } = require('3dtiles-inspector');

(async () => {
  await runInspector('./out_tiles/tileset.json');
})();
```

如果您需要自行控制浏览器的启动或管理会话生命周期:

```js
const {
  resolveAndValidateTilesetPath,
  startInspectorSession,
} = require('3dtiles-inspector');

(async () => {
  const tilesetPath = resolveAndValidateTilesetPath('./out_tiles/tileset.json');
  const session = await startInspectorSession(tilesetPath, {
    openBrowser: false,
    handleSignals: false,
  });

  console.log(session.url);

  await session.close();
})();
```

## 检查员特征

![screenshot](https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/screenshot.png)

-   `Translate`, (中文(简体) ), `Rotate`,无限 `Scale` 音轨/值输入,以及 `Reset` 用于根变换编辑
-   `Move Camera` 至 WGS84 纬度/经度/高度
-   `Move Tiles` 以 ENU 相通的转换来迁移平板根
-   `Set Position` 以单击地球、地形或已装入的瓷砖,并将瓷砖放在那里
-   `Terrain`默认情况下,在进入铯离子代号后切换铯世界地平线,同时保存卫星图像
-   `Render on demand`,默认情况下启用,以在场景闲置时暂停画布渲染
-   `Geometric Error` 从 `1/16x` 改为 `16x`
-   `Layer Multiplier` 从 `1/8x` 改为 `8x` 每块瓦片与瓦片全球叶基线的几何-误差
-   `Crop Regions` 用于绘制屏幕空间 排除区域或3D高斯平板砖上的收割球体
-   `Save` 以持久地将 root 转换编辑器、 几何- error 缩放和确认的裁剪选择返回磁盘

### 作物区域

`Crop Regions` 当装入的平板上包含3D高斯克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 它允许您绘制一个或多个屏幕空间, 排除矩形或定义单一的裁剪球体, 在查看器中预览, 然后单击时应用裁剪 `Save`。 。 。 .

对于屏幕区域:

1.  点击 `Draw Region` 然后将一个矩形拖到花板上取出.
2.  在移动相机前,如果屏幕区域需要调整,拖动待取的角点或侧控;待取的形状必须保持对流四面屏幕四边形.
3.  旋转,平板,或放大相机,以3D来固定待定的屏幕形状,然后拖动远平面的手柄来设定作物区域延伸到场景的深度.
4.  点击 `Confirm` 将区域添加到保存列表中,或 `Cancel` 以丢弃待决矩形.
5.  如果您需要调整带有变换柄的3D远平面, 请选择确认的区域行 .
6.  点击 `Save` 在已确认的作物地区持续进行根变和去掉花板.

在作物领域:

1.  点击 `Create Sphere` 将一个球体置于当前平板中心.
2.  以半径轨调整半径,或选择行并用球心局部-坐标变换柄移动.
3.  点击 `Confirm` 隐藏球体外的花板,或 `Cancel` 把它丢掉.
4.  点击 `Save` 清除确认球体外的花板.

![Crop Regions](https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/region.png)

支持本地保存作物重写 `.gltf` 编号 : `.glb` 使用高斯平板资源 `KHR_gaussian_splatting_compression_spz_2`。完全删除的平板原生被从他们的glTF中去除,而空的平板内容可以从平板 JSON中被刷去. 远程内容和不支持的高斯克特编码被否决,而不是被修改.

若为 `build_summary.json` 存在于根平板旁边, `Save` 还更新:

-   `root_transform`
-   `root_transform_source`
-   `root_coordinate`
-   `viewer_geometric_error_scale`
-   `viewer_geometric_error_layer_scale`

## 发展

```bash
npm install
npm test
npm run pack:check
```

## 处理错误

运行时间和验证失败 `InspectorError` 从节点API中打印出简明错误信息.

## 常见问题

### 3dtiles-inspector 是什么？

在交互式浏览器会话中检查,对齐,并保存本地的3D平面根会变\.

### 如何安装 3dtiles-inspector？

在项目目录运行 npm install 3dtiles-inspector，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 3dtiles-inspector，可以用 npx 3dtiles-inspector 直接运行。

### 3dtiles-inspector 支持 TypeScript 吗？

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

### 3dtiles-inspector 支持 ESM 还是 CommonJS？

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

### 3dtiles-inspector 需要什么版本的 Node\.js？

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

### 3dtiles-inspector 可以商用吗？

3dtiles-inspector 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### 3dtiles-inspector 的下载量有多少？

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

### 3dtiles-inspector 还在维护吗？

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