选矿流程设计-万维易源

概述

选矿流程设计

任务目标

• 从选矿实验报告全文中自动提取工艺拓扑结构（作业节点 + 物料流向连线）
• 对料流数据进行校正与平衡计算，输出各料流的产率、品位、回收率
• 深度融合结构信息与数据信息，生成极度详细的数质量流程图文生图提示词
• 调用生图模型生成简体中文标注的专业工程制图（数质量流程图，3:4 竖版）
• 触发场景：选矿工艺设计、选矿试验报告可视化、数质量流程图绘制、选矿厂工程图纸生成

能力组成

能力流程描述

本技能以「选矿实验报告全文（report_text，必填）+ 化验数据（assay_data，选填）」为输入，经过 6 个阶段生成最终工程制图：

1. 合规校验优化：对输入报告进行合规性校验与内容优化，保障输入数据可靠、格式规范。
2. 选矿工艺拓扑结构提取（与阶段3并行执行）：解析报告中的选矿流程，提取破碎、磨矿、粗选、精选、扫选、分离等作业节点及物料流向连线，产出 topology_nodes、topology_edges。
3. 选矿料流数据校正与平衡计算（与阶段2并行执行）：基于报告中各作业点的原始产率、品位等测量数据，可结合选填的化验数据进行校正与平衡计算（最小二乘法等算法），产出 balanced_streams。
4. 数质量流程图生图提示词生成（依赖阶段2、3）：以结构融合策略将拓扑结构（作业节点与流向）与校正后的料流数据（数值标注）深度融合，生成极度详细的文生图提示词 generated_prompt。
5. 数质量流程图图片生成（依赖阶段4）：以 3:4 宽高比调用生图模型，生成简体中文标注的专业工程制图。
6. 轮询图片生成状态（依赖阶段5）：每 6 秒查询一次生成状态，最长等待 1500 秒，直至任务 SUCCEEDED，产出 flowchart_image_url。

数据流转方式：报告文本 → 并行执行（拓扑提取 ‖ 数据平衡计算）→ 结构与数据融合生成提示词 → 文生图 → 轮询 → 输出五项结构化结果。人机协作节点：用户负责提供报告全文与（可选的）化验数据；任务提交后由系统异步执行，用户通过轮询逐步获取进度与最终结果。

技能能力组成流程图

官方能力流程图：

Mermaid 流程图：

flowchart TD
    IN["用户输入<br/>report_text 选矿实验报告（必填）<br/>assay_data 化验数据（选填，JSON字符串）"] --> S0["Step1 合规校验优化"]
    S0 --> S1["Step2 选矿工艺拓扑结构提取"]
    S0 --> S2["Step3 选矿料流数据校正与平衡计算<br/>（与Step2并行）"]
    S1 -->|"topology_nodes / topology_edges"| S3["Step4 数质量流程图生图提示词生成<br/>（结构 + 数据深度融合）"]
    S2 -->|"balanced_streams"| S3
    S3 -->|"generated_prompt"| S4["Step5 生成数质量流程图图片<br/>（宽高比 3:4）"]
    S4 --> S5["Step6 轮询图片生成状态<br/>间隔6秒，超时1500秒"]
    S5 -->|"状态为 SUCCEEDED"| OUT["最终输出<br/>flowchart_image_url 数质量流程图图片<br/>generated_prompt 生图提示词<br/>topology_nodes 工艺拓扑节点<br/>topology_edges 工艺拓扑连线<br/>balanced_streams 校正后料流数据"]

前置准备

• 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
• 计费参考：按次计费（约 0.28 元/次，含模型推理价格），实际以平台结算为准
• 鉴权配置：

本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。

如何获取 AppKey

如果你还没有 AppKey，请按以下步骤通过手机验证获取：

1. 请用户提供手机号（中国大陆手机号）
2. 调用发送验证码接口：

“` POST https://www.showapi.com/auth/agent_sendCode Content-Type: application/x-www-form-urlencoded

phone={手机号} “ 成功响应：{"flag":true,"remark":"发送成功"}`

1. 请用户查看手机收到的6位验证码并告诉你
2. 调用验证接口获取 AppKey：

“` POST https://www.showapi.com/auth/agent_verify Content-Type: application/x-www-form-urlencoded

phone={手机号}&code={验证码} “ 成功响应：{"flag":true,"app_key":"你的AppKey"}`

1. 将获取到的 app_key 保存，后续所有 API 调用 URL 中携带 appKey={app_key} 参数

注意事项

• 验证码5分钟有效，每分钟只能发送1次
• 如果手机号已注册过易源数据平台账户，会直接返回该账户的 AppKey，不会重复注册
• AppKey 获取后请妥善保存，避免重复验证
• 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
• 依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

1. 自动触发模拟调用

系统检测到未配置 appKey 时，自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求（body: {"flow_id":"6a66fb053c51f2e6590227df"}），直接获取完整模拟生成结果。此过程为一次性返回，不执行 execute_task.py 和 query_task.py。

1. 可视化预览

将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现数质量流程图图片内容。

1. 引导真实调用

提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请通过手机验证获取 AppKey（步骤见「前置准备-鉴权配置」），并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。

标准流程（有 appKey，强制异步执行）

1. 收集用户需求

请用户提供选矿实验报告全文（report_text，必填，需包含各作业点的原始产率、品位等测量数据）；如有选矿厂化验数据（assay_data，选填，JSON字符串格式）一并提供，可提升校正精度。

1. 异步提交生成任务

调用脚本异步执行拓扑提取、平衡计算与数质量流程图生成任务（脚本强制异步模式，无需额外参数），仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --report-text "选矿实验报告全文……"
   # 报告较长时建议从文件读取：
   python scripts/execute_task.py --report-file ./选矿试验报告.md
   # 如有化验数据可一并提交：
   python scripts/execute_task.py --report-file ./选矿试验报告.md --assay-data '{"原矿":{"Cu":"0.68%","Mo":"0.043%"}}'

1. 轮询查询任务结果（必选）

使用 task_id 循环查询任务状态（建议间隔 10~15 秒），每一轮轮询后，即时将当前返回的核心资料同步反馈给用户，直至获取完整结果。调用示例：

   python scripts/query_task.py --task-id "返回的task_id值"

1. 等待结果完成

必须轮询直到完成。图片生成环节内部含轮询（间隔6秒、最长1500秒），整体任务耗时可能达数分钟，请耐心持续轮询。

1. 结果解析与落地应用

提取数质量流程图图片URL，结合拓扑节点/连线核对工艺流程，利用校正后的料流数据（产率、品位、回收率）核对关键指标，必要时使用生图提示词二次生成或微调制图。

1. 生成html页面

生成一个简单的html页面来融合返回的主要信息，特别是数质量流程图图片，并附上拓扑结构与料流数据表格。

使用示例

示例1：铜钼金伴生矿试验报告出图

• 输入：某低品位铜钼金伴生矿选矿试验报告全文（含破碎磨矿、浮选粗选/精选/扫选各作业点产率与品位数据）
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：数质量流程图图片 + 工艺拓扑节点/连线 + 校正后料流数据 + 生图提示词
• 配置要点：报告需包含各作业点的原始产率、品位等测量数据，数据越完整结果越准确

示例2：补充化验数据精修流程图

• 输入：试验报告全文 + 选矿厂化验数据（assay_data，JSON字符串）
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：校正精度更高的料流平衡数据与对应数质量流程图
• 配置要点：assay_data 按JSON字符串格式提供精确品位，如 {"原矿":{"Cu":"0.68%"}}

示例3：多方案流程图批量对比

• 输入：不同浮选流程方案的试验报告（如混合浮选—铜钼分离 与 优先浮选）
• 流程：分别异步提交多个任务并行执行 → 按 task_id 逐个轮询直至完成
• 产出：多张数质量流程图及配套数据，便于工艺方案对比
• 配置要点：多个任务并行提交时注意按 task_id 分别轮询并分别反馈

生成效果示例

描述

技能运行完成后输出 5 项内容：

1. flowchart_image_url（数质量流程图）：简体中文标注的专业工程制图（3:4 竖版），图中以标准工程符号呈现各选矿作业节点，带箭头连线表示物料流向，并逐条标注料流名称、产率、品位、回收率。
2. topology_nodes（工艺拓扑节点）：作业节点数组，每项含 node_id（节点ID）、node_name（节点名称）、node_type（节点类型）。
3. topology_edges（工艺拓扑连线）：物料流向连线数组，每项含 edge_id（连线ID）、from_node（起点节点）、to_node（终点节点）、stream_type（料流类型）。
4. balanced_streams（校正后料流数据）：经校正与平衡计算的料流数组，每项含 stream_id（料流ID）、stream_name（料流名称）、yield（产率）、grade（品位）、recovery（回收率）。
5. generated_prompt（生图提示词）：融合结构与数据后生成的极度详细的文生图提示词，可用于复现或微调制图。

输出案例

说明：若输出结果包含图片，优先插入对应图片资源，之后再输出 JSON / Markdown 格式的文本内容。

生成的选矿数质量流程图（专业工程制图，简体中文标注）：

接口返回 JSON（以下为基于铜钼金伴生矿示例报告的典型输出，实际数值随输入报告变化）：

{
  "showapi_res_body": {
    "flowchart_image_url": "https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a66fb053c51f2e6590227df/snapshot/caseImgs/ee601954c9.png?t=1785134713",
    "generated_prompt": "专业选矿数质量流程图工程制图，竖版3:4，白色背景……（节选）作业节点包括：原矿、颚式破碎机（粗碎）、圆锥破碎机（中细碎）、球磨机（磨矿）、混合浮选粗选、再磨、抑铜浮钼铜钼分离、扫选；带箭头实线连接并标注料流：原矿100.00%（Cu 0.68%，Mo 0.043%，Au 0.27g/t）→ 粗碎产品 → ……；铜精矿产率3.06%、Cu品位21.45%、回收率91.01%……全部使用简体中文标注，工程制图规范，字迹清晰、布局自上而下、无元素重叠",
    "topology_nodes": [
      {"node_id": "N01", "node_name": "原矿", "node_type": "source"},
      {"node_id": "N02", "node_name": "颚式破碎机（粗碎）", "node_type": "crushing"},
      {"node_id": "N03", "node_name": "圆锥破碎机（中细碎）", "node_type": "crushing"},
      {"node_id": "N04", "node_name": "球磨机（磨矿）", "node_type": "grinding"},
      {"node_id": "N05", "node_name": "混合浮选粗选", "node_type": "flotation"},
      {"node_id": "N06", "node_name": "再磨", "node_type": "grinding"},
      {"node_id": "N07", "node_name": "铜钼分离（抑铜浮钼）", "node_type": "separation"},
      {"node_id": "N08", "node_name": "扫选", "node_type": "flotation"}
    ],
    "topology_edges": [
      {"edge_id": "E01", "from_node": "N01", "to_node": "N02", "stream_type": "原矿"},
      {"edge_id": "E02", "from_node": "N02", "to_node": "N03", "stream_type": "粗碎产品"},
      {"edge_id": "E03", "from_node": "N03", "to_node": "N04", "stream_type": "碎矿产品"},
      {"edge_id": "E04", "from_node": "N04", "to_node": "N05", "stream_type": "磨矿产品"},
      {"edge_id": "E05", "from_node": "N05", "to_node": "N06", "stream_type": "混合粗精矿"},
      {"edge_id": "E06", "from_node": "N06", "to_node": "N07", "stream_type": "再磨产品"},
      {"edge_id": "E07", "from_node": "N05", "to_node": "N08", "stream_type": "粗选尾矿"}
    ],
    "balanced_streams": [
      {"stream_id": "S01", "stream_name": "原矿", "yield": "100.00%", "grade": "Cu 0.68%；Mo 0.043%；Au 0.27g/t", "recovery": "—"},
      {"stream_id": "S02", "stream_name": "铜精矿", "yield": "3.06%", "grade": "Cu 21.45%", "recovery": "Cu 91.01%"},
      {"stream_id": "S03", "stream_name": "钼精矿", "yield": "0.09%", "grade": "Mo 46.54%", "recovery": "Mo 93.97%"},
      {"stream_id": "S04", "stream_name": "金回收", "yield": "—", "grade": "Au 5.10g/t", "recovery": "Au 50.45%"},
      {"stream_id": "S05", "stream_name": "最终尾矿", "yield": "96.85%", "grade": "Cu 0.08%；Mo 0.01%", "recovery": "—"}
    ]
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

资源索引

• [scripts/execute_task.py](scripts/execute_task.py)：异步提交选矿数质量流程图生成任务（真实调用时使用）
• [scripts/query_task.py](scripts/query_task.py)：轮询查询异步任务结果（真实调用时使用）

响应数据结构

1. 异步任务提交响应

{
  "showapi_res_body": {
    "task_id": "唯一任务ID",
    "status": "pending",
    "msg": "任务已提交，正在异步处理中"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

2. 任务查询响应（单轮轮询返回数据，需实时同步给用户）

任务处理中时，showapi_res_body 可能仅包含状态进度信息；任务完成后返回以下五项完整结果：

{
  "showapi_res_body": {
    "flowchart_image_url": "生成的选矿数质量流程图图片访问地址",
    "generated_prompt": "融合结构与数据后生成的极度详细的文生图提示词",
    "topology_nodes": [
      {"node_id": "节点ID", "node_name": "节点名称", "node_type": "节点类型"}
    ],
    "topology_edges": [
      {"edge_id": "连线ID", "from_node": "起点节点ID", "to_node": "终点节点ID", "stream_type": "料流类型"}
    ],
    "balanced_streams": [
      {"stream_id": "料流ID", "stream_name": "料流名称", "yield": "产率", "grade": "品位", "recovery": "回收率"}
    ]
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

1. report_text 为必填项，需包含各作业点的原始产率、品位等测量数据；报告越完整，拓扑提取与平衡计算越准确。
2. assay_data 为选填项，必须为合法 JSON 字符串；提供后可提升料流数据校正精度。
3. 所有任务强制异步执行，不支持同步模式。
4. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户；图片生成环节内部含轮询（间隔6秒、最长1500秒），整体耗时可能达数分钟，必须轮询直到完成。
5. 平衡计算结果（产率/品位/回收率）基于输入数据校正得出；若原始数据矛盾较大，请核对报告数值或补充化验数据后重新生成。
6. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。