准备工作
首先需要安装 Obsidian 和 SmartGit。Obsidian 是本地优先的笔记工具，每个仓库都是独立空间，插件配置也互不干扰。建议先在本地创建一个专用文件夹存放所有笔记仓库，例如 D:\Obsidian\docs_notes，方便后续管理。
SmartGit 从 24.1 版本起内置了完整的 Git 客户端和 SSH 功能，无需额外配置 Git 环境即可直接使用。关于授权，软件提供 90 天试用期，非商业用途可申请免费许可证，具体流程参考官方说明。
云端仓库初始化
在 Gitee 上创建一个新仓库。关键点： 创建时不要勾选'初始化仓库'或上传 README，否则会导致后续推送冲突。因为我们需要将本地的完整历史直接推上去，如果远程已有文件，Git 会拒绝快进合并。
本地与云端绑定
打开 SmartGit，添加刚才创建的本地笔记文件夹作为仓库。点击'远程'->'推送到'，选择添加远程地址。回到 Gitee 仓库页面复制克隆链接填入，输入账号密码验证。
确认连接无误后，执行本地提交并推送。如果内容较多，可全选后自定义提交信息再操作。
常见问题处理
如果在推送时遇到 Updates were rejected because the tip of your current branch is behind its remote counterpart 错误，通常是因为远程仓库存在初始文件而本地为空。此时 Git 无法自动合并。
hint: Updates were rejected because the tip of your current branch is behind Done hint: its remote counterpart. If you want to integrate the remote changes, hint: use 'git pull' before pushing again.
执行 git pull origin master 拉取远程更新时，若本地无提交记录，Git 可能不会自动创建跟踪分支，导致推送依然失败。因此，保持两端仓库状态一致是同步成功的关键。解决方法就是确保 Gitee 端仓库是空的，或者手动清空远程仓库后再试。
