项目文件夹

0
2026-07-13 10:17:21 +00:00

Note

本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

CAD 技能生成并预览 CAD 几何体的演示
 ██████╗ █████╗ ██████╗       ███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
██╔════╝██╔══██╗██╔══██╗      ██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
██║     ███████║██║  ██║      ███████╗█████╔╝ ██║██║     ██║     ███████╗
██║     ██╔══██║██║  ██║      ╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
╚██████╗██║  ██║██████╔╝      ███████║██║  ██╗██║███████╗███████╗███████║
 ╚═════╝╚═╝  ╚═╝╚═════╝       ╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝

面向 CAD、机器人与硬件设计智能体的技能库

文档 | 演示

加入 Discord GitHub stars License: MIT Follow @earthtojake Python STEP STL 3MF URDF SDF SRDF

CAD Skills

CAD Skills 是一个智能体技能库,用于从本地项目文件生成、检查、采购、切片以及交接 CAD 与机器人描述(robot-description)工件。

🧰 Skills

安装本库可为智能体提供面向 CAD、制造、机器人描述文件、仿真与本地审阅的专项工作流。

Skill Summary Source
CAD 根据自然语言或图像请求创建和编辑 CAD 模型,主要输出 STEP,并可选择导出为 STL、3MF 和 GLB。 skills/cad
CAD Viewer 在本地浏览器中预览 CAD、G-code 和机器人文件。 skills/cad-viewer
step.parts 查找现成的 STEP 零件,如螺丝、轴承、电机和连接器。 skills/step-parts
DXF 从 Python 源码或 CAD 几何体创建 2D DXF 图纸,如型材、模板、垫片和切割布局。 skills/dxf
URDF 编写包含连杆(links)、关节(joints)、限位、惯量和网格的机器人结构文件。 skills/urdf
SRDF 为 URDF 添加 MoveIt 规划组、末端执行器、位姿和碰撞规则。 skills/srdf
SDF 创建包含坐标系、物理、传感器和光照的仿真器模型与世界。 skills/sdf
SendCutSend 在上传至 SendCutSend 前检查 DXF 和 STEP 文件。 skills/sendcutsend
G-code 使用真实切片器 CLI,将支持的网格文件切片为经过验证、匹配打印机配置的 FDM .gcode skills/gcode
Bambu Labs 对经过验证的 .gcode 进行试运行、上传,并谨慎启动本地 Bambu Lab 打印任务。 skills/bambu-labs
Implicit CAD 使用 GLSL 有符号距离场(signed-distance fields)和 CAD Viewer 光线步进(raymarch)渲染,创建浏览器原生隐式 CAD 模型。实验性功能。 skills/implicit-cad

💻 Installation

生产环境请从 main 安装或克隆;该分支包含提供商安装器所需的已生成技能/插件输出。

Skills

使用 Skills CLI 安装 CAD Skills

npx skills install earthtojake/text-to-cad

这是首选安装方式。它会为支持的智能体直接安装各个技能。

Plugins

Codex 和 Claude Code 也支持提供商原生插件安装:

# Codex
codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad
# Claude Code
claude plugin marketplace add earthtojake/text-to-cad
claude plugin install cad@text-to-cad

若新安装的技能未出现,请重启你的智能体。本地开发时,从 develop 拉分支,向 develop 提交 PR,并采用 CONTRIBUTING.md 中的符号链接工作流。

📸 Screenshots

CAD 技能演示:在 CAD Viewer 中展示生成的几何体 CAD URDF 技能演示:在 CAD Viewer 中展示机器人描述输出 URDF SRDF MoveIt2 技能演示:在 CAD Viewer 中展示逆运动学 SRDF / MoveIt2

🧪 Benchmarks

本仓库通过 Git LFS 将重型资源存放在 assets/**benchmarks/** 中,并将这些目录排除在默认 LFS 拉取之外,以便轻量克隆不会下载 GIF 资源。基准测试 Markdown 仍使用普通 Git 管理,便于阅读 diff。若要在本地仅拉取基准测试资源,请运行:

git lfs pull --include="benchmarks/**"
# Target Prompt Output
1 带四个孔的长方体校准块 创建一个居中的 100 x 60 x 20 mm 块体,带四个 8 mm 垂直通孔。仅在外侧顶面周边添加 2 mm 倒角。 长方体校准块旋转演示 gif
2 带螺栓孔分布的圆形法兰 创建一个直径 80 mm、厚 10 mm 的圆形法兰,中央通孔直径 30 mm。在 60 mm 螺栓圆上添加六个 6 mm 通孔,并对外侧圆边倒圆角。 圆形法兰旋转演示 gif
3 带加强筋与双向孔的 L 型支架 由底板与后侧竖板创建 L 型支架。添加底板竖向孔、背板横向孔、两块三角形加强筋,并对底板/背板过渡处倒圆角。 L 型支架旋转演示 gif
4 带键槽的阶梯轴 沿 X 方向创建长 120 mm 的轴,直径阶梯段为 20/30/20 mm。添加端部倒角,并在中间段顶部开浅矩形键槽。 阶梯轴旋转演示 gif
5 带凸台的开放式电子设备外壳 创建一个中空开放式外壳,壁厚与底板均为 3 mm。添加四个内部凸台,带居中盲孔,并对外侧竖向转角倒 2 mm 圆角。 开放式电子设备外壳旋转演示 gif
6 航空风格叉形支架与减重开孔 创建对称叉形支架,含底板、两个圆角耳片、底板安装孔和横向耳片孔。添加三角形减重孔、加强筋和圆角过渡。 叉形支架旋转演示 gif
7 星型发动机风格气缸与散热片 创建竖向发动机气缸外形,含中央筒体、12 片散热片、底部法兰和顶盖。添加 35 度倾角的火花塞凸台,并开同轴通孔。 星型发动机风格气缸旋转演示 gif
8 后弯叶片的离心叶轮 创建离心叶轮,含背板、轮毂和通孔。添加 12 片一体后弯叶片,从根部到叶尖扫掠约 45 度。 离心叶轮旋转演示 gif
9 带螺旋扶手的旋转楼梯 创建微型旋转楼梯,含中央柱、底座圆盘和 20 级上升楔形踏步。添加一圈螺旋扶手,并在踏步外端设置竖向栏杆柱。 旋转楼梯旋转演示 gif
10 简化行星齿轮级 创建平面行星齿轮总成,含独立的太阳轮、行星轮、齿圈、行星架和销轴实体。使用简化梯形齿,并在半径 42 mm 的圆周上布置三颗行星轮。 行星齿轮级旋转演示 gif

🛠️ 贡献

开发在 develop 分支进行;请向 develop 提交 PR,而不是向 main。 有关本地贡献工作流、skill 链接与验证指引,请参阅 CONTRIBUTING.md