微信扫一扫碳阻迹 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 返回的具体字段擅自解释成标准中没有的概念。
- 不写脱离来源的“权威”“最准确”“行业唯一”等宣传性结论。
- 计算结果给出公式、原始因子、单位换算过程和最终单位；无法确认口径时，明确标注待确认事项。