pascalorg/editor

TL;DR

Pascal Editor 是一个基于 WebGPU 和 React Three Fiber 构建的开源、本地优先（Local-first）3D 建筑编辑器。其核心亮点在于原生集成 Model Context Protocol (MCP)，允许 AI Agent（如 Claude Code）直接操作场景数据，实现了从 CAD 建模到自动化生成的工作流闭环。

它解决什么问题

传统 BIM/CAD 软件（如 Revit, SketchUp）通常封闭且难以与 AI Agent 集成，导致自动化设计落地困难。Pascal Editor 试图解决两个痛点：一是通过 Local-first 架构确保数据隐私和低延迟，无需依赖云端 API；二是提供标准化的 MCP Server，让 AI Agent 能够以“工具调用”的方式安全地读取、修改和生成建筑几何体，填补了 3D 创作工具与 LLM Agent 之间的连接空白。

核心做法

架构上采用 Turborepo Monorepo，将渲染、逻辑与 UI 解耦。 1. 数据层：使用 Zustand + Zundo 管理场景状态，支持 Undo/Redo。节点（Nodes）以扁平字典存储，通过 parentId 关联层级。 2. 渲染层：基于 React Three Fiber (R3F) 和 WebGPU。引入 Dirty Nodes 机制，仅在数据变更时通过 System（如 WallSystem, SlabSystem）在 useFrame 中更新几何体，避免全量重绘。 3. AI 集成：内置 @pascal-app/mcp 包，暴露场景 CRUD、空间查询等工具。Agent 可通过 pascal mcp connect 直接连接本地服务，无需 API Key。 4. 插件化：通过 Plugin manifest 扩展节点类型和 UI，如官方示例的树木插件。

作者

项目由 pascalorg (Organization) 维护。核心贡献者包括 Aymeric Rabot, Wassim Samad 等。README 未明确披露创始团队背景，但从技术栈选型（R3F, WebGPU, MCP）和架构设计来看，团队具备深厚的前端图形学及 AI 应用开发经验。该项目与 Pascal.app（一个知名的建筑可视化平台）关系密切，极可能是其开源核心引擎。

社区反应

截至数据抓取时，Stars: 22,938，Forks: 2,896。这是一个极高的 Star/Fork 比（约 7.9），表明开发者对其技术实现和架构设计有强烈兴趣，而不仅仅是概念炒作。Open Issues 为 48 个，相对于其体量来说控制得当。主语言 TypeScript + MIT License 进一步促进了社区贡献意愿。

怎么上手

环境要求： Node.js >= 22.13, Bun (推荐)。

最小复现步骤： 1. 快速运行编辑器与 MCP 服务： bash npx @pascal-app/cli editor 2. 连接 AI Agent (以 Claude Code 为例)： - 安装技能：npx skills add pascalorg/editor --skill pascal-3d - 配置连接：pascal mcp setup claude - 在 Claude Code 中通过 /plugin marketplace add pascalorg/editor 加载插件。 3. 本地开发： bash bun install && bun dev # 启动 Next.js Dev Server (Port 3002)

争议与局限

WebGPU 兼容性：依赖 WebGPU API，目前仅支持最新版的 Chrome/Edge/Firefox。在 Safari 或旧版浏览器上可能无法运行，限制了普及度（推断自技术栈）。
Agent 安全性：虽然 MCP 提供了沙箱隔离，但允许 AI Agent 直接修改几何体（如删除墙体、移动家具）仍存在误操作风险。README 提到需配置“collision-free”检查，但未详细说明防止恶意或荒谬生成的约束机制。
数据格式锁定：场景状态深度绑定内部的 Node Schema 和 Zustand Store。虽然提供了导出，但与其他主流 CAD/BIM 格式（如 IFC, DWG）的互操作性在 README 中未明确提及，可能存在生态孤岛风险。