HiCAD – 开源的 AI 参数化 3D CAD 建模平台

1. HiCAD是什么

HiCAD 是一款开源的 AI 参数化 3D CAD 建模平台，专为 3D 打印爱好者和创客群体设计，旨在通过自然语言交互彻底降低传统 CAD 软件的学习门槛。用户只需用中文或英文描述需求，AI 即可秒级生成可编辑的 JSCAD 参数化代码，配合实时 3D 预览、Monaco 代码编辑器与参数化滑块面板，实现从创意构思到可打印 STL 模型的一站式工作流。该平台由社区开发者 MrXujiang 主导开发，基于 GPL v3 协议完全开源，支持 Docker 和 PM2 私有化部署，具备极高的灵活性和可扩展性。

技术定位与领域： HiCAD 定位于 AI 驱动的参数化 3D 建模领域，属于“文本到 3D 模型”生成工具的一个细分方向。与传统的文本到 3D 生成工具不同，HiCAD 输出的不是不可编辑的网格或点云，而是参数化的 JSCAD 代码，用户可对生成的模型进行精确的尺寸调整和结构修改，完美适配 3D 打印场景。

研发背景： 该项目由开发者 MrXujiang 个人发起并维护，其动机源于传统 3D 建模软件（如 Fusion 360、SolidWorks、Blender）对普通用户极高的学习曲线。研发团队希望通过引入大语言模型（LLM）的自然语言理解能力，结合参数化建模的确定性优势，打造一个“零门槛”的 3D 建模工具，让非专业用户也能快速将创意转化为可打印的实物。

核心价值： HiCAD 的核心价值在于它解决了 3D 打印领域长期存在的两大痛点：一是建模软件的学习成本过高，二是从设计到打印的流程碎片化。通过将自然语言理解、代码生成、实时渲染、参数化控制和文件导出整合在一个统一的 Web 界面中，HiCAD 将“想法到模型”的周期从数小时甚至数天缩短到几分钟，极大提升了个人创客和小型团队的迭代效率。

技术特点： HiCAD 采用双阶段精准建模引擎架构，先通过 LLM 进行意图分析，再调用确定性代码生成器输出精确的 JSCAD 脚本，避免了纯 AI 生成的“幻觉”问题。前端基于 Vue 3 + Three.js，利用 WebWorker 隔离代码执行环境实现 300ms 级的实时预览反馈，后端则通过 SSE 流式推送和多适配器设计支持 DeepSeek、OpenAI、Qwen 等主流大模型的一键切换。

2. 主要功能

• AI 智能建模： 用户输入自然语言描述（如“一个带 M3 螺丝孔的手机支架”），系统通过双阶段引擎自动分析意图并生成参数化 JSCAD 代码。该过程结合了大模型的语义理解能力和确定性代码生成器的精确性，确保输出的模型在结构上零误差，解决了纯 AI 生成中的“幻觉”问题。

• 实时 3D 预览： 采用 WebWorker 隔离 JSCAD 代码执行，并通过 Three.js WebGL 进行硬件加速渲染。代码变更后，3D 视图在 300 毫秒内即可呈现更新结果，支持 360° 交互旋转、缩放和平移，提供接近原生 CAD 软件的流畅体验。

• Monaco 代码编辑器： 内置与 VS Code 同源的 Monaco 编辑器，提供语法高亮、智能代码补全和错误提示。用户可直接手动编辑 JSCAD 源码，并支持“AI 继改”模式——即用户修改部分代码后，AI 能精确定位修改点并保留原有结构进行二次生成，实现人机协作的精细建模。

• 参数化控制面板： 系统自动从生成的 JSCAD 代码中提取关键变量（如长度、宽度、半径、孔距等），并生成对应的可视化滑块控件。用户无需编写代码，只需拖动滑块即可实时调节模型尺寸，所有参数变化同步反映在 3D 预览中，极大降低了非技术用户的操作门槛。

• STL/OBJ 导入导出： 支持导入外部 STL 文件进行在线预览，模型完成后可一键导出为 ASCII/Binary STL 或 OBJ 格式。导出的文件尺寸单位精确到毫米，可直接导入 Cura、PrusaSlicer 等主流切片软件，无缝衔接 3D 打印工作流。

• 模板市场： 内置 24 个覆盖手机支架、机械臂、珠宝、外壳配件等行业的免费模板。用户可直接使用模板进行 AI 二次编辑，或将自己满意的作品发布到社区共享，形成从消费到贡献的闭环生态。

• 多 AI 适配器： 后端封装了 DeepSeek、OpenAI、Qwen 等大模型的统一适配器接口。用户只需在 .env 文件中修改一行配置（如 AI_ADAPTER=deepseek），即可在多个模型之间热切换，兼顾生成质量、成本和网络稳定性。

• 模型分享： 生成独立分享链接，接收方无需登录即可在线预览参数化 3D 模型，支持 360° 交互浏览。该功能特别适合团队协作评审或社区展示，降低了模型分享的沟通成本。

3. 如何使用

1. 环境要求与前置条件： 在线体验无需安装任何软件，仅需现代浏览器（Chrome、Edge 或 Firefox）。本地部署则需要确保系统已安装 Node.js >= 18.0.0 和 pnpm >= 9.0.0，建议操作系统为 Linux 或 macOS，Windows 环境需额外配置 Git Bash 或 WSL。

2. 在线体验流程： 访问 HiCAD 官网（https://hicad.mvtable.com/），在首页输入框用自然语言描述需求，例如“一个带 M3 螺丝孔的手机支架”。AI 自动输出 JSCAD 参数化代码并在右侧实时渲染 3D 预览。通过左侧面板的可视化滑块调节模型尺寸，实时观察 3D 视图变化。确认无误后点击“导出”按钮下载 STL 文件，直接导入 Cura 等切片软件进行 3D 打印。

3. 本地部署步骤： 执行 git clone [email protected]:MrXujiang/HiCAD.git 克隆项目并进入 HiCAD 目录。复制 .env.example 为 .env，填入 DEEPSEEK_API_KEY 或其他 AI 模型的 API Key。运行 pnpm install && pnpm start 安装依赖并启动服务，服务启动后访问 http://localhost:3000 即可使用。

4. 关键配置说明： 修改 .env 文件中的 AI_ADAPTER 字段为 deepseek、openai 或 qwen，重启服务即可切换 AI 后端。如需使用 OpenAI，还需配置 OPENAI_API_KEY 和 OPENAI_BASE_URL（可选，用于代理）。建议首次使用 DeepSeek，因其免费额度较高且中文理解能力优秀。

5. 注意事项与最佳实践： 对于复杂模型（如机械臂、坦克），建议在描述中明确标注尺寸单位和结构关系（如“直径 50mm 的圆柱体”），以提升 AI 生成精度。本地部署时，如果使用 PM2 管理进程，需确保环境变量正确加载。若遇到 WebWorker 加载失败，请检查浏览器是否允许跨域请求。

4. 优缺点分析

5. 同类工具对比

选型建议： 对于 3D 打印爱好者和创客群体，HiCAD 是最佳选择，因为它提供了从自然语言输入到可打印 STL 文件的最短路径，且参数化编辑能力允许用户进行精细调整。对于机械工程师和专业产品设计师，Text-to-CAD (Zoo) 更合适，因为它输出标准的 STEP 格式，可直接导入专业 CAD 软件进行后续工程分析。而对于需要快速生成视觉原型或概念展示的用户，Meshy 或 Point-E 可能更高效，但它们生成的模型通常需要额外的手动优化才能用于 3D 打印。

6. 编辑点评

HiCAD 在技术创新性上展现了令人印象深刻的双阶段引擎设计。与当前主流的“文本到 3D 网格”生成工具不同，HiCAD 没有停留在生成不可编辑的网格模型，而是选择输出参数化的 JSCAD 代码。这一设计决策体现了对 3D 打印实际工作流的深刻理解——3D 打印用户需要的不是“一次性”的模型，而是可以反复调整尺寸、修改结构、适配不同打印机的“可编辑资产”。将 LLM 的语义理解能力与确定性代码生成器结合，有效规避了纯 AI 生成中的“幻觉”问题，这是一个值得行业借鉴的架构思路。

从实用价值来看，HiCAD 将 3D 建模的门槛降到了前所未有的低度。任何一个会打字的人，都可以在几分钟内生成一个手机支架、机械臂关节或珠宝原型。这对于 STEM 教育、硬件原型迭代和个人创作场景具有革命性意义。然而，当前版本在复杂工业级模型上的表现仍有提升空间，AI 生成的代码有时需要手动调整才能满足精确的工程要求。

适用人群方面，HiCAD 最适合 3D 打印爱好者、创客、教育工作者和需要快速迭代硬件原型的初创团队。对于需要高精度工程模型的机械工程师，建议仍以传统 CAD 软件为主，将 HiCAD 作为灵感生成和快速原型工具。

未来发展潜力巨大。随着大模型能力的持续提升和 JSCAD 社区的壮大，HiCAD 有望成为“个人 3D 建模”的标准入口。建议开发团队优先优化复杂模型的生成质量，并引入社区驱动的模板贡献机制，以加速生态建设。

• 技术创新性：★★★★★（双阶段引擎设计独特）
• 实用价值：★★★★☆（大幅降低门槛，但复杂模型待优化）
• 易用性：★★★★★（零学习成本）
• 生态成熟度：★★★☆☆（模板和社区尚在初期）
• 开源友好度：★★★★★（GPL v3，完全可自托管）

7. 应用场景

• 个人 3D 打印创作： 3D 打印爱好者快速将创意转化为可打印模型，无需学习传统 CAD 软件。用户只需用自然语言描述需求，AI 生成参数化代码后，通过滑块调整尺寸，一键导出 STL 文件即可开始打印。例如，制作一个定制的手机支架或桌面收纳盒，整个过程仅需 5 分钟。

• STEM 教育启蒙： 教育领域用于 STEM 教学，学生通过自然语言理解参数化设计与 3D 建模原理。教师可以设计“用语言描述一个立体结构”的课堂活动，学生通过调整滑块观察模型变化，直观理解几何参数对模型的影响，激发对工程设计的兴趣。

• 硬件原型迭代： 创客与硬件开发者快速迭代机械结构原型，如手机支架、机械臂关节、外壳配件等。在硬件开发初期，使用 HiCAD 快速生成多个版本的原型进行测试，根据实际效果反馈调整描述参数，实现“描述-打印-测试-修改”的快速循环，大幅缩短开发周期。

• 珠宝与工业设计定制： 珠宝与工业设计从业者用模板市场进行二次定制，缩短从概念到实物的时间。设计师可以在模板市场中找到戒指、吊坠等基础模型，通过 AI 二次编辑添加个性化元素，再通过参数化滑块调整尺寸和比例，快速生成样品进行物理验证。

• 企业私有化模型库： 企业团队私有化部署内部 3D 模型库，实现设计资产的安全管理与协同共享。团队可以在内部服务器上部署 HiCAD，建立统一的模型管理平台，成员通过分享链接在线预览和评审，避免文件版本混乱和格式兼容问题。

8. 常见问题FAQ

Q：HiCAD 生成的模型可以直接用于 3D 打印吗？
A：可以。HiCAD 导出的 STL 文件尺寸单位精确到毫米，可直接导入 Cura、PrusaSlicer、Bambu Studio 等主流切片软件。建议在切片前检查模型是否封闭（水密性），必要时在切片软件中启用“修复”功能。

Q：本地部署时，如何切换使用的 AI 模型？
A：修改项目根目录下的 .env 文件，将 AI_ADAPTER 字段设置为 deepseek、openai 或 qwen，并确保填写了对应模型的 API Key。修改后重启服务即可生效。例如，切换到 DeepSeek 的配置为：AI_ADAPTER=deepseek 和 DEEPSEEK_API_KEY=your_key_here。

Q：HiCAD 支持哪些 3D 模型格式的导入和导出？
A：导出支持 ASCII/Binary STL 和 OBJ 格式，导入支持 STL 格式的在线预览。不支持 STEP、IGES、FBX 等工业级格式的导入或导出。如果需要这些格式，建议将 STL 导入 Blender 或 Fusion 360 进行格式转换。

Q：生成的模型精度如何？能否满足工程级需求？
A：对于常见的 3D 打印模型（如手机支架、外壳、装饰品），HiCAD 的生成精度完全满足需求，尺寸误差在 0.1mm 以内。但对于需要高公差配合的机械零件（如齿轮、轴承座），建议使用传统 CAD 软件进行精确建模，或将 HiCAD 生成的模型导入专业软件进行微调。

Q：HiCAD 的模板市场如何贡献和共享模型？
A：目前模板市场的共享功能正在开发中。用户可以将自己满意的 JSCAD 代码通过 GitHub Issue 或 Pull Request 的方式提交给项目维护者，审核通过后会被收录到官方模板库。社区也鼓励用户在自己的博客或社交媒体上分享生成的模型链接。

Q：使用 OpenAI 作为 AI 后端时，是否需要配置代理？
A：如果您的服务器无法直接访问 OpenAI API（如位于中国大陆），需要在 .env 文件中设置 OPENAI_BASE_URL 为可用的代理地址（如 https://api.openai-proxy.com/v1）。建议优先使用 DeepSeek 或 Qwen 等国内可用模型，以获得更稳定的连接体验。

Q：HiCAD 是否支持多语言输入？
A：支持。HiCAD 的 AI 后端支持中文、英文、日文等多种自然语言输入。建议使用中文或英文描述以获得最佳效果，因为训练数据中这两种语言占比最高。使用其他语言时，生成质量可能有所下降。

9. 项目地址

• GitHub 仓库： https://github.com/MrXujiang/HiCAD
• 在线体验地址： https://hicad.mvtable.com/
• JSCAD 官方文档： https://openjscad.xyz/