HiCAD 技术架构设计

frontend/src/
├── pages/EditorPage.vue              # 编辑器主页面，编排 AI、代码、参数、预览和导出
├── components/ai/AiChatBox.vue       # AI 对话、模型选择、自定义 Key、生成与停止
├── components/editor/CodeEditor.vue  # Monaco 编辑器、补全、主题、debounce 写回
├── components/editor/ParamPanel.vue  # 参数解析、滑块/输入控件、变量反写
├── components/editor/QualityPanel.vue # 质量评分、低分建议、一键优化
├── components/viewer/ThreeViewer.vue # 3D 预览容器和视图控制
├── stores/aiStore.ts                 # SSE、消息、模型、续改、自动评测
├── stores/editorStore.ts             # 当前代码、渲染状态、质量结果、脏状态
├── stores/userStore.ts               # 登录态、会员、配额、发布权限
├── composables/useJscad.ts           # Worker 管理、requestId、防抖、STL 导入
└── composables/useThreeScene.ts      # Three.js 场景、材质、几何更新、NaN 防护

backend/src/modules/
├── ai/
│   ├── ai.controller.ts              # /api/ai/generate、/modify、/history、/optimize-prompt
│   ├── ai.service.ts                 # AI 编排、配额检查、单/双阶段生成、续改、历史保存
│   ├── adapters/                     # AiAdapter、DeepSeekAdapter、MultiAdapter、OpenAIAdapter
│   ├── prompt-builder.ts             # JSCAD 系统 Prompt 与 Skill-Harness 规则
│   ├── design-prompt.ts              # 机械臂设计规格 Agent Prompt
│   ├── tank-prompt.ts                # 坦克/装甲车辆设计规格 Prompt
│   ├── car-prompt.ts                 # 汽车/超跑设计规格 Prompt
│   ├── design-spec.types.ts          # MechanicalArmSpec、TankSpec、CarSpec 与归一化
│   ├── jscad-codegen.ts              # Stage 2 确定性 JSCAD 代码生成器
│   └── ai-quality-evaluator.service.ts # 7 维质量评测与基准报告
├── auth/                             # JWT 登录和策略
├── user/                             # 用户、会员、配额
├── model/                            # 模型保存、分享、发布
├── template/                         # 模板市场
├── pay/                              # 支付和订单
├── admin/                            # 管理后台
└── feedback/                         # 用户反馈

多 Agents 协作链路

用户需求
  -> Intent Detector 判断 general / mechanical_arm / tank / car
  -> Design Agent 输出结构化 Spec
  -> Spec Normalizer 做范围裁剪和默认值兜底
  -> Codegen Agent 生成确定性 JSCAD
  -> Worker Runtime 执行代码并返回几何
  -> Quality Agent 评分并生成优化建议
  -> Modify Agent 基于当前代码续改

// Harness 心智模型
const base = cuboid({ size: [100, 10, 60] })
const body = roundedCuboid({ size: [80, 35, 45], roundRadius: 4 })
const cover = cuboid({ size: [70, 8, 40] })

// 从下到上堆叠，并让每层有轻微嵌入
return stackOverlap(2, base, body, cover)

Stage 1：Design Agent
Prompt -> {
  type: 'car',
  material: 'painted_metal',
  style: 'supercar',
  params: { carLength, carWidth, carHeight, wheelRadius },
  features: { spoiler, sideIntakes, splitter, diffuser, glassRoof }
}

Stage 2：Deterministic Codegen
Spec -> 参数声明 -> 精确定位公式 -> JSCAD 几何 -> module.exports = { main }

Worker Runtime
  -> extractCode(rawCode)
  -> autoRepairTruncatedCode(code)
  -> executeJscad(cleanCode)
  -> serializeGeometry(geometry)
  -> postMessage({ groups, triangleCount, warning }, transferables)