ccdblisted

# CCDB 排放因子查询与匹配 Carbonstop 碳阻迹 · 产品碳足迹 / LCA。用于需要实际因子数据的查询与匹配；仅解释通用概念且不需要查数据时，无需调用 CCDB。不执行建模写入，不替代完整核算或合规审核。 ## CLI 检查与安装 通过 `ccdb-cli` 完成查询。宿主需要本地命令执行能力、网络访问和有效 CCDB 授权；安装 Skill 不会自动安装 CLI 或登录。 先执行 `ccdb-cli --version` 检查是否已安装，可用时复用，不重复安装或登录。命令不存在且用户同意安装时执行： ```sh npm install -g ccdb-cli@latest ccdb-cli --version ``` npm 版需要 Node.js 22+；不使用 Node.js 时，从 [官方最新 Release](https://github.com/carbonstop/ccdb-cli/releases/latest) 获取对应系统/架构的独立二进制并核对校验文件。安装、更新及镜像排错见 [CLI 说明](https://github.com/carbonstop/ccdb-cli)，不自行构建源码。 无安装权限、命令执行能力或可用后端时，说明缺失条件并停止查询，不擅自更换接入方式或伪造查询结果。 ## 环境与认证 默认环境为 production；只有用户明确使用测试环境时，使用 `--profile test` 或 `CCDB_PROFILE=test`。标准环境使用 CLI 预设；显式环境变量仍可覆盖地址和客户端 ID，见 [CLI 配置](https://github.com/carbonstop/ccdb-cli/blob/main/docs/CONFIGURATION.md)。不要因连接失败自动切换环境或重写配置。 - 默认推荐 device OAuth。缺少有效凭证且用户同意登录后，执行 `ccdb-cli auth login`；由用户在浏览器打开显示的授权 URL 并同意授权。无浏览器终端加 `--no-browser`，由用户在另一设备打开链接。PKCE 可用 `--method pkce` 显式选择。查询命令不会自动启动登录。 - 登录和查询必须使用相同的环境、系统用户及凭证配置。不要把自己的登录状态视为宿主执行环境的登录状态。 - API Key 是用户主动选择的备选。通过宿主的安全配置向 CLI 注入 `CCDB_API_KEY`，或使用 `ccdb-cli auth login --method api-key` 的不回显输入/受控 stdin。 - 显式环境 Key 优先于保存的 OAuth 凭证；OAuth 失败不自动切换 Key，Key 失败也不切换 OAuth。恢复 OAuth 需用户从实际执行环境移除 Key 配置并登录。不要求在聊天或命令参数中提供密钥，不打印凭证文件。 状态和诊断：`ccdb-cli auth status --json` 检查本地凭证，`ccdb-cli doctor --json` 检查发现端点，都不证明业务权限。按需执行，不为安装验收额外查询；用户需要数据时再通过小范围实际请求验证业务权限。 ## 查询与匹配 先确定材料/活动、产品或企业核算口径、单位、地区、适用年度、技术路线及边界。仅在缺失信息会影响选择时询问，不默认中国或最新年份。 ```sh ccdb-cli factor search "电力" --limit 5 --j