Shopprentice

🪵 AI 驱动的真实榫卯家具 CAD 生成器

基于自然语言或图片为 Fusion 360 生成参数化家具 CAD 模型,支持真实榫卯结构,代码可审计执行。

收藏
2.5k
安装
1.2k
版本
0.5.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

ShopPrentice 是一款面向 Fusion 360 的 AI 驱动参数化家具建模技能。用户通过自然语言描述、参考图片或链接,即可生成生产级 CAD 模型。其核心工作流程包括:

1. 设计规划:识别家具类型(椅子、桌子、柜子等)和风格(现代、Shaker、Craftsman 等),加载对应类型与风格指南,规划组件结构与连接方式
2. 参数化建模:使用 Fusion 360 Python API 创建完全参数化的模型——修改任意尺寸后整个模型自动重算,包括榫卯位置、镜像特征和阵列数量

3. 真实榫卯生成:支持数十种传统木工接合方式(Mortise & Tenon、Dovetail、Domino、Drawbore 等),严格遵循木材纤维方向与力学原理,生成包含物理咬合关系的实体模型

4. MCP 实时执行:通过本地 MCP 服务器(localhost:9100)将脚本直接发送至 Fusion 360 执行,实现"描述→代码→模型"的闭环

显著优点

  • 专业级输出:生成的模型包含完整制造信息,可直接用于 CNC 加工或手工制作
  • 真实 joinery:不同于简化方块拼接,严格模拟真实榫卯的 CUT/JOIN 操作流程,支持 end-grain 识别与纤维方向校验
  • 完全参数化:所有关键尺寸均为用户参数,修改后自动更新关联几何体,避免传统建模的"断裂参照"问题
  • 可审计安全:安装脚本与生成代码完全开源(GitHub 可查),执行前可本地审查,无需网络访问外部 API
  • 增量构建策略:组件级逐步验证,每阶段自动检查干涉与连通性,降低复杂模型的调试难度

潜在局限

  • 高门槛依赖:必须使用 Claude Opus 等前沿大模型,普通模型难以处理多步骤程序指令与长上下文推理
  • 学习曲线陡峭:用户需理解木工术语(grain direction、joinery type)与 Fusion 360 API 的基本概念
  • Draft 功能风险:部分榫卯类型(Box Joint、Bridle Joint 等)标记为 Draft,未经完整验证,可能出现 API 序列错误
  • 平台绑定:深度依赖 Fusion 360 及其 Python API,无法迁移至 Blender、FreeCAD 等其他 CAD 平台
  • 硬件资源:复杂模型(如带多排 domino 的大衣柜)可能触发 Fusion 360 的性能瓶颈

适合人群

  • 专业家具设计师:需要将概念快速转化为可制造参数模型
  • 木工爱好者/创客:希望学习传统榫卯在现代 CAD 中的实现方式
  • CNC 加工从业者:需要带精确 joinery 的 3D 模型用于刀路生成
  • 教育工作者:木工与参数化设计的交叉教学

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 代码执行风险 | 生成并执行 Python 脚本 | 脚本保存至本地可审查,MCP 仅限 localhost |
| 模型几何错误 | 参数修改可能导致干涉或断裂 | 每阶段强制 `validate_design` 检查 |
| 数据持久化 | `clean=True` 误用会清除用户现有工作 | 工具层强制校验,拒绝未追踪文档的清理操作 |
| 网络安装 | 使用 curl 管道安装 | 源码完全可审计,建议先下载审查再执行 |
| 功能漂移 | Draft joinery 可能行为异常 | 文档明确标注状态,使用时需额外验证 |

技术亮点

该技能体现了"Craft as Code"的理念——将传统木工的工艺知识(grain direction、joinery mechanics、wood movement)编码为可执行的参数规则。例如,其"如果它适配,就切割它"原则(rule 6)确保任何咬合结构都通过 CUT 操作实现,而非独立绘制空隙,从根本上保证几何一致性。

Shopprentice 内容

addin文件夹
palette文件夹
primitives文件夹
server文件夹
tools文件夹
_script_generator文件夹
commands文件夹
dev文件夹
examples文件夹
bed-frame文件夹
bench文件夹
bookshelf文件夹
cabinet文件夹
chair文件夹
coffee-table文件夹
counter-stool文件夹
crib文件夹
desk文件夹
dresser文件夹
esherick-stool文件夹
hall_bench文件夹
mirror-frame文件夹
pencil-box文件夹
pergola-rebuild文件夹
rachels-table文件夹
roubo_workbench文件夹
shelf文件夹
side-table文件夹
sideboard文件夹
stool-rebuild文件夹
tv-console文件夹
wardrobe文件夹
windsor-chair文件夹
wood-planter文件夹
wrap-box文件夹
hardware文件夹
helpers文件夹
mcp文件夹
scripts文件夹
tests文件夹
fixtures文件夹
tools文件夹
woodgrain文件夹
woodworking文件夹
joinery文件夹
styles文件夹
templates文件夹
types文件夹
手动下载zip · 942.2 kB
__init__.pytext/plain
请选择文件