批次4后续专项完成：D11清偿 + OCC方案B实施 + 部署参数 + D2诚实标注 + CI门禁

① D11 HTML 报告 RustFS 单源化（TECH_DEBT P2 清偿）：可视化产物写任务临时目录后
   裸传报告键 html/reports/{filename}（文件名寻址），/html StaticFiles 挂载删除，
   新增 html_report_router 根路径代理（报告键→遗留 JSON 包装→本地卷兜底→404，
   防穿越）；URL 形状 /html/{filename} 不变，持久化引用零迁移；celery 摘除
   html_data 卷，镜像不再烤入陈旧报告；顺带删除 get_stp_file_with_data 死数据块
② OCC 方案 B（D10 清偿）：run_occ(op_name, payload) 契约 + 常驻工作进程池
   （occ_process_pool + occ_worker 操作注册表），超时/崩溃 terminate 换新补位、
   任务级超时 recover 整体重建，残留线程泄漏根治；TopoDS 不跨进程（generate_cavity
   分模 + 方案 STEP 持久化全在子进程内，返回 export_manifest）；删除内存形状缓存链、
   CADExporter.export_mold_results、shape_loader（→ stp_materializer）
③ OCC 方案 A 部署参数：CELERY_CONCURRENCY / CELERY_MAX_TASKS_PER_CHILD 进
   Dockerfile.celery + compose + .env.example
④ D2 诚实标注：铝价响应带 source: "simulated"，前端按来源渲染标注（原硬编码
   "上海期货交易所"属虚假声明），死代码 getAluminumPrice 删除
⑤ CI 门禁：.gitea/workflows/ci.yml 三 job（pytest / 前端构建含 vue-tsc /
   openapi 漂移检测）

接口变更三件套随批完成（openapi 76→77 paths + gen:api + 前端构建通过；方案 B
接口面零变化）。测试基线 143 passed, 0 skipped（新增 16 项）。文档六处同步。

Co-Authored-By: Claude Code <noreply@anthropic.com>

AGENTS.md

@@ -53,7 +53,8 @@ src/
       machining_router.py       # 加工类接口：/design-cam /check-collision /optimize-toolpath /design-electrodes /simulate-machining
       export_router.py          # 导出类接口：/export-mold /export-download /export-recommendations
       core_modules.py           # 核心计算模块惰性装载器（设计/加工路由共用，装载失败 503）
-      aluminum_price_routes.py  # /api/aluminum-price/* 铝价（当前为模拟/参考数据，见 TECH_DEBT D2）
+      aluminum_price_routes.py  # /api/aluminum-price/* 铝价（模拟数据，响应带 source: "simulated"，见 TECH_DEBT D2）
+      html_report_router.py     # GET /html/{filename} 报告代理（根路径挂载：RustFS 报告键 → 遗留 JSON 包装 → 本地卷兜底；include_into 由入口调用）
       debug_router.py           # /api/debug/tasks 全量任务 dump（仅 DEBUG 模式注册，仍需登录）
     core/                       # 几何与方案核心算法（OCC 重依赖区）
       stp_parser.py             # STEP/STP 解析
@@ -71,16 +72,18 @@ src/
       cavity_layout_optimizer.py # 型腔布局优化
       mold_machining.py / mold_cam.py # 加工与 CAM
       mold_quality_inspector.py # 质量检查
-      cad_exporter.py           # CAD 导出
+      cad_exporter.py           # CAD 导出（export_mold_results 随方案 B 已删；export_step 等供 OCC 子进程持久化/转换）
+      occ_worker.py             # OCC 常驻工作进程入口：操作注册表（parse_stp/generate_mesh/generate_cavity/analyze_mold_design/detect_undercuts/convert_component_step/ping/sleep/warmup）+ worker_main 消息循环
     services/                   # 业务服务层
       task_dispatcher.py        # 后台任务统一分派（勿绕过它 fire-and-forget）
       task_query_service.py     # 任务状态查询聚合
-      processing_service.py     # 分析处理编排
+      processing_service.py     # 分析处理编排（run_occ 经常驻 OCC 进程池调度，见 occ_process_pool.py / OCC_THROUGHPUT.md）
+      occ_process_pool.py       # OCC 常驻工作进程池（方案 B）：超时/崩溃 terminate 换新补位；任务级超时 recover 整体重建
       calculation_service.py    # 计算服务
       cost_estimate_service.py  # 成本估算
       cam_bundle_service.py     # CAM 结果打包
       verification_service.py   # FreeCAD 验证（可选）
-      shape_loader.py           # shape 加载（含 OCC 超时后 executor 重建逻辑）
+      stp_materializer.py       # 按 task_id 把 STP 原件落盘临时文件（OCC 解析在子进程内，形状不跨进程）
       material_service.py       # 物料价格服务
       aluminum_price_service.py # 铝价服务（模拟数据）
       llm_service.py            # LLM 增强分析（可选，OpenAI 兼容）
@@ -98,7 +101,7 @@ src/
     models/                     # inventory 域 ORM（catalog / warehouse / trading / finance 四文件，共 15 表）
     utils.py
   shared/                       # 【共享平台层：只放真正跨模块复用的基础能力，勿堆业务】
-    app_factory.py              # create_app：request_id 日志中间件 / auth_router / /health / SPA fallback / /html mount
+    app_factory.py              # create_app：request_id 日志中间件 / auth_router / /health / SPA fallback / connect_rustfs 开关（D11 后 /html 由 moldinsight 代理路由提供，不再挂本地 StaticFiles）
     config/settings.py          # Settings 单例：dotenv + os.getenv；DB_*/SECRET_KEY 惰性校验无默认
     database/database.py        # async engine / session / get_db_session
     database/init_db.py         # 建表与管理员种子
@@ -110,7 +113,7 @@ src/
     services/redis_task_manager.py # Redis 任务状态（Hash 字段级原子更新，兼容旧 string）
     utils/logger.py             # 结构化日志（json/text）+ request_id
     utils/file_handler.py       # 上传文件处理
-    utils/html_generator.py     # /html 静态分析报告生成
+    utils/html_generator.py     # 可视化报告生成（HTML/摘要/数据 JSON；产物写任务临时目录，由 moldinsight 上传 RustFS 报告键）
   celery_app.py                 # Celery app（Redis broker，task_acks_late）
   celery_tasks.py               # moldinsight 异步分析任务
 frontend/                       # Vue 3 独立工程：src/modules 按域组织（moldinsight/inventory/users/login/home）；src/types/api.ts 为 openapi 生成物，勿手改