用途：在桌面、服务器或沙箱环境中安全地引导并操作 Obsidian 知识库，按环境选择最合适的执行方式。
执行顺序：确认仓库后先本地克隆引导，然后依次为本地 Obsidian CLI、本地文件系统/git 回退、GitHub API 回退。
主要能力：本地知识库引导（克隆到 ~/Documents/<repo-name>，配置 Git 与 raw/ 子模块，写入 ~/.config/obsidian-gh-knowledge/config.json）；通过 obsidian 命令进行搜索、读取、创建、追加、移动、删除、任务、标签、属性、模板与日记操作；提供本地包装脚本 scripts/local_obsidian_knowledge.py，支持 doctor、dashboard、review、simplify-review、audit、capture-raw、capture、project-note、organize、sync 等子命令。
使用方式：先确认知识库仓库 URL，再运行 init_local_vault.py 引导；之后按模式选择使用 CLI 或本地 git。CLI 需 Obsidian 桌面版 1.12+ 并在设置中启用命令行界面。
规则与限制：Agent 必须先读后写，笔记需含 ## TL;DR，可视化说明使用 Mermaid；项目操作限定在 5️⃣-Projects/GitHub/<project>/ 内，先读 _Overview.md；raw/inbox 存放原始素材，0️⃣-Inbox 存放已综合的笔记；同步时先 pull/rebase，禁止 force-push main。无头环境应跳过 CLI 直接使用本地或 GitHub 模式。部分 CLI 文档仍显示早期访问措辞。