看 GitHub 项目最头疼的一步是读源码目录。想搞清楚一个开源项目怎么工作，得从 README 追到 docs，再从 docs 翻到 issues，运气不好还得自己 clone 下来跑一遍。上周有人给我看了个工具，把这一步省了：输入仓库地址，几分钟后生成一份带目录的 wiki，每个章节都能继续追问。我试了几个仓库，这篇说说它到底能干什么，顺便把原理讲清楚。
它叫 DeepWiki，是做 AI 程序员 Devin 的公司 Cognition 出的免费网站（deepwiki.com）。名字起得很直白：Deep（深挖）+ Wiki（百科）。你把 GitHub 仓库地址贴进去，它用 AI 把整个代码库读一遍，生成一套结构化的文档页面。目前已索引的仓库里，VS Code（192.6k 星）、Hugging Face Transformers（166.2k 星）、Playwright（96.2k 星）都在。
它能做什么
举三个我实际试过的用法。
第一，快速了解陌生项目。我把 Ollama 的仓库喂给它，几分钟后拿到一份完整 wiki：从「Key Concepts」「Command Line Interface」到「Inference Engine」「GPU and Hardware Support」，一共二十多个章节。每段正文下面都标着信息来源，格式是 README.md 第 7 到 10 行、server/routes.go 第 98 到 104 行这样的引用。也就是说它说的每句话都能点回源码验证，这是它跟普通 AI 总结最大的区别。
第二，带着问题追问。每个 wiki 自带对话窗口，可以直接问「Ollama 的 KV Cache 是怎么管理的」「请求调度是怎么做的」，它会基于源码回答，并继续给出文件和行号。相当于给仓库配了一个读过全部代码的答疑助手。
第三，读代码前先看架构。它会给每个项目画架构图和数据流图。比如看 Ollama 那份 wiki 时，先翻架构章节搞清「client-server 模型、ollama serve 管理模型生命周期」这个大框架，再去啃代码，效率高不少。
它怎么做到的
原理不复杂：爬取仓库 → 切分代码文件 → 用大模型分析代码结构和依赖关系 → 生成文档和图表 → 建立可检索的索引。官方的定位是「Think Deep Research for GitHub」。
几个值得知道的点：
- 它对公开仓库免费，热门仓库（比如上面提到的几个）已经预生成了 wiki，打开就有
- 冷门仓库需要现场生成，要等几分钟
- 私有仓库也能分析，需要配套的 Devin 账号授权。没有的话就只分析公开仓库，这点企业用户要注意
- 基于 Cognition 自家的 Devin 模型能力做代码理解，不是简单把 README 喂给 ChatGPT
我特意翻了一下它对 Ollama 的「Last indexed: 9 September 2026」标注，说明 wiki 不是一次性的，仓库更新后可以重新索引。
和传统方式比
跟自己 clone 代码看相比：省了搭环境和翻目录的时间，架构层面的问题（模块怎么分、请求怎么流转）它答得又快又准。但细节逻辑还是得看代码，AI 生成的文档偶尔会有不精确的地方，好在每个结论都带源码引用，点过去核对很方便。
跟 GitHub 官方的 wiki/docs 相比：官方文档是人写的，权威但常常滞后、不全；DeepWiki 是 AI 从代码里现挖的，新且全，但深度解读不如人类维护的文档。
我现在的用法是组合拳：先 DeepWiki 十分钟过一遍架构，有疑问的地方点着源码引用确认，最后才是 clone 下来跑。顺序反了效率会差很多。
跟「让 ChatGPT 总结这个项目」的区别：ChatGPT 不知道你的代码长什么样（除非贴给它），而 DeepWiki 把整个仓库索引成了知识库，追问时答案有据可查。
什么样的人该用
- 做技术选型，想快速评估开源库内部实现的人
- 想给开源项目贡献代码，需要先摸清架构的贡献者
- 带新人的 team lead，直接甩个 DeepWiki 链接比口述架构省事
接手别人的项目、看不懂前辈代码的程序员（最典型场景），搭配一篇 AI 编程助手的实测选择：5款AI编程助手实测对比，读代码和写代码配一套工具就齐了
免费（公开仓库），浏览器打开就能用，建议先拿自己最熟的仓库试一次，看看它对你知道答案的问题回答得准不准，再决定要不要纳入工作流。
最后
AI 辅助读代码这件事，今年明显卷起来了。DeepWiki 这种「仓库进、文档出」的形态，解决的是「看不懂」的问题；至于「看了之后改得对不对」，还是得靠你自己。工具地址：deepwiki.com，Devin 的出品方 Cognition 开发的。想让 AI 直接帮你写代码的，可以看之前那篇 Codex CLI 上手教程，一个管读一个管写。
参考：deepwiki.com 官网及 Ollama、claude-code 仓库的 DeepWiki 页面（含 Last indexed 标注与源码行号引用）。价格与私有仓库支持细节以官方最新说明为准。