nodes/jtydhr88-ComfyUI-PascalEditor

Fork 0

Files

T

Terry Jia 478a9d9c3f 0.4.0: update bundled Pascal Editor to upstream v0.9.1

2026-07-27 09:35:37 -04:00

4.6 KiB

Raw Permalink Blame History

ComfyUI-PascalEditor

一个将 Pascal Editor（全功能 3D 建筑编辑器）直接集成到 ComfyUI 工作流中的插件。

English

更新说明（v0.4.0）

本版本将内置的 Pascal Editor 从 0.6.0 更新到上游 v0.9.1，一次带来四个 minor 版本的编辑器改进：

Paint slots 材质系统 v2 — 按槽位上漆（slab 顶面/侧面拆分）、动态材质库（分类浏览、就地创建场景材质）
纵向建筑模型 — 按层存储层高、墙体翻转、露台（deck）
组操作 — Photoshop 风格的多选移动、旋转、复制
放置与交互大改 — FSM 驱动的放置流程，墙体/围栏/屋顶/楼梯/机电全面模式化吸附，上下文 HUD
烘焙 GLB 导出 — 动画剪辑一并烘焙（门、风扇），GLB 漫游查看器带 LOD，纹理引用导出模式
平面图升级 — 按楼层多页 PDF 导出、施工图文档、导航性能大幅提升
测量工具 — 生产级测量工具、自然语言尺寸输入、所有长度输入统一支持公制/英制
渲染与光照 — 以太阳为主的光照风格、天空背景、贴地地平线
插件系统 — 插件契约 + 官方 Nature 包（树木、花草）
漫游改进 — 下蹲、更宽 FOV、调优的行走/奔跑/跳跃速度、统一查看器 UI
新增门开启动画（推拉/车库/折叠/暗藏/谷仓）、横板围栏样式、音效，以及数百项修复

注意：上游的云端场景 API 与实时协作属于服务端功能，不包含在此静态嵌入版本中。

插件侧改动：

场景加载/保存改走上游的 build JSON 校验流程，并保留已安装插件状态；加载后正确重置撤销历史
插件路由新增托管编辑器的 fonts/、hdri/、material/ 资源目录

功能特性

完整的 3D 建筑编辑器 — 在 ComfyUI 节点中直接创建和编辑建筑、墙体、地板、天花板、屋顶、门窗、楼梯、围栏和区域
截图输出 — 运行工作流时自动捕获当前 3D 视口画面作为 IMAGE 输出，可直接用于 img2img、ControlNet 等
可配置分辨率 — 节点上的 width/height 控制输出图片大小（中心裁切 + LANCZOS 缩放，不拉伸变形）
3D 模型导出 — 通过节点按钮导出 GLB、STL 或 OBJ 格式的 3D 模型
场景保存和加载 — 将建筑布局保存为 JSON 文件，随时重新加载
全屏模式 — 在全屏对话框中打开编辑器，获得更好的编辑体验
顶部菜单 — ComfyUI 顶部菜单栏快捷访问按钮
可折叠 UI — 侧边栏和工具栏可折叠/拖拽，最大化视口空间

安装

将此仓库克隆到 ComfyUI 的 custom_nodes 目录：

cd ComfyUI/custom_nodes
git clone https://github.com/jtydhr88/ComfyUI-PascalEditor.git

重启 ComfyUI，Pascal Editor 节点将出现在 PascalEditor 分类下。

使用方法

作为节点使用

将 Pascal Editor 节点添加到工作流
在嵌入的 3D 编辑器中设计建筑
将 image 输出连接到下游节点（如 Preview Image、img2img、ControlNet）
运行工作流 — 当前视口画面会自动捕获并输出

节点按钮

按钮	功能
Export GLB	下载 GLB 格式的 3D 模型
Export STL	下载 STL 格式的 3D 模型
Export OBJ	下载 OBJ 格式的 3D 模型
Save Build	将当前场景保存为 JSON 文件
Load Build	加载之前保存的 JSON 场景
Fullscreen	在全屏对话框中打开编辑器

顶部菜单

点击 ComfyUI 顶部菜单栏中的 Pascal Editor 按钮，在全屏对话框中打开编辑器。

直接访问

通过浏览器直接访问：http://127.0.0.1:8188/pascal-editor/

开发

环境要求

Node.js 18+
Bun 包管理器

构建插件扩展

cd ComfyUI/custom_nodes/ComfyUI-PascalEditor
npm install
npm run build

重新构建编辑器 UI

pascal-editor-ui/ 目录包含预构建的编辑器。如需从源码重新构建，请切换到 pascalorg/editor 的 feat/comfyui-plugin-v3 分支并运行：

bun install
bun scripts/build-comfyui.mjs

然后将 apps/editor/out/ 覆盖到本插件的 pascal-editor-ui/ 目录。

致谢

本插件集成了 Pascal 开发的 Pascal Editor — 一个基于 React Three Fiber、Three.js 和 Next.js 构建的开源 3D 建筑编辑器。

许可证

MIT

4.6 KiB Raw Permalink Blame History Unescape Escape