
editor
用命令行和 AI 智能体直接编辑 3D 建筑模型
editor 是一个开源的三维建筑编辑器,面向建筑师、设计师和 AI 智能体。它把传统 3D 建模能力与本地优先(local-first)架构结合,提供本地 CLI 命令行工具和 MCP(Model Context Protocol)工具集,让人类用户和 AI 智能体都能直接操作建筑模型。项目核心解决的是「AI 难以直接编辑专业 3D/BIM 数据」的问题:通过 MCP Server 暴露建模、楼层平面、构件操作等能力,AI 智能体可以像调用工具一样生成和修改建筑方案,而人类则用 CLI 做批处理与自动化。技术栈为 TypeScript,支持 3D、CAD、BIM、floorplan 等概念,并带有 Gemini CLI 扩展和 agent-skills 相关集成,强调数据留在本地、可脚本化、可被智能体驱动,适合做 AI 辅助建筑设计与自动化建模的底座。
项目数据
使用教程
环境要求
- Node.js 22.13 或更新版本
- npm(用于 npx 与全局安装 CLI)
- 使用源码开发模式时需要 Bun
- 浏览器(用于打开本地编辑器界面,可选)
安装与启动步骤
-
1确认 Node 版本
Pascal 要求 Node.js 22.13 或更新版本,版本过低无法运行 CLI。
node -v -
2直接运行编辑器
无需克隆仓库,直接拉起编辑器;CLI 会同时启动鉴权 MCP 服务并自动选择无冲突回环端口。
npx @pascal-app/cli editor -
3全局安装 CLI
装好后可直接使用 pascal 命令,便于反复启动编辑器或连接 MCP。
npm install --global @pascal-app/cli -
4连接 AI 智能体
让智能体以此命令启动 MCP 连接,不需要编辑器进程,也不需要下载 Web 运行时。
pascal mcp connect -
5源码开发模式
克隆仓库后安装依赖并启动 watch 开发服务器,会先构建各包再启动编辑器。
bun install bun dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
PASCAL_HOME | 否 | 指定独立的 Pascal 主目录,用于隔离并发工作 | ~/pascal-home-a |
如何确认成功
终端出现本地回环访问地址且编辑器可打开;项目数据写入 ~/.pascal/data/pascal.db。
常见问题
Q:必须克隆仓库才能用吗?
A:不必。Node.js 22.13 以上执行 npx @pascal-app/cli editor 即可创建持久化本地安装,只有源码开发才需要克隆仓库。
Q:AI 智能体该怎么接入?
A:把智能体配置为启动 pascal mcp connect 即可,该命令不依赖编辑器进程,也不需要下载编辑器运行时。
Q:项目数据保存在哪里?
A:默认保存在 ~/.pascal/data/pascal.db。用不同 PASCAL_HOME 目录可让多份工作互不干扰。
Q:多个客户端能同时用吗?
A:本地 CLI 服务只应配一个活跃智能体客户端。需要并发独立工作时,用不同的 PASCAL_HOME 目录和各自的服务进程。
Q:端口冲突怎么办?
A:CLI 会自动选择不冲突的本地回环端口,一般无需手动指定端口。
注意事项
- 首次启动编辑器的命令会按版本下载一次 Web 编辑器运行时,并用包内发布的摘要进行校验。
- pnpm/Bun 的等价命令、项目管理、MCP 配置、更新与存储路径、故障排查见官网 Run Pascal locally 文档。
- 全局安装 pascal 命令后,可直接用 pascal 相关子命令,无需每次走 npx。
核心亮点
- 同时提供本地 CLI 和 MCP 工具,人类与 AI 智能体共用同一套建模能力
- local-first 架构,建筑数据留在本地,适合对隐私和可控性有要求的团队
- TypeScript 实现,前端/Node 生态开发者容易二次开发和集成
不足之处
- 建筑/BIM 领域专业功能深度相比成熟商业 CAD/BIM 软件仍有差距
- MCP 与智能体生态较新,相关工具链和最佳实践仍在演进
适用场景
- AI 智能体根据自然语言需求自动生成和修改建筑平面与三维模型
- 建筑师用本地 CLI 批量处理、脚本化生成或转换建筑构件数据
- 在 Gemini CLI 等智能体环境中通过 MCP 调用建模工具做设计辅助
替代项目
Blender、FreeCAD、OpenSCAD
项目介绍
上一篇:esp-claw
下一篇:awesome-ai-agent
同类项目推荐
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
AutoGPT
开源
开箱即用的 AI 员工,交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
agent-manager
开源
一站式管理企业 AI 代理,部署治理全搞定
WSO2 AI Agent Manager is an open control plane designed for enterprises to deploy, m···