--- id: ai.index.zh language: zh title: BioLine AI 文档索引 section: ai-index version: 1.0 --- # BioLine AI 文档索引 本文件是 BioLine AI 文档服务的索引，供 AI Agent 与 fkit 的 `--docs` 读取。它本身不解释任何命令，只负责把「要做什么」映射到「该读哪一篇」。 ## 读取约定 - 基准地址：`https://www.bioline.cloud/ai/` - 下方所有链接一律以 `/ai/` 开头。拼到基准地址后面即为可抓取的原始 Markdown，不需要 BioLine 登录。 - 本索引与被索引的文档都是简体中文。英文用户可以把 `--docs-lang` 设为 `en`，但 AI 侧只提供中文文档。 - 索引来源目录是 `ch/`；AI 文档服务直接复制该目录，所以本索引必须留在 `ch/` 内。 - 每条命令文档都包含：用途 / 语法 / 参数与选项 / 影响范围 / 安全使用 / 输出 / 读取本页。 ## 命令映射表（机器解析区） 下面这段是本索引唯一供程序解析的区域，由标记行界定。解析规则：只读取 `start` 与 `end` 两条标记之间的行；每行必须形如「`- \``命令路径`\`` → `/ai/...`」，命令路径与 CLI 命令树完全一致（空格保留），链接为根相对路径，需与上面的基准地址拼接。标记之外的正文（分组说明、任务链路等）不参与解析。 - `login` → /ai/commandLineAndFkit/commands/login/ - `upload` → /ai/commandLineAndFkit/commands/upload/ - `ls` → /ai/commandLineAndFkit/commands/ls/ - `mv` → /ai/commandLineAndFkit/commands/mv/ - `mkdir` → /ai/commandLineAndFkit/commands/mkdir/ - `rm` → /ai/commandLineAndFkit/commands/rm/ - `cp` → /ai/commandLineAndFkit/commands/cp/ - `project` → /ai/commandLineAndFkit/commands/project/ - `download` → /ai/commandLineAndFkit/commands/download/ - `create-tool` → /ai/commandLineAndFkit/commands/create-tool/ - `update` → /ai/commandLineAndFkit/commands/update/ - `pull` → /ai/commandLineAndFkit/commands/pull/ - `tool` → /ai/commandLineAndFkit/commands/tool/ - `tool config` → /ai/commandLineAndFkit/commands/tool-config/ - `tool config export` → /ai/commandLineAndFkit/commands/tool-config-export/ - `tool config apply` → /ai/commandLineAndFkit/commands/tool-config-apply/ - `tool summary` → /ai/commandLineAndFkit/commands/tool-summary/ - `tool summary export` → /ai/commandLineAndFkit/commands/tool-summary-export/ - `tool summary apply` → /ai/commandLineAndFkit/commands/tool-summary-apply/ - `tool list` → /ai/commandLineAndFkit/commands/tool-list/ - `flow` → /ai/commandLineAndFkit/commands/flow/ - `flow create` → /ai/commandLineAndFkit/commands/flow-create/ - `flow list` → /ai/commandLineAndFkit/commands/flow-list/ - `flow inspect` → /ai/commandLineAndFkit/commands/flow-inspect/ - `file` → /ai/commandLineAndFkit/commands/file/ - `file search` → /ai/commandLineAndFkit/commands/file-search/ - `job` → /ai/commandLineAndFkit/commands/job/ - `job create` → /ai/commandLineAndFkit/commands/job-create/ - `job template` → /ai/commandLineAndFkit/commands/job-template/ - `job list` → /ai/commandLineAndFkit/commands/job-list/ - `job search` → /ai/commandLineAndFkit/commands/job-search/ - `job get` → /ai/commandLineAndFkit/commands/job-get/ - `job stop` → /ai/commandLineAndFkit/commands/job-stop/ ## 一、fkit 命令文档（33 条） ### 1. 认证与项目上下文 - [登录与认证 — `login`](/ai/commandLineAndFkit/commands/login/)：用 BioLine 主机与访问密钥建立 fkit 认证上下文；没有业务 JSON 输出。 - [切换当前项目 — `project`](/ai/commandLineAndFkit/commands/project/)：交互式切换后续 fkit 命令使用的项目上下文。 ### 2. 云端文件与目录 - [上传文件或目录 — `upload`](/ai/commandLineAndFkit/commands/upload/)：把本地文件或目录传到云端目标路径；`--recursive` 传目录，`--force` 覆盖同名文件。 - [列出云端文件 — `ls`](/ai/commandLineAndFkit/commands/ls/)：查看云端路径下的文件与目录，支持 `--json`、`--keyword`、`--limit`。 - [移动或重命名云端路径 — `mv`](/ai/commandLineAndFkit/commands/mv/)：在云端移动或重命名，最后一个路径是目标。 - [创建云端目录 — `mkdir`](/ai/commandLineAndFkit/commands/mkdir/)：创建云端目录，`--parents` 补齐缺失的上级。 - [复制云端路径 — `cp`](/ai/commandLineAndFkit/commands/cp/)：在云端复制文件或目录，复制目录必须 `--recursive`。 - [删除云端文件 — `rm`](/ai/commandLineAndFkit/commands/rm/)：删除云端文件；删除目录必须 `--recursive`，无法撤销。 - [下载云端文件 — `download`](/ai/commandLineAndFkit/commands/download/)：把云端文件或目录下载到本地目标位置。 - [文件命令入口 — `file`](/ai/commandLineAndFkit/commands/file/)：分组入口，进入项目文件搜索子命令。 - [搜索项目文件 — `file search`](/ai/commandLineAndFkit/commands/file-search/)：按关键词搜索项目文件路径，最多返回 100 项。 ### 3. Tool 发现与创作 - [Tool 命令入口 — `tool`](/ai/commandLineAndFkit/commands/tool/)：分组入口，选择列表、配置或摘要子命令。 - [列出 Tool — `tool list`](/ai/commandLineAndFkit/commands/tool-list/)：列出当前项目中可用的 Tool。 - [创建 Tool — `create-tool`](/ai/commandLineAndFkit/commands/create-tool/)：以容器镜像和唯一名称创建、配置并登记 Tool，支持 `--json`。 - [检查并更新 Tool — `update`](/ai/commandLineAndFkit/commands/update/)：默认只做 check；写入模式必须显式选择原位更新或上传新版本。 - [拉取 Tool 版本 — `pull`](/ai/commandLineAndFkit/commands/pull/)：下载指定 Tool 版本到本地缓存，供后续离线使用。 - [Tool 配置命令 — `tool config`](/ai/commandLineAndFkit/commands/tool-config/)：分组入口，进入配置的导出或应用子命令。 - [导出 Tool 配置 — `tool config export`](/ai/commandLineAndFkit/commands/tool-config-export/)：读取指定版本的命令、输入输出端点与资源配置，输出 JSON。 - [应用 Tool 配置 — `tool config apply`](/ai/commandLineAndFkit/commands/tool-config-apply/)：从 JSON 文件读取配置并应用到指定版本。 - [Tool 摘要命令 — `tool summary`](/ai/commandLineAndFkit/commands/tool-summary/)：分组入口，进入摘要的导出或应用子命令。 - [导出 Tool 摘要 — `tool summary export`](/ai/commandLineAndFkit/commands/tool-summary-export/)：读取指定版本的 Markdown 摘要，可选择一个标题路径。 - [应用 Tool 摘要 — `tool summary apply`](/ai/commandLineAndFkit/commands/tool-summary-apply/)：从 Markdown 文件读取摘要并更新指定版本的描述。 ### 4. Flow 发现与创作 - [Flow 命令入口 — `flow`](/ai/commandLineAndFkit/commands/flow/)：分组入口，进入创建、列表查询或版本检查子命令。 - [列出 Flow — `flow list`](/ai/commandLineAndFkit/commands/flow-list/)：列出当前项目的 Flow 并展开可用版本，可按关键词筛选。 - [检查 Flow 版本 — `flow inspect`](/ai/commandLineAndFkit/commands/flow-inspect/)：读取指定版本的输入、输出、参数与节点摘要，JSON 中附带 `sourceGraph`。 - [创建 Flow — `flow create`](/ai/commandLineAndFkit/commands/flow-create/)：从 JSON 图文件创建 Flow，节点必须引用精确的 `TOOL:VERSION`。 ### 5. Job 执行与查询 - [Job 命令入口 — `job`](/ai/commandLineAndFkit/commands/job/)：分组入口，进入创建、模板、列表、搜索、详情或终止子命令。 - [查看 Job 模板 — `job template`](/ai/commandLineAndFkit/commands/job-template/)：读取指定 Flow 版本的源任务模板，但不创建 Job。 - [创建 Job — `job create`](/ai/commandLineAndFkit/commands/job-create/)：加载选定 Flow 版本的云端任务模板，应用 JSON spec 创建 Job。 - [列出 Job — `job list`](/ai/commandLineAndFkit/commands/job-list/)：列出当前项目 Job group，可选关键词筛选，包含 batch group。 - [搜索 Job — `job search`](/ai/commandLineAndFkit/commands/job-search/)：按关键词搜索可运行 Job，包含 batch group 内的 Job。 - [查看 Job 详情 — `job get`](/ai/commandLineAndFkit/commands/job-get/)：读取指定 Job 的详细信息和任务状态。 - [终止 Job — `job stop`](/ai/commandLineAndFkit/commands/job-stop/)：终止指定的单个运行中 Job；执行前需用户确认，请求不自动重试。 ## 二、OpenClaw 双车道契约（10 篇） 这一组约束执行车道与创作车道的运行行为，不是命令参考。凡涉及「怎么发现、怎么登记、失败了怎么办」，读这里。 - [双车道架构](/ai/openclaw/dual-lane-architecture/)：两条车道的边界、状态序列、动态 fkit 发现与 `document_gap` 规则。 - [execution registry.yaml：执行登记](/ai/openclaw/execution-registry/)：执行车道的 registry 模板、字段含义与提交确认边界。 - [执行 Files / Flows / Jobs](/ai/openclaw/execution-files-flows-jobs/)：如何用 fkit 的真实响应发现文件与 Flow，并提交与轮询 Job。 - [authoring registry.yaml：创作登记](/ai/openclaw/authoring-registry/)：创作车道 registry 模板，以及 build、publish、register 的独立确认。 - [创建 Tool](/ai/openclaw/create-tool/)：从文档、Dockerfile、接口草稿到 smoke test、publish、read-back register 的完整流程。 - [更新 Tool 与维护版本](/ai/openclaw/update-tool/)：版本与可用模式检查，以及原位更新 / 创建新版本的选择规则。 - [创建 Flow](/ai/openclaw/create-flow/)：把真实存在的 Tool Version 组合成可检查的有向图。 - [历史本地下游镜像迁移盘点](/ai/openclaw/downstream-images/)：旧工作区保留的五个镜像条目，是迁移盘点，不是运行时 allowlist。 - [Python / R 分析、绘图与报告](/ai/openclaw/analysis-plotting-reports/)：下游分析从 finalized 的 `stage/manifest.json` 开始，脚本先落盘再由隔离容器执行。 - [失败、document_gap 与质量检查](/ai/openclaw/failures-document-gap-quality/)：失败阶段与留档要求、`document_gap` 的触发与质量门。 ## 三、典型任务链路 按下面的顺序读文档并按顺序执行，可以覆盖绝大多数操作场景。 - 执行一个已有 Flow：`flow list` → `flow inspect` → `ls` / `upload` → `job create` → `job get` → `download` - 创建并登记一个新 Tool：`tool list` → `create-tool` → `update`（先 check，再决定 in-place 或 new-version）→ `tool summary apply` - 把已有 Tool 组合成新 Flow：`tool list` → `flow list` → `flow inspect` → `flow create` → `flow inspect` - 基于已有结果继续分析：`job list` / `job search` → `job get` → `download` - 中止运行中的 Job（需用户确认）：`job get` → `job stop` → `job get` - 出现失败或文档缺失：先读 [失败、document_gap 与质量检查](/ai/openclaw/failures-document-gap-quality/)，再读对应命令页