AI 编程 Agent不了解项目结构,改代码全靠猜。OpenWiki 就为解决这个痛点而生。
7 月 5 日,LangChain 开源 OpenWiki——自动为代码库生成并维护 AI Agent 文档 的 CLI。开源 5 天,Star 冲到 9970,发了 4 个版本。
跑一遍 openwiki,项目根目录生成 openwiki/ 文件夹:架构概览、目录说明、关键模块、数据流。
代码变了再跑一次,增量更新,只刷新变动部分。
更巧妙的是,它会自动在 AGENTS.md / CLAUDE.md 里插入一段提示,告知 AI Agent 先读 openwiki/。不存在就创建,存在就追加。之后 Cursor / Claude Code 打开项目时自动先读 openwiki/。
npm install -g openwiki → openwiki --init 交互式配置(提供商、Key、模型),凭据存 ~/.openwiki/.env。
然后 openwiki "请生成文档",生成 openwiki/ 目录。可继续追问。一次性输出加 -p:openwiki -p "总结"。
CI 自动更新(复制到 .github/workflows/openwiki-update.yml):
on:
schedule:
- cron: "0 8 * * *"
jobs:
update:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with: { node-version: "22" }
- run: npm install --global openwiki
- run: openwiki --update --print
env:
OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
OPENWIKI_MODEL_ID: z-ai/glm-5.2
- uses: peter-evans/create-pull-request@v7
with:
add-paths: openwiki
branch: openwiki/update
title: "docs: update OpenWiki"不直接写 main,提 PR 走审查。GitLabCI 模板在官方 examples/。
项目 | Stars | 定位 | 给谁看 | 核心差异 |
|---|---|---|---|---|
OpenWiki | ~10K | Agent 文档生成 | AI Agent | 轻量、LangChain 背书、Agent 生态整合 |
DeepWiki-Open | 17K | Wiki 页面生成 | 人类 | 页面美观可交互 |
GitNexus | 43K | 知识图谱索引 | AI Agent | MCP 协议,Agent 动态探索而非读文档 |
ai-doc-gen | 734 | 多智能体文档 | 人类+Agent | Python 生态,GitLab 集成 |
GitNexus 跟 OpenWiki 可互补——前者让 Agent 动态探索代码结构,后者让 Agent 先读静态文档。
npm install 即用。装一个跑下你熟悉的项目,感受最直接。当前 107 个 open issues 还很粗糙,但 5 天 4 版的迭代速度,大概率会成为 AI 工程标配。