三库记忆同步（A / B / C）

何时用

• 用户在两台及以上电脑上维护同一个知识库 / 记忆库
• 需要跨设备接续同一条主线（求职、项目、写作）
• git 协议被代理 / GFW 挡住，推不上去

架构

核心原则：只增不删，更新而非覆盖。两边各自往 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

用户：「我周末在家聊了很多，帮我把家里的记忆读回来。」

1. 查 B 库最近 commit（按时间倒序）→ 定位到对方设备推送的时间点
2. 拉那一批新增/修改的 md 到本地缓存目录
3. 读完后归并到本地日志：新事实标【事实】+证据来源，冲突项标 ⚠️ 并提问，不并行保留两个值
4. 若发现对方记忆里某条与实查不符（如"13 个 skills 实际 12 个"），重新实查再更正，不要沿用

坑位清单

• git credential fill 的凭据可能被系统清理，需要时重新取
• 私有仓库走代理必挂，公仓正常 —— 不要误判成"仓库坏了"
• 两侧都在用同名工具时，笔记里要标清生成于哪台机器（如 C:\Users\<你本机用户名> vs C:\Users\<你本机用户名>），否则事后分不清来源
• 大附件绝不入库，否则 tarball 拉取极慢

隐私与边界

只同步个人记忆类 md。密钥、公司资料、聊天截图原文、他人信息一律不进仓库。 PAT 用完即删，不写进任何脚本或提交。