用途
fleet-init 用于初始化 CocoFleet 清单(manifest),以支持多进程编排。它属于 CocoPlus 体系,通过生成一个 JSON 模板来定义一组独立的 Coco 进程实例及其依赖关系。
主要能力
- 前置校验:确认 .cocoplus/ 目录存在,否则提示先运行 $pod init 并停止。
- 参数解析:解析 $fleet init [fleet-name];若未提供 fleet-name,则输出用法示例并停止。
- 环境检查:跨平台确认 coco CLI 是否可用(Windows 用 where coco,Mac/Linux 用 which coco,或运行 coco --version 检查退出码);若未找到则报错并停止。
- 目录与文件创建:创建 .cocoplus/fleet/ 目录,并写入 .cocoplus/fleet/[fleet-name]-manifest.json。
- 模板内容:包含 id、name、version、created_at(ISO 8601 时间戳)、defaults(persona、model、coco_flags、timeout_minutes)以及 instances 数组。示例实例包含 id、name、persona、task_file、output_dir、depends_on、checkpoints 字段,并演示了依赖关系(instance-002 依赖 instance-001)。
- 完成输出:确认清单路径,并说明如何添加实例、每个实例所需字段,以及通过 $fleet run [fleet-name] 执行。
使用方式
- 确保当前目录已初始化 CocoPlus(存在 .cocoplus/)。
- 运行 $fleet init [fleet-name],例如 $fleet init data-pipeline-fleet。
- 技能会检查 coco CLI 是否在 PATH 中,然后生成清单文件。
- 编辑生成的 JSON,按需添加或修改实例定义。
- 使用 $fleet run [fleet-name] 执行该 fleet。
适用场景
适用于需要将多个独立 Coco 进程按依赖关系编排执行的场景,例如数据处理流水线、分阶段任务等。每个实例在独立进程中运行,不共享上下文,因此 task_file 必须自包含,需在任务文件中记录所有必需的输入、schema 和上下文。
限制
- 单个 fleet 清单最多 10 个实例。
- 每个实例的 task_file 必须完全自包含,不能内联任务内容。
- 执行依赖 coco CLI 在 PATH 中可用。
- 需要 .cocoplus/fleet/ 目录存在,否则首次运行会失败。
- 关于收费、价格、平台支持范围等更多信息,资料中暂未提供。