看到LangChain AI 刚刚开源了个项目OpenWiki,看它的名称和实现就是把wiki知识库这条路线在实际的应用中落下来,项目介绍:
OpenWiki is a CLI that writes and maintains agent documentation for your codebase.
OpenWiki是一个CLI,用于为你的代码库编写和维护面向Agent的文档。
Github上面的Star数量在快速增长中,当前版本是 v0.0.1,估计还在早期阶段。技术栈为 TypeScript、Ink(React 终端 UI 框架)、LangChain/LangGraph、DeepAgents,内置支持 5 个 LLM Provider,包括OpenRouter。
今年初Karpathy基于自己的AI/AGENT使用经验提出个人LLM Wiki概念:AI不需要每次从原始文档检索,让 Agent增量构建和维护一套持久化的 wiki:一套结构化的、内部互相链接的 Markdown 文件,然后保持持续的更新。随后社区很快出现了围绕这套思路的实现和讨论。
Agent特别擅长一次更新十几数十个文档,并且能厘清文档之间的关系(链接)。
六月份,Google Cloud 发布了 OKF(Open Knowledge Format)v0.1,目标是把这类 LLM wiki 的思路做成一套开放规范。OKF 定义的是一套开放的、厂商中立的最小交换约定:知识以 Markdown 文件目录的形式组织,每个MD概念文件带 YAML frontmatter,文件路径构成概念的ID。它的目标是让不同生产者写出的知识bundle能被不同消费者(人或者Agent)更稳定地应用。
Karpathy 的wiki思路和 OKF 的开放格式规范,是两个背景点。其目标都是给Agent准备"持续化更新的知识文档"这条路线。
我也在之前发布了几篇文章介绍了OKF和WIKI知识库:
谷歌发布OKF(Open Knowledge Format)规范,它与Karpathy的LLM-wiki是什么关系?
图解谷歌OKF(Open Knowledge Format)仓库,理解开放知识格式的落地路径
拆解开源知识库OpenKB:Karpathy的wiki 理念,如何被PageIndex做成无向量知识库
OpenWiki不光是维护Wiki,而且消费Wiki,内置了Agent模式支持问答,实现是基于自家的Agent SDK。
它做了什么?
从项目介绍可以看出OpenWiki落地的不是通用个人知识库,而是"给代码仓库维护 Agent 可读文档"这条路线:
输入一个代码仓库,输出一套结构化 Markdown 文档
生成产物落在仓库的 openwiki/ 目录下,这套文档虽然主要给 Agent 使用,但看项目prompt里的约束要求,它既要对人友好,也要对coding agents 友好。它和 OKF 也是有一点差异:OpenWiki 输出的是仓库内文档,不是严格按 OKF 组织的可交换 knowledge bundle(知识包)。当代码迭代跟新的时候update模式会把 git 变更摘要以及上次更新的元数据一起交给 OpenWiki(内置的内部Agent,下同),再按 prompt 约束做尽量小的增量更新。
OpenWiki 项目结构
OpenWiki 实现了完整的工具链:CLI、内置 Agent、LLM 路由、对话持久化,几乎全套完备,可以独立运行。
CLI工具层是基于 Ink(一个TUI框架)构建的。一个设计细节:init 或 update 命令跑完后会自动退出(shouldAutoExitStartupRun),不需要用户手动 Ctrl+C,让 CLI 同时能当交互式聊天工具,也能当一次性命令用,看来也很适合配合Skill+CLI的模式一起使用。
OpenWiki不只是Wiki文档管理。它的默认模式是聊天:直接运行 openwiki 不带任何参数,打开的是一个交互式问答界面,内置包含了文件系统工具和 shell 后端接入代码仓库,可以随时开启回答。
具体的三种模式的分工:
- chat(默认):交互式问答。OpenWiki 可以读代码、跑 git 命令、搜索文件,但不会主动修改文档。用户明确要求改文档时才动手,也就是说自身就是一个相对完备的Agent。
- --init:首次扫描代码库,从零生成一套结构化Wiki文档
- --update:基于 git 变更证据增量更新已有Wiki文档
如果看 chat 模式的 system prompt:
"This is an interactive chat turn. Answer the user's message directly. Do not create or update OpenWiki documentation unless the user explicitly asks you to modify documentation."
翻译:这是一个交互式聊天轮次。直接回答用户的消息。除非你明确要求你修改文档,否则不要创建或更新OpenWiki文档。
这意味着 OpenWiki 的定位不是"一个能管理文档的纯 CLI",而是一个"懂你代码库的 Agent",Wiki文档管理只是它的能力之一。
CLI生成的wiki文档落在仓库里的 openwiki/ 目录,后续 init、update 或 chat 都把它当作仓库内现成文档来消费。SQLite会把线程状态写到 ~/.openwiki/openwiki.sqlite,它只持久化当前线程的状态(消息历史、工具结果等),每次CLI启动都会启动新的会话ID,也就是说它当前不跨会话。
但我觉得这会不会太重了?大部分情况我们需要的只是一个简单的wiki管理实现。
Agent 运行时用 DeepAgents 组装,DeepAgents 是 LangChain 生态里的高层抽象,把模型、工具…