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 提供了一個穩健且開放的基礎設施。