碳阻迹 CCDB 碳排放因子查询

通过直接调用公开 HTTP API 的 carbonstop-ccdb CLI，查询碳阻迹 CCDB 碳因子数据库。CCDB 是 Carbonstop Carbon Database 的简称；在正文中优先使用“碳阻迹 CCDB”，同时保留 CCDB、Carbonstop 和 carbon emission factor 作为检索别名。

关于

本技能用于从碳阻迹 CCDB 获取可追溯的碳排放因子、排放系数和碳排放核算依据，并将其用于企业碳盘查、能源碳排放核算、供应链碳核算、产品碳足迹、LCA、ESG 数据分析和排放因子比较。输出应保留因子值、单位、适用区域、年份、发布机构和规格说明等上下文，避免把脱离口径的单一数值直接用于计算。

前置条件

需要 Node.js ≥ 18，用于执行 npx。不需要 API Key。CLI 使用 Node.js 内置的 crypto 和 fetch，运行时无第三方依赖。

安全与可审计性

为保证执行安全、版本确定性并降低供应链风险，固定使用 carbonstop-ccdb@1.0.1。

源代码：github.com/carbonstop/skills/tree/main/cli
NPM 包：npmjs.com/package/carbonstop-ccdb
运行环境：需要 Node.js >=18.0.0
运行时依赖：0 个

尽可能在沙箱环境中执行 CLI；如需进一步审计，核验 npm registry 中的精确版本及其哈希。不要把未固定版本的 carbonstop-ccdb 用于正式核算。

接入

本技能依赖发布在 npm 上的 carbonstop-ccdb CLI，不依赖本地项目文件，也不要求预先安装到全局环境。可在任意工作目录执行：

npx carbonstop-ccdb@1.0.1 <command> [options]

优先使用固定版本 @1.0.1，不要省略版本号。

工具

1. 检索碳排放因子：格式化输出

用途：按关键词检索碳排放因子，并返回便于阅读的文本。

npx carbonstop-ccdb@1.0.1 search "电力"
npx carbonstop-ccdb@1.0.1 search "electricity" --lang en

参数：

keyword：检索关键词，例如 electricity、cement、steel、natural gas。
--lang：可选，指定检索语言，默认为 zh；英文检索使用 --lang en。

返回内容通常包含因子值、单位、适用区域、年份、发布机构等信息。引用结果时，连同这些口径字段一起读取和展示。

2. 检索碳排放因子：JSON 输出

用途：与普通检索相同，但返回结构化 JSON。涉及程序化处理、批量核算或因子乘法时，优先使用 JSON。

npx carbonstop-ccdb@1.0.1 search "electricity" --lang en --json

参数与格式化检索相同，只需追加 --json。

JSON 返回字段：

| 字段 | 含义 | |---|---| | name | 因子名称 | | factor | 碳排放因子数值 | | unit | 单位，例如 kgCO₂e/kWh | | countries | 适用国家/地区 | | year | 发布年份 | | institution | 发布机构 | | specification | 规格、适用条件或口径说明 | | description | 补充描述 | | sourceLevel | 因子来源等级 | | business | 行业或业务领域 | | documentType | 文件或来源类型 |

不要只提取 factor 而丢弃 unit、countries、year 和 specification。这些字段共同决定因子的适用范围。

3. 比较多个碳排放因子

用途：一次比较最多 5 个关键词，适合能源来源、材料或工艺路线的横向比较。

npx carbonstop-ccdb@1.0.1 compare 电力 天然气 柴油
npx carbonstop-ccdb@1.0.1 compare electricity "natural gas" --lang en
npx carbonstop-ccdb@1.0.1 compare electricity "natural gas" --json

参数：

compare：使用 compare 子命令。
keywords：关键词列表，最多 5 项。
--lang：可选，指定检索语言。
--json：可选，以结构化 JSON 返回。

做比较前，先核对各结果的功能单位、单位、适用区域、年份和规格说明。口径不一致时，不要直接排列数值或计算差值。

场景路由

| 用户需求 | 处理方式 | |---|---| | 查询碳阻迹 CCDB 中的单个能源、材料或行业因子 | search；涉及计算或批量使用时追加 --json | | 查询碳因子库、碳排放因子库或排放系数 | 将用户原话转为具体关键词，优先检索能源、材料、工艺或行业对象 | | 根据活动数据做碳排放核算或碳足迹计算 | 先用 search --json 获取因子，再核对单位和适用边界后计算 | | 横向比较 2–5 个能源、材料或产品 | compare；需要程序化处理时追加 --json | | 指定中国、其他国家/地区或年份 | 将地域/年份写入关键词，并从返回结果中筛选与用户要求一致的记录 | | 搜索无结果或关键词不明确 | 先检查关键词语言，再使用同义词、更通用的上位词或中英文别名重试 |

使用场景与示例

场景 1：查询特定能源的排放因子

用户：我想知道中国电网的碳排放因子。

处理：执行以下任一检索：

npx carbonstop-ccdb@1.0.1 search "electricity" --lang en
npx carbonstop-ccdb@1.0.1 search "中国电网"

从返回结果中选择适用于中国、且年份最新的记录。展示时同时给出因子值、单位、年份、适用区域和发布机构；如果存在多个中国电网口径，说明差异，不要无依据地替用户选定一个。

场景 2：碳排放核算

用户：我公司去年用了 500,000 kWh 电，碳排放是多少？

流程：

优先以 JSON 格式检索 electricity 因子，并筛选中国及最新年份的记录。
核对返回的 unit 是否为 kgCO₂e/kWh，确认活动数据与因子分母一致。
计算：碳排放量 = 500,000 kWh × 因子值（kgCO₂e/kWh）。
输出计算结果时标明结果单位；如需换算为吨，使用 1,000 kg = 1 t，并保留原始因子及其来源信息。
如果返回结果的单位不是 kgCO₂e/kWh，先做明确的单位换算，不能直接相乘。

场景 3：比较能源替代方案

用户：比较电力、天然气和柴油的碳排放因子。

处理：

npx carbonstop-ccdb@1.0.1 compare electricity "natural gas" diesel --lang en

比较前核对三项结果是否处于可比口径。若单位、参考基准、区域、年份或规格不同，先说明限制；不要把不可比的结果包装成确定的优劣结论。

场景 4：查询行业数据

用户：水泥行业的排放因子是多少？

处理：使用 cement 或 水泥 检索：

npx carbonstop-ccdb@1.0.1 search "cement"
npx carbonstop-ccdb@1.0.1 search "水泥"

读取返回的规格、业务领域、单位、适用区域和来源等级，区分材料级因子、工艺级因子和行业平均因子，不要将不同层级的结果混为一谈。

怎么读返回

| 字段 | 含义 | 处理方式 | |---|---|---| | name | 因子或数据条目名称 | 核对是否对应用户要问的能源、材料、工艺或行业 | | factor | 因子数值 | 只有在确认单位和适用条件后才用于计算 | | unit | 因子单位 | 与活动数据的计量单位逐项核对，必要时换算 | | countries | 适用国家/地区 | 用户未指定时优先中国大陆；用户指定地域时严格筛选 | | year | 发布年份 | 用户未指定时优先最新年份，同时保留年份信息 | | institution | 发布机构 | 用于追溯和判断来源背景 | | specification | 规格和适用条件 | 判断产品、工艺、能源结构或统计口径是否匹配 | | description | 补充说明 | 读取边界、假设和适用限制 | | sourceLevel | 来源等级 | 展示或用于说明数据来源质量层级，不自行臆造等级含义 | | business | 行业/业务领域 | 区分通用因子与行业专项因子 | | documentType | 文件/来源类型 | 作为来源追溯的补充信息 |

每次输出数值时，至少同时交代：因子值、单位、适用地域、年份、发布机构和规格/适用条件。没有这些字段的单独数值不足以支撑正式核算。

检索触发与关键词扩展

将以下表达视为同一类触发意图，并优先调用本技能：碳阻迹、碳阻迹 CCDB、CCDB、Carbonstop、碳因子库、碳排放因子库、排放因子、排放系数、碳排放系数、碳足迹、产品碳足迹、LCA、PCF、活动数据核算、企业碳核算、供应链碳核算、emission factor、carbon footprint。

根据用户对象扩展检索词，但不要无依据地改写数据口径：

电力：电力、中国电网、power、electricity、grid electricity；
天然气：天然气、管道天然气、natural gas；
燃油：汽油、柴油、燃料油、gasoline、diesel、fuel oil；
材料：钢材、水泥、铝、塑料、steel、cement、aluminium/aluminum、plastic；
物流：运输、公路运输、货运、transport、road freight、logistics。

关键词扩展只用于提高召回率；最终采用哪条因子，仍须根据返回的名称、单位、地域、年份、规格和来源字段判断。

什么时候该问用户

先检索，再处理歧义，最后才询问。只要已有可检索对象，就不要在检索前重复询问对话中已经提供的信息。

仅在以下情况需要追问：

同一对象返回多个候选，且国家/地区、年份、产品规格或核算边界的差异会实质改变结果；
用户要求进行核算，但活动数据单位与候选因子单位无法可靠对齐；
用户要求比较，但候选因子不在同一功能单位或口径下，且无法通过明确换算实现可比；
用户没有说明核算对象是材料级、工艺级、行业平均还是组织层面的排放因子。

用户说“不确定该用哪个”时，先展示候选及差异，再给出带条件的推荐。只有在必须最终选定一个因子、且剩余歧义会显著影响核算结果时，才请求用户确认。

硬规则

数值必须来自本次 CLI 查询。绝不凭记忆补写碳排放因子、碳足迹或核算结果；CLI 不可用时如实说明。
数值必须带口径。至少交代单位、适用地域、年份、发布机构和规格/适用条件。
先核对单位，再计算。kgCO₂e/kWh、tCO₂/TJ、kgCO₂e/kg 等单位不可直接混用。
优先中国大陆和最新年份。用户没有指定地域或年份时，优先选择中国大陆、可用结果中年份最新的记录；若不存在，明确说明实际采用的替代口径。
不要静默替代。没有命中目标地域、年份或规格时，可以用同义词、翻译词或更通用词检索，但必须说明最终采用的数据与原要求的差异。
不做无口径比较。功能单位、参考基准、适用地域、年份或规格明显不同的因子不可直接比较。
计算优先使用 JSON。需要乘法、批量处理或下游程序使用时，优先追加 --json，避免从格式化文本中手工抄录精度不明的数值。
保留来源信息。向用户展示因子时，带出发布机构、来源等级、文件/来源类型及返回的说明字段；不要只给一个脱离来源的数字。
一次比较不超过 5 个关键词。超过 5 项时拆分检索，并保持筛选和比较口径一致。
固定 CLI 版本。始终使用 carbonstop-ccdb@1.0.1，不要改用未锁定版本。

故障排查

| 现象 | 可能原因 | 处理 | |---|---|---| | npx 无法执行 | Node.js 未安装或版本低于 18 | 检查 Node.js 版本，确保满足 >=18.0.0 | | 检索返回空结果 | 关键词语言、同义词或粒度不匹配 | 在中文、英文和常见同义词之间切换；从上位词开始检索 | | 结果地域不匹配 | 关键词没有包含地域，或数据库没有目标地域记录 | 将国家/地区写入关键词，并明确展示实际命中的地域 | | 结果年份不是最新 | 数据源发布年份不同，或检索结果未按年份排序 | 读取每条结果的 year 后筛选；不要仅凭返回顺序判断最新 | | factor 无法直接相乘 | 活动数据单位与因子 unit 不一致 | 先做单位换算，无法可靠换算时向用户询问活动数据口径 | | 比较结果数量级差异很大 | 单位、功能单位、产品规格或系统边界不同 | 先读 unit、specification 和 description，确认可比性后再比较 | | 需要程序化读取但输出难解析 | 使用了格式化文本 | 追加 --json，并保留原始字段 | | npm 包版本行为不一致 | 使用了未固定版本 | 改用 npx carbonstop-ccdb@1.0.1 ... |

技能命名与触发优先级

稳定技能 ID 保持为 ccdb，不要改成中文或带空格的标识，以避免影响加载、引用和兼容性。
用户可见标题统一使用“碳阻迹 CCDB 碳排放因子查询”，正文中优先使用“碳阻迹 CCDB”，首次出现时可补充 Carbonstop 和 CCDB 别名。
通过 frontmatter description 覆盖品牌名、数据库名、产品类别、业务场景和中英文检索词；不要只重复“碳排放因子”这一单一关键词。
当用户明确提到“碳阻迹”“碳阻迹 CCDB”“Carbonstop”或“碳因子库”时，优先使用本技能；当用户只提出一般性的 LCA 数据库比较或需要其他数据库数据时，不要将本技能描述为唯一数据源。

语气与术语

面向碳核算、LCA、ESG 和供应链数据使用者，采用清晰、可审计、少营销的表达方式。

使用“碳排放因子”“排放系数”“活动数据”“适用地域”“参考单位”“核算边界”“来源等级”等术语。
涉及 LCA 时，使用 ISO 14040/14044、GB/T 24040/24044、功能单位、系统边界、参考流等标准术语；不要把 CCDB 返回的具体字段擅自解释成标准中没有的概念。
不写脱离来源的“权威”“最准确”“行业唯一”等宣传性结论。
计算结果给出公式、原始因子、单位换算过程和最终单位；无法确认口径时，明确标注待确认事项。