blenderpython/INSTALL.md

# SUWood Blender 插件安装指南

## 📋 安装前准备

### 系统要求
- **Blender 版本**: 3.0 或更高版本（推荐 4.2+）
- **操作系统**: Windows 10+, macOS 10.15+, Linux
- **Python**: 3.7+ (Blender 内置)
- **内存**: 建议 8GB 或更多
- **显卡**: 支持 OpenGL 3.3 或更高

### 下载插件
1. 下载 `blenderpython` 文件夹
2. 确保文件夹包含以下文件：
   ```
   blenderpython/
   ├── __init__.py
   ├── suw_core/
   ├── suw_menu.py
   ├── suw_unit_point_tool.py
   ├── suw_unit_face_tool.py
   ├── suw_unit_cont_tool.py
   ├── suw_zone_div1_tool.py
   ├── suw_observer.py
   ├── suw_client.py
   ├── suw_constants.py
   ├── suw_load.py
   ├── README.md
   └── test_installation.py
   ```

## 🚀 安装方法

### 方法一：通过 Blender 界面安装（推荐）

#### Windows 用户
1. **打开 Blender**
2. **进入插件设置**
   - 点击菜单 `Edit` → `Preferences`
   - 选择 `Add-ons` 标签页
3. **安装插件**
   - 点击 `Install...` 按钮
   - 选择 `blenderpython` 文件夹
   - 点击 `Install Add-on`
4. **启用插件**
   - 在搜索框中输入 "SUWood"
   - 找到 `SUWood - 智能家具设计`
   - 勾选启用插件

#### macOS 用户
1. **打开 Blender**
2. **进入插件设置**
   - 点击菜单 `Blender` → `Preferences`
   - 选择 `Add-ons` 标签页
3. **安装插件**
   - 点击 `Install...` 按钮
   - 选择 `blenderpython` 文件夹
   - 点击 `Install Add-on`
4. **启用插件**
   - 在搜索框中输入 "SUWood"
   - 找到 `SUWood - 智能家具设计`
   - 勾选启用插件

#### Linux 用户
1. **打开 Blender**
2. **进入插件设置**
   - 点击菜单 `Edit` → `Preferences`
   - 选择 `Add-ons` 标签页
3. **安装插件**
   - 点击 `Install...` 按钮
   - 选择 `blenderpython` 文件夹
   - 点击 `Install Add-on`
4. **启用插件**
   - 在搜索框中输入 "SUWood"
   - 找到 `SUWood - 智能家具设计`
   - 勾选启用插件

### 方法二：手动安装

#### Windows 手动安装
1. **找到 Blender 插件目录**
   ```
   %APPDATA%\Blender Foundation\Blender\4.2\scripts\addons\
   ```
2. **复制插件文件**
   - 将 `blenderpython` 文件夹复制到上述目录
3. **重启 Blender**
   - 完全关闭 Blender
   - 重新打开 Blender
4. **启用插件**
   - 进入 `Edit` → `Preferences` → `Add-ons`
   - 搜索 "SUWood" 并启用

#### macOS 手动安装
1. **找到 Blender 插件目录**
   ```
   ~/Library/Application Support/Blender/4.2/scripts/addons/
   ```
2. **复制插件文件**
   - 将 `blenderpython` 文件夹复制到上述目录
3. **重启 Blender**
   - 完全关闭 Blender
   - 重新打开 Blender
4. **启用插件**
   - 进入 `Blender` → `Preferences` → `Add-ons`
   - 搜索 "SUWood" 并启用

#### Linux 手动安装
1. **找到 Blender 插件目录**
   ```
   ~/.config/blender/4.2/scripts/addons/
   ```
2. **复制插件文件**
   - 将 `blenderpython` 文件夹复制到上述目录
3. **重启 Blender**
   - 完全关闭 Blender
   - 重新打开 Blender
4. **启用插件**
   - 进入 `Edit` → `Preferences` → `Add-ons`
   - 搜索 "SUWood" 并启用

## ✅ 安装验证

### 1. 检查插件状态
1. 进入 `Edit` → `Preferences` → `Add-ons`
2. 搜索 "SUWood"
3. 确认插件已启用（复选框已勾选）

### 2. 检查面板显示
1. 打开 3D 视图
2. 按 `N` 键打开侧边栏
3. 查看是否有 `SUWood` 标签页
4. 点击标签页查看工具按钮

### 3. 运行测试脚本
1. 在 Blender 中打开文本编辑器
2. 加载 `test_installation.py` 文件
3. 运行脚本查看测试结果

## 🐛 常见问题解决

### 问题 1：插件无法安装
**症状**: 点击 Install 后没有反应或报错

**解决方案**:
1. 确保 Blender 版本为 3.0 或更高
2. 检查 `blenderpython` 文件夹是否完整
3. 确保文件夹包含 `__init__.py` 文件
4. 尝试重启 Blender 后重新安装

### 问题 2：插件安装后无法启用
**症状**: 插件出现在列表中但无法勾选启用

**解决方案**:
1. 检查控制台错误信息
2. 确保所有依赖模块可用
3. 尝试手动安装方法
4. 检查文件权限

### 问题 3：面板不显示
**症状**: 插件已启用但侧边栏中没有 SUWood 标签

**解决方案**:
1. 确保在 3D 视图中查看
2. 按 `N` 键确保侧边栏已打开
3. 检查是否有其他插件冲突
4. 重启 Blender

### 问题 4：工具按钮无响应
**症状**: 点击工具按钮没有反应

**解决方案**:
1. 确保在 3D 视图中操作
2. 检查是否有选中的对象
3. 查看控制台错误信息
4. 确认 SUWood 服务器是否运行

### 问题 5：性能问题
**症状**: 插件运行缓慢或卡顿

**解决方案**:
1. 关闭不必要的 Blender 功能
2. 减少场景中的对象数量
3. 更新显卡驱动
4. 增加系统内存

## 📞 获取帮助

### 查看日志
1. 打开 `Window` → `Toggle System Console`
2. 查看错误和警告信息
3. 复制错误信息用于问题报告

### 测试安装
运行测试脚本：
```python
# 在 Blender 的文本编辑器中运行
exec(open("test_installation.py").read())
```

### 联系支持
- 在 GitHub 上提交 Issue
- 提供详细的错误信息
- 包含 Blender 版本和系统信息

## 🔄 更新插件

### 更新步骤
1. **备份当前设置**
   - 导出插件设置（如果有）
2. **卸载旧版本**
   - 在插件设置中禁用插件
   - 删除旧版本文件
3. **安装新版本**
   - 按照安装步骤安装新版本
4. **恢复设置**
   - 重新配置插件设置

### 版本兼容性
- 插件支持 Blender 3.0+ 版本
- 建议使用最新的 Blender 版本
- 主要版本更新可能需要重新安装

---

**安装完成后，您就可以开始使用 SUWood 进行专业的家具设计了！** 🎉