用途：这是 Foreman OS 插件的可选增强组件，通过 MCP 协议向客户端暴露三个图像生成工具，用于建筑渲染、施工文档配图与项目预览。插件本身不依赖它，缺失时以 SVG 渲染作为回退。
主要能力：generate_image_flux2 调用 Black Forest Labs 的 Flux 2 生成写实图像，可设 prompt、width、height、steps、guidance、seed、output_format，返回 base64 图像、seed、尺寸与模型名；generate_image_gemini 调用 Google Gemini 多模态能力，支持参考图与宽高比，适合概念图与图生图；generate_svg 为纯 Python 生成，无需外部 API，支持 floor_plan、site_plan、isometric、elevation、grid 等类型，返回 SVG 字符串。
使用方式：安装依赖 pip install -r references/requirements.txt，设置环境变量 export FLUX2_API_KEY="your-flux2-key" 与 export GEMINI_API_KEY="your-gemini-key"，运行 python references/server.py，再在 Claude 或 Foreman OS 的 MCP 设置中配置。密钥按需可选：只设一个则只注册对应工具，均不设时仅 SVG 可用。
限制：Flux 2 为异步轮询，单图超时 2 分钟，HTTP 超时 30 秒，含指数退避重试（最多 5 次）；Gemini 受内容安全过滤影响；SVG 需按 schema 提供 spatial_data，否则可能生成无效标记。性能上 Flux 2 约 5-15 秒、Gemini 约 3-8 秒、SVG 小于 100 毫秒。具体价格与配额资料未提供。