企业官网建设流程全解析

Pascal Editor CLI使用指南：一条命令启动3D编辑器与AI MCP服务的完整教程

【免费下载链接】editorCreate and share 3D architectural projects.项目地址: https://gitcode.com/GitHub_Trending/editor93/editor

Pascal Editor是一款开源的 3D 建筑设计编辑器，而它的Pascal Editor CLI可以帮你用一条命令，同时启动完整的本地 3D 编辑器与内置的AI MCP 服务——无需克隆仓库、无需手动构建。这篇文章是一份面向新手的 Pascal Editor CLI 使用指南，覆盖环境要求、一键启动流程、常用命令速查、AI 智能体接入方法，以及本地数据与安全防护机制，读完即可在你的终端里跑起一套"编辑器 + AI 建筑助手"的本地工作流。

为什么值得用 Pascal Editor CLI：5个核心优势 🚀

相比在浏览器里打开网页版，CLI 方式更适合开发者和重度用户：

CLI 的完整能力在 packages/cli/README.md 中有详细说明，编辑器本体基于 React Three Fiber + WebGPU 构建，架构介绍见根目录 README.md。

安装前检查：只需满足2个条件

在使用 Pascal Editor CLI 之前，请确认环境满足以下要求：

• Node.js 22.13 或更高版本，以及 npm
• 一个浏览器（无头服务器可加--no-open跳过打开浏览器）

初始正式发布版本支持 macOS，打包运行时也已通过 Ubuntu 的自动化冒烟测试，更广泛的 Linux 与 Windows 支持仍在验证中。检查版本只需：

node -v

一键启动步骤：pascal editor全流程解析

打开终端，执行下面这条命令，Pascal Editor CLI 就开始工作：

npx @pascal-app/cli editor

如果你偏好其他包管理器，对应写法是pnpm dlx @pascal-app/cli editor或bunx @pascal-app/cli editor。

首次运行是一个自动化的向导流程，终端会实时显示进度：

1. 准备本地存储：创建~/.pascal下的项目、运行时、日志等目录
2. 安装运行时：下载编辑器所需的独立运行时（与你的项目数据分离）
3. 自动选择端口：向操作系统申请空闲的 loopback 端口，不与本地其他开发服务器冲突
4. 启动进程：同时拉起编辑器进程与经过认证的 MCP 服务进程
5. 双重健康检查：编辑器与 MCP 各自通过健康检查后，自动打开http://pascal.localhost:<port>

首次通过npx成功运行后，CLI 会顺带全局安装同版本的 CLI，之后你可以直接使用简短的pascal命令（status、logs、stop等）。如果全局安装因 npm 权限失败，编辑器会保持运行，CLI 也会提示等价的npx替代命令。

几个常用启动参数：

• --no-open：无头机器上使用，不打开浏览器
• --foreground：让进程监督程序接管编辑器，或把日志挂到当前终端
• --port <n>：指定端口；若被占用，会提示并安全地改选其他端口

启动完成后，你就能在本地 3D 编辑器中画墙、建房间、放置家具了。以下模型都来自编辑器内置素材库：

日常命令速查表：编辑器进程管理

安装完成后，以下命令覆盖了日常使用的所有场景（未全局安装时在命令前加npx @pascal-app/cli）：

进程管理逻辑（状态文件、端口选择、健康检查）实现在 packages/cli/src/editor-process.ts，诊断逻辑见 packages/cli/src/diagnostics.ts。

AI MCP 服务接入：让 AI 智能体直接编辑你的场景 🤖

这是 Pascal Editor CLI 最有意思的能力：MCP 服务器会随pascal editor自动启动，把编辑器 UI 使用的同一套场景操作（建墙、放家具、开门窗、撤销等）以 MCP 工具的形式暴露给任意兼容的 AI 宿主（Codex、Claude Code、Cursor 等）。

接入只需三步：

第 1 步：确认 MCP 服务已随编辑器启动

pascal editor pascal mcp status

第 2 步：为客户端配置一次稳定连接器

pascal mcp setup codex # 配置 Codex pascal mcp setup claude # 配置 Claude Code

使用 JSON 配置文件的客户端（如 Claude Desktop、Cursor）则运行pascal mcp config获取通用配置片段。核心条目是启动pascal mcp connect——这是一个稳定的 stdio 连接器：它会自动发现动态分配的本地端口，因此客户端配置里既不含变化的端口，也不含密钥；即使编辑器当时处于停止状态，AI 连接进来时它还会自动把 Pascal 启动起来。

第 3 步：让 AI 开工

让智能体读取pascal://agent-guide资源，然后加载场景、编辑、并取回editorUrl回到编辑器查看结果。MCP 暴露了 30 多个工具，常用的包括：

• create_room：从多边形一键生成房间（区域 + 楼板 + 天花 + 墙体）
• add_door/add_window：参数化地在墙上开门窗
• furnish_room：按房间类型自动摆放真实感家具
• apply_patch：批量创建/更新/删除/移动，提交前会先做 dry-run 校验
• undo/redo：AI 的每次改动都可撤销

AI 改的和你浏览器里看的是同一个场景：MCP 的修改写入本地 SQLite 并记录到scene_events流，编辑器页面通过 server-sent events 订阅该流，AI 每做一步修改，打开的浏览器标签页就会实时同步更新。一个完整的"从一句话需求生成两居公寓"的会话示例，可以参考 packages/mcp/examples/generate-apartment.md；坐标约定详见 packages/mcp/README.md。

本地数据与安全：你的项目只留在你的机器上 🔒

Pascal Editor CLI 的安全设计对新手很友好，记住三点即可：

• 只监听本机：编辑器与 MCP 服务都只绑定127.0.0.1，并使用保留的.localhost主机名，不对外网暴露
• MCP 需要随机令牌：令牌保存在 Pascal 私有运行时目录中，客户端配置永远不会包含它
• 数据与运行时分离：更新 CLI 不会覆盖你的作品，且保留旧运行时用于回滚

本地目录结构如下：

~/.pascal/ runtime/<version>/ 已安装的编辑器运行时 data/pascal.db 项目与场景（SQLite） logs/editor.log 脱离终端的编辑器输出 run/editor.json 受管理进程身份 run/mcp-token 私有本地 MCP 令牌 plugins/ 保留的插件存储

CLI 不提供删除项目数据的命令，pascal doctor会在运行时版本累积超过 3 个时给出警告。

常见问题快速排查清单

MCP 连接器的完整实现（stdio 桥接 + Bearer 认证）可阅读 packages/cli/src/mcp-connector.ts。

总结

Pascal Editor CLI 用一条npx @pascal-app/cli editor命令，就把"本地 3D 建筑编辑器 + 认证 MCP 服务"整套拉了起来：项目留在本地 SQLite，AI 智能体通过pascal mcp connect稳定接入并能实时驱动你的场景。对新手的建议路径是：先按本文流程跑通一键启动，再用pascal status、pascal doctor熟悉状态查看，最后用pascal mcp setup接上你的 AI 客户端——从"一句话需求"到"一栋可撤销、可实时预览的建筑"，中间只隔着你的一句话。

【免费下载链接】editorCreate and share 3D architectural projects.项目地址: https://gitcode.com/GitHub_Trending/editor93/editor