项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 25331
使用教程
环境要求
- Node.js 22.13 或更新版本
- npm(用于 npx 与全局安装 CLI)
- 使用源码开发模式时需要 Bun
- 浏览器(用于打开本地编辑器界面,可选)
安装与启动步骤
-
1确认 Node 版本
Pascal 要求 Node.js 22.13 或更新版本,版本过低无法运行 CLI。
node -v -
2直接运行编辑器
无需克隆仓库,直接拉起编辑器;CLI 会同时启动鉴权 MCP 服务并自动选择无冲突回环端口。
npx @pascal-app/cli editor -
3全局安装 CLI
装好后可直接使用 pascal 命令,便于反复启动编辑器或连接 MCP。
npm install --global @pascal-app/cli -
4连接 AI 智能体
让智能体以此命令启动 MCP 连接,不需要编辑器进程,也不需要下载 Web 运行时。
pascal mcp connect -
5源码开发模式
克隆仓库后安装依赖并启动 watch 开发服务器,会先构建各包再启动编辑器。
bun install bun dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
PASCAL_HOME | 否 | 指定独立的 Pascal 主目录,用于隔离并发工作 | ~/pascal-home-a |
如何确认成功
终端出现本地回环访问地址且编辑器可打开;项目数据写入 ~/.pascal/data/pascal.db。
常见问题
Q:必须克隆仓库才能用吗?
A:不必。Node.js 22.13 以上执行 npx @pascal-app/cli editor 即可创建持久化本地安装,只有源码开发才需要克隆仓库。
Q:AI 智能体该怎么接入?
A:把智能体配置为启动 pascal mcp connect 即可,该命令不依赖编辑器进程,也不需要下载编辑器运行时。
Q:项目数据保存在哪里?
A:默认保存在 ~/.pascal/data/pascal.db。用不同 PASCAL_HOME 目录可让多份工作互不干扰。
Q:多个客户端能同时用吗?
A:本地 CLI 服务只应配一个活跃智能体客户端。需要并发独立工作时,用不同的 PASCAL_HOME 目录和各自的服务进程。
Q:端口冲突怎么办?
A:CLI 会自动选择不冲突的本地回环端口,一般无需手动指定端口。
注意事项
- 首次启动编辑器的命令会按版本下载一次 Web 编辑器运行时,并用包内发布的摘要进行校验。
- pnpm/Bun 的等价命令、项目管理、MCP 配置、更新与存储路径、故障排查见官网 Run Pascal locally 文档。
- 全局安装 pascal 命令后,可直接用 pascal 相关子命令,无需每次走 npx。
核心亮点
- 同时提供本地 CLI 和 MCP 工具,人类与 AI 智能体共用同一套建模能力
- local-first 架构,建筑数据留在本地,适合对隐私和可控性有要求的团队
- TypeScript 实现,前端/Node 生态开发者容易二次开发和集成
不足之处
- 建筑/BIM 领域专业功能深度相比成熟商业 CAD/BIM 软件仍有差距
- MCP 与智能体生态较新,相关工具链和最佳实践仍在演进
适用场景
- AI 智能体根据自然语言需求自动生成和修改建筑平面与三维模型
- 建筑师用本地 CLI 批量处理、脚本化生成或转换建筑构件数据
- 在 Gemini CLI 等智能体环境中通过 MCP 调用建模工具做设计辅助
替代项目
Blender、FreeCAD、OpenSCAD
上一篇:esp-claw
下一篇:awesome-ai-agent
同类项目推荐
MetaGPT
开源
AI 团队流水线开工,产品经理到码农齐活
The Multi-Agent Framework: First AI Software Company, Towards Natural Language Progr···
agent-device
开源
让 AI 代理直接操控手机,自动化测试与交互一步到位
Open source device layer for AI coding agents: a CLI, MCP server, and typed Node.js ···
ling-stack
开源
自带模型,本地管好 AI 队友的对话与审批
Local-first AI teammate workspace. Bring your own models and keep project conversati···
py-xiaozhi
开源
一套 Python 框架,把语音、多模态和硬件设备接成 AI 助手
Open-source AI assistant ecosystem with MCP integrations, multimodal workflows, IoT ···
tribe
开源
低代码搭建多智能体团队,快速实现复杂自动化
Low code tool to rapidly build and coordinate multi-agent teams
rai
开源
用自然语言指挥 ROS 2 机器人干活
RAI is a vendor agnostic agentic framework for Physical AI robotics, utilizing ROS 2···
re_gent
开源
给 AI 编程代理装上时光机,随时回滚任何一次自动修改
Version control for AI agents — track what your agent did, blame any line to a prom···
lnwjud
开源
本地跑 AI 智能体,统一接管 MCP 工具与桌面自动化
lnwjud — local AI-agent runtime & MCP gateway
openclaw-superpowers
开源
给 OpenClaw 装上 44 个即插即用技能,让智能体自学新招
44 plug-and-play skills for OpenClaw — self-modifying AI agent with cron scheduling···
