DEVELOPER TOOLS / V0.1.0

在 VS Code 里，描述并生成。

把 CGA 生成和规则修复放进你的编辑器。需要 VS Code 1.85 或更新版本。

01 / 安装

从 VSIX 安装

下载后，在 VS Code 的扩展面板点击右上角“…” → “从 VSIX 安装…” → 选择下载文件。

code --install-extension nl2cga-0.1.0.vsix

02 / 获取 KEY

登录本站控制台

打开我的 Key，创建具有 cga:generate 权限的 Key。明文仅创建时展示一次，请妥善保存；遗失后可轮换。

03 / 配置

填入 Key 与接口地址

按 Ctrl/⌘ + Shift + P，运行 NL2CGA: Set API Key 并粘贴 Key。插件使用 VS Code SecretStorage 保存。

设置 nl2cga.endpoint 为：

https://www.nl2cga.com

04 / 使用

生成或修复 CGA

运行 NL2CGA: Generate CGA，输入建模描述；结果打开为新文档。修复时打开 CGA 文件，运行 NL2CGA: Repair CGA 并填写问题。

0.1.0 客户端请求超时为 60 秒；错误详情见 Output → NL2CGA。

完整代码示例

输入：“10x10地块挤出10米盒子”

以下为 2026-09-30 使用新建 API Key 实测返回的 CGA 全文，任务状态 succeeded。内容为模型原始输出，尚未另行用桌面 CityEngine 验证。

box.cgaCGA · 本次 API 实测输出

attr lotWidth = 10
attr lotDepth = 10
attr height = 10
attr window_ratio = 0.4

@StartRule
Lot -->
	primitiveQuad(lotWidth, lotDepth)
	extrude(height)
	comp(f){ top: Roof | side: Facade }

Roof -->
	platform(0.5)
	color(0.5, 0.5, 0.5)

Facade -->
	split(y){ ~3.33: Floor }*

Floor -->
	split(y){ 1.5: Sill | 'window_ratio: Wall }

Sill -->
	color(0.8, 0.8, 0.85)

Wall -->
	color(0.5, 0.6, 0.7)

本站界面实拍

由无头浏览器截取本站真实产品界面，不是插件运行截图。

API Key 只属于你的账户。不要提交到公开仓库；怀疑泄露时立即在控制台吊销。生成规则应在目标 CGA 运行环境中检查。