[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-75593":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":34,"readmeContent":35,"aiSummary":36,"trendingCount":15,"starSnapshotCount":15,"syncStatus":37,"lastSyncTime":38,"discoverSource":39},75593,"HiCAD","MrXujiang\u002FHiCAD","MrXujiang","HiCAD,一款AI驱动的CAD建模平台","https:\u002F\u002Fhicad.mvtable.com",null,"JavaScript",129,37,1,0,5,6,98,15,67.54,"GNU General Public License v3.0",false,"main",true,[26,27,28,29,30,31,32,33],"3d-engine","3d-models","3d-printing","3d-visualization","ai-agents","ai-cad","ai-tools","cad","2026-06-12 04:01:18","\u003Cdiv align=\"center\">\n\n# ⬡ HiCAD\n\n**AI 驱动的参数化 3D CAD 建模平台**\n\n![](https:\u002F\u002Fnext.jitword.com\u002Fuploads\u002Fdemo_19e108a1958.png)\n![](demo.png)\n\n*用自然语言描述你的想法，秒级生成可 3D 打印的参数化模型*\n\n[![License: GPL v3](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-GPLv3-blue.svg)](https:\u002F\u002Fwww.gnu.org\u002Flicenses\u002Fgpl-3.0)\n[![Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNode.js-%3E%3D18-339933.svg?logo=nodedotjs)](https:\u002F\u002Fnodejs.org\u002F)\n[![Vue 3](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVue-3.x-42b883.svg?logo=vuedotjs)](https:\u002F\u002Fvuejs.org\u002F)\n[![NestJS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNestJS-10.x-E0234E.svg?logo=nestjs)](https:\u002F\u002Fnestjs.com\u002F)\n[![TypeScript](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTypeScript-5.x-3178C6.svg?logo=typescript)](https:\u002F\u002Fwww.typescriptlang.org\u002F)\n[![PRs Welcome](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-brightgreen.svg)](https:\u002F\u002Fgithub.com\u002Fyour-username\u002Fhicad\u002Fpulls)\n\n[🚀 demo](https:\u002F\u002Fhicad.mvtable.com) · [✨ 功能特性](#-功能特性) · [🤖 AI 配置](#-ai-适配器配置) · [🛠️ 技术栈](#️-技术栈) · [🤝 参与贡献](#-参与贡献)\n\n\u003C\u002Fdiv>\n\n💡：在线体验：https:\u002F\u002Fhicad.mvtable.com\n\n---\n\n## ✨ 功能特性\n\n| 功能 | 描述 |\n|------|------|\n| 🤖 **AI 智能建模** | 自然语言输入，AI 自动生成参数化 JSCAD 3D 代码 |\n| 🎯 **双阶段精准建模** | 机械臂\u002F坦克等复杂模型：意图分析 → 确定性代码生成，零定位误差 |\n| 👁️ **实时 3D 预览** | WebWorker 驱动零卡顿渲染，Three.js 360° 旋转交互 |\n| ✏️ **Monaco 代码编辑器** | VS Code 同款编辑器，语法高亮 + 智能补全 |\n| 🎛️ **参数化控制面板** | 滑块实时调节模型尺寸参数，所见即所得 |\n| 📦 **STL \u002F OBJ 导出** | 一键导出，直接导入切片软件开始 3D 打印 |\n| 🏪 **模板市场** | 浏览、使用、发布社区共享的 3D 参数化模板 |\n| 🔗 **模型分享** | 生成分享链接，他人无需登录即可预览你的模型 |\n| 🔄 **多 AI 适配器** | 支持 DeepSeek · OpenAI · Qwen，`.env` 一行切换 |\n| 📱 **响应式设计** | 完美适配桌面端与移动端 |\n\n---\n\n## 🚀 快速开始\n\n### 前置要求\n\n- **Node.js** >= 18.0.0  \n- **pnpm** >= 9.0.0\n\n```bash\n# 安装 pnpm（未安装时执行）\nnpm install -g pnpm\n```\n\n### 一键启动\n\n```bash\n# 1. 克隆仓库\ngit clone git@github.com:MrXujiang\u002FHiCAD.git\ncd HiCAD\n\n# 2. 配置环境变量（填入你的 AI API Key）\nvi .env\n# ↑ 编辑.env，填写你的 DEEPSEEK_API_KEY\n\n# 3. 安装依赖 & 启动\npnpm install && pnpm start\n```\n\n🎉 启动成功后打开浏览器访问：\n\n| 服务 | 地址 |\n|------|------|\n| 🌐 前端页面 | http:\u002F\u002Flocalhost:3000 |\n| 🔌 后端 API | http:\u002F\u002Flocalhost:3000\u002Fapi |\n\n> **💡 获取注册激活码**：关注微信公众号 **「趣谈AI」**，回复 **「HiCAD」** 即可免费获得永久激活码，完成注册后即可使用 AI 建模功能。\n\n---\n\n## ⚙️ 环境变量说明\n\n复制 `.env.example` 为 `.env` 并按需填写：\n\n```env\n# 服务端口\nPORT=3000\n\n# JWT 密钥（生产环境必须修改为随机字符串！）\nJWT_ACCESS_SECRET=change-me-to-random-string-32chars\nJWT_REFRESH_SECRET=change-me-to-random-string-32chars\n\n# AI 适配器选择：deepseek | openai | qwen\nAI_ADAPTER=deepseek\n\n# 至少填写一个 API Key\nDEEPSEEK_API_KEY=your_deepseek_api_key_here\nOPENAI_API_KEY=your_openai_api_key_here\nQWEN_API_KEY=your_qwen_api_key_here\n\n# 数据存储目录（默认 .\u002Fdata，无需修改）\nDATA_DIR=.\u002Fdata\n```\n\n---\n\n## 🤖 AI 适配器配置\n\n| 适配器 | 推荐模型 | 特点 | 获取 Key |\n|--------|----------|------|----------|\n| `deepseek` ⭐ | DeepSeek V3 | **推荐**，性价比极高，代码能力强 | [platform.deepseek.com](https:\u002F\u002Fplatform.deepseek.com\u002F) |\n| `openai` | GPT-4o | 高质量，价格较高 | [platform.openai.com](https:\u002F\u002Fplatform.openai.com\u002F) |\n| `qwen` | Qwen-Max | 国内访问稳定 | [dashscope.aliyuncs.com](https:\u002F\u002Fdashscope.aliyuncs.com\u002F) |\n\n修改 `.env` 中的 `AI_ADAPTER` 字段即可切换，重启服务后生效。\n\n---\n\n## 🛠️ 技术栈\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>前端技术\u003C\u002Fb>\u003C\u002Fsummary>\n\n| 技术 | 版本 | 用途 |\n|------|------|------|\n| [Vue 3](https:\u002F\u002Fvuejs.org\u002F) | 3.x | UI 框架，Composition API |\n| [Vite](https:\u002F\u002Fvitejs.dev\u002F) | 5.x | 构建工具，极速热重载 |\n| [Pinia](https:\u002F\u002Fpinia.vuejs.org\u002F) | 2.x | 状态管理 |\n| [Three.js](https:\u002F\u002Fthreejs.org\u002F) | 0.160+ | WebGL 3D 渲染 |\n| [Monaco Editor](https:\u002F\u002Fmicrosoft.github.io\u002Fmonaco-editor\u002F) | 0.45+ | 代码编辑器（VS Code 内核） |\n| [Tailwind CSS](https:\u002F\u002Ftailwindcss.com\u002F) | 3.x | 原子化 CSS 样式 |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>后端技术\u003C\u002Fb>\u003C\u002Fsummary>\n\n| 技术 | 版本 | 用途 |\n|------|------|------|\n| [NestJS](https:\u002F\u002Fnestjs.com\u002F) | 10.x | Node.js 企业级框架 |\n| [TypeScript](https:\u002F\u002Fwww.typescriptlang.org\u002F) | 5.x | 类型安全 |\n| [Passport JWT](http:\u002F\u002Fwww.passportjs.org\u002F) | - | 无状态身份认证 |\n| [lowdb](https:\u002F\u002Fgithub.com\u002Ftypicode\u002Flowdb) | 7.x | 轻量级 JSON 文件数据库 |\n| [bcrypt](https:\u002F\u002Fgithub.com\u002Fkelektiv\u002Fnode.bcrypt.js) | 5.x | 密码安全哈希 |\n| SSE (Server-Sent Events) | - | AI 流式输出实时推送 |\n\n\u003C\u002Fdetails>\n\n---\n\n## 📁 项目结构\n\n```\nhicad\u002F\n├── backend\u002F                    # NestJS 后端服务\n│   ├── src\u002F\n│   │   ├── modules\u002F\n│   │   │   ├── ai\u002F             # AI 建模核心\n│   │   │   │   ├── adapters\u002F   # DeepSeek \u002F OpenAI \u002F Qwen 适配器\n│   │   │   │   ├── design-prompt.ts   # 机械臂意图分析 Prompt\n│   │   │   │   ├── tank-prompt.ts     # 坦克意图分析 Prompt\n│   │   │   │   ├── jscad-codegen.ts   # 确定性 3D 代码生成器\n│   │   │   │   └── prompt-builder.ts  # 通用建模 Prompt\n│   │   │   ├── auth\u002F           # JWT 认证 + 激活码注册\n│   │   │   ├── model\u002F          # 3D 模型 CRUD\n│   │   │   ├── template\u002F       # 模板市场\n│   │   │   ├── user\u002F           # 用户管理 + AI 配额\n│   │   │   ├── admin\u002F          # 管理后台\n│   │   │   └── feedback\u002F       # 意见反馈\n│   │   └── database\u002F           # lowdb JSON 数据库服务\n│   ├── data\u002F                   # 运行时数据（.gitignore 保护）\n│   └── .env                    # 环境变量（.gitignore 保护）\n│\n├── frontend\u002F                   # Vue 3 前端\n│   ├── src\u002F\n│   │   ├── pages\u002F              # 页面：Home \u002F Editor \u002F Workspace \u002F Market\n│   │   ├── components\u002F         # 组件：AI 聊天框 \u002F 3D 预览 \u002F 代码编辑器\n│   │   ├── stores\u002F             # Pinia：用户 \u002F 编辑器 \u002F AI 状态\n│   │   ├── composables\u002F        # useJscad \u002F useThreeScene\n│   │   └── utils\u002F              # JSCAD 解析 \u002F STL 导出\n│   └── public\u002Fworkers\u002F         # JSCAD WebWorker\n│\n└── shared\u002F                     # 前后端共享 TypeScript 类型\n    └── src\u002Ftypes\u002F              # User \u002F Model \u002F AI 类型定义\n```\n\n---\n\n## 🏗️ 构建与部署\n\n### 本地开发\n\n```bash\npnpm dev              # 同时启动前端(5173) + 后端(3000)，支持热重载\npnpm build            # 构建生产版本（shared → backend → frontend）\npnpm start            # 生产模式启动后端\n```\n\n### 使用 PM2 部署到服务器\n\n```bash\n# 构建\npnpm build\n\n# 将前端 dist 复制到后端 public 或 nginx 静态目录\n# 使用 PM2 守护后端进程\npm2 start ecosystem.config.json\npm2 save && pm2 startup\n```\n\n### Nginx 反向代理配置参考\n\n```nginx\nserver {\n    listen 80;\n    server_name your-domain.com;\n\n    # 前端静态文件\n    location \u002F {\n        root \u002Fpath\u002Fto\u002Fhicad\u002Ffrontend;\n        try_files $uri $uri\u002F \u002Findex.html;\n    }\n\n    # API 反向代理\n    location \u002Fapi {\n        proxy_pass http:\u002F\u002Flocalhost:3000;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        # 支持 SSE 流式响应\n        proxy_buffering off;\n        proxy_cache off;\n        proxy_read_timeout 300s;\n    }\n}\n```\n\n---\n\n## 🗺️ 路线图\n\n- [x] AI 自然语言 → JSCAD 3D 模型\n- [x] 双阶段精准建模（机械臂 \u002F 坦克）\n- [x] Monaco 代码编辑器 + 实时预览\n- [x] 参数化控制面板\n- [x] 模板市场\n- [x] STL \u002F OBJ 导出\n- [x] 激活码注册系统\n- [ ] Docker 一键部署支持\n- [ ] 更多 AI 模型类型（人形机器人、建筑结构）\n- [ ] 协同编辑\n- [ ] 模型版本历史\n\n---\n\n## 📬 联系与支持\n\n- 🔔 关注微信公众号 **「趣谈AI」** → 回复 **「HiCAD」** 获取激活码及最新动态\n- 🐛 提交 [GitHub Issue](https:\u002F\u002Fgithub.com\u002Fyour-username\u002Fhicad\u002Fissues) 反馈 Bug 或功能建议\n\n---\n\n## 📄 开源协议\n\n本项目基于 [GNU General Public License v3.0](LICENSE) 开源。\n\n```\nCopyright (C) 2025 HiCAD Contributors\n\nThis program is free software: you can redistribute it and\u002For modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n```\n\n**本协议要求**：基于本项目的衍生作品必须同样以 GPL v3 协议开源。\n\n---\n\n\u003Cdiv align=\"center\">\n\n如果这个项目对你有帮助，请点一个 ⭐ **Star** 支持一下！\n\n**Made with ❤️ by [趣谈AI](https:\u002F\u002Fgithub.com\u002Fyour-username)**\n\n\u003C\u002Fdiv>\n","HiCAD 是一款AI驱动的参数化3D CAD建模平台，支持用户通过自然语言描述快速生成可3D打印的模型。其核心功能包括基于AI的智能建模、双阶段精准建模流程、实时3D预览与交互、Monaco代码编辑器集成以及参数化控制面板等，使得从概念到成品的过程变得流畅高效。该平台采用Node.js、Vue 3、NestJS和TypeScript构建，确保了良好的性能与用户体验，并且能够适配多种AI服务如DeepSeek、OpenAI及Qwen。HiCAD非常适合需要快速原型设计或定制化3D打印项目的场景使用，无论是专业设计师还是业余爱好者都能从中受益。",2,"2026-06-11 03:53:01","CREATED_QUERY"]