| name | hlzd-image-gen |
| description | B2B 工业品产品图生成 —— 文生图（T2I）/ 图生图（I2I）/ 白底抠图 / 阿里国际站主图 / 批量风格化。Agnes Image 2.1 Flash + rembg。输出 PNG + 历史 JSON。 |
| license | MIT |
| metadata | {"author":"HLZD (海联智达 / 海良数科)","version":"0.1.0","industry":"cross-border-b2b","category":"content-asset","triggered_by":["生图","文生图","图生图","T2I","I2I","产品图","白底图","白底主图","抠图","去背景","工业品配图","阿里国际站主图","机械配图","设备渲染","建材展示","风格迁移","批量生图","generate product image","remove background","product photo","industrial product image"]} |
hlzd-image-gen — B2B 工业品 AI 生图
解决 B2B 工业品（机械/设备/建材）的精准生图问题：白底合规 + 工程精度 + 平台规格。
Quick Commands
hlzd-image-gen "石油套管" "白底棚拍"
hlzd-image-gen "蝶阀 D71X" "45度视角，棚拍光"
hlzd-image-gen --i2i D:\ref.jpg "保持风格，换成水泥工地背景"
hlzd-image-gen --bg-remove D:\product.jpg --output D:\product_white.png
hlzd-image-gen --auto-b2b --chart-type funnel
hlzd-image-gen --auto-b2b --quantity 3
py scripts/orchestrator.py --entities entities.json --capability t2i
定位
| 对比项 | 通用生图工具（MJ/SD Web） | hlzd-image-gen |
|---|
| 适用品类 | 消费品/艺术创作/插画 | B2B 工业品（机械/设备/建材） |
| Prompt 风格 | 艺术化形容词 | 行业术语 + 工程精度（套管/阀门/HS 编码） |
| 一致性 | 每张图独立 | 多角度/多场景保持产品结构一致 |
| 输出尺寸 | 创意比例 | 平台规格（阿里 1:1、博客 16:9、A+ 1200×628） |
| 合规 | 宽松 | 白底图 + 无 LOGO + 无版权元素 |
| 生态 | 独立工具 | 与 HLZD-B2B工业品调研 + HLZD-D3可视化 全链路打通 |
核心原则：B2B 工业品图不是"好看"，是"准确 + 一致 + 合规"。
核心能力矩阵
| 能力 | 实现 | 适用场景 | 单图耗时 |
|---|
| T2I（文生图） | Agnes Image 2.1 Flash | 无参考图，从零生成 | 5-15s |
| I2I（图生图） | Agnes Image 2.1 Flash | 有参考图，风格迁移 | 8-20s |
| 抠图 | rembg（U²-Net/ISNet） | 商品图去背景 | 1-3s |
何时用哪种：
- 用户说"生成 XX 的图" → T2I
- 用户说"把这张图改成 XX" → I2I
- 用户说"抠图 / 白底图 / 去背景" → 抠图
数据源
| 数据源 | 用途 | 费用 |
|---|
| Agnes Image 2.1 Flash | T2I + I2I 云端生图 | 当前 $0/图（促销），标准 $0.003/图 |
| rembg | 本地抠图（U²-Net / ISNet） | 免费 |
| HLZD-B2B工业品调研 | 闭环输入（产品名/HS 编码/目标市场） | 免费 |
Agnes API 速查
POST https://apihub.agnes-ai.com/v1/images/generations
Authorization: Bearer ${AGNES_API_KEY}
Content-Type: application/json
# T2I 请求体
{
"model": "agnes-image-2.1-flash",
"prompt": "...",
"size": "1024x1024",
"extra_body": {"response_format": "url"}
}
# I2I 请求体（图生图）
{
"model": "agnes-image-2.1-flash",
"prompt": "...",
"size": "1024x1024",
"image": ["https://example.com/input.jpg"],
"extra_body": {"response_format": "url"}
}
工作流（主流程）
输入（自然语言或 entities.json）
↓
[1] NLU 解析（Claude 自身）→ 追问缺失字段
↓
[2] B2B 闭环检测（可选）
→ 扫描 HLZD-B2B工业品调研 目录
→ 按 mtime 取最新报告 → 解析 markdown 补全实体
↓
[3] 展示理解回执（Markdown 表格）
↓
[4] Prompt Builder
→ 加载 preset（按 product_category）
→ 拼装中英双语 prompt
↓
[5] 能力路由 + 提交
├─ T2I → agnes_client.generate_t2i()
├─ I2I → agnes_client.generate_i2i()
└─ 抠图 → image_enhancer.remove_bg()
↓
[6] 出图 + 历史保存
→ outputs/generated/YYYY-MM-DD/{product}_{seq}.png
→ outputs/history/YYYY-MM-DD.json
↓
[7] 展示结果 + 追问迭代
Step 2.5 专业访谈（强推荐）
何时触发：用户提到具体工业品（套管/阀门/轴承/钢结构等）且未指定专业规格时。
Claude 的执行步骤：
- 检测到产品名属于工业品类
- 主动调用
AskUserQuestion 工具问关键专业参数（3-5 个）
- 用户回答后存入
entities.expert_answers
- prompt_builder 自动引用这些参数
套管访谈模板（钢级 / 外径 / 扣型 / 端部 / 长度）
阀门访谈模板（类型 / 压力等级 / 连接方式 / 阀体材质 / 操作方式）
钢结构访谈模板（用途 / 主要构件 / 表面处理 / 防腐等级）
完整工业品规格速查表见 references/industrial-specs.md。
输出格式
D:\AI-P\skills\hlzd-image-gen\outputs\
├── generated\
│ └── YYYY-MM-DD\
│ └── {产品名}_{序号}.png
└── history\
└── YYYY-MM-DD.json
历史 JSON 字段
{
"date": "2026-07-06",
"entries": [{
"timestamp": "2026-07-06T14:23:15",
"capability": "t2i",
"product_name": "石油套管",
"product_category": "machinery",
"model": "agnes-image-2.1-flash",
"params": {"prompt": "...", "size": "1024x1024"},
"image_url": "https://storage.googleapis.com/agnes-aigc/xxx.png",
"local_path": "D:\\...\\石油套管_001.png",
"source_report": "D:\\...\\石油套管B2B市场调研报告.md",
"cost": 0.0
}
工业品 Preset 库
详见 presets/ 目录（6 个 YAML）。
| 文件 | 类别 | 覆盖产品 |
|---|
presets/industrial/machinery.yaml | 机械类 | 套管/阀门/轴承/工具 |
presets/industrial/equipment.yaml | 设备类 | 集装箱/工程机械/发电机 |
presets/industrial/materials.yaml | 建材类 | 钢结构/铝合金/塑料管 |
presets/common/angles.yaml | 通用视角 | front/45deg/overhead/cutaway/detail |
presets/common/lighting.yaml | 通用光照 | studio/natural/dramatic/softbox |
presets/common/styles.yaml | 通用风格 | photorealistic/catalog/technical/3d-render |
限制与边界
✅ 适合
- B2B 工业品主图、场景图、细节图
- 商品图抠图（白底图、透明 PNG）
- 参考图风格迁移（保持工业质感）
- 与 HLZD-B2B工业品调研 闭环配图
❌ 不适合
- 消费品/服装/美妆（风格不匹配）
- 真人照片（合规风险 + Agnes 模型效果差）
- 受版权保护品牌 LOGO（合规问题）
- 图片放大/超分辨率（v0.1 不支持）
⚠️ 硬限制
- 单次批量 ≤ 8 张
- 参考图必须可公网访问（I2I）或本地文件路径
- Agnes 单图超时 5 分钟自动重试 2 次
- rembg 仅支持 PNG/JPG/WebP
错误地图
| 异常 | 触发场景 | 处理 |
|---|
HTTP 401 | token 无效/过期 | 检查 .env 中 AGNES_API_KEY |
HTTP 429 | 限流 | 自动重试 2 次（指数退避） |
HTTP 400 | 参数错误 | 检查 prompt 敏感词 + size 合规 |
| 网络超时 | 30s 无响应 | 自动重试 2 次 |
| rembg 模型未找到 | 首次运行 | 联网自动下载 ~170MB U²-Net |
| B2B 报告未找到 | 智能检测失败 | 用户显式提供路径 |
| Windows python Exit 49 | Store 劫持 | 用 py launcher |
依赖与部署
py -m pip install -r requirements.txt
copy .env.example .env
mb skills install hlzd-image-gen 青囊
Windows 上 python 可能被劫持到 Windows Store，统一使用 py launcher。
验证清单
新版本发布前必跑：
自动串联
上游（被谁触发）
- HLZD-B2B工业品调研：报告生成后自动调用本 skill 出产品配图
- HLZD-email-group：邮件需要配图时调用本 skill
下游（触发谁）
- 生图后 → 可调 HLZD-D3可视化 嵌入 dashboard
- 生图后 → 可调 HLZD-办公文档 嵌入抬头报价单
- 生图后 → 可调 HLZD-视频生成 做图生视频
被动串联
已知限制（v0.1 接受）
- Agnes 仅一个模型（
agnes-image-2.1-flash），无降级链
- 不支持实时图片放大/超分辨率
- 不支持参考图批量混合（一次只能 1 张参考图）
后续路线（v0.2+）
| 版本 | 新增 |
|---|
| v0.2 | 接入通义万相 / Stable Diffusion 作为降级链 |
| v0.2 | 图片放大（Real-ESRGAN） |
| v0.3 | 视频首帧生成（与 HLZD-视频生成 深度协同） |
| v0.3 | 阿里国际站 API 直传（自动上架） |
| v0.4 | 多参考图风格混合 |
