# @codepawlhq/67js 中文文档

规范地址：https://npmcn.com/package/%40codepawlhq/67js/

版本：0\.17\.0
npm 元数据更新时间：2026-11-09T20:42:56.205Z
中文译文更新时间：2026-11-10T07:28:27.696Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40codepawlhq/67js
原文对照：https://npmcn.com/package/%40codepawlhq/67js/?lang=original
项目主页：https://67js.codepawl.com/
源码仓库：https://github.com/codepawl/67.js

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

- 包体积（解压后）：3.9 MB，223 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.19\.0
- 运行依赖：1 个
- peer 依赖：manifold-3d 3\.5\.4，@dimforge/rapier3d-compat 0\.21\.0
- 首次发布：2026-10-09T06:22:34.587Z
- 最新版本发布：2026-11-09T20:42:55.864Z
- 近 30 天下载量：3454（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

AI代理驱动的3D引擎:一个MCP服务器,PNG预览和CPU或GPU导出到图像和视频

## 安装

```sh
npm install @codepawlhq/67js
```

也可以使用：`pnpm add @codepawlhq/67js`、`yarn add @codepawlhq/67js`、`bun add @codepawlhq/67js`

## README

[![67js: 3D engine that AI agents drive, over a Bistro street rendered by it](https://67js.codepawl.com/previews/banner.jpg)](https://67js.codepawl.com/)

[![npm version](https://img.shields.io/npm/v/@codepawlhq/67js?style=flat-square&label=npm&color=7CC765&labelColor=0A1D1A)](https://www.npmjs.com/package/@codepawlhq/67js) [![License: MIT](https://img.shields.io/badge/license-MIT-E9F5F0?style=flat-square&labelColor=0A1D1A)](https://npmcn.com/package/%40codepawlhq/67js/LICENSE) ![Node.js 20.19 or later](https://img.shields.io/badge/node-%E2%89%A520.19-4DB6FF?style=flat-square&labelColor=0A1D1A) ![MCP server for agents](https://img.shields.io/badge/agents-MCP%20server-F7C948?style=flat-square&labelColor=0A1D1A)

67js是一款WebGL2渲染器,其外加了地形,植被,人物,液体,车辆和介质输出等附加物. 一个场景是平面数据:每个部分都有几何,矩阵和材料. 一个代理通过一个MCP服务器来构建并更改一个场景,查看PNG预览并制作静态或MP4视频. 目标是能和Blender一样,能和3.j一样轻. [文件/目标](https://github.com/codepawl/67.js/blob/main/docs/goal.md) 定义每个部分. 见 [显示](https://67js.codepawl.com/showcase.html),则 [文档](https://67js.codepawl.com/docs.html),则 [代理人指南](https://67js.codepawl.com/llms.txt) 编辑 [更改日志](https://github.com/codepawl/67.js/blob/main/CHANGELOG.md)。 。 。 .

## 显示大小写

下面的每一张照片都是67js的渲染. 链接的在浏览器中打开直播.

<table><tbody><tr><td><b><a href="https://67js.codepawl.com/showcase.html?scene=airport" rel="nofollow noopener noreferrer">机场坡道</a></b></td><td><b><a href="https://67js.codepawl.com/showcase.html?scene=datacenter" rel="nofollow noopener noreferrer">AI 数据中心</a></b></td><td><b><a href="https://67js.codepawl.com/showcase.html?scene=port" rel="nofollow noopener noreferrer">集装箱港</a></b></td></tr><tr><td><a href="https://67js.codepawl.com/showcase.html?scene=airport" rel="nofollow noopener noreferrer"><img alt="An airport ramp with an airliner at its stand and the turnaround crew" src="https://67js.codepawl.com/previews/showcase-airport.webp" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td><a href="https://67js.codepawl.com/showcase.html?scene=datacenter" rel="nofollow noopener noreferrer"><img alt="A cutaway AI data center hall" src="https://67js.codepawl.com/previews/showcase-datacenter.webp" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td><a href="https://67js.codepawl.com/showcase.html?scene=port" rel="nofollow noopener noreferrer"><img alt="A container port with cranes and stacked containers" src="https://67js.codepawl.com/previews/showcase-port.webp" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td></tr></tbody></table>

<table><tbody><tr><td><b>Bistro咖啡馆一角</b></td><td><b>比斯特罗广场</b></td></tr><tr><td><img alt="A green corner restaurant with red awnings and a blue scooter in the Bistro scene" src="https://67js.codepawl.com/previews/bistro-cafe.webp" loading="lazy" decoding="async" referrerpolicy="no-referrer"></td><td><img alt="A large plane tree in a hedged circle on a Bistro plaza" src="https://67js.codepawl.com/previews/bistro-plaza.webp" loading="lazy" decoding="async" referrerpolicy="no-referrer"></td></tr></tbody></table>

## 安装

**让你的经纪人做.** 将此提示粘入克洛德码, Codex, Cursor,双子座CLI或OpenCode. 代理安装 包,读取指南并连接 MCP 服务器.

```text
Install 67js from npm as `67js@npm:@codepawlhq/67js` and connect its MCP server with `npx 67js-mcp`. Read
https://67js.codepawl.com/llms.txt first and follow it.
```

**Claude代码插件.** 一个指令增加了MCP服务器和两种技能. 服务器从已发布 npm 开始 软件包 `npx`,所以没有地方建设.

```text
/plugin marketplace add codepawl/67.js
/plugin install 67js@67js
```

**通过手**

```sh
npm install 67js@npm:@codepawlhq/67js
```

注册名称是 `@codepawlhq/67js`。命令在别名下安装 `67js`,因此进口量不会减少. 一揽子措施是无害环境管理。 工具需要Node.js 20.19或以后,渲染需要WebGL2浏览器.

## 快开始

```js
import { Renderer67, box, sphere } from '67js';

// Column-major 4x4 matrix: scale, then move.
const placed = ([x, y, z], [width, height, depth] = [1, 1, 1]) =>
  new Float32Array([width, 0, 0, 0, 0, height, 0, 0, 0, 0, depth, 0, x, y, z, 1]);

const parts = [
  {
    name: 'Floor',
    geometry: box(),
    matrix: placed([0, 0, 0], [8, 0.1, 8]),
    material: { color: [0.4, 0.42, 0.45], metallic: 0, roughness: 0.9, emission: 0 },
  },
  {
    name: 'Ball',
    geometry: sphere(48, 24),
    matrix: placed([0, 1, 0]),
    material: { color: [0.8, 0.3, 0.2], metallic: 0, roughness: 0.35, emission: 0 },
  },
];

const canvas = document.querySelector('canvas');
const renderer = new Renderer67(canvas, parts, { samples: 4, memoryBudgetMiB: 256 });
renderer.render({ eye: [4, 3, 6], target: [0, 1, 0] });
```

打电话 `renderer.updateParts(parts)` 以移动或重新显示部件而无需上传. 打电话 `renderer.resize()` 画布改变大小后,以及 `renderer.dispose()` 在更换出炉器之前. 这个 [指南](https://npmcn.com/package/%40codepawlhq/67js/docs/guide.md) 覆盖相机,灯光,效果和每个物质领域. 要从脚本中保存 PNG, 请使用 [调制自写菜单](https://npmcn.com/package/%40codepawlhq/67js/docs/guide.md#render-a-png-from-a-script-without-mcp)。 。 。 .

## 对于特工

该包包括一个MCP服务器,将一个代理连接到一个持续的浏览器渲染器. 服务器需要本地 Chrome 安装 .

```sh
npx 67js-mcp --backend gpu --memory 192
```

使用 `--backend cpu` 在一个没有GPU的机器上. 带着面包, `bunx 67js-mcp` 取同一种旗帜; CI 在每个拉请求中都会在包子下运行被包的服务器 . 代理作者 a [JSON 配方](https://npmcn.com/package/%40codepawlhq/67js/docs/agent-scene.md)组合 [灯和雾](https://npmcn.com/package/%40codepawlhq/67js/docs/agent-look.md)进口 [GLB 资产](https://npmcn.com/package/%40codepawlhq/67js/docs/agent-asset.md) 添加 [动议](https://npmcn.com/package/%40codepawlhq/67js/docs/agent-motion.md)。 。 。 . 它让 PNG 预览回放, 比较最多四个视图 [审查网格](https://npmcn.com/package/%40codepawlhq/67js/docs/agent-review.md) 运行 [提供工作](https://npmcn.com/package/%40codepawlhq/67js/docs/agent-render-jobs.md) 静态和MP4视频. 服务器不接受任意代码和远程资产URL. 这个 [MCP 参考](https://npmcn.com/package/%40codepawlhq/67js/docs/mcp.md) 列出其工具.

两种技巧教一个代理驾驶 MCP 工具: [建筑- 67js- scene](https://npmcn.com/package/%40codepawlhq/67js/skills/build-67js-scene/SKILL.md) 用于场景和材料,以及 [变相- 67js-媒体](https://npmcn.com/package/%40codepawlhq/67js/skills/render-67js-media/SKILL.md) 用于图像和视频导出. 对于纯文本指南,请给代理 [页:1](https://67js.codepawl.com/llms.txt)。 。 。 .

[页:1](https://github.com/codepawl/viz3d) 使用67个js. 将地点、系统与事件变成3D应用软件和电影. 要加入克洛德代码,运行 `/plugin marketplace add codepawl/viz3d`,则 `/plugin install visualize-in-3d@codepawl`。 。 。 .

## 加词

每个加通是一个单独的导入,所以一个页面只加载它所使用的.

| 区域 | 导入 | 指南 |
| --- | --- | --- |
| 照明 | `67js/addons/hdri` | [基于图像的照明](https://npmcn.com/package/%40codepawlhq/67js/docs/lighting.md) 从 `.hdr` 文件 |
| 地形 | `67js/addons/terrain`, (中文(简体) ), `67js/addons/texture-set` | [断裂地势](https://67js.codepawl.com/terrain.md) 带有扫描地层 |
| 植被 | `67js/addons/vegetation`, (中文(简体) ), `67js/addons/grass`, (中文(简体) ), `67js/addons/clutter` | [树](https://67js.codepawl.com/vegetation.md), (中文(简体) ), [草类](https://67js.codepawl.com/grass.md) 财务报告和审定财务报表 [地面杂乱](https://67js.codepawl.com/clutter.md) 风和细节 |
| 字符 | `67js/addons/gltf`, (中文(简体) ), `67js/addons/retarget`, (中文(简体) ), `67js/addons/skeleton-pose` | [glTF 导入](https://npmcn.com/package/%40codepawlhq/67js/docs/gltf.md), (中文(简体) ), [弹夹重定向](https://67js.codepawl.com/retarget.md) 财务报告和审定财务报表 [带有 IK 的平面层](https://npmcn.com/package/%40codepawlhq/67js/docs/skeleton-pose.md) |
| 液体 | `67js/addons/spume` | [燃烧的液体回放](https://67js.codepawl.com/spume.md) 与折射和喷洒 |
| 车辆 | `67js/addons/vehicle` | [车轮在路上](https://67js.codepawl.com/vehicle.md) |
| 物理学 | `67js/addons/physics` | [猛烈接触和关节](https://npmcn.com/package/%40codepawlhq/67js/docs/physics.md) 记录在时间表中 |
| 建模 | `67js/addons/mesh`, (中文(简体) ), `67js/addons/modeling`, (中文(简体) ), `67js/addons/sculpt` | [网格编辑](https://npmcn.com/package/%40codepawlhq/67js/docs/mesh.md), (中文(简体) ), [建模](https://npmcn.com/package/%40codepawlhq/67js/docs/modeling.md) 财务报告和审定财务报表 [雕花笔](https://67js.codepawl.com/sculpt.md) |
| 离线光 | `67js/addons/path-tracer`, (中文(简体) ), `67js/addons/light-bake` | [路径跟踪静态](https://67js.codepawl.com/path-tracer.md) 财务报告和审定财务报表 [烤光图](https://67js.codepawl.com/light-bake.md) |
| 通行证 | `67js/addons/user-pass` | [你自己的全屏GLSL通行证](https://npmcn.com/package/%40codepawlhq/67js/docs/user-passes.md): 二进制、像素下缩放、四进制 |
| 探员 | `67js/addons/agent-scene`, (中文(简体) ), `67js/addons/agent-asset` | [场会](https://npmcn.com/package/%40codepawlhq/67js/docs/agent-scene.md) 有修订和检查站 |

这个 [文档页面](https://67js.codepawl.com/docs.html) 列出每个向导.

## 图像和录像

渲染命令通过无头Chrome,GPU或CPU向PNG或MP4导出一个场景.

```sh
npm run render -- --kind image --scene nature --backend gpu --preset high --output artifacts/nature.png
```

视频导出流一次一个帧,所以电影从不坐入内存. 这个 [创造技能](https://npmcn.com/package/%40codepawlhq/67js/skills/render-67js-media/SKILL.md) 列出每个预设和旗帜.

## 本地运行网站

1.  安装节点.js 22.12 或稍后.
2.  运行 `npm ci`。 。 。 .
3.  运行 `npm run dev`。Vite 打印本地 URL.

## 履约索赔

[核查](https://npmcn.com/package/%40codepawlhq/67js/docs/verification.md) 拥有测量结果及其限度. 他们比较了同一硬件上的相配场景. 它们没有显示比三.j的通用速度优势或与Blender的视觉等同.

## 捐款

读取 [捐款额](https://github.com/codepawl/67.js/blob/main/CONTRIBUTING.md) 在你打开拉动请求之前。 它涵盖了设置,检查,代码样式和发行流程. 编码代理从 [一般事务人员(其他职等)](https://github.com/codepawl/67.js/blob/main/AGENTS.md),以及 `npm run preflight` 本地运行拉动请求检查. 问题和错误报告 : [支助](https://github.com/codepawl/67.js/blob/main/SUPPORT.md)。 。 。 .

## 贷项

-   [gl- 矩阵](https://github.com/toji/gl-matrix) 提供矩阵数学.
-   GlTF 添加器有自己的解析器 。 Draco、Meshopt和KTX2解码器是 [3个j](https://threejs.org/) 装填器,你通过.
-   该网站上的纹理和HDRI是CC0扫描来自 [保利港](https://polyhaven.com/) 财务报告和审定财务报表 [环境CG](https://ambientcg.com/)。见 [纹理信用额度](https://github.com/codepawl/67.js/blob/main/public/textures/CREDITS.md)。 。 。 .
-   Bistro 将使用 [亚马逊木材厂 Bistro](https://developer.nvidia.com/orca/amazon-lumberyard-bistro) (CC BY 4.0,来自NVIDIA ORCA 库)在CC0下 [保利港](https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky) 苍天.
-   展出模型及其来源列于世界 `scene.json` 下级 `public/showcase/`。 。 。 .
-   横幅字标记使用 [空难](https://fonts.google.com/specimen/Sora) (SIL开放字体许可证).

## 许可证

[麻省理工学院](https://npmcn.com/package/%40codepawlhq/67js/LICENSE) 代码Pawl

## 常见问题

### @codepawlhq/67js 是什么？

AI代理驱动的3D引擎:一个MCP服务器,PNG预览和CPU或GPU导出到图像和视频

### 如何安装 @codepawlhq/67js？

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

### @codepawlhq/67js 支持 TypeScript 吗？

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

### @codepawlhq/67js 支持 ESM 还是 CommonJS？

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

### @codepawlhq/67js 需要什么版本的 Node\.js？

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

### @codepawlhq/67js 可以商用吗？

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

### @codepawlhq/67js 的下载量有多少？

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

### @codepawlhq/67js 还在维护吗？

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

