场景编辑器

◆

文件

暂无记录

编辑

查看

运行

设置

帮助

场景编辑器

Main

Top

Front

Side

3D 场景加载中...

最近打开

视角保持自动渲染

场景 JSON · 代码编辑

正在切换…

工具面板

组件

说明

画布双击物体：描边（包围盒）+ 进入编辑，不高亮

场景树单击：后处理高亮；场景树双击：高亮 + 描边 + 编辑；点击物体或 gizmo 取消高亮；右键清除高亮/描边并退出编辑

Esc：退出浏览器全屏

AI 凭据

Provider

接口根 URL

须兼容 OpenAI Chat Completions；若粘贴路径含 /chat/completions，将自动裁成根前缀。

API Key

Model（可选）

记住当前配置（仅存本机浏览器；含 API Key，共用设备请勿勾选）

取消勾选将立即清除已保存的配置。

Agent（多轮）

启用 Agent（多轮，消耗更多 Token）

思考深度

迭代应用到画布（命令/auto 调整：每轮 patch 立即上画布，再基于最新场景继续优化）每轮变更后自适应取景（命令迭代模式；默认关）

未勾选 Agent 时，生成/调整/看图与原先单次调用一致。JSON 生成/全量调整的多轮主要为校验与布局审查。

完成后填充纹理（与上方 LLM 相同接口根 URL；默认生图模型 dall-e-3）

浏览器直连生图可能受网关 CORS 限制；失败时仍会载入无纹理场景。

阶段产物自动载入（JSON 生成/全量调整：校验通过的阶段预览；命令迭代模式由「迭代应用」直接改画布）

浏览器落盘方式

图床 endpoint（POST multipart）

Electron 可直接写仓库 resources/textures/；浏览器请用授权目录、图床或 ZIP。外置 CLI 为可选批处理，编辑器不依赖它。

流式预览 LLM 输出（默认开；生成 / 调整 / 看图标签页同步）

AI 能力来自 ThreeJSON core/ai（浏览器直连 LLM），不读取 setting.json，不调用外置 Node/Python 工具链。

生成场景

提示词

在输入框中按 Ctrl+Enter（Mac：⌘+Enter）提交。

调整当前场景

修改说明

调整输出模式

附带完整 JSON（命令模式：在对象列表基础上附加完整场景；JSON 全量/增量始终附带完整场景）附带空间摘要（命令模式：各对象位置与几何尺寸摘要 + 场景尺度概况；大场景或需完整材质/结构时可改勾完整 JSON）

在输入框中按 Ctrl+Enter（Mac：⌘+Enter）提交。

将使用「查看 → 查看场景 JSON」同源的完整导出作为当前场景上下文。

命令模式就地修改场景，可通过撤销恢复；不会整包载入 JSON。

上次 AI 产出

看图生成

图片 → 新场景 JSON（需 Vision，推荐 chatgpt + gpt-4o / gpt-4o-mini）

本地文件（优先级最高）

Base64（未选文件时使用）

裸 Base64 的 MIME

在线图片 URL（前两者都空时使用）

补充说明（可选）

image_detail（OpenAI）

在输入框中按 Ctrl+Enter（Mac：⌘+Enter）提交。

优先级：本地文件 > Base64 > URL。内网或 localhost 的 URL 常无法被模型服务端拉取。

属性面板

场景树

属性

识别名 (name) 显示名 (label) 可见位置 (x,y,z) 旋转 (x,y,z) 缩放 (x,y,z)

Domain

状态 domain handler objType threeJsonId

信息面板

dismissTrigger

材质

纹理 URL 纹理重复 X 纹理重复 Y 颜色发光色发光强度透明度金属度粗糙度双面线框

投射阴影接收阴影

事件

请先在场景树中选中对象。

域对象事件编辑将在 Phase 3 提供。

对象平台事件脚本（script / lib://） dsl

资源库 assetLibrary

texture 条目参与 lib:// 解析；其它 assetKind 仅登记（未接入运行时）。

threeJsonId name（可选） assetKind url / textureUrl（texture）扩展 JSON（非 texture，可选）

场景管理

属性失焦自动写入场景 JSON；修改相机/调度等后，请点击「应用到画布」使运行时生效。完整 JSON 请使用 Code 模式编辑。

身份

threeJsonId 识别名 (name) 显示名 (label) 备注 (remark) version

sceneConfig 开关

enableDefaultModel enableComposeBoxModel runtimeDefaults.autoFillCamera runtimeDefaults.autoFitCamera

autoFitCameraMode

相机 camera

fov near far position (x,y,z)

渲染器 renderer

antialias shadowMapEnabled alpha clearAlpha ratioRate 纹理采样默认

控制器 controls

enableDamping dampingFactor enableZoom enablePan autoRotate minDistance maxDistance maxPolarAngle（弧度） target (x,y,z)

渲染循环 renderLoop

fps lowFps autoResize firstAutoResize

部署调度 deployScheduler

enabled mode policy fluxMs density maxInFlightAsync

interaction（事件绑定）

bindSceneEvents

辅助线显示（sceneConfig.helpers）

gridShow axesShow

操作指南：左键旋转，右键拖动，滚轮缩放；场景树单击高亮，双击高亮+描边+编辑。

当前场景 JSON

关于

Scene Editor 1.0.0 Powered by ThreeJSON and Three.js

Domain 子结构已修改

原解析器无法自动保证语义。请选择处理方式：

将本次选择设为默认，且不再显示此提示

录制参数

帧率（fps）

格式（mimeType）

码率（bps）

提示：录制依赖浏览器的 captureStream / MediaRecorder 支持，输出通常为 WebM。

导出文件

文件名

可修改后导出；取消则中止本次导出。

场景预设

预设名称

请输入预设名称。

另存为副本

将当前场景另存为副本，并分配新的 threeJsonId。完成后会自动打开该副本，撤销/重做历史将清空；原场景缓存不会被覆盖。

场景名称

导出 .tjz 包

导出格式

资源策略

导出 runtime（scene/camera/renderer/controls/light/renderLoop）

tryPack 时尝试抓取外链 URL（默认关闭）

提示：three-native 模式下不会抽取 assets，导出结果按原生 JSON 原样打包。

导出 3D 模型

格式

范围

OBJ/STL/PLY 主要导出几何；USDZ 适合 iOS AR 预览。贴图丰富的场景建议使用 GLB。

纹理采样

未填项继承档位/场景默认；此处显式项优先于主面板档位。

跳过预设优化 generateMipmaps minFilter magFilter anisotropy colorSpace

选择 eventScript 资源

请确认导入方式

导入模式

添加到当前场景：保留现有对象；替换当前场景：清空可编辑内容后导入。补光/补相机由设置或下方选项决定。

自动补光自动补相机导入后相机自适应

载入场景选项

自动补光自动补相机

未保存的修改

发现未保存的编辑