⬡ HiCAD

AI 驱动的参数化 3D CAD 建模平台

用自然语言描述你的想法，秒级生成可 3D 打印的参数化模型

🚀 demo · ✨ 功能特性 · 🤖 AI 配置 · 🛠️ 技术栈 · 🤝 参与贡献

💡：在线体验：https://hicad.mvtable.com

💌：AI实战学习手册：https://aibook.mvtable.com

---

✨ 功能特性

功能	描述
🤖 AI 智能建模	自然语言输入，AI 自动生成参数化 JSCAD 3D 代码
🎯 双阶段精准建模	机械臂/坦克等复杂模型：意图分析 → 确定性代码生成，零定位误差
👁️ 实时 3D 预览	WebWorker 驱动零卡顿渲染，Three.js 360° 旋转交互
✏️ Monaco 代码编辑器	VS Code 同款编辑器，语法高亮 + 智能补全
🎛️ 参数化控制面板	滑块实时调节模型尺寸参数，所见即所得
📦 STL / OBJ 导出	一键导出，直接导入切片软件开始 3D 打印
🏪 模板市场	浏览、使用、发布社区共享的 3D 参数化模板
🔗 模型分享	生成分享链接，他人无需登录即可预览你的模型
🔄 多 AI 适配器	支持 DeepSeek · OpenAI · Qwen，.env 一行切换
📱 响应式设计	完美适配桌面端与移动端

---

🚀 快速开始

前置要求

• Node.js >= 18.0.0
• pnpm >= 9.0.0

# 安装 pnpm（未安装时执行）
npm install -g pnpm

一键启动

# 1. 克隆仓库
git clone git@github.com:MrXujiang/HiCAD.git
cd HiCAD

# 2. 配置环境变量（填入你的 AI API Key）
vi .env
# ↑ 编辑.env，填写你的 DEEPSEEK_API_KEY

# 3. 安装依赖 & 启动
pnpm install && pnpm start

🎉 启动成功后打开浏览器访问：

服务	地址
🌐 前端页面	http://localhost:3000
🔌 后端 API	http://localhost:3000/api

💡 获取注册激活码：关注微信公众号 「趣谈AI」，回复 「HiCAD」 即可免费获得永久激活码，完成注册后即可使用 AI 建模功能。

---

⚙️ 环境变量说明

复制 .env.example 为 .env 并按需填写：

# 服务端口
PORT=3000

# JWT 密钥（生产环境必须修改为随机字符串！）
JWT_ACCESS_SECRET=change-me-to-random-string-32chars
JWT_REFRESH_SECRET=change-me-to-random-string-32chars

# AI 适配器选择：deepseek | openai | qwen
AI_ADAPTER=deepseek

# 至少填写一个 API Key
DEEPSEEK_API_KEY=your_deepseek_api_key_here
OPENAI_API_KEY=your_openai_api_key_here
QWEN_API_KEY=your_qwen_api_key_here

# 数据存储目录（默认 ./data，无需修改）
DATA_DIR=./data

---

🤖 AI 适配器配置

适配器	推荐模型	特点	获取 Key
deepseek ⭐	DeepSeek V3	推荐，性价比极高，代码能力强	platform.deepseek.com
openai	GPT-4o	高质量，价格较高	platform.openai.com
qwen	Qwen-Max	国内访问稳定	dashscope.aliyuncs.com

修改 .env 中的 AI_ADAPTER 字段即可切换，重启服务后生效。

---

🛠️ 技术栈

前端技术

技术	版本	用途
Vue 3	3.x	UI 框架，Composition API
Vite	5.x	构建工具，极速热重载
Pinia	2.x	状态管理
Three.js	0.160+	WebGL 3D 渲染
Monaco Editor	0.45+	代码编辑器（VS Code 内核）
Tailwind CSS	3.x	原子化 CSS 样式

后端技术

技术	版本	用途
NestJS	10.x	Node.js 企业级框架
TypeScript	5.x	类型安全
Passport JWT	-	无状态身份认证
lowdb	7.x	轻量级 JSON 文件数据库
bcrypt	5.x	密码安全哈希
SSE (Server-Sent Events)	-	AI 流式输出实时推送

---

📁 项目结构

hicad/
├── backend/                    # NestJS 后端服务
│   ├── src/
│   │   ├── modules/
│   │   │   ├── ai/             # AI 建模核心
│   │   │   │   ├── adapters/   # DeepSeek / OpenAI / Qwen 适配器
│   │   │   │   ├── design-prompt.ts   # 机械臂意图分析 Prompt
│   │   │   │   ├── tank-prompt.ts     # 坦克意图分析 Prompt
│   │   │   │   ├── jscad-codegen.ts   # 确定性 3D 代码生成器
│   │   │   │   └── prompt-builder.ts  # 通用建模 Prompt
│   │   │   ├── auth/           # JWT 认证 + 激活码注册
│   │   │   ├── model/          # 3D 模型 CRUD
│   │   │   ├── template/       # 模板市场
│   │   │   ├── user/           # 用户管理 + AI 配额
│   │   │   ├── admin/          # 管理后台
│   │   │   └── feedback/       # 意见反馈
│   │   └── database/           # lowdb JSON 数据库服务
│   ├── data/                   # 运行时数据（.gitignore 保护）
│   └── .env                    # 环境变量（.gitignore 保护）
│
├── frontend/                   # Vue 3 前端
│   ├── src/
│   │   ├── pages/              # 页面：Home / Editor / Workspace / Market
│   │   ├── components/         # 组件：AI 聊天框 / 3D 预览 / 代码编辑器
│   │   ├── stores/             # Pinia：用户 / 编辑器 / AI 状态
│   │   ├── composables/        # useJscad / useThreeScene
│   │   └── utils/              # JSCAD 解析 / STL 导出
│   └── public/workers/         # JSCAD WebWorker
│
└── shared/                     # 前后端共享 TypeScript 类型
    └── src/types/              # User / Model / AI 类型定义

---

🏗️ 构建与部署

本地开发

pnpm dev              # 同时启动前端(5173) + 后端(3000)，支持热重载
pnpm build            # 构建生产版本（shared → backend → frontend）
pnpm start            # 生产模式启动后端

使用 PM2 部署到服务器

# 构建
pnpm build

# 将前端 dist 复制到后端 public 或 nginx 静态目录
# 使用 PM2 守护后端进程
pm2 start ecosystem.config.json
pm2 save && pm2 startup

Nginx 反向代理配置参考

server {
    listen 80;
    server_name your-domain.com;

    # 前端静态文件
    location / {
        root /path/to/hicad/frontend;
        try_files $uri $uri/ /index.html;
    }

    # API 反向代理
    location /api {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        # 支持 SSE 流式响应
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 300s;
    }
}

---

🗺️ 路线图

• AI 自然语言 → JSCAD 3D 模型
• 双阶段精准建模（机械臂 / 坦克）
• Monaco 代码编辑器 + 实时预览
• 参数化控制面板
• 模板市场
• STL / OBJ 导出
• 激活码注册系统
• Docker 一键部署支持
• 更多 AI 模型类型（人形机器人、建筑结构）
• 协同编辑
• 模型版本历史

---

📬 联系与支持

• 🔔 关注微信公众号 「趣谈AI」 → 回复 「HiCAD」 获取激活码及最新动态
• 🐛 提交 GitHub Issue 反馈 Bug 或功能建议

---

📄 开源协议

本项目基于 GNU General Public License v3.0 开源。

Copyright (C) 2025 HiCAD Contributors

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

本协议要求：基于本项目的衍生作品必须同样以 GPL v3 协议开源。

---

如果这个项目对你有帮助，请点一个 ⭐ Star 支持一下！

Made with ❤️ by 趣谈AI