核心用法
ShopPrentice Woodworking 是一款专为 Fusion 360 设计的 AI 家具建模工具，通过自然语言描述、参考图片或链接，自动生成含真实木工榫卯结构的生产级参数化 CAD 模型。
工作流程：
1. 模式选择：通过 capture_design 检测文档状态，决定是全新构建（clean=True）还是增量编辑（additive mode）
2. 设计规划：按家具类型（chair/table/box 等）和风格（Modern/Shaker/Craftsman 等）加载对应指南，输出组件级建造计划
3. 参数化建模：使用 Fusion 360 Python API 构建组件 → 镜像/阵列复制 → 跨组件 CUT 操作创建榫卯 → 细节打磨
4. 实时执行：通过 MCP 服务器在本地 9100 端口与 Fusion 360 通信，自动执行脚本并验证
关键技术特性：
- 真实榫卯系统：支持 mortise & tenon、dovetail、domino、drawbore、tenon wedge 等 15+ 种木工接合方式，严格遵循木材纹理方向与力学原理
- 参数化设计：所有尺寸联动响应，修改任一参数自动重算整个模型，避免硬编码
- 制造导向：模型包含加工所需的全部几何信息，可直接用于 CNC 或手工制作
显著优点
1. 专业级木工知识嵌入：内置木材纹理方向、端面/侧面胶合强度差异、季节性涨缩等木工物理规则，自动选择合适接合方式
2. 完整的接合库：15+ 种榫卯类型均有详细参数规范与 API 实现模板，从简单 dado 到复杂 drawbore M&T 均可生成
3. 增量构建策略：支持分组件逐步验证，降低复杂模型失败风险；validate_design 自动检测干涉与断连
4. 开源可审计：GitHub 开源（ShopPrentice/shopprentice），安装脚本完全透明，用户可审查所有生成代码
5. 多模态输入：文字描述、图片、参考链接均可作为设计输入
潜在缺点与局限性
1. 模型依赖门槛：必须配合 Claude Opus 等前沿大模型使用，普通模型无法处理多步骤程序指令
2. 软件生态锁定：专为 Fusion 360 设计，无法导出至 Blender、SolidWorks 等其他 CAD 平台
3. 本地 MCP 依赖：需运行本地 MCP 服务器（localhost:9100），增加配置复杂度
4. 学习曲线陡峭：用户需理解参数化建模、Fusion 360 特征树、木材接合原理等专业知识才能有效使用
5. Draft 状态接合类型：box joint、bridle joint、lap joint、miter joint 等仍为草稿状态，使用时需额外验证
6. 无云协作：项目文件存储于本地 ~/shopprentice-projects/，无内置版本控制或团队协作功能
适合人群
- 专业家具设计师：需要快速生成可制造的参数化模型
- 木工爱好者/创客：希望将设计想法转化为带加工信息的 3D 模型
- 教育领域：木工、工业设计专业师生学习参数化 CAD 与榫卯结构
- 小型定制家具工坊：用于设计验证与客户沟通
不适合：仅需简单 3D 可视化、无 Fusion 360 基础、或使用轻薄本无法运行 Fusion 360 的用户。
常规风险
1. 数据覆盖风险：clean=True 会清空现有文档，虽有工具层防护拒绝未跟踪文档的清理操作，但误操作仍可能导致工作丢失
2. 参数冲突导致模型破损：错误的参数组合（如 box_height < lid_thick + bottom_thick）可能产生无效几何体
3. 脚本执行风险：生成并执行 Python 脚本修改本地 Fusion 360 文档，虽可预览但仍存在意外修改可能
4. 网络安装风险：一键安装脚本从 GitHub 拉取并执行，虽开源可审计，但非包管理器安装缺乏签名验证