Skip to content

执行 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:确认后提交 ​

执行顺序固定为:

  1. 将 Flow、inspect 结果、文件列表、binding 和默认值写入 planning 记录。
  2. 进入 awaiting_plan_confirmation,向用户展示可读的计划和影响范围。
  3. 获得确认后生成可复现的 job spec,调用 fkit job create。
  4. 记录返回的 Job ID,进入 submitted → running;fkit job get 轮询不阻塞会话。
  5. 只有成功状态才进入 finalized,用 fkit download 将结果整理到 stage/。

提交不是发布,轮询不是成功的替代品。任何失败都保留响应、时间和阶段,并使用 对应的 *_failed 值。

通过 fkit 查询命令文档 ​

OpenClaw 会为即将调用的精确命令请求对应页面,不需要 BioLine 登录:

text
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。