尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

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

Pascal Editor CLI使用指南:一条命令启动3D编辑器与AI MCP服务的完整教程 Pascal Editor CLI使用指南一条命令启动3D编辑器与AI MCP服务的完整教程【免费下载链接】editorCreate and share 3D architectural projects.项目地址: https://gitcode.com/GitHub_Trending/editor93/editorPascal Editor是一款开源的 3D 建筑设计编辑器而它的Pascal Editor CLI可以帮你用一条命令同时启动完整的本地 3D 编辑器与内置的AI MCP 服务——无需克隆仓库、无需手动构建。这篇文章是一份面向新手的 Pascal Editor CLI 使用指南覆盖环境要求、一键启动流程、常用命令速查、AI 智能体接入方法以及本地数据与安全防护机制读完即可在你的终端里跑起一套编辑器 AI 建筑助手的本地工作流。为什么值得用 Pascal Editor CLI5个核心优势 相比在浏览器里打开网页版CLI 方式更适合开发者和重度用户优势说明一条命令运行pascal editor自动完成安装、端口选择、进程启动与健康检查项目本地化场景数据保存在本地 SQLite 数据库~/.pascal/data/pascal.db编辑器 MCP 同步启动AI 智能体可直接操作你本地的项目无需额外配置终端独立管理启动、停止、查日志、看状态都由终端命令完成健康检查式更新pascal update激活新运行时前做健康检查失败自动回滚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。首次运行是一个自动化的向导流程终端会实时显示进度准备本地存储创建~/.pascal下的项目、运行时、日志等目录安装运行时下载编辑器所需的独立运行时与你的项目数据分离自动选择端口向操作系统申请空闲的 loopback 端口不与本地其他开发服务器冲突启动进程同时拉起编辑器进程与经过认证的 MCP 服务进程双重健康检查编辑器与 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命令作用pascal editor按需安装、确保编辑器运行并打开pascal start确保编辑器运行不打开浏览器pascal stop [--force]停止受管理的编辑器与 MCP 进程pascal restart以当前配置重启编辑器与 MCP 服务pascal status [--json]查看编辑器与 MCP 的健康状态、版本、端口、URLpascal open [project]打开编辑器或按 ID/名称打开指定项目pascal resume [project]打开最近项目或指定项目pascal projects [--json]列出本地项目pascal logs [--follow]查看或实时跟踪编辑器日志pascal update [--version v]健康检查后激活已发布的运行时pascal doctor [--json]诊断 Node.js、存储、运行时、进程与插件状态进程管理逻辑状态文件、端口选择、健康检查实现在 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/redoAI 的每次改动都可撤销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 是否在运行pascal status --json怀疑环境或进程有问题pascal doctor覆盖 Node、存储、运行时、插件端口被占用CLI 会自动改选端口并提示也可用--port n指定日志排查pascal logs --follow更新到新版本pascal update健康检查失败会自动回滚MCP 连接器的完整实现stdio 桥接 Bearer 认证可阅读 packages/cli/src/mcp-connector.ts。总结Pascal Editor CLI 用一条npx pascal-app/cli editor命令就把本地 3D 建筑编辑器 认证 MCP 服务整套拉了起来项目留在本地 SQLiteAI 智能体通过pascal mcp connect稳定接入并能实时驱动你的场景。对新手的建议路径是先按本文流程跑通一键启动再用pascal status、pascal doctor熟悉状态查看最后用pascal mcp setup接上你的 AI 客户端——从一句话需求到一栋可撤销、可实时预览的建筑中间只隔着你的一句话。【免费下载链接】editorCreate and share 3D architectural projects.项目地址: https://gitcode.com/GitHub_Trending/editor93/editor创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表