juicebox-debug-bundle

用途：面向 Juicebox API 的故障排查，将连接状态、数据集健康、分析配额与速率限制信息收集为单个诊断归档，便于定位上传失败、分析停滞、配额耗尽和认证异常。采集脚本为 Bash，先建带时间戳的目录并写入 summary.txt，记录 JUICEBOX_API_KEY 是否已设置，再请求 https://api.juicebox.ai/v1/health 获取 HTTP 状态，依次抓取 /v1/account/quota、/v1/datasets?limit=10、/v1/analyses?limit=5，并将速率限制响应头写入 rate-headers.txt，最后打包为 tar.gz。分析时解压后查看 summary.txt、quota.json、datasets.json、recent-analyses.json，可用 jq 过滤字段。常见问题：401 需在 Juicebox 设置中重新生成 API Key；上传卡住检查文件格式（CSV/JSON）并降低到 100MB 以下；配额为 0 需升级或等待月度重置；分析失败核对列与数据类型；429 依据 Retry-After 实现指数退避。另有 TypeScript 健康检查函数，读取 JUICEBOX_API_KEY 并请求 health 与 quota 输出状态。限制：资料要求仅在沙箱夹具中收集，拒绝真实凭据、联系人级载荷及未批准来源；需脱敏、日志遮蔽并验证 contacts_exported=0；出现敏感材料须停止、删除并轮换访问；须经批准范围、保留窗口与清理路径，仅保留脱敏归档并删除中间产物。输出为调试回执，含环境、夹具类型、聚合健康/错误/配额信号、抑制与脱敏检查、事件负责人、保留与删除证明、回滚引用，不含请求载荷、身份、联系人与密钥。