openbkn-ai 环境检查
公约：../_shared/contract.md
插件检测：../_shared/plugin-check.md
做什么
在绑定/推送前，检查环境是否就绪。如果缺少必要资源，判定是否需要搭建。同时检测可插拔插件可用性。
输入
network_dir：网络目录（.bkn文件位于{network_dir}/bkn/）network_context：网络名称、领域goal：validate / push / update / copy
检查清单
| 检查项 | 方法 | 失败结果 |
|---|---|---|
| 草案目录 | {network_dir}/bkn/ 存在 + network.bkn 齐备 |
blocked |
| CLI | openbkn --version |
blocked |
| 平台连通性 | openbkn config show |
blocked |
| 业务域 | 配置是否匹配 | warning |
| 同名网络 | openbkn bkn list |
记录冲突 |
| 资源就绪 | Vega resource 是否存在 | 触发 bind_mode 判定 |
| Skill 模块 | openbkn skill list --limit 1 |
warning（记入 capability_matrix） |
| Agent 工厂 | openbkn agent list --limit 1 |
warning（记入 capability_matrix） |
| 定时任务（巡检用） | OpenClaw 调度 API 可用性 | warning（记入 capability_matrix） |
所有 CLI 操作委托 bkn-openbkn（读取 ../bkn-openbkn/SKILL.md）。
定时任务能力检测
在检查清单末尾，检测 OpenClaw 定时任务能力：
前提条件：定时任务能力仅在 plugin_availability.test == available（有 bkn-test 插件）时才有意义。若 test 插件不可用，巡检功能整体不可用，定时任务不会创建。
- 检测 OpenClaw 是否已安装且可访问（委托
bkn-openbkn检查环境） - 检测 OpenClaw 调度 API 是否可用（
openclaw cron list或等价命令） - 结果写入
env_capability_matrix.patrol_cron：available|unavailable - 不可用时不阻塞流程，但若同时
plugin_availability.test == unavailable，pipeline 阶段八整体跳过巡检
插件可用性检测
在检查清单末尾，按 ../_shared/plugin-check.md 协议检测可插拔插件：
- 检测
../_plugins/bkn-rules/SKILL.md文件存在且非空 →plugin_availability.rules: available - 检测
../_plugins/bkn-test/SKILL.md文件存在且非空 →plugin_availability.test: available - 根据检测结果判定
plugin_mode（见plugin-check.md） - 结果写入
pipeline_state.yaml，pipeline 据此裁剪阶段分支
Resource 可用性检查
在资源就绪检查阶段，获取平台可用 Vega resource 列表（仅元数据），供后续绑定阶段使用：
- 执行
openbkn vega resource list获取平台全部可用资源- 必须获取全部视图：优先使用
--all参数；如不支持则使用--page-size分页循环获取，直到获取数量等于平台返回的总数 - 如平台未返回总数且 CLI 不支持分页参数，执行
openbkn dataview list --limit 9999作为降级方案
- 必须获取全部视图：优先使用
- 输出
resource_availability（仅含资源元数据，不做对象-资源匹配推荐） - 对象-资源匹配的决策权交由
bkn-bind - 资源 property schema 由
bkn-bind按需获取（通过openbkn vega resource query <id> -d '{"limit":1}'推断属性）
resource_availability:
total_resources: 0
fetched_resources: 0 # 实际获取的资源数量
truncated: false # true 表示平台有截断风险，bkn-bind 应 warn 用户
available_resources: [{resource_id, resource_name, datasource_id, property_count}]
Bootstrap 与 bind_mode 判定
| 资源状态 | bootstrap_level | result_status | bind_mode |
|---|---|---|---|
| 数据源+资源都有 | none | ready | full |
| 仅有其一 | soft | need_user_confirm | full |
| 都没有 | none | ready | deferred |
bind_mode: deferred 表示当前环境无可用资源，pipeline 将跳过资源绑定阶段（阶段四），推送门禁中的绑定相关条件自动豁免。网络以 schema-only 模式推送，资源可后续通过 update pipeline 补绑。
输出
environment_status: ready | blocked | warning
bootstrap_required: true | false
bootstrap_level: soft | none
bind_mode: full | deferred
plugin_mode: full | limited
plugin_availability:
rules: available | unavailable
test: available | unavailable
check_summary: {cli, connectivity, domain, draft, resource_readiness}
blocking_issues: [{issue, reason, suggested_fix}]
bootstrap_plan: {steps, estimated_effort}
resource_availability: {total_resources, fetched_resources, truncated, available_resources}
env_capability_matrix:
cli: available | unavailable
platform: available | unavailable
skill_module: available | unavailable
agent_factory: available | unavailable
resource: available | unavailable
context_loader: available | unavailable
patrol_cron: available | unavailable # P1-5/P1-6 巡检自动创建
env_capability_matrix 和 plugin_availability 写入 pipeline_state.yaml，后续阶段据此裁剪分支（如 Skill 注册降级、Agent QA 降级、插件阶段跳过）。
约束
- 仅检查不修改 .bkn
- 不执行 push/delete/update
- bootstrap 前需用户确认