# 筑易 — 新西兰住宅前期设计工作台

从一句任务书到方案、平面图、合规检查、造价估算和效果图。**为新西兰的住宅、加建、minor dwelling(granny flat)而做**——内置 Auckland Unitary Plan 分区规则、NZ Building Code(F4/G4/G7/H1/E2)、NZS3604 结构选型和 2025 年 QS 造价基准。

不是自动驾驶,是加速器。**关键决策由建筑师把关。**

---

## 快速开始

1. 装 [Python 3.9+](https://www.python.org/downloads/)(安装时勾选 *Add to PATH*)
2. 装 [Blender](https://www.blender.org/download/)(免费)
3. 装 Claude Code 并登录 —— agent 用你自己的账号跑,费用记在你自己名下:
   ```
   npm i -g @anthropic-ai/claude-code
   claude login
   ```
4. 双击 `启动.bat`,浏览器会打开 http://127.0.0.1:8899

首次启动会自动装 Python 依赖并做一次环境自检。想单独检查:

```bash
python webapp/doctor.py
```

## 它需要什么

| 组件 | 必需 | 缺了会怎样 |
|---|---|---|
| Python 3.9+ | 是 | 跑不起来 |
| Blender | 是 | 建模、渲染、立面剖面全部不可用 |
| Claude Code CLI(已登录) | 是 | agent 不能跑,方案生成和大师评审不可用 |
| ComfyUI + Flux 模型 | 否 | 只影响最后一步照片级效果图;Blender 渲染照常 |
| Rhino 8 / Unreal | 否 | 都是可选支线,主线不用 |

**路径自动探测。** 装在非常规位置时,在项目根目录建 `config.local.json`:

```json
{ "blender": "D:/Blender/blender.exe", "comfy_root": "D:/ComfyUI" }
```

## 怎么用

1. **输入** — 场地、任务书、风格;可选上传草图/mood board;填 council 与 zone(有地址可以点「查分区」自动查 Auckland GIS)
2. **生成方案** — 默认「求解器」方式:agent 只出设计意图(房间、面积、邻接、朝向),坐标由 CP-SAT 求解器算,**不需要 Rhino**。几秒出 1–4 个方案,每个带客观评分
3. **平面审阅** — 评分卡(设计 5 维 + 结构校核 + NZ 合规逐条引条文到页 + QS 估价);不满意点「换个方案」随时回退
4. **大师评审会** — 11 位大师看着你的图纸提修改建议,每条都由求解器重算、打分器裁决,涨分才留;可以直接向他们提问
5. **批准** — 自动展开细部(墙、窗框、竖梃、屋顶、挂板、楼梯、栏杆、家具),导出模型,Blender 三机位渲染
6. **出图** — 立面/剖面线稿、Flux 照片级效果图、网页漫游、设计说明书、分析总表

## 已知边界(先说清楚)

- **概念到方案深化(LOD 200–300)**,不出施工图、不出 consent 文件包
- 平面轮廓支持矩形、L/U 形和内院;不支持自由曲线与复杂多边形
- 结构给的是 NZS3604 范围内的选型建议;触发 SED 的必须找注册工程师
- 造价是 QS 粗估(2025 基准 + 地区/层数/地基系数),不能替代正式估价
- 效果图只上材质光影,**结构以模型为准**;不要拿 AI 图当施工依据

## 重要声明

本工具的输出是**概念设计辅助材料,不构成专业建筑、工程或法律意见。**

新西兰的 Restricted Building Work 设计必须由持牌人(LBP Design)或注册建筑师完成并签署。任何用于建筑同意(building consent)、资源同意(resource consent)或施工的图纸,都必须经有资质的专业人士独立复核与签认。合规检查是辅助提示,不是合规证明;最终责任在使用者及其委托的专业人士。

法规数据截至 2026 年 7 月,可能已更新——以 [building.govt.nz](https://www.building.govt.nz/) 和你所在 council 的现行文件为准。

## 隐私

- 所有项目数据存在你自己的电脑上(`projects/`),不上传任何服务器
- 但 agent 运行时,任务书与场地描述会发送给你配置的大模型服务商(默认 Anthropic)。**如果任务书里有客户地址或个人信息,那些内容会离开你的电脑** —— 按 Privacy Act 2020 处理,必要时先脱敏

## 第三方组件与许可

| 组件 | 许可 |
|---|---|
| OR-Tools | Apache-2.0 |
| Pillow | MIT-CMU |
| Blender(外部调用) | GPL — 单独安装,不随本包分发 |
| Poly Haven 材质/HDRI/家具 | CC0(首次使用时按需下载) |
| FLUX.2-klein **4B** | Apache-2.0,可商用 |
| FLUX.2-klein **9B** | **FLUX 非商用许可(NCL)—— 仅限自用,不可用于对外接活或售卖** |

本包不含任何模型权重。ComfyUI 与 Flux 模型需自行获取,并遵守其各自许可。

---

问题排查先跑 `python webapp/doctor.py`,它会逐项说明缺什么、影响什么、怎么补。
