ARTICLE · 1325264
实测一个1.6万星工具:把整个项目喂给AI只需一条命令
实测一个1.6万星工具：把整个项目喂给AI只需一条命令
上个月我写过一篇 markitdown，讲怎么把文档变成 Markdown 喂给模型。那篇底下有人问：文档能喂了，那代码呢？一大坨项目，怎么让 AI 一口气读明白。
这个问题问到了点子上。我平时用各种编程助手，最烦的一件事就是：想让它看清楚一个工程，我得手动把文件一个一个复制进对话，遇到大项目还得挑着贴，怕超长度。后来发现一个叫 gitingest 的小东西，专门干这件事，而且免费、本地跑、不烧任何额度。我昨晚在 Windows 10 上真装真跑了一遍，把过程和坑都记下来。
先说装。开一个干净的 Python 3.10 虚拟环境，一行命令：pip install gitingest。我看着它装完，报出来 30 个包，前后 16 秒，整个环境占 46MB。没有编译错误，没让我补装任何东西，也没弹窗要我登录或者填 key。这个仓库叫 coderamp-labs/gitingest，1.6 万星、1210 个 fork，MIT 许可，上个月底还在更新。一个这么受欢迎的工具，体积却这么小，我有点意外。
用起来更省事。你把目录路径丢给它，再指定一个输出文件，它就扫一遍，吐出一份纯文本：gitingest /path/to/repo -o digest.txt。我拿手头一个目录实测，4 个文件，它标出预估 267 个 token，整个过程大概 5 毫秒，出来的文件 1158 字节。第一次跑我以为它没动，看输出才发现是真的，快到没脾气。
它吐出来的内容长什么样，我直接讲。开头是一棵目录树，把你的文件结构画清楚；接着按文件把内容原样贴进去；最后附一行预估 token 数。你把这整段丢进任意对话，模型就相当于拿到了整个项目的文字版。我还特意建了个最小样例，里面写了带中文注释的 Python 代码，它也照常读出来，一个字没丢。
最妙的用法藏在名字里。它的官网 gitingest.com 做了一个取巧的事：你只要把任意 GitHub 链接里的 hub 换成 ingest，比如把 github.com/某用户/某仓库改成 gitingest.com/某用户/某仓库，网页直接给你一份可复制的文本块。这意味着你连装都不用装，点一下链接就能拿到一份喂料。我试了，确实能出。
坑我也踩实了，四个。
第一个，误判二进制。我手头几份中文 Markdown 喂进去，它直接标成 [Binary file]，内容整段跳过。我第一反应是文件坏了，新建一份同样内容的文件再跑，却正常读出来了。后来查明白，是它的编码探测在某些中文 UTF-8 文件上会翻车。命令行里加 -i 强制后缀也没用，这个开关救不回被它判成二进制的文件。正经的解法是先把文件存成干净、无 BOM 的 UTF-8，或者干脆走它的 Python API 直接指定文件读。这个不算 bug，但你要是不知道，会以为自己文件有问题。
第二个，它只拼文本，不替你理解。输出是目录树加原文拼接，不是摘要，也不是导读。你把它丢给模型之前，得自己想清楚要问什么。指望它直接给答案的人，会失望。它管的是喂料这一步，后面的理解和回答，是模型的事。
第三个，大仓库 token 爆炸。默认单个文件上限 10MB，你要是把整个项目一气喂进去，轻松几万 token，超过模型上下文就废了。正确的做法是用 -e 把 node_modules、.git 这类排除掉，只留真正要读的源码。我一般只喂我自己写的几层，不连带依赖一起扔。
第四个，私有库要 token。抓 GitHub 链接读私有仓库，得用 -t 参数或者设 GITHUB_TOKEN 环境变量，而且 URL 模式要联网。纯本地目录模式不用联网，这也是我推荐先试本地的原因，既快又不出门。
谁适合装。
经常把代码贴进对话、让模型读仓库的人。你不用再一篇篇手动复制文件，它一次把结构和内容打包好。
接手陌生项目、想让模型快速讲清结构的人。把目录丢进去，比你自己翻半天快得多。
做代码评审、让模型对比改动的人。给它两份状态，它帮你把上下文铺平，你只管问差异。
写技术文档、要给模型整个工程当背景的人。它能把工程全貌压成一段，你再追问细节。
谁别碰。
想克隆并运行仓库的人。它不是 git 客户端，装它不等于能跑项目，该 clone 还 clone。
想要语义摘要的人。它只是文本拼接，理解是模型的事，别指望它替你想。
超大单体仓库。token 撑爆上下文，反而没法用，不如拆着喂。
asset 重的仓库。图片、二进制本就被跳过，它对这种项目没意义。
我现在的用法很固定：要让 AI 读一个我不熟的工程，先跑一遍 gitingest，把文本块丢进去，再开口问。这一步替我省掉的，是反复复制粘贴和挑文件的工夫。46MB 的磁盘占用，换来的是每次都能给模型一份完整上下文，我觉得值。
它和上次写的 markitdown 是一对：一个把文档变 Markdown，一个把项目变喂料，本质都是同一件事，把你的资料整理成模型能吃进去的样子。如果你也天天跟编程助手打交道，这两个都值得装。
拿不准的话，找你手头最小的一个项目试一次，五分钟就能判断它对你有没有用。想看我后续拆哪些能真装真跑的开源工具，关注公众号「弋然小记」，我持续更新。
