提示：本地台式机若仍报 401，请确认 config.json 中的 service_id 为 cityengine-workstation-01 且 service_secret 为上表中的数据库当前真实值。修改配置后请重启 Agent 服务。

一键安装命令

powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest -Uri https://pyprt.cityvistion.com/downloads/install-cityengine-connector.ps1 -OutFile \:TEMP\install-cityengine-connector.ps1; & \:TEMP\install-cityengine-connector.ps1"

使用方法：安装完成后，在 CityEngine 中打开 Scripting 窗口，运行 cityvistion_connector.py， 然后在 ce.cityvistion.com 的 CGA 编辑器中点击"实时对比"标签，即可同时查看 cgajs 和 CityEngine 的解析结果。

🧪 测试自动修复

⬆ 上传插件 📋 插件列表 ⭐ 待审核

已上架插件

名称	分类	状态	下载次数	操作
CityEngine 实时对比连接器	cityengine	已上架	0	查看
RPK Agent	cityengine	已上架	0	查看
CityEngine 一键发布插件	cga	已上架	0	查看
CGA 自动同步插件	cga	已上架	0	查看
Agent 通用检测修复工具	analysis	已上架	0	查看

🛒 创建订单 📋 订单列表 📅 我的订阅

1. 默认路径与自定义路径

默认路径：D:\CityEngine\Omega（推荐作为统一 CGA 库目录，Omega 项目）
自定义路径：在 config.json 的 watch_directories 中添加任意多个目录，支持递归扫描子目录。

2. 配置文件模板

下载 cga-sync-config.example.json，复制为 config.json 并修改路径：

下载配置模板

3. 目录配置示例

{
  "cga_sync": {
    "enabled": true,
    "interval_seconds": 300,
    "watch_directories": [
      {
        "path": "D:\CityEngine\Omega",
        "category": "general",
        "recursive": true
      },
      {
        "path": "D:\CityEngine\Projects\ChineseRoofs",
        "category": "chinese_roof",
        "recursive": true
      }
    ]
  }
}

4. 同步策略说明

策略	说明
定时增量	默认每 5 分钟扫描一次，只上传 MD5 变化的文件
本地删除	服务器端标记为已删除，不物理删除（可配置）
冲突处理	默认服务器端优先（server_wins），本地覆盖需手动确认
语义提取	自动解析 attr/rule/函数/注释，AI 生成中文标签和屋顶类型

插件下载与安装

文件	说明	操作
cityvistion_publisher.py	CityEngine 2023+ Python 插件	下载

安装步骤

1. 将 cityvistion_publisher.py 复制到 CityEngine 安装目录的 scripts 文件夹（如 C:\Program Files\Esri\CityEngine2025.1\scripts）。
2. 打开 CityEngine，进入 Window → Show View → Scripting。
3. 在 Scripting 窗口点击 Add Script，选择 cityvistion_publisher.py。
4. 首次使用需在脚本顶部配置 ADMIN_TOKEN（从本后台获取）。
5. 选中一个 .cga 文件，运行 publish_selected_file()；或运行 batch_publish_directory() 批量发布目录。

插件功能

功能	说明
单文件发布	选中 .cga 文件，填写屋顶类型/建筑风格/斗拱等元数据，一键上传
批量发布	扫描整个目录，自动按文件名推断标题和关键词，批量上传
自动提取	自动解析 attr/rule/函数调用，生成 NL2CGA 标签
屋顶样式枚举	内置硬山顶/悬山顶/歇山顶/重檐歇山顶/庑殿顶/攒尖顶等 14 种中国古建筑屋顶

NL2CGA 集成效果：发布后，用户输入"创建天安门"即可自动匹配 roof_type=重檐歇山顶 + architectural_style=官式 的示例代码，直接生成可执行的 CGA。