okf：你的 AI 代理驱动、用于管理知识图谱的 CLI

okf 是一个用于 Open Knowledge Format (OKF) 的 Go CLI 工具包，刚刚发布的 v0.2.0 带来了一系列重要更新。作为 agentic-first、JSON-native、厂商中立的工具，它让 AI 代理能够通过简单的方式发现并驱动命令行，从而管理知识图谱。

OKF 是 Google 提出的开放知识格式，但官方参考实现与 Python、Gemini 和 BigQuery 深度绑定。如果代理不运行在 Google 的云栈上，就没法使用官方工具。okf 以单一 Go 二进制文件形式提供了完全中立的替代方案：无需 Python 环境、无需 Gemini API 密钥、无需 BigQuery，只需一个可执行文件即可在任意环境中运行。

okf 的设计哲学是"代理优先"。它并不在 CL I内部调用 LLM，而是让外部的 AI 通过 okf schema 命令获取整个 CLI 的 JSON 清单，包括每个命令的参数、输出格式和退出码。代理根据这个 schema 来调用命令，并依据结构化 JSON 和类型化错误码作出决策。stdout 只输出 JSON，诊断信息走 stderr，退出码与错误类型一一对应，因此代理可以在零提示工程的情况下完成发现、执行和恢复。

v0.2.0 的核心亮点是完整实现 OKF v0.2 规范。信任层级成为一等字段，每个概念都能从已验证事件中推导出信任级别：unverified、machine-confirmed 或 human-reviewed。来源（provenance）信息被纳入概念文档，支持按来源追踪作者、使用次数和最后修改时间，并且在验证时会双向检查 body 脚注与 source id 的对应关系。生命周期字段（status 和 stale_after）让数据时效性变成简单的日期比较，过期当天就会在验证时被标记。新增的"attested computations"概念类型允许定义受认可的运算合约，包括运行时、类型化参数、执行器和确定性认证器，okf 会验证合约路径确实存在于 bundle 中。

工具包共包含 11 个命令，全部默认输出 JSON。除 schema 和 version 外，还有用于创建和结构化的 init 与 index，用于验证与质量的 validate 和 lint，用于探索查询的 list、search、show，以及用于图形与关系的 graph 和 backlinks。这些命令都经过 88 个测试的验证，仅依赖 Go 标准库，采用 Apache 2.0 许可。Google 知识目录中的参考 bundle 全部通过零错误验证，且旧版 v0.1 bundle 仍可使用，只是会得到迁移警告。

安装非常简单，支持 Homebrew、go install 或从源码构建，并提供 cosign 签名和 SBOM。对于希望在任意 AI 代理中集成知识图谱管理的团队来说，okf 提供了一个稳健且开放的基础设施。