本页目录

Pascal Editor:开源 3D 建筑设计编辑器(AECO / scan-to-BIM)

editor · pascalorg/editor

Pascal Editor 是一款面向 AECO(建筑、工程、施工与运维)的开源 3D 建筑设计软件,采用 MIT 许可证,强调本地优先,浏览器优先。它可在浏览器中创建并编辑建筑模型,支持场地、楼层、墙体、楼板、屋顶、门窗洞口、房间与家具等构件;也...

其他 自研引擎 Rust 游戏状态管理 音频系统 UI 系统 渲染技术 高级
★ Stars 25,561 Forks 3,178 License MIT 更新 2026-11-16

国内开发环境适配

Windows
未知
Linux
未知
macOS
未知
引擎 / 框架:自研引擎 暂无中文教程标记 未标记站长实测
npm 安装 @pascal-app/cli 与相关包需要可用的 npm 网络,国内建议配置镜像;首次运行 `npx @pascal-app/cli editor` 会按版本下载一次 Web 编辑器运行时并做摘要校验,网络受限时可能失败,离线安装方式需参考官方本地编辑器文档。托管端点 editor.pascal.app 与 MCP 托管服务在境外的可达性待核验;本地 CLI 模式无需账号与 API Key,不依赖云端。自托管镜像 ghcr.io 的拉取速度视网络环境而定。

中文项目介绍

Pascal Editor 是一款面向 AECO(建筑、工程、施工与运维)场景的开源 3D 建筑设计软件,采用 MIT 许可证,主打「本地优先、浏览器优先」。它可以在浏览器里创建与编辑建筑模型,构件覆盖场地、建筑、楼层、墙体、楼板、屋顶、门窗洞口、房间与家具;也可以把 3D 扫描作为参考层导入,在其上绘制可编辑的建筑构件,从而支撑 scan-to-BIM 工作流。

它同时提供两种使用形态:直接在浏览器中使用编辑器,或通过 CLI 在本地运行同一套编辑器;并借助 MCP(Model Context Protocol)让 AI 代理读取、编辑、校验与保存同一个场景。技术栈基于 React Three Fiber 与 WebGPU。

补充说明

快速上手

README 给出了四条起始路径:

  • 本地运行编辑器:执行 npx @pascal-app/cli editor。
  • 自托管:使用单容器 + SQLite 存储。
  • 嵌入 npm 包:在自己的 React 应用中挂载 viewer 或完整编辑器。
  • 接入 AI 代理:支持 Claude Code、Cursor、Codex 以及任意 MCP 客户端。

连接 AI 代理(MCP)

Pascal 的 MCP 服务器为代理提供检查、编辑、校验与保存建筑场景的工具。项目存放位置有两种选择:

  • 本地(无需账号):CLI 在本机启动 MCP 服务,代理通过 pascal mcp connect 连接;项目保存在 ~/.pascal/data/pascal.db,不上传任何数据,也不需要 Pascal 账号或 API Key。
  • 托管工作区:端点 https://editor.pascal.app/api/mcp,作用于账号或组织,需要该账号授权。Cursor 插件使用浏览器登录;Claude Code、Codex 等客户端则使用在设置页创建的 API Key。部分托管操作(例如 Architect 运行)会消耗 Pascal 积分。

本地命令需要 pascal 在 PATH 中,Node.js 版本要求为 22.x 的 22.23.4+、24.x 的 24.22.1+ 或 26.12.1+:

npm install --global @pascal-app/cli

各客户端的接入方式:

  • Claude Code:pascal mcp setup claude 注册本地服务;或通过插件市场安装 pascal-agent-skills@pascal,插件同时打包 skills、本地 pascal 服务以及可选的托管 pascal-hosted 服务(API Key 存入系统钥匙串,留空则保持纯本地)。
  • Cursor:在 Cursor 市场安装 Pascal,或手动在 .cursor/mcp.json 中配置 stdio 的 pascal 与 HTTP 的 pascal-hosted 两个服务。
  • Codex:pascal mcp setup codex,或安装 Codex 插件;托管端点可用环境变量存放 Bearer Token。
  • 其他客户端:pascal mcp config 打印通用配置;连接器会自行发现本地端口与私有 token,可用 pascal mcp status 或 pascal doctor 检查。

README 特别提醒:每个本地 CLI 服务只应有一个活跃的代理客户端,因为本地 HTTP 运行时会在客户端之间共享活跃场景状态;需要并行独立工作时,应为每个任务使用独立的 PASCAL_HOME 目录与服务进程。托管端点使用独立的会话隔离桥接。

此外项目还提供 agent skills:pascal-3d 覆盖安全的本/托管 MCP 配置与场景操作,furniture-fit 用于产出有边界的、基于证据的家具占地评估,可通过 npx skills add pascalorg/editor 单独安装。仓库还提供供语言模型使用的文档索引 llms.txt 以及 server.json 清单。

本地运行与自托管

在本地创建持久化安装无需克隆仓库:

npx @pascal-app/cli editor

CLI 会在后台启动编辑器与带认证的 MCP 服务,自动选择无冲突的回环端口,并把项目保存在 ~/.pascal/data/pascal.db。Web 编辑器运行时会在首次启动编辑器的命令中按版本下载一次,并用包内发布的摘要校验;单独的 pascal mcp connect 不需要下载。

自托管方面,编辑器以单容器 ghcr.io/pascalorg/pascal-editor 发布,标签与 npm 包版本一致(latest 跟随稳定版)。项目存放在 /data 下的 SQLite 中,一个管理员密码保护实例,PASCAL_PUBLIC_URL 在运行时读取,因此同一镜像可服务任意域名:

docker run -d -p 3000:3000 -v pascal-data:/data \
  -e PASCAL_ADMIN_PASSWORD=change-me \
  -e PASCAL_PUBLIC_URL=https://pascal.example.com \
  ghcr.io/pascalorg/pascal-editor:latest

使用已发布的 npm 包

若要在自己的 React 应用中嵌入,可安装核心包与内建节点包,并在挂载 <Viewer> 前加载一次内建插件:

npm install @pascal-app/core @pascal-app/viewer @pascal-app/editor @pascal-app/nodes
import { loadPlugin } from '@pascal-app/core'
import { builtinPlugin } from '@pascal-app/nodes'

await loadPlugin(builtinPlugin)

捕获会话以可选子路径 @pascal-app/core/capture 与 @pascal-app/viewer/capture 形式提供;@pascal-app/ifc-converter 可将 IFC 文件转换为 Pascal 场景图。

从源码开发与插件

在仓库根目录运行,以便 packages/* 的监听器热更新:

bun install
bun dev   # 构建并监听包,在 http://localhost:3002 提供编辑器

可用 turbo build 构建全部,或用 turbo build --filter=@pascal-app/core 构建单个包。仓库中的 SETUP.md、docs/architecture.md、docs/releasing.md 分别涵盖环境准备、包之间的关系以及 npm/容器/MCP Registry 的发布流程。

插件通过内置组件同样的 Plugin 清单发布节点类型(schema、3D/2D 渲染、放置工具、检查器参数化)与左侧栏面板,可参考官方插件指南与示例仓库 pascalorg/plugin-trees。

关于 Pascal Next

README 还介绍了 Pascal Next 的托管预览:一个被细致重建的真实住宅,从房间与饰面到墙体背后的结构与系统,提供爆炸视图、剖切视图、X 光视图、漫游、门窗交互与环境光照调节等体验。项目明确说明:该预览用于探索下一代 Pascal 编辑器的方向,展示的体验尚未包含在开源编辑器版本中。

适用与注意点

Pascal Editor 面向建筑/室内设计、BIM 与 scan-to-BIM 相关的工具开发与集成场景,而非游戏项目。若你希望以 MCP 方式让 AI 代理参与建模,本地模式不需要账号与 API Key,是最容易上手的入口;需要团队协作或托管能力时再考虑托管工作区。

开源许可证与版权说明

许可证标识:MIT。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目