产品碳足迹(PCF)核算取数

产品碳足迹的工作量不在加法,在逐行匹配:BOM 上写的是「钻头」「废外壳(钢壳,软包)」「框架蒸压加气混凝土砌块外墙 200厚」,清单数据库里只有工艺过程。这一步匹配错了,后面的合计再精确也没有意义。

本技能负责把 BOM 行接到真实数据集上,并保证每一项都可追溯。

关于

本技能接入 HiQ Cortex —— 海科数据的 LCA 数据智能服务。海科数据是国内 LCA 基础数据与碳足迹服务提供商,自建中国本土生命周期清单数据库,并聚合 18 个国际主流数据源与 24000+ 已发布 EPD,口径遵循 ISO 14040/14044、ISO 14067 与 GB/T 24040/24044。

BOM 行到数据集的匹配由服务端完成。 把 BOM 上的原始描述原样交给检索接口 —— 工厂俗称到标准名的翻译、制成品到材质的还原、括号里补充说明的拆解、物料类别到工艺方向(生产 / 处理)的映射,都在服务端执行。返回的候选已排序并带 fit 匹配质量与 summary 说明。

不要在本地先把 BOM 名称「翻译」一遍再去搜 —— 那会丢掉原始信息,反而降低命中率。原话交给它。

数据权限

一份 BOM 里通常几种情况混着:部分物料免费库就能覆盖,部分要商业库。受限项如实标注,不要用免费库的值悄悄顶上去 —— 一份混了口径又没标注的 BOM 核算表,后面没人能复核。

硬规则

1. 每个数值都来自本次会话的工具调用。 一行都不能凭记忆填。
2. 每一行都要交代基准:数据库 + 版本 + 系统模型 + 地域 + 参考流。BOM 核算表要能逐行追溯。
3. 合计前先确认口径一致。 系统模型不同的数据不能相加;功能单位不一致要先换算,换算依据要写出来。
4. 单位要对齐。 数据集的参考单位(kg / m³ / kWh / tkm)与 BOM 的用量单位不一致时,先做单位换算并说明换算系数来源。密度、堆积密度这类换算参数如果是假设值,必须标注为假设。
5. 代理数据单独标注,不要混进直取行。
6. 受限不是错误,给 purchase_url,不静默替代。

另外两条通用的:

• 给了数值就给链接。 返回里带 link 的,每条结果都一并给出,别等用户追问。
• 不要把 dataset_key / dataset_uuid 贴给用户看。 那是给工具用的不透明句柄,
  对人没有意义 —— 展示的是名称、参考流、地域、库+版本+系统模型、数值、链接。
  另注:dataset_uuid 不是 hiq-editor 里的「背景数据唯一 ID」,别拿去填 background。

接入

没有凭据时,第一句话就给扫码登录 —— 不要让用户去控制台建 API key。

扫码是「跑一条命令 + 浏览器点一下」,无需注册;建 API key 要登录控制台、找入口、
复制粘贴、设环境变量,门槛高出一个量级。把后者摆在第一步会直接劝退用户。

# 没装过 hiq-cortex 就先装 —— 单文件程序,不依赖 node / python
curl -fsSL https://download.hiq.earth/cli/hiq-cortex/install.sh | sh

hiq-cortex login    # ← 缺凭据时默认走这条

Windows 的安装命令是 PowerShell 的 irm https://download.hiq.earth/cli/hiq-cortex/install.ps1 | iex。
宿主已经有 Node 时,npx @hiq-ai/hiq-cortex-cli <命令> 与 hiq-cortex <命令> 完全等价,省掉下载。

命令会打印一个授权链接。把链接原样给用户,让他点「授权访问」,然后继续原来的任务 ——
凭据落在 ~/.config/hiq-cortex/credentials.json(权限 600),之后所有命令直接可用,可见数据范围与
该账号一致(包含他已开通的商业数据库)。

只在这三种情况下才提 API key:用户自己说要用 key、运行在 CI / 服务端无浏览器环境、
或扫码登录失败。

export HIQ_API_KEY=sk_xxx            # 服务端 / CI 用;同时存在时优先于扫码凭据

宿主支持 MCP 时优先用 MCP —— 若当前会话已有 lookup_datasets、aggregate_datasets 等工具就直接用;没有则把 https://x.hiqlcd.com/api/cortex/mcp 配进宿主的 MCP 配置(header 用 X-API-Key,或用扫码登录凭据的 Authorization: Bearer),配置方式见 README。

凭据只从环境变量、宿主配置或 login 落盘的那份读取 —— 绝不硬编码进为用户生成的文件,也不在输出里回显。

工具

批量 lookup:BOM 有几十行时,一次调用传入全部 key,不要逐行调。

检索是 REST 接口(POST https://x.hiqlcd.com/api/cortex/search,SSE 返回,解析 WorkflowCompleted 事件的 content),每次 20–40 秒。BOM 行数多时这是主要耗时 —— 提前告诉用户,不要并发轰接口。

怎么读返回

输出形态

产品碳足迹的输出是一张可复核的表,不是一个数:

• 逐行:物料名 → 匹配到的数据集(名称 + 参考流 + 地域)→ 单位用量 → 因子 → 小计 → 数据来源(库 + 版本 + 系统模型)
• 分组小计:原材料 / 能源 / 运输 / 废弃物,便于看结构
• 单列出来:fit: low 的行、代理数据行、受限未取到值的行
• 合计:并说明边界(cradle-to-gate 还是 cradle-to-grave)、口径、以及哪些项未纳入

用户只要一个数时也要给基准和边界 —— 一个没有边界说明的产品碳足迹数字不能用。

什么时候该问用户

先查、再对比、最后才问。 BOM 拿到手先跑检索,在同一轮里给出匹配结果和明确的疑问项,不要逐行追问。

必须问的通常只有三类:产地(影响电网与工艺)、材质歧义(BOM 写「塑料件」但没说是 PP 还是 ABS)、边界(算到出厂还是算到报废)。这三类可以一次性问齐,不要挤牙膏。

语气与术语

面向 LCA 从业者写,用 ISO 14040/14044、ISO 14067、GB/T 24040 的标准术语。功能单位 · 参考流 · 系统边界 · 单元过程 · 分配 allocation · 截止规则 cut-off criteria。

不写客套话,不堆形容词,不做总结式收尾,不自造中文术语。

故障排查