openwiki 是什么?

OpenWiki v0.5.2 是本地 CLI 和编码 Agent 集成:为代码库或个人资料生成可版本控制的 Markdown Wiki,并用 Grounded Claims 关联关键事实与源码证据。

⭐ 16,636 Stars 🍴 1,209 Forks TypeScript MIT 作者: langchain-ai
来源:github.com/langchain-ai/openwiki/tree/v0.5.2 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

v0.5.2 发布于 2026-09-15,加入 IBM Bob、Kiro 集成并包含 provider、安全与稳定性修复。OpenWiki v0.5.2 是本地 CLI 和编码 Agent 集成:为代码库或个人资料生成可版本控制的 Markdown Wiki,并用 Grounded Claims 关联关键事实与源码证据。

来源:github.com/langchain-ai/openwiki

核心功能

Grounded Claims

把架构、行为、数据流和安全边界等关键事实关联到版本化源码证据。

来源:github.com/langchain-ai/openwiki/tree/v0.5.2
编码 Agent 集成

支持 Codex、Claude、OpenCode、Cursor、IBM Bob 与 Kiro,使用宿主认证和仓库工具。

来源:github.com/langchain-ai/openwiki/tree/v0.5.2
本地 Markdown 与可视化

Wiki、claims 和运行元数据存入仓库,可用本地可视化器探索。

来源:github.com/langchain-ai/openwiki/tree/v0.5.2

技术架构

Agent 读取仓库、生成页面并把事实证据写入 openwiki/.claims;.run.json 持久化中断状态,完整收尾后删除。个人模式数据默认在 ~/.openwiki。

来源:github.com/langchain-ai/openwiki/tree/v0.5.2

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 模型 provider 或已认证编码 Agent模型 provider… Git 仓库 可选 mermaid/jsdom可选 mermaid/j… Grounded Claims 编码 Agent 集成 本地 Markdown 与可视化 openwiki 项目本体 核心功能 关键依赖

技术栈

语言TypeScript/Node.js >=22.22.0框架Deep Agents + CLI + SQLite/本地 Markdown
模型 provider 或已认证编码 AgentGit 仓库可选 mermaid/jsdom
openwiki/、openwiki/.claims/、openwiki/.run.json、~/.openwiki 或 OPENWIKI_CONFIG_DIR
来源:github.com/langchain-ai/openwiki/blob/v0.5.2/package.json

快速上手

路径一安装 0.5.2 后运行 integrations install codex,重启宿主并在仓库初始化;路径二用 openwiki --init 和 --update 独立运行。两条路径都需审查生成目录与 Claims。
来源:github.com/langchain-ai/openwiki/tree/v0.5.2

使用场景

适合把代码文档与源码证据一起放进 Git,并由 Agent 持续更新;需要自托管团队 Web Wiki 时可评估 DeepWiki Open,敏感仓库则先审计 provider、ignore 与网络。

来源:github.com/langchain-ai/openwiki;https://github.com/AsyncFuncAI/deepw…

优势与局限

优势

  • Markdown 与证据 sidecar 可版本控制
  • Claim 失效会触发页面复核
  • 支持独立 CLI 和多个编码 Agent

局限

  • 生成与更新依赖模型 provider 或宿主
  • ignore 规则不是绝对保密保证
  • 个人 connector 扩大数据与凭证边界
来源:github.com/langchain-ai/openwiki/tree/v0.5.2

最新版本

v0.5.2 发布于 2026-09-15,加入 IBM Bob、Kiro 集成并包含 provider、安全与稳定性修复。

来源:github.com/langchain-ai/openwiki/releases/tag/v0.5.2

实测与证据

status: official_docs_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 静态核对 v0.5.2 release、README、package、Claims、集成、遥测与 CI 说明  |  limitations: 未安装 CLI、调用 provider、生成 Wiki 或测试 connector  |  observed_output: 确认 Node >=22.22、integration/standalone 两条路径、claims/.run.json、OPENWIKI_CONFIG_DIR、telemetry-file 与 CI token 边界

来源:github.com/langchain-ai/openwiki/releases/tag/v0.5.2

同类项目对比

DeepWiki Open 更偏自托管 Web Wiki 和在线问答;OpenWiki 更偏本地 CLI/编码 Agent,Markdown 随代码入库,并用 Claims 维护事实到源码的版本联系。

来源:github.com/AsyncFuncAI/deepwiki-open;https://github.com/langchain-ai/…

总结评价

实际采用时先限制读取范围和 provider,再用 Claim 回链、代码变更触发更新及失败恢复作为验收。

来源:github.com/langchain-ai/openwiki

常见问题

OpenWiki v0.5.2 最少需要什么环境?

官方 npm 包要求 Node.js 22.22.0 或更高版本。独立模式还要配置受支持的模型 provider;编码 Agent 集成可使用宿主已认证的模型和仓库工具。

OpenWiki 能接入 Codex 吗?

可以。运行 openwiki integrations install codex,重启 Codex 后在仓库中要求初始化或更新 OpenWiki。可用 integrations list 检查,用 uninstall 移除;加 --project 可限制在某个仓库。

OpenWiki 的状态和证据放在哪里?

代码 Wiki 写入仓库的 openwiki/,运行中状态在 openwiki/.run.json,Grounded Claims 在 openwiki/.claims/。个人模式的凭证、连接器数据和历史默认在 ~/.openwiki,也可用 OPENWIKI_CONFIG_DIR 改位置。

OpenWiki 会收集代码或提示词吗?

官方说明遥测只含命令、结果、粗粒度错误类别和部分设置元数据,不收集文件内容、仓库名、凭证、提示词、模型输出、路径或 URL。可用 --telemetry-file 预览;敏感环境仍应自行禁网或审计。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件