我厌倦了 AI 文件搞乱我的仓库——于是我构建了这个 CLI
发布: (2026年3月17日 GMT+8 19:02)
3 分钟阅读
原文: Dev.to
Source: Dev.to
问题
在编码时使用 AI 工具,许多项目会累积各种临时或 AI 生成的文件:
notes.md
final-notes.md
prompt-final-final.md
temp.md
这些文件可能有用,但它们不应该出现在仓库中。忽略它们会让仓库变得凌乱,提交它们又会让历史变得杂乱。结果要么是噪声满天,要么是有用的笔记丢失。
介绍 ccv(Claude Code Vault)
ccv 是一个小型 CLI,能够将所有私有的、与 AI 相关的文件统一存放在仓库之外的保险库中。
- 无仓库存储:
~/.ccv/ - 项目专属子文件夹:
~/.ccv/projects/<project-name>/ - 通过项目内的符号链接透明访问
示例布局
.project-docs/notes.md → ~/.ccv/projects/my-project/notes.md
功能
- 为 AI 生成的笔记、提示集合、调试实验、架构草案等提供独立存储。
- 保持仓库整洁,同时保留所有有用文件。
- 支持多个项目共用。
- 文件仍然保存在本地,若需要仍可使用 Git 进行版本控制。
- 简单的命令集:
# 为当前项目初始化保险库
ccv init
# 将文件添加到保险库(在项目中创建符号链接)
ccv add notes.md
# 将更改推送到保险库(可选的同步步骤)
ccv push
为什么有帮助
- 消除工作流中的持续烦恼。
- 在实际代码和辅助 AI 文件之间提供清晰的分离。
- 让 AI 工具(Claude 或其他)能够读取这些文件,而无需它们成为仓库的一部分。
入门
- 仓库:
- 免费使用。
如果该工具为你节省了时间或提升了工作流,欢迎考虑支持作者:
没有花哨的东西——只是一个让日常工作流更清爽的实用方法。