Git 自动同步说明

摘要:如果你在提交历史里见过大量”chore: 自动同步 2026-xx-xx xx:xx:xx”的记录,那就是 obsidian-git 插件在工作。这篇讲它具体做了什么、备份机制是怎样的,帮助理解知识库的版本历史是怎么来的。

这个插件在做什么

obsidian-git 插件会把整个知识库当作一个 Git 仓库来管理,每次你修改、新建笔记,它都会在后台按设定的时间间隔自动提交(commit)一次改动,提交信息统一是”chore: 自动同步 + 时间戳”格式。

本知识库配置的自动提交间隔是 10 分钟(如果这段时间内有文件变化)。这意味着:

  • 你不需要手动保存或手动提交,插件会定期自动帮你把改动记录下来
  • 知识库的完整修改历史都能在 Git 提交记录里查到,理论上任何误删、误改都可以找回

当前是否会自动推送到远程仓库

不会。本知识库把”自动推送”(auto push)关闭了,只做本地自动提交。这意味着:

  • 你的每次改动会先在本地留下一条 Git 记录
  • 但不会自动同步给团队其他人,需要有人手动执行推送(push)操作,才会让改动出现在共享的远程仓库里

如果不清楚知识库的同步机制具体是怎么设置的(谁负责推送、多久推送一次),建议直接询问知识库维护者,不要自行改动 Git 相关设置。

为什么知道这个有用

  • 看到”chore: 自动同步”的提交记录,知道这是插件自动生成的,不用疑惑”这是谁改的”
  • 如果发现自己的笔记内容”不见了”,可以通过查看 Git 历史找回之前的版本(找知识库维护者协助操作,避免自己在不熟悉的情况下执行 Git 命令导致进一步问题)
  • 理解”本地已保存”和”团队都能看到”是两件不完全同步的事,重要更新完成后最好和维护者确认一下是否已经同步给大家

与本知识库的关联

  • 遇到误删、找不回内容的情况,联系知识库维护者协助从 Git 历史恢复,不要自行尝试 Git 命令行操作