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