前言
用 AI 辅助开发的时候,有一个很高频的需求:
把项目里的某些文件内容,快速整合成一段文字,粘贴给 ChatGPT / Claude / Deepseek 。听起来简单,但实际操作很烦——你要一个个打开文件、复制、粘贴、还要手动标注"这是哪个文件"。项目一大,光这个准备工作就要花好几分所以我写了 Vaultex,一个带 GUI 的小工具,专门干这件事。
编辑
它能做什么
一句话:扫描一个文件夹,把你指定类型的文件合并成一整段文本输出。
具体功能:
📂 可视化选择文件夹
📄 勾选你要的文件类型(.py .md .json 随便选)
🎯 白名单 / 黑名单过滤,精确控制哪些文件夹、哪些文件要包含
📦 文件大小限制,避免把超大文件塞进去
🔁 支持递归扫描或只扫当前层
🔍 先预览文件列表,确认没问题再提取
💾 可以保存输出到本地文件
🤖 Token 数量估算,看看够不够塞进上下文窗口
安装方式
直接 pip 安装:
pip install vaultex
然后运行:
vaultex
就这两行,浏览器 会自动打开 GUI 界面。
(ps:如若没有,请手动复制链接至浏览器)
使用流程
点击 📂 选择你的项目文件夹
勾选你要提取的文件类型,比如只要 .py 文件
展开过滤选项,排除 __pycache__、node_modules 这些没用的目录
点 🔍 Preview 先看一眼文件列表
确认没问题,点 🚀 Extract,内容就合并好了
复制输出,直接粘给 AI,完事。
为什么我觉得它有用
以前我问 AI 帮我看代码,要么截图(AI 看不全),要么一个个复制(太慢),要么直接把整个项目压缩包丢过去(大模型不支持)。Vaultex 解决的就是这个"最后一公里"问题——让你能精准地把"刚好够用"的上下文喂给 AI,不多不少。Token 估算功能也很实用,避免你粘进去之后发现超出上下文限制,白忙一场。
项目地址
GitHub:https://github.com/gongzhijie535-ctrl/vaultex
PyPI:pip install vaultex
欢迎 Star ⭐,有问题或建议也可以直接开 Issue。
谢谢大家前来捧场啦!也希望能够帮到大家❤️
夜雨聆风