用途：openbkn 是 BKN 平台的统一命令行工具，一个二进制覆盖知识网络构建与查询、资源与 Vega Catalog 管理、模型工厂、Skill 与工具箱、沙箱执行、Trace 诊断及运营（admin 子命令），纯后端、无 Web UI。
主要能力：bkn 组支持知识网络与 Schema（对象/关系/行动类型、指标、概念组）、实例与语义搜索、push/pull/validate、create-from-catalog；vega 组支持 Catalog、资源、索引构建任务与 SQL；另有 resource、context（Context Loader/MCP 检索）、mcp（只读发现）、model、skill、toolbox、sandbox、function、api、tool、trace、admin、call 等命令组。
使用方式：安装执行 npm install -g @openbkn/bkn-sdk，需 Node.js 22.19.0+，也可用 npx @openbkn/bkn-sdk 临时运行。基础调用形式为 openbkn [--base-url <url>] [--token <tok>] [--user <id|name>] [--json | --compact] [-k|--insecure] <group> <sub> [options]。默认输出人类可读表格，加 --json 或 --compact 输出精确 JSON。认证可用 openbkn auth login（支持 --token、-u -p、浏览器、--device），凭据按平台/用户分层存于 ~/.bkn/，可用 BKN_CONFIG_DIR 覆盖；也可用环境变量 BKN_TOKEN、BKN_BASE_URL、BKN_USER、BKN_PROFILE。第三方 Agent 业务问答需走受管上下文：每轮先调 bkn_start_interaction，回答后调 bkn_finish_interaction。
限制与注意：不要猜参数，以实时 openbkn <group> <sub> --help 为准；不要猜请求体字段，应到 https://openbkn-ai.github.io/bkn-foundry/ 查对应模块（改定义看 bkn-backend，取数/执行看 ontology-query，skill/tool 看 execution-factory，受管交互看 agent-observability），context 的 --args 形状由 context tools <kn-id> 提供。部分平台能力暂未覆盖，如 bkn-agent 运行时、执行工厂 MCP 写入与 Market、Skill 索引构建任务，可用 openbkn call 打原始接口并自动注入认证头。知识网络没有整网构建，需先 openbkn vega resource update 再 vega resource build。破坏性操作作用于线上，执行前须确认。宽表查询应限制 limit 并使用分页与过滤。默认检查 SDK 与平台基础版本一致，可用 --skip-version-check 或 BKN_SKIP_VERSION_CHECK=1 跳过。