用途：为 Juicebox AI 人才搜索 API 提供生产级 SDK 集成模式，用于检索职业档案并对候选人数据做增强。API 通过 JUICEBOX_API_KEY 鉴权，端点基址为 https://api.juicebox.work/v1，返回结构化档案对象，并以 LinkedIn URL 作为天然去重键。
主要能力：单例客户端集中处理 search 与 enrich 的限流与请求头，使用 Authorization: Bearer 与 Content-Type: application/json。search 发送 query 与 limit（默认 20），enrich 发送 linkedin_url。JuiceboxError 携带状态码；safeCall 包装调用，遇 429 等待 5 秒后重试，遇 401 抛出无效密钥错误，其余错误附带操作上下文。请求构建器支持 query、limit（上限 100）、location、title_filter、company_filter、years_experience 等字段。类型覆盖 Profile、SearchResponse（含 total、has_more、cursor）与 EnrichResult（含 education、experience）。测试工具提供 mockProfile 与 mockSearchResponse 合成夹具。
使用方式：从受控环境配置构造客户端，请求前拒绝未知工作区、来源或目标；在客户端边界集中做来源权威、抑制名单、模式、脱敏与幂等校验。多查询搜索可用 Set 对 linkedin_url 去重；结果超过 100 条时使用上一响应的 cursor 分页。输出客户端契约回执，包含 SDK 版本、环境、策略版本、夹具结果、错误分类、聚合计数、导出行数断言与回滚行为，且不包含联系人、增强数据与凭据。
适用场景：批量搜索流水线、人才数据增强与可审计的沙箱集成。限制：需自备密钥、类型化客户端边界、密钥管理器引用、沙箱工作区、批准的来源/目标允许列表与合成候选人夹具；不得把被拒绝或未验证的增强当作成功或导出回退；仅用合成夹具测试畸形数据、限流、拒绝与回滚。具体定价与平台支持暂未提供。