
如何5分钟跑通Pascal Editornpx CLI一键启动3D编辑器完整教程【免费下载链接】editorOpen-source 3D architectural editor with a local CLI, MCP tools, and practical workflows for humans and AI agents.项目地址: https://gitcode.com/GitHub_Trending/editor93/editorPascal Editor 是一款开源的本地优先 3D 建筑编辑器基于 React Three Fiber 与 WebGPU 构建支持在浏览器中运行也提供 npx CLI 一键本地启动方式并内置 MCP 工具让人类和 AI 智能体都能高效建模。本文将带你用一条npx命令在 5 分钟内跑通这个 3D 编辑器并掌握常用的 CLI 管理命令。一、Pascal Editor 是什么Pascal Editor 的核心能力包括 3D 建筑设计墙体、楼板、门窗、屋顶、区域划分全部语义化建模内置家具与构件库从沙发、办公桌到空调、风管开箱即用本地优先项目数据保存在本机 SQLite 数据库无需上传云端AI 智能体接入通过 MCPModel Context Protocol让 AI 客户端直接读写你的 3D 项目想深入了解源码架构可阅读根目录的 README.md 和 SETUP.md。↑ Pascal 3D 编辑器内置家具库中的沙发模型渲染预览二、一键安装启动npx 命令一行搞定前置要求条件说明Node.js22.13 或更高版本npm必须可用即使用 pnpm/Bun 启动 CLI 也需 npm浏览器除非加--no-open参数网络首次启动需下载 Web 运行时约 64 MB启动命令在任意终端目录执行npx pascal-app/cli editor这条命令会自动完成安装 Web 运行时—— 首次运行下载编辑器运行时到~/.pascal/runtime/version/并校验 SHA-256 摘要防止损坏或被篡改的安装包启动编辑器 MCP 服务—— 自动选择无冲突的本地回环端口不与你的其他开发服务器抢端口打开浏览器—— 跳转到http://pascal.localhost:port注册pascal命令—— 交互式首次运行后CLI 会自动全局安装同版本之后可直接用pascal短命令 使用 pnpm 或 Bun 的开发者也可以分别执行pnpm dlx pascal-app/cli editor或bunx pascal-app/cli editor。↑ 编辑器内置 3D 家具库中的办公桌模型三、常用 CLI 命令速查表启动之后日常管理和排查基本靠这几条命令完整列表见 packages/cli/README.md命令用途pascal status查看编辑器与 MCP 的健康状态、版本、端口pascal logs --follow实时跟踪编辑器日志pascal stop停止后台的编辑器和 MCP 进程pascal restart按当前配置重启服务pascal projects列出本地所有项目pascal open 项目名打开指定项目pascal doctor一键体检Node、存储、运行时、进程全检查pascal update带健康检查的运行时升级失败自动回滚实用启动参数# 无头服务器不打开浏览器 npx pascal-app/cli editor --no-open # 前台模式日志直接输出到当前终端 npx pascal-app/cli editor --foreground --no-open # 指定端口被占用时会安全换端口并提示 npx pascal-app/cli editor --port 3000↑ 编辑器构件库中的 3D 门组件支持语义化放置与开启角度建模四、连接 AI 智能体MCP 一步到位Pascal 最独特的地方是AI 原生支持。MCP 服务随 CLI 自动启动让 Codex、Claude Code、Cursor 等客户端直接操作你的本地 3D 项目# 为 Codex 或 Claude 配置 MCP 连接不会覆盖已有配置 pascal mcp setup codex pascal mcp setup claude # JSON 格式的 MCP 客户端配置 pascal mcp config配置完成后你可以在 AI 客户端中这样对话帮我建一个 3x4 米的客厅加一扇门和两扇窗再摆一张沙发。AI 会通过语义化工具create_room、add_door、place_item、furnish_room等完成建模并通过validate_scene验证、save_scene持久化最后返回可点击的本地编辑器链接。 两个值得关注的 Agent 技能包pascal-3d安全连接本地/托管 MCP 并做已验证的场景工作furniture-fit基于证据的家具摆放空间评估↑ 设备库中的 3D 空调模型MCP 智能体可通过 place_item 工具直接放置五、进阶从源码本地启动开发者路线如果你想参与开发而不是直接使用也可以克隆仓库本地运行git clone https://gitcode.com/GitHub_Trending/editor93/editor cd editor # 安装依赖项目使用 Bun 管理 bun install # 启动开发服务器自动构建 core 与 viewer 包并开启热更新 bun dev打开http://localhost:3002即可看到编辑器。仓库采用 Turborepo monorepo 结构关键目录路径职责apps/editor/Next.js 编辑器应用packages/core/节点 Schema、场景状态、空间查询packages/viewer/React Three Fiber 3D 渲染运行时packages/nodes/内置节点定义与渲染器packages/cli/本地编辑器安装器与进程管理器packages/mcp/MCP 服务器与场景存储⚠️ 注意bun dev必须从仓库根目录执行这样才能让 core 与 viewer 包的热更新监听生效。六、数据存储与常见问题数据在哪里所有本地数据集中在~/.pascal/目录~/.pascal/ runtime/version/ # 已安装的 Web 编辑器运行时 data/pascal.db # 项目与场景数据SQLite logs/editor.log # 后台日志 run/ # 进程标识与 MCP 令牌关键点运行时与项目数据生命周期分离——升级 CLI 不会覆盖你的作品CLI 也不提供删除项目数据的命令。遇到问题怎么办症状解法启动异常运行npx pascal-app/cli doctor全面体检想看日志pascal logs --follow端口冲突加--port n指定端口冲突时会自动换端口离线/内网机器联网机器下载运行时归档目标机用pascal editor --runtime ./归档文件进程卡死pascal stop --force受保护的恢复路径七、总结用一句话概括本文的核心操作Node.js 22.13 环境下执行npx pascal-app/cli editor5 分钟内即可在本机跑起完整的 Pascal 3D 编辑器项目数据本地存储AI 智能体还能通过 MCP 直接参与建模。无论你是想快速体验开源 3D 建筑编辑还是构建自己的 AI 建筑设计工作流Pascal Editor 的 npx CLI 都是最低摩擦的入口。动手试试吧【免费下载链接】editorOpen-source 3D architectural editor with a local CLI, MCP tools, and practical workflows for humans and AI agents.项目地址: https://gitcode.com/GitHub_Trending/editor93/editor创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考