# 在客户月会前核查交付数据质量


> 本基线中，正式环境尚未开放 submission:read Key 路径。检查提交时使用独立的已登录会话；交付记录导出仍使用 Data Key。

> 执行前先查[操作开放范围与兼容性](/zh/api/compatibility)。

客户反馈记录有问题时，先整理反馈涉及的活动 ID、订阅范围、日期和记录 ID。有 Data 读取权限的 API Key 只能重读其获准订阅中**已交付**的记录；它看不到全部提交，也不能读取其他组织的数据。计算比例之前，先在报告中写清范围和统计时段。

逐个活动使用一把对目标订阅有 Data 读取权限的完整组织 API Key，取得方法见[为组织准备数据读取权限](/zh/api/api-data)。在 bash 或 zsh 中运行下面的命令，在不回显的提示处输入 Key；它只传给明确指定的命令。Key 和标识符应属于下面地址对应的生产环境。Key 保存在组织批准的密钥存储中，导出记录保存在私有目录。

```sh
export HB_ENVIRONMENT='production'
export HB_API_URL='https://api.humanbased.ai'
unset HB_API_KEY
printf 'Data Key: '
read -rs HB_API_KEY
printf '\nCampaign ID: '
read -r HB_CAMPAIGN_ID
printf 'Subscription ID: '
read -r HB_SUBSCRIPTION_ID
HB_AUDIT_DIR="$(mktemp -d)"
printf 'Export directory: %s\n' "$HB_AUDIT_DIR"
hbd --version
HB_API_KEY="$HB_API_KEY" hbd auth whoami --json
HB_API_KEY="$HB_API_KEY" hbd campaign subscription list "$HB_CAMPAIGN_ID" --json
HB_API_KEY="$HB_API_KEY" hbd campaign records pull "$HB_CAMPAIGN_ID" --subscription "$HB_SUBSCRIPTION_ID" \
  --limit 200 --all --json > "$HB_AUDIT_DIR/campaign-records.json"
printf 'Exit code: %s\n' "$?"
```

[导出全部交付记录](/zh/api/cli-export)说明了续读和文件保管方法。记录退出码；只有 `data.complete=true`，才能把文件视为该订阅当前可读范围的完整结果。每个相关活动和订阅都要分别读取，一份文件不代表整个组织。

如果这把 Key 还具有 `campaign:read` 权限，可以用同一个左闭右开的事件时间区间建立活动层面的基线：

```sh
HB_API_KEY="$HB_API_KEY" hbd campaign metrics "$HB_CAMPAIGN_ID" --from <start-iso> --to <end-iso> --json
HB_API_KEY="$HB_API_KEY" hbd campaign outcomes "$HB_CAMPAIGN_ID" --from <start-iso> --to <end-iso> --json
```

分别保留两条命令的分母与时间口径。这些数字描述活动事件；交付记录导出描述一项订阅当前可读的行。两者不是同一批记录，不能直接相除当作通过率。

按行制作核查表，保存 `campaign_id`、`subscription_id`、`submission_id`、所查日期或字段，以及证据引用。对照约定的交付字段和客户反馈的记录 ID，检查必填值、日期窗口、重复的交易标识或标准化地址、交易所与网络标签。先标为**待复核线索**：相同地址可能对应获准的不同工作，评分或成功拉取也不能证明客户已经入库，更不能证明钱包的现实归属。

有目标活动权限的人，可以用**已登录的 CLI 会话**查看原始提交和审核结果；组织 API Key 也可获授 `submission:read`，但只能读取所属组织及活动白名单内的活动：

```sh
hbd campaign submissions list <campaign-id> --page 1 --limit 100 --json
hbd campaign submissions inspect <campaign-id> <submission-id> --json
```

如果要使用已登录会话，运行前确认当前 shell 没有设置 `HB_API_KEY`；Key 则需带 `submission:read`。对受保护或封闭的活动，登录的人可在终端加 `--reveal` 查看隐藏的答案，Key 始终收到隐藏字段。按活动和贡献者抽查有线索、无线索的记录，再把交付 ID 与客户入库日志对账。记录审核人实际看过的证据、结论，以及尚待客户确定的口径，然后再给出质量结论。读取和写报告不会改变审核结果或奖励。生产环境尚未部署这项 Key 权限；开放前请使用登录会话。
