- 普通用户：从 GitHub Releases 下载
OpenBrep-*-macOS.zip或OpenBrep-*-Windows.zip - 解压后运行
OpenBrep - 命令行 / 开发者用户再使用
git clone或pipx安装
简体中文 | English
OpenBrep — 面向 ArchiCAD 高阶用户和 GDL 开发者的 AI 工作台。编译验证、知识驱动、资产可追溯。
Code Your Boundaries
正式发布版本 v1.0.0 — Tauri 桌面工作台正式落地。React + Tauri + Python sidecar 全栈架构，Streamlit 完全退役，自愈编译循环与知识图谱驱动稳定运行。
你用 AI 写了一段 GDL 代码，想在 ArchiCAD 里测试。传统路径：
打开库对象编辑器 → 手动填参数 → 切 5 个 Script 窗口 → 粘代码 → 编译
openbrep 把这个流程压缩到：
描述需求（中文/英文皆可）→ AI 生成并填入脚本框 → 一键编译 → .gsm 拖入 ArchiCAD
或者导入已有 .gsm 文件，让 AI 帮你 debug、重构、加参数。
访问 GitHub Releases，下载对应系统的压缩包：
- macOS：
OpenBrep-free-macOS.zip - Windows：
OpenBrep-free-Windows.zip
Current macOS package compatibility: Apple Silicon only (arm64, M1/M2/M3/M4), macOS 14 Sonoma or later. Intel Mac is not covered by the current macOS zip.
On macOS, unzip it, open the OpenBrep folder, and double-click OpenBrep.command. On Windows, unzip it and run OpenBrep.exe. This path does not require users to learn git clone, git pull, or manual Python dependency installation first.
Temporary macOS Gatekeeper workaround:
The current macOS zip is not yet Developer ID signed and notarized. If macOS shows security warnings or blocks the app even after you confirm the prompts, remove the quarantine flag from the unzipped folder:
xattr -dr com.apple.quarantine /path/to/OpenBrepTip: type xattr -dr com.apple.quarantine in Terminal, keep the trailing space, drag the unzipped OpenBrep folder into Terminal, then press Enter. After that, run OpenBrep.command again.
We are preparing a properly signed and notarized macOS package so this manual step will not be needed.
OpenBrep 是 Python 应用。正式发布到 PyPI 后，推荐用隔离工具安装：
pipx install "openbrep[ui]"
obr或使用 uv：
uv tool install "openbrep[ui]"
obrgit clone https://github.com/byewind1/openbrep.git
cd openbrep
bash install.sh
obr如果
obr不可用，重开终端或运行source ~/.zshrc
obr默认仅在本机http://localhost:8501启动 UI，不会自动打开浏览器；请用你的常用浏览器手动访问或直接使用已收藏地址。
cd openbrep
git pull origin main
bash install.sh # 有新依赖时重跑，无害
obr个人配置（config.toml / API Key）升级后保持不变，无需重新配置。
需要 Python 3.10+。真实编译（.gsm 输出）需要安装 ArchiCAD 28/29。
OpenBrep v1.0 采用全栈桌面架构：
React 前端 (Vite + Monaco + Three.js)
↕ HTTP/API
Python 后端 (ThreadingHTTPServer + Agent Runtime)
↕ stdout 握手协议
Tauri 桌面壳 (Rust/Tauri v2)
# 启动 React 开发服务器 + Python API（热重载）
obr
# 或等价命令
python3 scripts/obr7.py默认端口被占用时会自动换端口。如果提示 frontend/node_modules not found，先运行 cd frontend && npm install。
# 单端口模式：Python 同时服务 API + 前端静态资源
python3 scripts/obr7.py --tauri
# 完整 Tauri 桌面应用（开发模式）
PATH="$HOME/.cargo/bin:$PATH" npx @tauri-apps/cli@2 dev
# 打包 Tauri 桌面安装包
cd frontend && npm run build && cd ..
PATH="$HOME/.cargo/bin:$PATH" npx @tauri-apps/cli@2 buildTauri 模式下，Rust 壳负责 spawn Python 进程、捕获 OBR7_READY_URL 信号、打开 Webview 窗口，关窗时发送 /api/shutdown 并等待 Python 进程退出。
面向 GDL 开发者的终端工作流。
pip install -e "."
# 创建对象
openbrep create "做一个宽600mm深400mm的书架，4个层板" --output ./my_shelf
# 修改对象（基于磁盘上的 HSF 项目目录）
openbrep modify ./my_shelf "把层板改成6个，间距均匀分布"
# 查看帮助
openbrep --help每次修改都读取完整项目状态，精确修改而非重写，自动编译验证。
开发者说明：如果你当前使用的是
pip install -e "."/pip install -e ".[ui]"的 editable install，修改仓库源码后通常会立即生效，不需要重新安装；只有在变更pyproject.toml、依赖、命令入口（如obr/obrcli）或打包规则时，才建议重新安装一次。
| 功能 | 说明 |
|---|---|
| 📂 导入 | 拖入 .gdl / .txt / .gsm 文件；.gsm 经 LP_XMLConverter 解包为 HSF |
| 🔧 编译 GSM | HSF → .gsm，支持 Mock 模式（无需 ArchiCAD）和真实 LP_XMLConverter 编译 |
| 📥 提取 | 从 AI 对话中扫描代码块，自动识别脚本类型（3D/2D/Param...）并写入编辑器 |
| 脚本标签页 | 6 个独立脚本框（3D / 2D / Master / Param / UI / Properties），每个均支持 streamlit-ace 语法高亮和全屏编辑 |
| 参数表 | 查看、手动添加参数；AI 生成的 paramlist.xml 可一键写入 |
| 🔍 语法检查 | IF/ENDIF、FOR/NEXT、ADD/DEL 匹配，3D 末尾 END，2D 必须有 PROJECT2 |
| 功能 | 说明 |
|---|---|
| 🖼️ 图片即意图 | 上传建筑构件图片 → AI 识别几何、提取参数化维度 → 直接生成 GDL 脚本，无需文字描述 |
| 自然语言创建 | "做一个宽 600mm 深 400mm 的书架，4 个层板" → 自动生成全部脚本和参数 |
| 自然语言修改 | 已有项目时："把层板改成 5 个，材质加一个 shelfMat 参数" → AI 理解上下文按需修改 |
| Debug 模式 | 包含 "为什么"/"检查"/"修复" 等词时，自动注入全部脚本上下文；AI 可以给出分析文字 + 代码修复 |
| 确认写入 | 已有项目的 AI 修改不会自动覆盖，消息下方出现 [✅ 写入] [❌ 忽略] 按钮 |
| 对话操作栏 | 每条 AI 消息下方：👍 👎 📋 🔄（好评/差评/复制/重新生成） |
| 多模型支持 | Claude / GLM / GPT / DeepSeek / Gemini / Ollama 本地，侧边栏切换 |
| 提供商 | 模型 | 说明 |
|---|---|---|
| Anthropic | claude-haiku / sonnet / opus | 推荐首选 |
| 智谱 | glm-5 / glm-4-flash | 国内可用，性价比高 |
| OpenAI | gpt-4o / gpt-4o-mini / o3-mini | |
| DeepSeek | deepseek-chat / deepseek-reasoner | |
| gemini-2.5-flash / pro | ||
| Ollama | qwen2.5 / qwen3 / deepseek-coder | 本地，无需 API Key |
侧边栏选择 LP_XMLConverter 模式，配置路径后可导入 .gsm 文件进行修改：
# ArchiCAD 29 路径（LP_XMLConverter 内嵌于 app bundle）
/Applications/GRAPHISOFT/Archicad 29/Archicad 29.app/Contents/MacOS/
LP_XMLConverter.app/Contents/MacOS/LP_XMLConverter
也可直接在 config.toml 中写入，启动后自动读取。
.gsm 文件解压后是这样的目录结构（HSF）：
MyBookshelf/
├── libpartdata.xml ← 对象身份（GUID、版本）
├── paramlist.xml ← 参数定义（强类型）
├── ancestry.xml ← 对象分类
└── scripts/
├── 1d.gdl ← Master Script
├── 2d.gdl ← 2D 平面符号
├── 3d.gdl ← 3D 几何模型
├── vl.gdl ← 参数逻辑（VALUES/LOCK）
└── ui.gdl ← 自定义界面
openbrep 以 HSF 为原生格式，每个脚本独立处理，AI 只读取与当前任务相关的脚本（减少 context 占用）。
面向维护者和 AI 开发工具的架构规范见：
- docs/ARCHITECTURE.md
- docs/AI_DEVELOPMENT_GUIDE.md
- 中文版：docs/ARCHITECTURE.zh-CN.md、docs/AI_DEVELOPMENT_GUIDE.zh-CN.md
openbrep/
├── openbrep/
│ ├── workbench/ # React 工作台服务层
│ │ ├── assistant_service.py
│ │ ├── compiler_service.py
│ │ ├── preview_service.py
│ │ ├── three_preview.py # Three.js payload 转换
│ │ └── view_models.py # LLM 输出分类 / 错误分类
│ ├── workbench_api.py # ThreadingHTTPServer API + SPA 静态服务
│ ├── core.py # Agent 主循环
│ ├── llm.py # 多模型统一接口
│ ├── compiler.py # LP_XMLConverter 封装
│ ├── local_file_dialog.py # macOS/Tk 原生文件选择器
│ ├── knowledge.py # 知识库加载
│ └── skills_loader.py # 任务策略加载
├── frontend/ # React + Vite + Monaco + Three.js 工作台
│ ├── src/
│ └── dist/ # npm run build 产物（Tauri 单端口模式）
├── src-tauri/ # Tauri v2 桌面壳（Rust）
│ ├── src/main.rs # spawn Python → 捕获信号 → Webview
│ └── tauri.conf.json
├── scripts/
│ └── obr7.py # 启动编排（dev / tauri 双模式）
├── knowledge/ # GDL 参考文档（可自行扩充）
├── skills/ # 任务策略（可自行扩充）
├── tests/ # 单元测试
├── config.example.toml
└── pyproject.toml
复制 config.example.toml 为 config.toml（已 .gitignore），按需填写。
[llm]
model = "glm-4-flash"
temperature = 0.2
max_tokens = 4096
[llm.provider_keys]
zhipu = "your-zhipu-key"
anthropic = "your-claude-key"
openai = "your-openai-key"
deepseek = "your-deepseek-key"
google = "your-gemini-key"
aliyun = "your-qwen-key"
kimi = "your-kimi-key"前缀匹配规则：
glm-→zhipudeepseek-→deepseekclaude-→anthropicgemini-→googleqwen-/qwq-→aliyunmoonshot-→kimigpt-/o1/o3/o4→openaiollama/→ 本地模式，不需要 API Key
[llm]
model = "ymg-gpt-5.3-codex"
api_key = "YOUR_YMG_KEY"
api_base = "https://api.ymg.com/v1"
[[llm.custom_providers]]
name = "ymg"
protocol = "openai" # openai | anthropic
base_url = "https://api.ymg.com/v1"
api_key = "YOUR_YMG_KEY"
[[llm.custom_providers.models]]
alias = "ymg-gpt-5.3-codex" # UI 里选择的名字
model = "gpt-5.3-codex" # 实际请求给 provider 的模型名请求时模型与凭据的解析顺序：
custom_providers（先按 alias/model 命中）provider_keys（按模型前缀匹配）[llm]顶层api_key/api_base（兜底）
也就是说：命中 custom provider 时，会优先使用该 provider 的 api_key/base_url/protocol。
- 只写
models = ["ymg-gpt-5.3-codex"]，不写{alias, model}对象，容易造成 alias 与真实模型名混淆。 base_url不是 OpenAI 兼容入口（常见是缺/v1）。- 切换模型后未确认
[llm].model/api_key/api_base是否与当前 provider 成组一致。
[compiler]
mode = "lp"
path = "/Applications/GRAPHISOFT/Archicad 29/.../LP_XMLConverter"- 用户手册 → — UI 每个功能的详细说明、工作流、常见问题
| 版本 | 主要内容 |
|---|---|
| v1.0.0 | Tauri 桌面工作台正式落地：彻底退役 Streamlit（79 个文件 + 24 个 UI 测试），迁移域逻辑至 openbrep/workbench/，初始化 Rust/Tauri v2 桌面壳，实现 Python sidecar 启动握手、stderr relay、SPA 静态服务、关窗孤儿进程防护；674 测试全绿（见 docs/releases/v1.0.0.md） |
| v0.8.0 | React 工作台成为默认 UI：合并 react-workbench 分支，obr 默认启动 React + Monaco + Three.js 工作台，Streamlit 降级为 fallback；新增 Verification 一等 seam（openbrep/verification.py），把散落的 static/lint/compile/plan_checks 聚合成统一验证报告，AI 生成后展示置信度、检查结果、残余风险；CREATE 路径 compile 状态显式可见，MODIFY 路径含 compile + auto-repair 证据（见 docs/releases/v0.8.0.md） |
| v0.7.0 | GDL 资产生命周期里程碑：新增 modify / repair 前后 revision 快照、obr history / obr rollback、工程级变更摘要、GDLContractChecker 合规检查输出，以及 `--compare mock |
| v0.6.12 | GDL 知识库校准收口：完成 P0-P6 批次的官方文档/社区/本地知识交叉校验，修正核心命令语义、参数结构、2D/3D 投影与高级几何边界，并补充 Pro 层商业化 Skill 开发方向（见 docs/releases/v0.6.12.md） |
| v0.6.11 | macOS 安装包修复：补齐 Streamlit 冻结包的前端静态资源与 streamlit.runtime.scriptrunner 隐藏导入；新增浏览器级包验证脚本，确保不仅 health 通过，首页和脚本执行也通过（见 docs/releases/v0.6.11.md） |
| v0.6.10 | macOS 安装包修复：打包启动器显式关闭 Streamlit global.developmentMode，避免 server.port 冲突；保留包级 smoke 验证入口，便于直接验证 Release zip（见 docs/releases/v0.6.10.md） |
| v0.6.9 | 安装包验证补丁：打包启动器支持固定端口与禁用自动开浏览器，新增 scripts/package_smoke.py，用于下载 Release zip 后直接运行包内启动器并验证 Streamlit health，不依赖本地 obr（见 docs/releases/v0.6.9.md） |
| v0.6.8 | macOS 安装包修复：打包启动器改为进程内启动 Streamlit，避免冻结包递归拉起自身；macOS zip 增加 OpenBrep.command 和启动说明；openbrep[ui] 明确包含 UI 导入所需依赖（见 docs/releases/v0.6.8.md） |
| v0.6.7 | UI 收尾小版本：隐藏版本管理与 Archicad 实机联动入口，收敛 HSF 保存 / 另存为为直达动作，清理多余提示与低频操作，进一步降低工作台认知负担（见 docs/releases/v0.6.7.md） |
| v0.6.6 | UI 清爽化小版本：拆分打开文件/HSF 项目入口，简化编译 GSM 和输出目录选择，移除低价值调试按钮与冗余提示，优化 macOS 原生文件选择器激活体验（见 docs/releases/v0.6.6.md） |
| v0.6.5 | 安装体验补丁：修正 GitHub Release 自动发布命令，改用 gh release create --generate-notes 兼容 --repo，用于接续 v0.6.4 的安装包发布自动化（见 docs/releases/v0.6.5.md） |
| v0.6.4 | 安装体验小版本：普通用户首选 GitHub Release 桌面包；修正 macOS/Windows installer workflow 产物路径并在 tag 构建后自动创建/更新 GitHub Release；补充 pipx / uv / git clone 分层安装说明（见 docs/releases/v0.6.4.md） |
| v0.6.3 | 新增个人工作空间记忆：持久化聊天记录、GDL 错题本、用户触发整理后的自我提升 skill；LLM 注入分层为用户工作空间记忆与源码开发者基线；优化 HSF 项目目录持久化、编译版本识别、自定义 provider 配置同步、参数单位文案与 UI 架构治理（见 docs/releases/v0.6.3.md） |
| v0.6.2 | 新增 wiki 知识检索与问答链路；新增用户自定义 flat 知识库接入；新增 skill creator 对话式创建与列表路由；补齐 pipeline/knowledge/skill 相关测试并修复 chat 关键路由细节（见 docs/releases/v0.6.2.md） |
| v0.6.1 | CLI 可用性与安装体验提升；新增/完善 GDL 静态检查与自动 repair；补强 chat / explainer / 图片链路与参考图生成；修复 obr 在非项目目录无法启动 UI（见 docs/releases/v0.6.1.md） |
| v0.6.0 | Runtime Phase 1 主骨架正式发布收尾：统一 create / modify / repair / chat 主链路；repair 独立 intent 闭合；CLI/UI/runtime 版本与发布口径统一（见 docs/releases/v0.6.0.md） |
| v0.5.7 | CLI 模式正式可用（create/modify 命令）；生成过程支持用户取消；pipeline 改进解决越改越差问题；参数路由修复（见 docs/releases/v0.5.7.md） |
| v0.5.6 | 图片上传不再卡死；cross-script / static checker 误报减少；AI 助手设置支持长期保存并注入系统提示；自定义代理与官方供应商分层选择，并优先显示代理名（见 docs/releases/v0.5.6.md） |
| v0.5.5 | UI重构为四栏布局：左栏操作+预览、中栏脚本+参数表、右栏AI对话（见 docs/releases/v0.5.5.md） |
| v0.5.4 | validator 分层重构：error/warning 分开，硬错误白名单收紧；跨脚本检查器；debug 最小改动；生成过程实时显示；生成中禁用 widget（见 docs/releases/v0.5.4.md） |
| v0.5.3 | 知识库升级与文档品牌增强：整合拆书增量（含 2D 高级与可编译示例）、新增命令索引与命令级精准路由、README 顶部加入 logo（见 docs/releases/v0.5.3.md）。 |
| v0.5.2 | 版本标注与发布归档规范化：UI 版本号统一读取代码版本；README 标题去版本；新增发布说明文档（见 docs/releases/v0.5.2.md） |
| v0.5.1 | 安装包发布准备：新增 macOS/Windows 打包脚本与 GitHub Actions 构建流程（PyInstaller） |
| v0.5 | OpenBrep 品牌发布 — 项目更名为 OpenBrep；稳定版本发布；Gitee 镜像支持（国内用户快速访问） |
| v0.5 pre | 统一编辑器 UI；图片即意图（上传图片 → AI 生成 GDL）；AI 对话修改脚本；确认写入流程；paramlist.xml 自动注入；GSM 导入（AC29）；streamlit-ace 语法高亮；全屏编辑；多模型支持 |
| v0.4.0 | HSF-native 架构重构；Streamlit Web UI；强类型 paramlist；44 项单元测试 |
| v0.3.x | GDL 解析器；Context surgery；Preflight |
| v0.2.0 | Anti-hallucination；Golden snippets |
| v0.1.0 | Core agent loop |
MIT — see LICENSE.