Obsidian 知识库同步（Vault-first）

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

核心策略

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

目录与映射维护（重点）

统一通过 <REDACTED_FILE> 维护目录映射。

每行格式：

<repo_path>|<vault_relative_path>

示例：

<REDACTED_ENTRY>
<REDACTED_ENTRY>
<REDACTED_ENTRY>

说明：

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

默认目录

• Vault 根：<REDACTED_PATH>
• 知识根：<REDACTED_PATH>/20 Sources/MOM Knowledge

你可以按需改：

./<REDACTED_SCRIPT> --vault-root "<REDACTED_PATH>"
./<REDACTED_SCRIPT> --vault-knowledge-root "<REDACTED_PATH>/20 Sources/MOM Knowledge"

常用命令

# 1) 预览发布（Obsidian -> repo）
./<REDACTED_SCRIPT> --dry-run

# 2) 执行发布（Obsidian -> repo）
./<REDACTED_SCRIPT>

# 3) 预览补种（repo -> Obsidian）
./<REDACTED_SCRIPT> --bootstrap --dry-run

# 4) 执行补种（repo -> Obsidian）
./<REDACTED_SCRIPT> --bootstrap

# 5) 不删除目标多余文件
./<REDACTED_SCRIPT> --no-delete

与 MOM Awake 联动

# 发布知识（Obsidian -> repo）
./<REDACTED_SCRIPT> --sync-knowledge

# 预览发布
./<REDACTED_SCRIPT> --sync-knowledge-dry-run

# 从 repo 补种到 Obsidian
./<REDACTED_SCRIPT> --sync-knowledge-bootstrap

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

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

• <REDACTED_FILE>

这个文档建议包含：

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

约定

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