Pascal Editor

Pascal Editor 快速入门

Pascal Editor（pascalorg/editor）是开源、本地优先的 3D 建筑编辑器：用 React Three Fiber + WebGPU 在浏览器里创建、编辑、演示三维建筑项目——扫描真实空间、AI 草图生成实体几何、拖家具备装、一键第一人称漫游。它最特别的一点是把 MCP server 作为一等公民：@pascal-app/mcp 让 Claude 等 Agent 直接读写 Pascal 场景（房间、物体、材质、建筑系统），你可以说「给二楼加一面墙」让 Agent 干活。MIT，TypeScript monorepo（Turborepo），2026-09-28 核验：GitHub 24,335★ / 3,016 fork，最近 push 2026-09-27（持续活跃），npm 包 @pascal-app/core / viewer / cli / mcp。

这是什么？适合谁？

传统 3D 建筑工具有两条路：专业 CAD/BIM（Revit、ArchiCAD）功能强但学习曲线陡、 license 贵；轻量工具（SketchUp 免费版等）好上手但协作与自动化弱。Pascal Editor 选了第三条路——浏览器原生 + 开源 + Agent 原生：

• Create（创建）：扫描真实空间转 3D、或直接在浏览器里从零起草。无重型工具、无陡峭学习曲线。
• Edit（编辑）：移墙、换家具、试布局、玩材质风格。官方强调 SDF/CSG 形体（像黏土但参数化）、AI 草图笔刷（strokes 变实体几何）。
• Present（演示）：第一人称走查，把空间感受直接给客户/家人看。
• AI-ready（Agent 原生）：MCP server 让 Agent 读改场景——await space.agent.run('find rooms under 12m²') 这种代码在官网首页就是示例。

适合人群：

• 建筑师/室内设计师：要快速出方案、给客户做沉浸式走查演示
• 房主/装修用户：把自己的房子做成「数字孪生」，试布局再动手
• 游戏设计师/影视美术：快速搭建可交互的 3D 空间场景
• 开发者/插件作者：整个编辑器、viewer、场景引擎都发布在 npm 上，可嵌入、可扩展
• AI Agent 玩家：想把「自然语言 → 3D 场景操作」接进自己工作流的人

不适合谁：需要 BIM 级施工图、结构计算、工程碰撞检测的专业施工团队（Pascal 是编辑与演示层，不是 BIM 平台）；需要离线桌面 GPU 渲染电影级效果的用户（WebGPU 浏览器渲染有上限）。

准备工作

• 运行环境：现代浏览器（WebGPU 支持：Chrome/Edge 113+、Safari 18+）；本地跑 CLI 模式需 Node.js 22.13+
• 账号要求：无（开源 MIT，本地优先）
• 时间预算：浏览器直接用 0 分钟安装；本地 CLI 安装约 5-10 分钟；跑通第一个 MCP Agent 操作再花 15 分钟
• 前置知识：会用浏览器就行（编辑模式）；CLI/MCP 模式需要命令行基础
• 替代方案：SketchUp Free（浏览器 3D，无 MCP/Agent 能力）；Blender（全功能 3D，学习曲线陡，Agent 生态靠社区插件）；Spacemaker/Autodesk Forma（商业 AI 建筑规划）

快速上手（三种方式）

方式一：浏览器直接用（最快）

打开 editor.pascal.app——创建账号后即可在浏览器里建模、编辑、演示。零安装。

方式二：本地 CLI 安装（持久化 + MCP）

Node.js 22.13+ 下一条命令创建持久本地安装（无需 clone 仓库）：

npx @pascal-app/cli editor

CLI 会启动编辑器和一个带鉴权的 MCP 服务（自动选无冲突的回环端口），项目保存在 ~/.pascal/data/pascal.db。

方式三：作为 npm 包嵌入自己的应用

npm install @pascal-app/core @pascal-app/viewer @pascal-app/editor @pascal-app/nodes
npm install @pascal-app/capture-protocol @pascal-app/capture-viewer

import { loadPlugin } from '@pascal-app/core'
import { builtinPlugin } from '@pascal-app/nodes'

await loadPlugin(builtinPlugin)

跑第一个 AI Agent 任务（MCP）

本地装好 CLI 后，把 Agent 配置为 pascal mcp connect（官方 README 给出的连接方式），然后对 Claude 说：

在当前场景里找出所有小于 12 平米的房间

或者官网示例代码的等价操作：

const space = await pascal.load('building.ifc')
await space.agent.run('find rooms under 12m²')

预期结果：Agent 通过 MCP 读取场景结构（房间、物体、材质），返回符合条件的房间列表；或按你的指令在 3D 模型里加一面墙、改一个楼层——改动实时反映在编辑器画布上。

常见踩坑

1. 症状：浏览器打开是黑屏/白屏。 原因：浏览器不支持 WebGPU 或未启用。解决：Chrome/Edge 升到 113+，地址栏查 chrome://gpu 确认 WebGPU 可用；Safari 需 18+。
2. 症状：npx @pascal-app/cli editor 报 Node 版本错。 原因：CLI 要求 Node.js 22.13+，旧 LTS 会直接失败。解决：node -v 确认版本，用 nvm/fnm 切到 22.13+。
3. 症状：MCP 连接被拒。 原因：CLI 启动的 MCP 服务带鉴权且只听回环端口；Agent 配置里端口/凭证不匹配。解决：按 CLI 启动日志里给出的端口与连接说明配置，用 pascal mcp connect 官方路径而非手写 URL。
4. 症状：资产库加载慢或家具缺。 原因：资产库数千个 3D 物体按需从官方源拉取，首次使用冷启动。解决：挂着等首载；频繁使用可关注官方本地缓存选项（以文档为准）。
5. 症状：导入 IFC 文件失败或丢构件。 原因：IFC 版本与构件映射尚在完善（官网示例用 building.ifc，但完整 IFC 支持范围未逐项验证）。解决：先用简单结构测试；复杂 BIM 模型建议导出为基础几何再导入。
6. 症状：旧教程里的命令对不上。 原因：仓库迭代快（Turborepo monorepo，包名/CLI 行为随版本变）。解决：以 GitHub README 与 npm 包页的当前版本说明为准，别信三方旧文。

常见问题 FAQ

Q1：和 Blender、SketchUp 比，Pascal 凭什么？

A：定位不同。Blender 是全功能 3D 创作套件（建模/动画/渲染全能但重）；SketchUp 是建筑设计上手最快的经典工具。Pascal 的差异化是：浏览器原生（零安装分发给客户）、开源 MIT（可自部署可二开）、npm 生态（core/viewer/editor 拆包可嵌入）、以及 MCP 原生——Agent 直接操作场景这一条，Blender/SketchUp 目前都只有社区插件级别的支持。

Q2：MCP 都能干什么？能真的「加墙改楼层」吗？

A：MCP server 暴露场景的读写能力（房间、物体、材质、建筑系统），官网首页明示「lets agents read and reshape Pascal scenes」并给出 space.agent.run('find rooms under 12m²') 示例。加墙/改楼层的具体能力边界以 MCP 工具清单实时为准，本文未逐工具实测。

Q3：数据存在哪？会上云吗？

A：本地优先：CLI 模式项目存 ~/.pascal/data/pascal.db；浏览器版的项目同步机制以官方文档为准（官网宣称「local-first」）。闭门造户型不必担心图纸出网，但浏览器版的具体云同步范围本文未审计。

Q4：能做施工图/结构计算吗？

A：不能。Pascal 是 3D 编辑与演示层，官网定位「Create / Edit / Present」，无 BIM 级施工图输出、无结构计算。要施工图请走 Revit/ArchiCAD。

Q5：商用免费吗？

A：MIT License——自由使用、修改、分发，商用免费。npm 包同理。托管版（editor.pascal.app）的账号政策以官网为准。

Q6：支持哪些 Agent？

A：任何支持 MCP 的客户端（Claude Code/桌面端 Claude、Codex 等）理论上都能连 @pascal-app/mcp；具体客户端的配置方法见各客户端 MCP 文档。

权限、安全、成本与限制

• 许可：MIT（仓库与 npm 包）。
• 安全：CLI 的 MCP 服务带鉴权且只绑定回环端口（localhost），设计上不暴露公网；不要手动把它转发到公网。浏览器版注意账号安全。
• 成本：软件免费开源；浏览器版免费档起步（以官网为准）；自部署成本仅为自己机器/服务器。
• 限制：WebGPU 渲染性能受浏览器与 GPU 上限约束；IFC 完整支持在演进中；无 BIM 施工图/结构计算能力；中文界面未验证（2026-09-28 官网为英文）。
• 核验声明：本文基于 2026-09-28 抓取的 GitHub README（pascalorg/editor）与官网（editor.pascal.app）撰写；GitHub API 核验 24,335★ / 3,016 fork / MIT / 最近 push 2026-09-27；未做完整建模工作流实测。

小技巧

1. 给客户演示用第一人称走查（Present 模式）比转圈截图有说服力得多——官网三个核心场景 Create/Edit/Present 里 Present 就是为此设计的。
2. 本地 CLI 模式 + MCP：让 Claude 先跑 find rooms under 12m² 这类只读查询熟悉场景结构，再下改动指令，出错率低。
3. npm 的 @pascal-app/viewer 单独可用于只读展示：给自己的项目官网嵌一个 3D 看房组件，编辑器都不用带。
4. AI 草图笔刷（sketch-to-geometry）适合快速起量：先草出体块再精确调参，比逐面建模快。
5. 资产库直接拖家具试布局——装修/软装方案用它做 A/B 对比，比 PSD 贴图直观。

进阶学习方向

• Monorepo 架构：仓库是 Turborepo 结构（apps/editor + packages/core/viewer/capture-protocol/capture-viewer/editor/nodes/cli/mcp），想二开或贡献代码先读仓库 README 的 Repository Architecture 节。
• MCP 集成深度：@pascal-app/mcp 的工具清单与权限模型，是把 Pascal 接进 CI（自动生成户型报告）或 Agent 工作流（批量改方案）的基础。
• 插件体系：官方明示「embed them, extend them, or let AI agents drive them」——插件构建者（Plugin builders）是官网列出的目标用户之一，从 @pascal-app/nodes 的内置节点定义入手。
• 生态竞品：对照 Blender 的 MCP 社区方案（blender-mcp 类项目）与商业 AI 建筑工具（Autodesk Forma），理解「编辑器层 Agent 原生」这条路线的独占位。

参考链接

• 官方仓库
• 官网 / 在线编辑器
• 官方文档
• @pascal-app/mcp (npm)