用途：为 Juicebox AI 人才分析与招聘 API 集成搭建本地开发反馈循环，用模拟的候选人搜索与画像补全数据快速迭代，避免消耗真实 API 额度。可在 mock 模式（快速迭代）与 sandbox 模式（对接真实 API 验证）之间切换。
主要能力：提供本地 Express 开发服务器（默认端口 3004），mock 模式下挂载 /v1/search、/v1/profiles/:id、/v1/usage 等模拟路由，返回示例候选人画像、经历、教育与额度信息；非 mock 模式通过 http-proxy-middleware 代理到 JUICEBOX_BASE_URL 并注入 Bearer 令牌。
使用方式：复制 .env.example 为 .env 并设置 JUICEBOX_API_KEY、JUICEBOX_BASE_URL、MOCK_MODE；安装 express、axios、dotenv、tsx、typescript 及 vitest、supertest 等依赖。运行 npm run dev:mock 启动 mock 服务，npm run test 跑单元测试，MOCK_MODE=false npm run test:integration 对接真实 API。
适用场景：构建人才管道工具、验证搜索与画像补全逻辑、调试过滤与序列化问题。
限制与注意：开发时建议将搜索 limit 设为 5 以节省额度，切换前用 /v1/usage 查看消耗；搜索为自然语言查询；需检查 skills 数组中的 null 值。常见错误包括 401（密钥无效）、402（额度耗尽）、400（查询格式错误）、429（限流，需指数退避）、ECONNREFUSED :3004（服务未启动）。前置条件要求本地沙箱、密钥引用而非明文、允许列表、抑制夹具与清理命令；仅用合成数据，记录审批，仅记录聚合诊断，验证 contacts_exported=0，收集脱敏回执后删除暂存数据并撤销临时凭证。具体价格与平台细节暂未提供。