memory-sync-abc
多台电脑(家里 / 公司)各有一个 Obsidian 记忆库时,用一个私有 GitHub 仓库做「最新并集」中转,实现双向同步。覆盖白名单 gitignore 设计、代理环境下 git 协议不通时改用 GitHub API 推送、PAT 的安全取法、以及"判断线上状态先查远端不信本地"的原则。
SKILL.mdmemory-sync-abc/SKILL.md
GitHub三库记忆同步(A / B / C)
何时用
- 用户在两台及以上电脑上维护同一个知识库 / 记忆库
- 需要跨设备接续同一条主线(求职、项目、写作)
- git 协议被代理 / GFW 挡住,推不上去
架构
| 标记 | 位置 | 角色 |
|---|---|---|
| A | 家里电脑 Obsidian vault | 主库之一 |
| B | GitHub 私有仓库 | A 与 C 的最新并集,只增不删 |
| C | 公司电脑 vault | 主库之一 |
核心原则:只增不删,更新而非覆盖。两边各自往 B 推,需要时从 B 拉。
标准流程
1. 白名单式 .gitignore(必须)
私有仓库里只放「记忆类 md」,其他一律不进:
/*
!/.gitignore
!/.gitattributes
!/README.md
!/*.md
!/00_Inbox不知/
!/00_Inbox不知/**
!/01_Projects/
!/01_Projects/**
!/02_Areas/
/02_Areas/* # 先排除全部
!/02_Areas/<需要的子目录>/ # 再逐个放行
!/02_Areas/<需要的子目录>/**
不放进仓库的:.obsidian/、.git/、附件与大文件(视频 376MB / 归档 179MB / 资源 114MB)、凭据、公司资料。
2. 取 PAT(不落盘)
printf "protocol=https\nhost=github.com\n\n" | git credential fill
从输出里取 password= 的值,用完即删,绝不写进脚本或仓库。
3. git 协议不通时改用 GitHub API
现象:私仓 git push 必挂(CONNECT tunnel failed, response 502),公仓却正常。
解法:用 Git Data API 走 HTTP 单次提交——建 blob → 建 tree → 建 commit → 更新 ref:
POST /repos/{repo}/git/blobs {"content": base64, "encoding": "base64"}
POST /repos/{repo}/git/trees {"base_tree": <head tree>, "tree": [...]}
POST /repos/{repo}/git/commits {"message": ..., "tree": ..., "parents": [head]}
PATCH /repos/{repo}/git/refs/heads/main {"sha": <new commit>}
⚠️ >1MB 的文件 contents API 不返回 base64(encoding: "none"),
要改用 GET /repos/{repo}/git/blobs/{sha} 取。
4. 拉取(B → 本地)
# 列远端全部文件
GET /repos/{repo}/git/trees/main?recursive=1
# 取单个文件
GET /repos/{repo}/contents/{path}?ref=main
铁律:判断"最新状态"先查远端,别只看本地
- MCP 的
push_files之类不产生本地 commit → 本地git log会骗人 - 两个设备各自都可能刚推过内容 → 本地不是权威
- 需要判断现状时,先查 B 库的最近 commit 与文件清单
⚠️ 入口文档可能过期:曾出现「CURRENT.md 停在 10-07」但真正的现状在另一侧的会话笔记里。 别只看那个写着 CURRENT 的文件,先看最近 commit 改了什么。
Example
用户:「我周末在家聊了很多,帮我把家里的记忆读回来。」
- 查 B 库最近 commit(按时间倒序)→ 定位到对方设备推送的时间点
- 拉那一批新增/修改的 md 到本地缓存目录
- 读完后归并到本地日志:新事实标【事实】+证据来源,冲突项标 ⚠️ 并提问,不并行保留两个值
- 若发现对方记忆里某条与实查不符(如"13 个 skills 实际 12 个"),重新实查再更正,不要沿用
坑位清单
git credential fill的凭据可能被系统清理,需要时重新取- 私有仓库走代理必挂,公仓正常 —— 不要误判成"仓库坏了"
- 两侧都在用同名工具时,笔记里要标清生成于哪台机器(如
C:\Users\<你本机用户名>vsC:\Users\<你本机用户名>),否则事后分不清来源 - 大附件绝不入库,否则 tarball 拉取极慢
隐私与边界
只同步个人记忆类 md。密钥、公司资料、聊天截图原文、他人信息一律不进仓库。 PAT 用完即删,不写进任何脚本或提交。