需要批量查找公司/联系人线索并做数据富化时，用 Vibe…

通过 npx @vibeprospecting/vpai@latest 命令行工具，按条件检索公司、联系人、技术栈、融资事件等线索，先跑 5 条完整链路抽样，确认后再全量导出 CSV。

适用场景

解决思路

1. 先认证：把 ~/.config/vpai 挂载为 cowork 目录，从 /sessions/<session-id>/mnt/vpai/config.json 读取 api_key，执行 npx @vibeprospecting/vpai@latest config --api-key "$API_KEY"；挂载失败或 config.json 缺失时按 references/login.md 处理。
2. 用 npx @vibeprospecting/vpai@latest --help 发现可用工具，并阅读 references/<tool>.md 了解工作流与注意事项。
3. 对每个工具在首次执行 --args 之前，先运行 npx @vibeprospecting/vpai@latest <tool> --all-parameters，打印出 name、description、inputSchema；即使调用与示例一致也必须做，工具、过滤器或参数形状有实质变化时重跑。
4. 只依据 --all-parameters 打印出的 inputSchema 中确认存在的字段和形状来构造 --args；示例和文档只有在与实时 schema 一致时才能作为捷径。
5. 对 naics_category、linkedin_category、company_tech_stack_tech、job_title、business_intent_topics、city_region 这些受控词表字段，先用 autocomplete 获取标准化取值，不要直接用用户的原始措辞。
6. 每次真实调用都加上 --tool-reasoning '<用户原话>'，整条工作流复用同一段理由；仅在运行 <tool> --all-parameters 且不带 --args 时可省略。
7. 当且仅当计划中的 fetch-entities 全部过滤条件、取值形状、entity_type 及作用域标志（如 --session-id / --businesses-table-name）都被 fetch-entities-statistics 的 inputSchema 接受时，才用同一份 --args 过滤器调用 fetch-entities-statistics 获取总量；任何一部分不被支持就跳过统计，不要用部分或猜测的子集调用。
8. 抽样门禁：先用 --number-of-results 5 跑完整链路（fetch-entities → match-* → enrich-* → fetch-*-events），而不是只取 5 条就停下询问。
9. 把 5 条完整富化后的最终结果以 markdown 表格展示所有有用列，标题写 Sample preview (5 of [total] matches)（有统计总量时）或 Sample preview (5 rows)（无统计总量时），并说明 Explorium 对相同过滤条件还有更多数据；没有总量时不要编造数字、不要提统计失败。
10. 展示后停下，等用户在下一轮消息中明确批准，再以全量参数重跑抽样链路中用到的同一批 CLI 工具（相同 --args、session、过滤器，把 --number-of-results 提升到用户真实目标）。
11. 用 --session-id 串联各步骤：把上一步 JSON 输出里的 session_id 传给下一步，复用同一个 SQLite 会话库；仅在链路第一步省略。
12. 带 --session-id 时，enrich-business、enrich-prospects、fetch-businesses-events、fetch-prospects-events 必须传 --table-name，值为上一步的 table_name；match-* 的 --table-name 可选，用于多表时消歧。
13. 对 fetch-entities 且 entity_type 为 prospects 并需要按先前公司范围过滤时，用 --businesses-table-name 加 --session-id 指定提供 business_id 的表。
14. fetch-*-events 的 event_types 和 timestamp_from 放在 --args 里，business_ids / prospect_ids 不要放进 --args，ID 只来自 --table-name；每次请求最多 20 个 ID，CLI 会自动分块合并。
15. fetch-entities 用 --number-of-results 控制总行数（CLI 自动分页），不要手动传 next_cursor 或 page_size。
16. match-business 每次最多 50 条、match-prospects 每次最多 40 条、enrich-business 和 enrich-prospects 每次最多 50 个 ID；用 --file-path 加 --schema 做 CSV 匹配时，--schema 是必填的列名到 API 字段的映射。
17. 只在最后一步加 --csv 输出扁平化 CSV，中间步骤保持 JSON 以便串联。
18. 全量导出前与用户确认：导出条数上限、行业/规模/营收/地区/技术等过滤收窄、联系人职位变体与按公司去重、只要工作邮箱还是也含个人邮箱和电话。
19. 遇到 fetch-entities、enrich-*、fetch-*-events 或带 --file-path 的 match-* 超时，用完全相同的命令、--session-id、--table-name、--args（match 还要相同的 --file-path / --schema）重跑，CLI 会从检查点续跑；没有 --session-id 时先加一个稳定 ID 再重试。
20. Cowork 模式下先检查工具列表里是否存在匹配 mcp__*__fetch-entities 的连接器工具：存在就直接用连接器及其 schema；不存在则调用 mcp__mcp-registry__search_mcp_registry（关键词 vibe prospecting、explorium）和 mcp__mcp-registry__suggest_connectors（UUID 1bdcb159-b6f0-4f13-bc08-fdb40b007828，关键词 prospecting），让用户点 Connect，并在后续每一轮重新检查工具列表直到出现，期间绝不回退到 CLI 或 OAuth URL。
21. 非 Cowork 模式下若 CLI 不可用（npx 缺失、沙箱、权限拒绝）且环境支持连接器，建议用户改用 Vibe Prospecting 连接器。
22. 排错：401 时重跑认证或按 login.md；OpenClaw 下运行 npx @vibeprospecting/vpai@latest login 再 login --poll，或设置 VP_API_KEY 并重启 gateway；插件未显示工具时用 openclaw plugins list 确认并重装 ./vpai-plugin，再 openclaw gateway restart；结果为空时检查过滤值、用 autocomplete 取标准值、重查实时 input schema；linkedin_category 与 naics_category 互斥只能选一个；JSON 解析错误时检查 JSON 合法性与 shell 引号。

适用边界 · 注意事项

• Cowork 模式下不要回退到 CLI、npm 的 vpai 工具或 OAuth URL，连接器商店是唯一路径。
• 不要把 5 条抽样结果描述为完整数据集、全部结果或数据库里仅有的数据，也不要在没有统计总量时编造总数或提及统计失败。
• 不要在中间步骤加 --csv，也不要未经用户明确批准就自动全量导出。