editor · pascalorg/editor
Pascal Editor 是一款面向 AECO(建筑、工程、施工与运维)的开源 3D 建筑设计软件,采用 MIT 许可证,强调本地优先,浏览器优先。它可在浏览器中创建并编辑建筑模型,支持场地、楼层、墙体、楼板、屋顶、门窗洞口、房间与家具等构件;也...
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。Pascal 的 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
各客户端的接入方式:
pascal mcp setup claude 注册本地服务;或通过插件市场安装 pascal-agent-skills@pascal,插件同时打包 skills、本地 pascal 服务以及可选的托管 pascal-hosted 服务(API Key 存入系统钥匙串,留空则保持纯本地)。.cursor/mcp.json 中配置 stdio 的 pascal 与 HTTP 的 pascal-hosted 两个服务。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
若要在自己的 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。
README 还介绍了 Pascal Next 的托管预览:一个被细致重建的真实住宅,从房间与饰面到墙体背后的结构与系统,提供爆炸视图、剖切视图、X 光视图、漫游、门窗交互与环境光照调节等体验。项目明确说明:该预览用于探索下一代 Pascal 编辑器的方向,展示的体验尚未包含在开源编辑器版本中。
Pascal Editor 面向建筑/室内设计、BIM 与 scan-to-BIM 相关的工具开发与集成场景,而非游戏项目。若你希望以 MCP 方式让 AI 代理参与建模,本地模式不需要账号与 API Key,是最容易上手的入口;需要团队协作或托管能力时再考虑托管工作区。
id Software 以 GPL 许可证发布的《雷神之锤3竞技场》(Quake III Arena)源...
Farbrausch 2001—2011 年 demo 工具源码合集,使用 C++,涉及 demoscene 与 D...