用途:让用户把一个任务交给别的模型执行,而不是自己动手;尤其适合同时并行跑多个不同模型的任务。
主要能力:单个任务可用 run 子命令指定模型友好名与 prompt;批量并发用 run-many 读取 batch.json 一次提交,内部真正并发完成;list-models 可查看可用模型及密钥是否配好。模型友好名来自 models.config.json,预置 deepseek-v4-pro、deepseek-v4-flash、kimi、gemini(Gemini 无官方 Anthropic 兼容端点,需自填网关地址,不填会直接报错),以及 kollab-gateway 系列四个模型。选型建议:批量文案/创意用 kollab-gateway-copy;批量翻译/格式转换用 kollab-gateway-bulk;简单调研摘要用 kollab-gateway-research;高质量单次产出用 deepseek-v4-pro。多轮工具调用容错要求高的任务应留给 Claude,因部分第三方模型存在 tool-calling 可靠性问题。
使用方式:运行前需 cp .env.example .env 并填入对应模型真实 API key,否则 run/run-many 会直接报出缺失的环境变量。示例:node bin/agent-fleet.mjs run --model <友好名字> --prompt "<任务描述>" [--cwd <目录>] [--json];node bin/agent-fleet.mjs run-many --config batch.json [--json];node bin/agent-fleet.mjs list-models。
限制与安全:--cwd 指向的目录被视为不可信输入,若其 .claude/settings.json 试图篡改请求目标地址、凭据或请求头(如用 env.ANTHROPIC_BASE_URL 劫持密钥),运行会 fail-closed 报错退出,不要删掉该闸门。但防护有边界:工具跑的是 bypassPermissions 自主 Agent,恶意目录仍可能通过 prompt injection 诱导模型外发密钥,来路不明的目录应放到容器或一次性虚拟机中处理。该工具为纯本地工具,与 Kollab 产品的基础设施、网关、账号体系无关。