自动化提交仅包含 Markdown 文件的更改到 git 仓库,使用安全暂存,适合笔记快照,不影响代码或二进制文件。

安装

概览

Braingit 是一款专为处理纯 Markdown 文件变更而设计的自动化 Git 提交工具,其核心理念在于通过确定性脚本实现高效、安全的笔记或工作区快照管理。它运行于现有的 Git 仓库中,默认仅关注扩展名为 `.md` 的 Markdown 文件,自动识别这些文件的修改状态,并将其安全地暂存并提交。这种机制特别适用于那些以文本笔记为主的知识库或工作空间,能够精准捕捉思维流的变化,同时完全避免对代码文件或二进制资产的干扰。Braingit 的设计哲学强调简洁与可靠性,确保每次提交都代表一个清晰、可回溯的内容快照,是个人知识管理和轻量级项目协作的理想选择。

核心功能特点

  1. 自动化提交仅包含 Markdown 文件的更改,精准控制提交内容范围
  2. 使用安全暂存机制,确保只有被识别的文件才会被纳入版本控制
  3. 支持自定义文件匹配模式,灵活适应不同命名规范的 Markdown 文件
  4. 提供确定性脚本执行,保证在不同环境下行为一致
  5. 默认退出码为0表示无操作,便于集成到定时任务或工作流中

适用场景

Braingit 最典型的应用场景是个人知识管理系统,例如 Obsidian、Logseq 或其他基于 Git 的笔记工具所生成的仓库。用户可以在日常写作、研究或学习过程中,随时通过 Braingit 快速生成一个‘快照’,记录下当前的知识节点或思考片段,而无需担心误提交代码或图片等无关文件。另一个常见场景是轻量级的项目文档维护,如技术博客的草稿、API 设计说明或会议纪要的实时更新。由于 Braingit 专注于文本内容,它能帮助团队保持文档仓库的整洁,避免非文本资产污染版本历史。此外,结合 OpenClaw 等定时任务工具,Braingit 可被配置为定期自动备份笔记,形成一个自动化的、基于 Git 的个人数字记忆库,极大提升知识沉淀的效率与可追溯性。