Pascal Editor
本地运行 Pascal：版本化程序、两个服务与持久数据
沿 CLI 安装器检查回环监听、MCP 令牌和数据库路径，避免升级时把程序文件与用户项目混为一谈。
你将学会
- CLI 管理的不只是一个网页
- 程序目录和项目数据分别管理
- 本地健康与公网部署是不同结果
开始前需要
- 基础场景图、JavaScript 和 HTTP 知识
- 尺寸与关系具有明确预期的自有小场景
解释实现边界，复现本章检查清单或窄范围图练习。
先看结论
- 编辑器和 MCP 是分别监督的服务。
- 程序目录与持久项目必须分开处理。
- 本地健康不能证明公网托管就绪。
CLI 管理的不只是一个网页
运行清单分别指定编辑器、MCP 入口与健康路径。安装器验证字段，限制版本名称字符，检查解析后的入口仍在运行目录内，并确认文件存在。安装使用锁和临时副本后再激活；这些是实现检查，不能被描述为密码学签名验证。
进程管理器在 127.0.0.1 上选择可用端口启动编辑器，形成 pascal.localhost 地址，再用另一个回环端口启动 MCP。它分别等待两个健康检查并记录进程身份。启动失败时清理由它启动的进程及状态、令牌文件；本次没有执行这些生命周期操作。
程序目录和项目数据分别管理
启动器通过 PASCAL_DATA_DIR 明确传入服务数据目录。可复用 SQLite 存储还支持 PASCAL_DB_PATH、数据目录覆盖以及 Windows APPDATA、XDG 等平台默认路径。因此，README 的家目录简写不是所有宿主或嵌入方式的统一位置，备份与迁移前必须解析实际路径。
MCP 进程获得新生成的令牌，本地连接器从请求受限权限的文件读取它。项目数据应独立于版本化程序目录保留，令牌文件则应受保护，不放进文档或诊断输出。应用升级不能通过删除整个用户数据根目录来完成。
本地健康与公网部署是不同结果
编辑器与 MCP 都健康，只能说明本地监督器的检查通过，不能证明浏览器渲染、持久化或共享公网访问已经可靠。所查传输层只允许带令牌的非回环绑定，但这一个条件并不提供 TLS、租户授权、资源策略或运行恢复。
本地评估保留回环地址，记录程序版本，导出非敏感项目并在升级前测试恢复。公开托管需结合宿主应用与认证模型另行设计。下面记录的是未执行的本地基线，不把 CLI 包装成可直接使用的多租户部署方案。
实施步骤
- 1
检查运行清单与选择的软件包版本。
- 2
安装升级前解析实际数据目录。
- 3
保留回环监听，保护生成令牌。
- 4
用测试项目验证保存、导出和恢复。
可复制示例
{"editorHost":"127.0.0.1","mcpHost":"127.0.0.1","services":["编辑器","MCP"],"dataPathMustBeResolved":true,"publicHostingVerified":false,"runtimeExecuted":false}常见问题
数据库总在相同家目录位置吗？
不是。环境覆盖与平台默认值会影响可复用存储，受管启动器也会传入选定数据目录。
运行清单检查等于发行者签名验证吗？
不是。所查代码检查结构、路径和文件存在性，不能把这些写成签名验证。
资料来源
- README.md来源核查 2026-09-08
- LICENSE来源核查 2026-09-08
- packages/cli/package.json来源核查 2026-09-08
- packages/core/package.json来源核查 2026-09-08
- packages/viewer/README.md来源核查 2026-09-08
- packages/cli/src/runtime.ts来源核查 2026-09-08
- packages/cli/src/editor-process.ts来源核查 2026-09-08
- packages/cli/src/mcp-connector.ts来源核查 2026-09-08
- packages/mcp/src/transports/http.ts来源核查 2026-09-08
- packages/mcp/src/storage/sqlite-scene-store.ts来源核查 2026-09-08
- packages/core/src/store/use-scene.ts来源核查 2026-09-08
- packages/viewer/src/components/renderers/node-renderer.tsx来源核查 2026-09-08
- packages/viewer/src/lib/renderer-capability.ts来源核查 2026-09-08
- packages/core/src/validation/validate-build-json.ts来源核查 2026-09-08
- packages/core/src/utils/heal-scene-graph.ts来源核查 2026-09-08
- packages/mcp/src/storage/slug.ts来源核查 2026-09-08