AutoCAD 家具导出插件
用于 AutoCAD 2024 的家具 3D 模型导出插件。当前主流程是按资产中心口径导出单板材、单组件或单五金件，用于后续辅助装配和规格款入库。
功能特点
- 单资产导出 -
FEXPORT默认导出单板材、单组件或单五金件 - 板材语义保留 - 导出孔位、孔组、吸附图样和吸附面，供辅助装配使用
- 五金规格提取 - 单五金模式保留几何签名、图层类型和实例信息
- 整套兼容保留 - 旧整套家具导出迁移到
FEXPORTPRODUCT
系统要求
- AutoCAD 2024
- Windows 10/11
- 具备读取
%AppData%\Autodesk\ApplicationPlugins的用户权限
安装方法
方法 1：手动安装发版包（推荐给产品/实施）
- 完全关闭 AutoCAD 2024
- 解压
dist/家具导出插件-v2.6.0-一键安装版.zip - 将整个
FurnitureExporter.bundle文件夹复制到：
%AppData%\Autodesk\ApplicationPlugins\
最终目录应为：
%AppData%\Autodesk\ApplicationPlugins\FurnitureExporter.bundle\Contents\FurnitureExporter.dll
- 如果系统提示是否覆盖旧文件，选择“全部替换”
- 重新打开 AutoCAD 2024
- 输入命令
FEXPORT，能识别即表示安装成功
方法 2：一键安装
双击 dist/家具导出插件-v2.6.0-一键安装版/安装.bat
脚本会自动：
- 复制插件到
%AppData%\Autodesk\ApplicationPlugins\FurnitureExporter.bundle - 写入当前用户的 AutoCAD 自启动项
- 追加插件目录到可信路径
方法 3：一键编译（开发）
双击运行 build.cmd 或在 PowerShell 中执行 .\build.ps1
脚本会自动：
- 检测 AutoCAD 2024 安装路径
- 编译插件
- 显示输出文件位置
如果自动检测失败，可以手动设置环境变量：
set ACAD_PATH=D:\你的路径\AutoCAD 2024
build.cmd
方法 4：手动编译
# 设置 AutoCAD 路径（根据实际安装位置修改）
set ACAD_PATH=C:\Program Files\Autodesk\AutoCAD 2024
# 编译
cd FurnitureExporter
dotnet build -c Release
临时加载（仅开发调试用）
- 打开 AutoCAD 2024
- 输入命令
NETLOAD - 选择
FurnitureExporter\bin\Release\net48\FurnitureExporter.dll
自动加载
将插件以 Bundle 形式放入 AutoCAD 插件目录，AutoCAD 启动时自动加载：
%AppData%\Autodesk\ApplicationPlugins\FurnitureExporter.bundle
安装后无需重复配置，后续每次启动 AutoCAD 会自动加载插件。
使用方法
FEXPORT - 导出单资产到资产中心
命令: FEXPORT
操作步骤：
- 选择资产类型 - 板材 / 组件 / 五金
- 选择实体 - 框选该单资产包含的 3D Solid 或图块，按 Enter 确认
- 保存文件 - 选择 ZIP 保存位置
输出文件： xxx_board_asset.zip / xxx_component_asset.zip / xxx_hardware_asset.zip，包含：
model.obj- 单资产模型hardware.json- 单资产结构化数据，包含exportMode: "single_asset"与assetTypeHint
FEXPORTPRODUCT - 整套家具兼容导出
命令: FEXPORTPRODUCT
仅用于旧产品链路兼容。新资产中心和辅助装配测试请优先使用 FEXPORT。
FINFO - 查看实体信息
命令: FINFO
选择实体后显示其详细信息（类型、尺寸、图层等），用于调试。
输出格式
hardware.json 示例
{
"version": "2.6",
"exportedAt": "2026-05-11T10:30:00Z",
"sourceFile": "桌腿.dwg",
"software": "AutoCAD 2024",
"pluginVersion": "2.6.0",
"modelFile": "model.obj",
"exportMode": "single_asset",
"assetTypeHint": "COMPONENT",
"sourceEntityCount": 1,
"panelCount": 1,
"snapPatterns": [],
"snapSurfaces": [],
"hardwareTypes": []
}
工作流程
设计师 系统
─────── ──────
1. 打开 DWG 文件
2. FEXPORT
3. 选择资产类型（板材/组件/五金）
4. 框选单个资产实体 ───────→
5. 保存 ZIP ────────────────→ 上传到资产中心
↓
自动解析
↓
创建/更新资产族规格款
↓
保存到数据库
↓
辅助装配可用 ✓
开发
编译
cd FurnitureExporter
dotnet build -c Release
调试
- Visual Studio 打开项目
- 设置调试程序为
acad.exe（AutoCAD 2024） - F5 启动调试
项目结构
FurnitureExporter/
├── FurnitureExporter.csproj # 项目配置
├── Commands.cs # AutoCAD 命令
├── GlbExporter.cs # GLB 导出器
├── HardwareAnalyzer.cs # 五金件分析器
└── Models.cs # 数据模型
常见问题
Q: 插件加载失败
- 确认 AutoCAD 版本为 2024
- 确认已安装 .NET 6.0 Runtime
- 检查 DLL 路径是否包含中文
Q: 导出的模型显示不正确
- 确保板材是 3D Solid 实体
- 检查模型单位是否为毫米
Q: 五金件未被识别
- 确保五金件是 3D Solid 或图块引用
- 检查是否正确框选了五金件
版本历史
v2.1.0
- 新增倒角和圆角检测功能
- 导出数据增加
edgeFeatures字段 - 优化 Brep 分析性能
v2.0.0
- 新增孔位自动检测（通过 Brep API）
- 新增五金件-孔位-板材智能关联
- 导出数据增加
panels、holes字段 - 支持孔位用途推断（铰链孔、偏心轮孔等）
v1.0.0
- 初始版本
- 支持板材 GLB 导出
- 支持五金件位置提取
- 自动按几何特征分组
许可
MIT License