执行 Files / Flows / Jobs
执行车道只通过 fkit 的真实响应定位 BioLine 对象。用户请求中的关键词用于查询, 不是本地 ID,也不是静态目录键。
Files:先列出输入
在 docs_loaded 后使用 fkit ls <input-path> 列出文件。planning 将输入路径、 文件清单和每个 binding 写入 execution;路径必须属于执行根或 BioLine 可读的 输入位置。缺少文件、端口或默认值时不要猜测,转到 document_gap 或 plan_failed 并保留证据。
Flows:动态发现再检查
按关键词调用 fkit flow list,若只有一个精确匹配才使用其响应中的 id 和 version_id。随后调用 fkit flow inspect <id>,核对输入端口、输出端口、文件组 和参数。多个近似匹配时展示候选并停止,不可按列表顺序静默选取。
Jobs:确认后提交
执行顺序固定为:
- 将 Flow、inspect 结果、文件列表、binding 和默认值写入 planning 记录。
- 进入
awaiting_plan_confirmation,向用户展示可读的计划和影响范围。 - 获得确认后生成可复现的 job spec,调用
fkit job create。 - 记录返回的 Job ID,进入
submitted → running;fkit job get轮询不阻塞会话。 - 只有成功状态才进入
finalized,用fkit download将结果整理到stage/。
提交不是发布,轮询不是成功的替代品。任何失败都保留响应、时间和阶段,并使用 对应的 *_failed 值。
通过 fkit 查询命令文档
OpenClaw 会为即将调用的精确命令请求对应页面,不需要 BioLine 登录:
fkit flow list --docs --docs-json --docs-lang zh
fkit tool summary export --docs --docs-json --docs-lang en响应包含所选命令路径、语言、文档 ID、规范页面 URL、固定 source 和 Markdown。 source 必须是 https://www.bioline.cloud/ai/commandLineAndFkit/,Markdown asset 必须与索引同源。 命令页面缺失或无效时保留证据并设置 document_gap。OpenClaw 不抓取文档站 HTML, 不读取本地文档包,也不回退到 Skills 或 pipeline 映射。
执行到下游的交接
finalize 写入 stage/manifest.json 与可复现性清单后,准备精确 BioLine NAME:VERSION。OpenClaw 检查该版本的下游 summary 和空 config command,再 pull 指定版本。 历史镜像表仅用于迁移盘点。stage/ 和任务 reproducibility 只读挂载,network 关闭, analysis 可写;生成脚本、输出和日志留在当前 Job workspace。
