Obsidian 知识库同步（Vault-first）

用途：把 Obsidian 作为知识主工作台，仓库作为发布镜像与版本管理层。

核心策略

• 主库在 Obsidian：日常编辑、查看、检索都在 Vault 中完成
• 仓库做镜像：需要版本追踪或协作时，再发布回 repo
• 默认模式是 publish（Obsidian -> repo）
• bootstrap（repo -> Obsidian） 只用于首次初始化或补种

目录与映射维护（重点）

统一通过 tools/knowledge-sync.manifest 维护目录映射。

每行格式：

<repo_path>|<vault_relative_path>

示例：

knowledge|10 Knowledge
docs/workflows|20 Workflows
memory|30 Daily Memory

说明：

• 左边是 repo 路径（发布目标）
• 右边是 Obsidian 知识根目录下路径（主编辑位置）

默认目录

• Vault 根：~/Documents/RS
• 知识根：~/Documents/RS/20 Sources/MOM Knowledge

你可以按需改：

./tools/mom-knowledge-sync.sh --vault-root "/path/to/vault"
./tools/mom-knowledge-sync.sh --vault-knowledge-root "/path/to/vault/20 Sources/MOM Knowledge"

常用命令

# 1) 预览发布（Obsidian -> repo）
./tools/mom-knowledge-sync.sh --dry-run

# 2) 执行发布（Obsidian -> repo）
./tools/mom-knowledge-sync.sh

# 3) 预览补种（repo -> Obsidian）
./tools/mom-knowledge-sync.sh --bootstrap --dry-run

# 4) 执行补种（repo -> Obsidian）
./tools/mom-knowledge-sync.sh --bootstrap

# 5) 不删除目标多余文件
./tools/mom-knowledge-sync.sh --no-delete

与 MOM Awake 联动

# 发布知识（Obsidian -> repo）
./tools/mom-awake.sh --sync-knowledge

# 预览发布
./tools/mom-awake.sh --sync-knowledge-dry-run

# 从 repo 补种到 Obsidian
./tools/mom-awake.sh --sync-knowledge-bootstrap

Obsidian 目录维护文档（你要的）

建议在 Vault 内维护一个目录总览，例如：

• 20 Sources/MOM Knowledge/00 MOM OS/Obsidian 目录映射.md

这个文档建议包含：

1. 目录用途（每个一级目录干什么）
2. 与 repo 的映射关系（对应 manifest 行）
3. 命名约定（中英文、日期、标签）
4. 变更记录（谁在什么时候改了目录结构）

约定

• 日常编辑在 Obsidian，不在 repo 直接改镜像文件
• 发布前建议先 --dry-run
• 涉及对外公开内容，先确认再发布