会自我维护的 wiki——Agent 写给 Agent 读的代码库记忆，2.5 个月 16k stars
更新于 2026-09-06
← 返回汇总文档不再过期，因为 Agent 盯着源码
LangChain 官方的 CLI：Agent 读你的代码库，合成一份链接互引的 Markdown wiki，源码一变就自动维护。杀手锏是 Grounded Claims——每条事实性描述都锚定到版本化的源码证据（精确到行号），证据一动就知道哪些说法要重写。wiki 既是人的可浏览站点（交互式节点图），更是 Agent 的持久记忆（自动维护 AGENTS.md/CLAUDE.md 指路）。基于 DeepAgents 构建，13 个模型提供商、9 个知识连接器、四种编码 Agent 集成，CI 定时开 docs PR。适合所有「文档永远追不上代码」的团队。
数据来源：GitHub API，采集于 2026-09-06。MIT 协议；基于 langchain-ai/deepagentsjs 构建；Trendshift 热榜常客；144 open issues。
代码天天变，文档靠人肉同步——写下的那一刻就开始腐烂。三个月后新人读到的文档描述的是一个不存在的系统。
让 LLM「给这个仓库写文档」，产出一次即定——两周后代码变了，文档不仅过期，还没有任何机制知道哪些话已经错了。
OpenWiki 对两个死因各给一刀：CI 定时重写解决维护（Agent 盯 diff，无变化不烧 token），Grounded Claims 解决「不知道哪错了」（每句话锚定证据，证据动则句子亮红灯）。
openwiki/.run.json 检查点记录进行中的 run 与进度——CI 跑一半挂了，重跑接着来，不推倒重来openwiki_begin / submit_plan / next_page / submit_page / finish 暴露为工具调用，宿主只提交稀疏的 Claim 决策| Code 模式（默认） | Personal 模式 | |
|---|---|---|
| 文档对象 | 当前仓库 | 你连接的一切知识源 |
| 写入位置 | 仓库内 openwiki/ | ~/.openwiki/wiki |
| 启动 | openwiki --init / --update | openwiki personal --init |
| 知识源 | 仓库源码+测试（+LangSmith trace） | 9 个连接器：Notion · Slack · Gmail · X · Web Search · HN · git 仓库 · Custom MCP（只读白名单） |
| Claims | ✓ 版本化源码证据 | —（连接器来源暂不 Claim） |
| 用途 | 新员工上手 / Agent 记忆 / 架构导览 | 个人第二大脑：自动从邮箱/Notion/时间线合成知识 |
连接器细节见诚意：X 走 OAuth+PKCE、Slack 提供 ngrok 隧道命令解决 OAuth 回调、每个连接器可配多实例（web-search-1 查 AI 研究、web-search-2 追 NBA）。
openwiki/<version>openwiki visualize # 127.0.0.1 交互式节点图 # + 并排 Markdown 阅读器 # 编辑实时热载 openwiki visualize openwiki \ --export docs/ # 导出静态站 → GitHub Pages
节点图探索 wiki 结构、并排读原文——「built for agents, explored by humans」的后半句。
| 提供商 | 凭证方式 | 亮点 |
|---|---|---|
| OpenAI（默认 gpt-5.6-terra） | API key | Responses API 路由工具调用 |
| OpenAI（ChatGPT 登录） | 浏览器 OAuth | 直接烧你的 Plus/Pro 订阅额度，token 自动刷新 |
| Anthropic / Gemini / Bedrock | key / IAM | Bedrock 走 IAM 链（含 OIDC/角色），支持推理 profile |
| GitHub Copilot | gh CLI 会话 | 复用 Copilot 订阅，企业零新增成本 |
| Gemini Enterprise (Vertex) | Google ADC 无密钥 | Model Garden 全目录含 Claude/Llama/DeepSeek |
| OpenRouter / Nebius / Fireworks / Baseten / NVIDIA | provider key | 主流托管全接 |
| OpenAI 兼容 | base URL + key | Ollama / LM Studio / LiteLLM 本地模型；流式网关有开关 |
所有凭证存 ~/.openwiki/.env 本地；CI 场景走仓库 secret。编码 Agent 集成模式甚至完全不需要 OpenWiki 的凭证（用宿主会话）。
| 维度 | 评分 | 依据 |
|---|---|---|
| 问题价值 | 文档腐烂 + AI 文档不可信是全行业痛点 | |
| 核心创新 | Grounded Claims 把「文档正确性」变成可机检命题 | |
| 工程完成度 | 可恢复队列/证据版本化/OKF/图验证降级，处处打磨 | |
| 生态位 | LangChain 官方 + deepagents + Agent memory 卡位 | |
| 成熟度 | 2.5 个月，OKF 生态与连接器深度待长 |
综合 9/10。「Agent 时代文档长什么样」的标杆答案——文档从给人读的静态物，变成有证据链、会自我修复、供 Agent 取用的活记忆。LangChain 官方下场，可能定义这个品类。
亲手体验 Grounded Claims：改几行「源码」，实时看每条 wiki 主张如何被判定——fresh（证据未动）、stale（证据行被改）、retired（证据消失）。证据锚定与漂移判定的完整逻辑，全部可玩。
进入 Playground →