# SUWood - 智能家具设计插件

## 📋 插件简介

SUWood 是一个专为 Blender 设计的智能家具设计插件，提供完整的柜体创建、分割、轮廓设计等功能。该插件从 SketchUp 平台移植而来，为 Blender 用户提供专业的木工设计工具。

## 🚀 主要功能

### 🛠️ 核心工具
- **点击创体工具** - 通过点击创建柜体单元
- **选面创体工具** - 在选中的面上创建柜体
- **删除柜体功能** - 删除选中的柜体单元
- **六面切割工具** - 六方向区域分割功能
- **轮廓创建工具** - 创建和编辑轮廓

### 🎯 智能功能
- **智能选择管理** - 自动管理对象选择状态
- **实时状态显示** - 实时显示操作状态和提示
- **多视图支持** - 支持前、右、顶等多个视图
- **参数化设计** - 精确的尺寸和参数控制

## 📦 安装方法

### 方法一：直接安装（推荐）

1. **下载插件**
   - 将整个 `blenderpython` 文件夹下载到本地

2. **安装到 Blender**
   - 打开 Blender
   - 进入 `Edit > Preferences > Add-ons`
   - 点击 `Install...` 按钮
   - 选择 `blenderpython` 文件夹
   - 点击 `Install Add-on`

3. **启用插件**
   - 在插件列表中找到 `SUWood - 智能家具设计`
   - 勾选启用插件

### 方法二：手动安装

1. **复制文件**
   ```bash
   # 将 blenderpython 文件夹复制到 Blender 插件目录
   # Windows: %APPDATA%\Blender Foundation\Blender\4.2\scripts\addons\
   # macOS: ~/Library/Application Support/Blender/4.2/scripts/addons/
   # Linux: ~/.config/blender/4.2/scripts/addons/
   ```

2. **重启 Blender**
   - 重启 Blender 应用
   - 插件将自动加载

## 🎮 使用方法

### 1. 访问插件面板
- 打开 3D 视图
- 按 `N` 键打开侧边栏
- 点击 `SUWood` 标签页

### 2. 使用工具

#### 点击创体工具
1. 点击 `点击创体` 按钮
2. 在 3D 视图中点击位置
3. 输入柜体尺寸参数
4. 完成创建

#### 选面创体工具
1. 点击 `选面创体` 按钮
2. 选择要创建柜体的面
3. 输入尺寸参数
4. 完成创建

#### 六面切割工具
1. 点击 `六面切割` 按钮
2. 选择要分割的区域
3. 使用方向键选择分割方向
4. 输入分割长度
5. 完成分割

#### 删除柜体
1. 选择要删除的柜体
2. 点击 `删除柜体` 按钮
3. 确认删除

### 3. 快捷键操作

#### 六面切割快捷键
- `↑` - 上分割（普通模式）/ 后分割（前后模式）
- `↓` - 下分割（普通模式）/ 前分割（前后模式）
- `←` - 左分割（仅普通模式）
- `→` - 右分割（仅普通模式）
- `Ctrl` - 切换分割模式（普通/前后）

## 🔧 系统要求

- **Blender 版本**: 3.0 或更高版本
- **操作系统**: Windows 10+, macOS 10.15+, Linux
- **Python**: 3.7+ (Blender 内置)
- **内存**: 建议 8GB 或更多

## 📁 文件结构

```
blenderpython/
├── __init__.py              # 插件主入口文件
├── suw_core/               # 核心功能模块
│   ├── __init__.py
│   ├── selection_manager.py
│   ├── data_manager.py
│   └── ...
├── 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        # 常量定义
└── README.md               # 说明文档
```

## 🐛 故障排除

### 常见问题

#### 1. 插件无法安装
- 确保 Blender 版本为 3.0 或更高
- 检查文件权限
- 尝试重启 Blender

#### 2. 工具按钮无响应
- 确保在 3D 视图中操作
- 检查是否有选中的对象
- 查看控制台错误信息

#### 3. 网络功能不可用
- 检查 SUWood 服务器是否运行
- 确认网络连接正常
- 检查防火墙设置

#### 4. 性能问题
- 关闭不必要的 Blender 功能
- 减少场景中的对象数量
- 更新显卡驱动

### 日志查看
- 打开 Blender 的 `Window > Toggle System Console`
- 查看错误和警告信息

## 🔄 更新日志

### v1.0.0 (2024-01-XX)
- ✅ 初始版本发布
- ✅ 完整的工具集实现
- ✅ Blender 4.2 兼容性
- ✅ 中文界面支持
- ✅ 双模式架构（Blender/存根）

## 🤝 技术支持

### 问题反馈
- 在 GitHub 上提交 Issue
- 提供详细的错误信息和复现步骤
- 包含 Blender 版本和系统信息

### 功能建议
- 欢迎提出新功能建议
- 参与插件开发讨论
- 贡献代码和文档

## 📄 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

## 🙏 致谢

- 感谢 SketchUp 平台的原始设计
- 感谢 Blender 社区的支持
- 感谢所有贡献者的努力

---

**SUWood - 让家具设计更简单！** 🏠✨