跳转至

freecad-dsh

DeepSeek Harness (DSH) 插件 — 让 AI 通过 Python 脚本调用 FreeCAD 实现创意设计

项目信息
仓库 https://github.com/Maicarons/freecad-dsh
在线体验 https://maicarons.github.io/freecad-dsh
主要语言 JavaScript
Stars 1
类型 原创项目
许可证 —
最近更新 2026-09-05

FreeCAD-DSH: AI 驱动的 FreeCAD 创意设计插件

English | 中文

FreeCAD-DSH 是一个 DeepSeek Harness (DSH) 插件，让 AI 能够通过 Python 脚本调用 FreeCAD 的各项功能，实现智能化、自动化的创意设计。

🚧 项目状态: 早期开发阶段 — API 和功能可能发生变化。

✨ 功能

  • 📐 参数化建模 — AI 自动生成 Python 脚本，创建参数化 3D 模型
  • 🔧 多工作台支持 — 支持 Part、PartDesign、Sketcher、Draft、Mesh 等工作台
  • 💬 自然语言设计 — 用自然语言描述设计意图，AI 自动转换为 FreeCAD 操作
  • 🔄 迭代优化 — 基于 AI 反馈循环的智能设计迭代
  • 📁 文件格式支持 — 导入/导出 STEP、STL、OBJ、DXF、IGES 等格式
  • 🧩 可扩展工具架构 — 每个 FreeCAD 操作都是独立的 DSH 工具

🚀 快速开始

前置要求

安装

## 克隆仓库
git clone https://github.com/Maicarons/freecad-dsh.git
cd freecad-dsh

## 安装依赖
npm install

在 DSH 中加载插件

## 方式 1：通过 DSH 插件命令加载
dsh plugin add freecad-dsh --path ./path/to/freecad-dsh

## 方式 2：在 DSH 配置中引用
## 编辑 dsh 配置，将 freecad-dsh 添加到 plugins 列表

配置 FreeCAD 路径

在 DSH 设置中配置 freecad.path，指向 FreeCAD 可执行文件：

{
  "freecad": {
    "path": "/usr/bin/freecad",
    "cmdPath": "/usr/bin/freecadcmd"
  }
}

📖 文档

完整文档请访问 https://maicarons.github.io/freecad-dsh（配置后可用）。

本地构建文档：

npm run docs:dev

🏗️ 项目结构

freecad-dsh/
├── src/
│   ├── host/          # DSH Host 端 — 工具注册与 FreeCAD 进程管理
│   │   ├── index.js   # 主入口
│   │   ├── freecad.js # FreeCAD 进程管理器
│   │   └── tools/     # 各个 FreeCAD 操作工具
│   ├── client/        # DSH Client 端 — 浏览器 UI
│   │   └── index.js   # 客户端 UI 注册
│   └── python/        # Python 桥接脚本
│       ├── bridge.py  # 主桥接模块
│       └── operations/ # FreeCAD 操作封装
├── docs/              # VitePress 文档
├── scripts/           # 辅助脚本
├── test/              # 测试
├── package.json
├── README.md
└── LICENSE

🛠️ 开发

## 安装开发依赖
npm install

## 本地构建文档
npm run docs:dev

## 运行测试
npm test

🤝 贡献

欢迎贡献！请阅读 贡献指南 了解详情。

📄 许可证

本项目基于 AGPL-3.0 许可证发布。

🙏 致谢