> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt > Use this file to discover all available pages before exploring further. # 更新日志 > CloudX CLI 发布历史 ## \[0.36] - 2026-07-17 ### 展示级收入导出 CloudX CLI 0.36 新增异步的全天展示级收入导出，用于账户范围的数据分析与核对。 ### 新增 * **展示级 CSV 导出** — 新增 `cloudx report impressions export --date YYYY-MM-DD`，用于创建或复用 gzip 压缩的 CSV，每一行对应一条展示记录。支持导出过去 45 天内已经结束的 UTC 日期。[阅读文档 →](/zh/cli/reporting#cloudx-report-impressions-export) * **精细导出过滤** — 可按应用 ID 或包名、广告单元 ID、国家、设备 OS、竞价方、订单项以及生产/测试流量过滤。 * **异步下载工作流** — 使用 `--wait` 轮询任务状态，或使用 `--output <路径>` 等待任务完成并通过短期有效 URL 安全下载结果。 ```bash theme={null} cloudx report impressions export --date 2026-07-16 --output ./impressions-2026-07-16.csv.gz ``` ## \[0.35] - 2026-06-26 ### A/B 测试国家定向 CloudX CLI 0.35 支持直接在终端中的 A/B 测试配置编辑里为测试版本设置地域定向。 ### 新增 * **A/B 测试地域定向** — 为 `cloudx config edit create-ab-test` 和 `cloudx config edit update-ab-test` 新增 `--country`。该标志接受重复传入或逗号分隔的 ISO 3166-1 alpha-2 或 alpha-3 国家代码，CloudX 会以 alpha-3 代码保存测试版本定向。[阅读文档 →](/zh/cli/configuration#ab-测试) ```bash theme={null} cloudx config edit create-ab-test --ad-unit-id au_123 --name "US/GB test" --country US --country GB ``` ## \[0.34] - 2026-05-29 ### 扩展配置写入 CloudX CLI 0.34 将 `cloudx config edit` 从订单项扩展到应用、广告单元、广告单元组、列表、标签、测试设备、网络映射和 A/B 测试生命周期命令。 ### 新增 * **库存草稿编辑** — 为主要库存实体新增创建、更新、删除和 upsert 命令。除特别说明外，草稿编辑会自动验证，仍需使用 `cloudx config publish` 发布。[阅读文档 →](/zh/cli/configuration#cloudx-config-edit) * **A/B 测试写入** — 新增 A/B 测试创建、更新、开始、结束、提升和删除命令。生命周期变更会立即发布生成的配置。[阅读文档 →](/zh/cli/configuration#cloudx-config-edit) ## \[0.33] - 2026-05-21 ### 配置验证、订单项编辑与发布 CloudX CLI 0.33 现在支持直接在配置工作流中编辑订单项、发布已评审的草稿，并可验证本地 YAML 文件和远程配置。 要将现有的 Homebrew 安装升级到此版本： ```bash theme={null} brew upgrade cloudx ``` ### 新增 * **配置验证** — 新增 `cloudx config validate [file]`，可验证本地 YAML 文件，也可远程验证实时配置、已发布版本或按 ID 指定的草稿。使用 `--strict` 可在出现警告时失败。[阅读文档 →](/zh/cli/configuration#cloudx-config-validate) * **订单项写入** — 新增 `cloudx config edit create-line-item`、`cloudx config edit update-line-item` 和 `cloudx config edit delete-line-item`，用于在配置草稿中准备订单项改动。草稿编辑会运行验证，并且永远不会自动发布。[阅读文档 →](/zh/cli/configuration#cloudx-config-edit) * **配置发布** — 新增 `cloudx config publish --id `，用于将已验证的草稿发布为实时配置。[阅读文档 →](/zh/cli/configuration#cloudx-config-publish) * **CLI 升级提示** — 当 CloudX API 返回已有更新版本的 CLI 时，CLI 现在会在终端显示升级提示，并链接到更新说明。 ## \[0.32] - 2026-05-13 要将现有的 Homebrew 安装升级到此版本： ```bash theme={null} brew upgrade cloudx ``` ### 新增 * **API Key 认证** — 支持通过 `CLOUDX_API_KEY` 在 CI、定时任务、脚本以及其他非交互式工作流中认证 CLI。API Key 由管理员在 Settings > API Keys 中管理。[阅读文档 →](/zh/cli/authentication#api-key) * **CloudX 拆分报表** — `cloudx report breakdown --by --metrics ` 支持按请求、展示、收入、填充率、eCPM、点击和 CTR 查询 CloudX-only 聚合报表。 * **报表粒度与控制** — `cloudx report dashboard` 和 `cloudx report export` 支持 `--granularity daily|hourly`；拆分报表可通过 `--granularity hourly`、`--top`、`--bottom` 与 `--having` 使用小时分桶、排序和过滤。 * **可配置请求超时** — 全局 `cloudx --timeout ` 可设置 API 请求超时。默认仍为 `1m`，最大 `2m`。[阅读文档 →](/zh/cli#根标志) ## \[0.31] - 2026-05-07 ### 跨聚合平台报表来源 CloudX CLI 0.31 为已转发展示级收入数据的 publisher 增加报表来源过滤。现有报表命令默认仍然只统计 CloudX；在支持的命令中，可以使用 `--source` 显式纳入外部聚合平台 ILRD。 要将现有的 Homebrew 安装升级到此版本： ```bash theme={null} brew upgrade cloudx ``` ### 新增 * **报表来源过滤** — 为 `cloudx report dashboard`、`cloudx report apps` 与 `cloudx report ad-units` 增加 `--source`。使用 `--source all` 查看 CloudX 加所有可用外部聚合平台来源，使用 `--source applovin` 查看单一聚合平台，或使用 `--source cloudx,applovin` 进行并排对比。 * **按来源统计的报表指标** — 控制台、应用与广告单元报表现在可以纳入外部聚合平台 ILRD，用于收入、展示、eCPM 与收入占比。包含外部聚合平台时，填充率仍然只代表 CloudX，因为外部 ILRD 不包含 CloudX 请求数。 * **更清晰的来源语义** — `--source` 使用 ILRD 中的聚合平台/平台来源，例如 `applovin`，而不是 `ADMOB_BIDDING` 等下游需求方网络名称。[阅读文档 →](/zh/cli/reporting#来源值) ## \[0.30] - 2026-05-06 ### 竞价列表性能与超时处理 CloudX CLI 0.30 重点提升较重查询下的竞价检查可靠性，并让超时失败更容易理解。 要将现有的 Homebrew 安装升级到此版本： ```bash theme={null} brew upgrade cloudx ``` ### 改进 * **使用 ILRD 过滤时竞价列表更快** — 改进 `cloudx auction list` 在 ILRD 较多的查询中的性能，尤其是在按外部 ILRD 和聚合平台缩小结果范围时。 * **更长的默认请求超时时间** — 将 CLI 默认超时时间增加到 60 秒，让较重的请求有更多时间完成。 * **更清晰的超时错误** — 发生超时时，CLI 现在会显示更清晰的提示，而不是底层网络错误。 * **更好的超时可见性** — CloudX 支持团队现在可以更容易识别和诊断超时的 CLI 请求。 ## \[0.29] - 2026-05-05 ### 竞价与配置检查 CloudX CLI 0.29 将终端工作流从报表扩展到生产问题排查。现在无需切换到控制台，即可检查竞价、轮次、出价、ILRD 载荷、实时配置、草稿以及已发布配置历史。 要将现有的 Homebrew 安装升级到此版本： ```bash theme={null} brew upgrade cloudx ``` ### 新增 * **竞价检查** — 新增 `cloudx auction list`、`cloudx auction show`、`cloudx auction rounds` 和 `cloudx auction bids`，用于查看竞价记录、关联行、轮次聚合指标、出价与未出价行、底价来源、CloudX ILRD，以及已启用的外部聚合平台 ILRD。[阅读文档 →](/zh/cli/auction-inspection) * **配置检查** — 新增 `cloudx config show`，支持查看实时配置、已发布版本、草稿以及通过 ID 指定的配置行；默认输出 YAML，也可通过 JSON 输出用于自动化流程。[阅读文档 →](/zh/cli/configuration) * **配置历史** — 新增 `cloudx config history`，支持查看已发布配置历史、按创建者过滤、按最近变更过滤、包含草稿，以及查看发布时的差异摘要。 * **工作流示例** — 更新 CLI 示例与概览页面，覆盖竞价、配置、JSON 以及报表组合工作流。[查看示例 →](/zh/cli/examples) ## 2026-04-22 ### 在终端里使用 CloudX CLI 控制台报表 并非每个问题都需要打开浏览器。全新的 **CloudX CLI** 让您的日常数据只在一行命令之间——运行 `cloudx report dashboard` 即可在命令行中看到收入、填充率、eCPM 与趋势。按国家、平台、广告单元或测试流量过滤，方式与控制台完全一致。 需要将数据用于下游分析时，使用 `--json` 输出结构化 JSON，或使用 `cloudx report export` 导出 CSV，直接送入电子表格、Notebook 或其他工具。通过 `brew install cloudx` 安装，登录一次，您的报表工作流便能随您在任何工作环境中使用。[阅读文档 →](/zh/cli)