首次使用 Cargo 时如何在两分钟内跑通一个真实获客演示并…

当用户刚安装 Cargo、工作区为空或想快速看它能做什么时，用一次引导式演示拉取约 25 条真实线索、展示费用回执并保存为周期性 play。

适用场景

解决思路

1. 先确认是否已登录：运行 `cargo-ai whoami` 返回工作区则跳过引导步骤。
2. 若未登录：运行 `npm install -g @cargo-ai/cli`（无法全局安装则每条命令前加 `npx @cargo-ai/cli`），再运行 `cargo-ai login --email you@company.com`（邮件验证码、无需浏览器，首次使用会创建账号；备选 `--oauth` 浏览器登录或 `--token <api-token>` 用于 CI），最后用 `cargo-ai whoami` 确认活动工作区。
3. 在第一次付费调用前明确告知用户：新账号有 100 个免费额度、无需绑卡，本次演示约花费 0.5 个额度。
4. 只问一个问题："Who do you sell to?"（用几个词描述目标人群，例如 "Heads of RevOps at mid-market SaaS"），其余（供应商、过滤条件、数量）全部由自己决定，不要追问输出格式、数量或供应商。
5. 遵守速度预算硬规则：不做探索性命令（不先跑 `cargo-ai --version`、`cargo-ai whoami`、`connection connector list`），每步只用一个命令块且命令间不加旁白，付费工作总计上限约 1 个额度，每步都要有回退方案且失败时静默降级继续。
6. 把人群翻译成 `searchLeads` 过滤条件（在 `keywords` 中用引号精确引用职位短语，裸关键词会匹配过松并污染结果），然后执行：`cargo-ai orchestration action execute --action '{"kind":"connector","integrationSlug":"salesNavigator","actionSlug":"searchLeads"}' --data '{"keywords": "\"<persona title phrase>\"", "limit": 25}' --wait-until-finished > /tmp/quickstart-run.json`（注意 searchLeads 最少返回 25 行，limit 低于 25 仍按 25 × 0.02 = 0.5 额度计费）。
7. 获取输出数据（不在 execute 的 stdout 中）：从 `/tmp/quickstart-run.json` 用 `jq -r '.run.uuid'` 取 RUN_UUID、`jq -r '.run.workflowUuid'` 取 WF_UUID，再执行 `curl -s "$(cargo-ai orchestration run download-outputs --workflow-uuid "$WF_UUID" --output-node-slug action --format json | jq -r '.url')" > /tmp/quickstart-outputs.json`。
8. 展示表格（文件包含该工作流所有运行，需按 `_uuid` 过滤到本次运行；每行的 `.output` 直接就是线索数组，字段为 snake_case）：`jq -r --arg u "$RUN_UUID" '[.[] | select(._uuid==$u)][0].output[] | [.full_name, .job_title, .company_name, (.recently_hired // false)] | @tsv' /tmp/quickstart-outputs.json | head -25`，展示 name · title · company · recently-hired 表格而非原始 JSON，并突出 `recently_hired: true` 的行（例如"这 25 人中有 6 人刚入职——正是联系的最佳时机"）。
9. 遇到认证或错误时按回退阶梯降级而非停止：第一级 `salesNavigator.searchLeads`（0.02/条）；第二级 `theirStack.searchJobs`（0.5），改述为"正在招聘你目标人群的公司"；第三级 `waterfall.searchProspects`（3/条，超出约 1 额度上限，必须先询问"两个便宜来源都未连接；我可以用 waterfall 花约 15 额度拉 5 条匹配——要跑吗，还是先免费连接 Sales Navigator？"，仅在明确同意后运行且 limit 上限为 5）；第四级什么都没连接时走免费路径：`cargo-ai connection integration list | head` 展示可接入项并提议连接一个（浏览器认证），之后继续演示。
10. 结束时必须给出费用回执：用 `cargo-ai billing subscription get` 获取已花额度与剩余额度（剩余 = `subscriptionAvailableCreditsCount − subscriptionCreditsUsedCount`），对新账号要对照 100 个免费起始额度表述（如"已花 0.5，你的 100 免费额度还剩 99.5"），并报告命中率（如"25 条全部返回"或实际返回情况及可疑行）。
11. 第 3 分钟立即提议把这次拉取变成周期性 play："想让这个自动运行吗？我可以把这个搜索保存为每周运行的 play，把新匹配写入模型——新的 <persona> 线索会自动出现。"用户同意后按 `../cargo-gtm/recipes/save-as-play.md` 操作，以演示的 action + filter 作为工作流主体并设置每周 cron。
12. 演示后基于刚拉取的行提出 2–3 个后续步骤（遵循 `../cargo-gtm/SKILL.md` §4 的 next-step 规范），例如"为这 25 条补充公司画像（约 0.5 额度/条）"、"为最好的 10 条查找并验证邮箱（约 1.4 额度/条）"；此后真正的 GTM 工作交给 `cargo-gtm`，超出演示范围前先阅读它。

适用边界 · 注意事项

• 用户有真实任务要跑（建列表、丰富 CSV、找邮箱）时——应使用 cargo-gtm。
• 用户想要 CLI 参考或路由时——应使用 cargo router 技能。