进阶能力
用 Git 同步工作区，保留独立备份
从查看变更和提交开始，理解 origin、自动同步、冲突策略与附件备份。
Refinex（沉默的老李）读完这篇，你可以
完成一次可检查的本地提交，理解远程同步前的条件和遇到冲突时的处理方式。
开始之前
本机已安装 Git。远程同步还需要你自己的仓库及已经配置好的访问凭据。
先区分保存、提交、同步和备份
| 动作 | 发生了什么 |
|---|---|
| 保存 | 将当前编辑内容写入本地文件。 |
| 提交 | 将选择的变更记录进本地 Git 历史。 |
| 同步 | 与配置的远程仓库交换提交和文件。 |
| 独立备份 | 额外保存可恢复的副本，避免同步删除或仓库故障一起影响所有数据。 |
先完成一次本地提交
打开 Git 面板
如果工作区尚未初始化，面板会提示“初始化 Git 仓库”。确认你希望将当前目录纳入版本管理后再操作。
查看并选择变更
在未暂存区域检查文件和差异，将本次需要保留的文件暂存。不要把密钥、缓存或不准备同步的私人附件一起纳入。
填写提交信息
在“提交信息”中说明这次改动，例如“补充项目计划与本周回顾”，再点击“提交”。这一步记录到本地，并不等于已上传远程。
确认提交结果
查看 Git 状态或日志，确认内容已进入历史。遇到缺少作者身份等错误时，先完成本机 Git 配置再重试。
配置并确认远程仓库
Git Sync 使用当前仓库的 origin remote。“设置 → Git Sync”展示检测到的远程地址，它不是创建 GitHub 仓库或填写登录密码的入口。
通过自己的 Git 工具配置远程仓库与认证。也可以在当前工作区目录的终端中先运行下面的只读命令，核对位置、状态和远程地址。
git rev-parse --show-toplevel
git status
git remote -v设置同步偏好并尝试同步
打开设置中的 Git Sync
确认已检测到本机 Git、当前目录是 Git 仓库，且展示的 origin 地址正确。
选择差异处理策略
不确定如何处理冲突时，保留“放弃”策略：遇到无法自动合并的差异时停止处理，而不是擅自选择本地或远程内容。
启用并检查一次同步
确认文件范围后启用 Git 同步，按需设置同步频率，使用“立即同步”检查当前工作区。该操作会提交、拉取并推送变更，不只是刷新状态。
确认远程结果
查看上次同步时间，再到远程仓库确认预期文件和提交。只有本地提示“已保存”还不能证明远程副本已经更新。
遇到冲突，先停下来核对
出现合并冲突时，先保留当前文件副本，并暂停对同一篇笔记的并发修改。到 Git 面板检查发生差异的文件，需要时使用熟悉的 Git 工具逐项合并。
“本地仓库”和“远程仓库”策略表达了保留哪一侧的偏好。它们不能代替内容审阅；不知道另一侧包含什么时，不要为了消除提示直接切换策略。
- 认证失败：检查远程地址和本机 Git 凭据，而不是把令牌写进笔记或公开 Issue。
- 没有找到 Git 面板入口：在 Git Sync 设置中检查“显示 Git 面板入口”。隐藏入口不代表同步已关闭。
- 跨设备协作：在第二台设备编辑之前先确认已同步，减少同一文件同时修改的机会。
备份整个工作区，而不只是正文
完整工作区包含普通 Markdown、Daily 与隐藏的 .markune 数据。附件、图稿和 Inbox 可能保存在隐藏目录里；迁移时漏掉它们，会留下正文却丢失配套内容。
如果使用 Git 备份，先检查忽略规则、仓库大小限制和哪些附件真正被跟踪。为重要内容保留独立副本，并在另一个位置实际打开、验证恢复结果。AI 会话等工具级数据不一定随工作区一起迁移。