OpenWiki 0.2 为代码库文档引入 OKF 支持

OpenWiki 是 LangChain 开发的开源命令行工具，用于生成和维护代码库文档。它能为仓库创建 wiki，并将其与编码代理连接，在代码变更时自动更新文档。OpenWiki 0.2 版本引入了对 OKF 的支持，这是一种由 Google Cloud 提出的知识 wiki 结构化标准，旨在帮助开发者更好地分类和整理代码库 wiki。

大型代码库通常需要庞大的 wiki 系统，包含数百个文件。此时，文档的结构化对于发现、更新、搜索和审查至关重要。OpenWiki 0.2 通过采用 OKF 格式，为生成的 wiki 添加了更清晰的结构，使编码代理能够更轻松地导航，从而减少搜索时间和令牌消耗。

在 OpenWiki 0.2 中，每个 wiki 文件都包含 YAML 前置元数据，包括标题、描述、标签、类别和资源 URL 等字段。OKF 定义了两个关键约定：index.md 用于汇总每个 wiki 目录中的文件和子目录，而 logs.md 则记录 wiki 随时间的变化，类似于变更日志。变更日志特别有助于快速了解更新内容：开发者无需在每次运行后阅读整个 wiki，只需查看 logs.md 即可知道哪些文件被修改以及需要关注哪些细节。

OKF 规范本身非常简单，易于集成。其 YAML 前置元数据仅包含几个关键字段，例如类型（必需）、标题、描述、资源 URL、可选标签和时间戳等。通过这些元数据，可以确定性生成 index.md 文件：从每个文件的描述中提取内容，生成类似“标题1 - 描述1”的条目。而 logs.md 则由 OpenWiki 在每次运行结束时自动生成，记录其修改历史，例如“2026-05-22：更新 - 添加了新的 BigQuery 表引用”。

结构化元数据还为代理提供了更好的检索能力。OpenWiki 通过 AGENTS.md 和 CLAUDE.md 等文件将 wiki 暴露给编码代理。由于 OKF 为每个文档添加了结构化元数据，未来的 OpenWiki 工具可以支持基于标签、类别、描述等字段的确定性搜索，而非完全依赖代理的开放式搜索。开放式搜索虽然有用，但对于简单查找而言可能过于缓慢且昂贵。结构化元数据为 OpenWiki 提供了更高效检索工具的路径。

由于 OKF 是一种开放格式，OpenWiki 生成的 wiki 可以与社区构建的查看器、渲染器、代码检查器等兼容工具配合使用，无需依赖单一集成。Google 还发布了开源的 OKF wiki 可视化器，可用于检查 wiki 并查看文档之间的关系。

对于现有用户，升级到 OpenWiki 0.2 后，生成的 wiki 将自动采用 OKF 格式。新用户可通过 npm 全局安装并初始化，只需几分钟即可生成仓库 wiki。