仅限受邀供应商

把离线演练带入真实验证

Dummy 只用于通过 ikun 实际演练 KUN 的完整批次生命周期。认证、会话和配额用于防滥用并控制测试顺序，不是产品能力或验收目标。下方服务地址直接作为 ikun 命令的第一个参数使用，不要自行拼接。

01 · 准备

下载 ikun 并生成测试数据

在 Guide 所述的 Linux x86_64 主机上下载当前归档和校验和，解压后同时验证归档与二进制：

curl -fLO 'https://ikun.bigdick.live/ikun-linux-x86_64.tar.xz'
curl -fLO 'https://ikun.bigdick.live/SHA256SUMS'
tar -xJf ikun-linux-x86_64.tar.xz
sha256sum --check SHA256SUMS

./ikun fabricate --directory './kun-dummy-curves' --n-battery 3

命令会生成 formation_0.csv 至 formation_2.csv，以及 grading_0.csv 至 grading_2.csv。这些文件只是假数据（mock data），用于演练下方生命周期，测试结束后可以丢弃。

Dummy 仅用于测试。所有上传数据都必须是脱敏、可丢弃的测试数据；条码、曲线、特征和 batch 名都必须使用假数据（mock data）。KUN 不会有意收集用户隐私数据，但不对上传数据提供安全保证。

邀请方提供只显示一次的 token。运行命令前，供应商必须按照所在组织现有的秘密管理流程将它设为 KUN_BEARER_TOKEN；不要把原始值写入命令历史、文档或工单。

每个供应商同一时间只能使用一个会话。新签发的会话可使用 24 小时。续期时，从续期时刻起最多再获得 24 小时，但任何会话都不会在首次签发七天后继续有效。续期需要明确操作，不会自动发生。

02 · 配额

实际调用会消耗获配额度

邀请中分配的配额具有最终效力，每一次真实调用都会消耗额度。随着集成进展，KUN 可能提高配额。遇到错误码 429 后必须停止重试并与维护人员沟通下一步。Dummy 不是负载测试服务。

03 · 生命周期

用五次调用完成 Store → Predict → Remove

以下命令把前两只样本一次 Store 到 mock-trial，随后用第三只样本验证门槛、补齐第三只样本、再次 Predict，最后 Remove 整个 batch：

./ikun store 'https://kun-dummy.bigdick.live/api' 'mock-trial' --mode none \
  --battery '{"barcode":"MOCK-CELL-001","formation_path":"./kun-dummy-curves/formation_0.csv","grading_path":"./kun-dummy-curves/grading_0.csv"}' \
  --battery '{"barcode":"MOCK-CELL-002","formation_path":"./kun-dummy-curves/formation_1.csv","grading_path":"./kun-dummy-curves/grading_1.csv"}'

# 两只正常样本不足门槛，本次结果为 Unpredictable
./ikun predict 'https://kun-dummy.bigdick.live/api' 'mock-trial' '25.5' --mode none \
  --battery '{"barcode":"MOCK-CELL-003","formation_path":"./kun-dummy-curves/formation_2.csv"}'

./ikun store 'https://kun-dummy.bigdick.live/api' 'mock-trial' --mode none \
  --battery '{"barcode":"MOCK-CELL-003","formation_path":"./kun-dummy-curves/formation_2.csv","grading_path":"./kun-dummy-curves/grading_2.csv"}'

# 三只正常样本已经登记，本次返回预测结果
./ikun predict 'https://kun-dummy.bigdick.live/api' 'mock-trial' '25.5' --mode none \
  --battery '{"barcode":"MOCK-CELL-003","formation_path":"./kun-dummy-curves/formation_2.csv"}'

./ikun remove 'https://kun-dummy.bigdick.live/api' 'mock-trial'

当前 batch 累计少于三只正常测试样本时，Predict 返回 Unpredictable；登记第三只后，同一份假数据（mock data）会进入正常预测路径。整段正常流程消耗五次请求。凭据有效期间，凭据持有者可以执行公开 Remove。

需要交互式生成和复制命令时，可以使用 Playground；Dummy 本页保留为静态操作说明。

04 · 保留场景

演练确定性结果

以下四个内置保留 batch 名是确定性快捷方式，用于快速、重复地演练常见结果。每个名称都会稳定得到表中对应结果，便于双方复核同一处理路径。

保留 batch	CLI 可见结果	应做什么
`__kun_dummy__bad_request`	400	纠正输入
`__kun_dummy__conflict`	409	与 KUN 沟通后再继续生命周期动作
`__kun_dummy__failure`	500	记录上下文并跟进
`__kun_dummy__unpredictable`	Unpredictable	进入约定兜底流程

05 · 验收

交付前逐项确认

只用 ikun 和脱敏、可丢弃的测试数据以及假数据（mock data）命名。
用三对 fabricate 曲线完成正常 Store → Predict → Remove 生命周期。
验证低于三只样本门槛的 Unpredictable 与达到门槛后的结果。
逐一处理四个确定性保留场景。