pascalorg/editor · 上手攻略
- 仓库：pascalorg/editor
- 链接：https://github.com/pascalorg/editor
- 分类：3D 建模 · 建筑编辑器 · MCP 集成
- 作者：Tom
- 更新：2026-09-25
这是什么
Pascal editor 是一个开源的本地优先 3D 建筑编辑器，用 React Three Fiber 和 WebGPU 构建，可以在浏览器中运行也可以通过 CLI 启动本地服务。它的核心定位是"建筑图纸的工具化"——不只是渲染 3D 模型，而是提供房间、墙面、门窗、机电系统等建筑元素的建模能力，并支持 AI Agent 通过 MCP（Model Context Protocol）连接来驱动工作流。
和 SketchUp、Revit 等传统建筑软件不同，Pascal 的设计哲学是本地优先 + AI 原生：不需要注册账号、不上传项目到云端，AI Agent 可以直接通过 MCP 调用它的工具来完成建筑场景构建。官方还提供了预制的工作流 skill（如 pascal-3d、furniture-fit），可以直接导入到 Claude Code 等 AI 编程工具中使用。
解决什么问题
建筑建模领域长期存在两个壁垒：
- 工具门槛高——Revit、Rhino、SketchUp 等专业软件学习曲线陡峭，价格昂贵，且大多不开放 AI 集成接口。
- AI 与建筑工作流脱节——大多数 AI 代码工具不熟悉建筑术语和 BIM 概念，无法生成可用的建筑场景描述。
Pascal editor 通过 WebGPU 渲染让浏览器直接跑 3D 编辑，通过 MCP 让 AI Agent 能够"理解"建筑场景并进行精确操作。两个能力结合，实现了"用自然语言描述建筑场景 → AI 生成 3D 模型 → 在编辑器中验证调整"的闭环。
快速安装
环境要求
- Node.js 22.13 或更高版本
- 支持 WebGPU 的浏览器（Chrome/Edge 113+，Firefox Nightly）
- 存储空间：首次运行约需下载数十 MB 编辑器运行时
安装步骤
方式一：一键 CLI（推荐）
# 全局安装 CLI
npm install --global @pascal-app/cli
# 启动编辑器并同时启动 MCP 服务
npx @pascal-app/cli editor
CLI 会自动：
- 启动编辑器 Web 界面
- 在后台启动已认证的 MCP 服务（自动选择不冲突的端口）
- 将项目存储在 ~/.pascal/data/pascal.db
方式二：skills.sh 安装 AI 工作流
npx skills add pascalorg/editor \
--skill pascal-3d \
--skill furniture-fit
方式三：Claude Code 插件安装
/plugin marketplace add pascalorg/editor
/plugin install pascal-agent-skills@pascal
⚠️ 注意：方式三会同时安装本地 pascal 连接器和远程 hosted 服务器。如已有手动配置的 pascal MCP 连接，需先运行
claude mcp remove --scope user pascal避免重复连接冲突。
核心用法
1. 基础场景编辑
启动后浏览器打开本地编辑器界面。核心操作包括： - 添加建筑元素：墙、门、窗、楼板、屋顶等内置图元 - 拖拽定位：鼠标拖拽移动元素，实时显示尺寸标注 - 剖切视图（Cut view）：任意位置切片，查看内部结构 - X-ray 模式：透视查看机电管线等隐藏系统 - 行走模式（Walkthrough）：第一人称视角在建筑内穿行 - 爆炸视图（Exploded view）：拆分各系统，查看组装关系
2. MCP 工具（AI Agent 控制）
Pascal MCP 服务启动后，在支持的 AI 客户端中添加：
# Claude Code 添加 pascal MCP
# 方式一：CLI 启动后自动配置
npx @pascal-app/cli editor
# 方式二：手动添加 MCP
claude mcp add --transport http pascal http://127.0.0.1:<CLI输出端口>/mcp
MCP 工具包括（具体以连接后的 schema 为准）：
- scene_create / scene_update——创建或更新场景
- element_add——添加建筑元素（墙/门/窗等）
- element_transform——移动、旋转、缩放元素
- view切换——切换剖切/X-ray/行走等视图模式
⚠️ MCP 工具 schema 随版本更新，Agent 应在使用前先查询实际可用工具列表，不要假设旧版本的工具仍存在。
3. AI Skill 工作流
Pascal 官方提供两个预制 skill，可通过 skills.sh 安装：
pascal-3d
- 覆盖安全的本地/远程 MCP 设置流程
- 场景创建与验证的标准步骤
- 适合需要精确建模的自动化场景
furniture-fit
- 家具适配评估：根据房间尺寸判断家具是否放得下
- 不做超出证据的断言（不支持的高度/摆动范围等会如实说明）
- 适合室内设计 AI 工作流
4. React 组件集成
Pascal 的 Viewer runtime 可以作为 React 组件嵌入到其他应用中：
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)
// 然后挂载 <Viewer /> 组件
支持可选的 Capture 扩展（录屏/会话记录）：
import { capture } from '@pascal-app/core/capture'
import { capture } from '@pascal-app/viewer/capture'
5. 查看在线演示
无需安装可直接体验 Next 版本： - https://editor.pascal.app/next
演示内容为正在开发中的新功能展示，不是当前开源 release 的功能子集，官方明确说明两者不等同。
典型适用场景
- 室内设计 AI 工作流：AI Agent 读取房间尺寸 → 自动生成家具布局方案 → 在 Pascal 中验证
- 建筑结构沟通：非技术人员在浏览器中打开
.pascal文件，剖切/爆炸视图查看建筑构成 - 设施管理（FM）：将建筑 3D 模型用于运维阶段的空间管理、设备定位
- AI Agent 自动化建模：开发者构建以建筑为核心的 Agent 系统，让 Agent 自主完成建模任务
- 本地优先 BIM 协作：多人各自本地编辑，通过导出的场景文件合并（注意 Pascal 目前无内置版本控制）
坑与注意
| 坑点 | 说明 | 应对 |
|---|---|---|
| WebGPU 兼容性问题 | Safari 和旧版浏览器不支持 | 使用 Chrome 113+ 或 Edge 113+；Firefox Nightly 需手动开启 WebGPU flag |
| Node.js 版本要求 | 需要 22.13+ | 用 node --version 确认；旧版本报错 "ERR_INVALID_PACKAGE_CONFIG" |
| MCP 重复连接冲突 | 手动配置 + 插件同时存在时报错 | 使用插件方式前先 claude mcp remove --scope user pascal 清理旧配置 |
| 单场景多 Agent 共享状态 | 共享场景状态可能导致冲突 | 每个独立 Agent 工作流使用独立 PASCAL_HOME 目录 |
| 开源版 vs next 演示版 | next.pascal.app 不是开源版功能 | 不要以在线演示作为开源版功能预期 |
| MCP server.json 版本独立 | MCP manifest 版本与 npm 包版本不同步 | 提 PR 验证 manifest；发布由 Pascal 组织 owner 从 main 分支操作 |
| OpenClaw 集成待发布 | 技能商店暂未上线 | 关注 skills.sh 官方公告；OpenClaw 集成需要 Pascal 在 ClawHub 上发布 |
与同类对比
| 特性 | Pascal editor | SketchUp | Revit | Sweet Home 3D |
|---|---|---|---|---|
| 开源 | ✅ | ❌ | ❌ | ✅ |
| 浏览器运行 | ✅ WebGPU | ❌ | ❌ | ⚠️ Java Applet |
| MCP/AI Agent 集成 | ✅ 原生 MCP | ❌ | ❌ | ❌ |
| 本地优先（免账号） | ✅ | ❌（需要账号） | ❌ | ✅ |
| 建筑系统（FM/机电） | ✅ 正在探索 | ⚠️ 插件 | ✅ 完整 | ❌ |
| WebGPU 渲染 | ✅ | ❌ | ❌ | ❌ |
| CLI 模式 | ✅ | ❌ | ❌ | ❌ |
Pascal 的核心差异是开源 + AI 原生：它不是"功能完整的 BIM 软件"，而是第一个将建筑 3D 编辑能力以 MCP 接口开放给 AI Agent 使用的开源项目。
一句话推荐结论
如果你在构建需要"AI Agent 操作 3D 建筑场景"的系统，Pascal editor 是目前唯一的开源 MCP 原生方案；如果你是建筑师找替代 SketchUp 的免费工具，它的 WebGPU 编辑体验值得一试，但功能完整性还不能替代专业 BIM 软件。
⚠️ 本攻略基于 2026-09-25 GitHub README 及公开文档。npm 包版本号、MCP 工具 schema 请以最新版为准。