用途：安全、一致地操作 Obsidian 仓库（vault），支持本地与远端两种环境。
执行模式（严格顺序）：1) 本地 Obsidian CLI 模式（首选），需本地仓库存在且 obsidian CLI 可用；2) 本地文件系统/git 回退，当仓库存在但 CLI 未启用时使用；3) GitHub 模式回退，当本地仓库不可用或被显式禁用时使用。此顺序用于兼容桌面、服务器与沙箱环境。
模式选择：VAULT_DIR 优先取 ~/.config/obsidian-gh-knowledge/config.json 中的 local_vault_path，否则用 ~/Documents/obsidian_vault/。若 VAULT_DIR 存在且 prefer_local 不为 false，则用本地模式；本地模式下仅当 command -v obsidian 成功且 obsidian help 成功时才用官方 CLI。CLI 检查失败则回退本地文件系统/git；本地不可用则用 GitHub 模式。若 obsidian help 输出 Command line interface is not enabled，需在 Obsidian 设置中启用后使用本地回退。
主要能力：搜索与读取（obsidian search/read）、创建与更新（obsidian create/write/append）、移动重命名与删除（obsidian move/delete）、任务/标签/属性/模板/每日笔记（obsidian tasks/tags/properties/templates/daily）。GitHub 模式提供 list、read、search、move、copy、write 命令，脚本路径按 skills/... 等顺序解析，使用 python3 "$SCRIPT_PATH" --repo <owner/repo> <command> [args]。
使用方式：优先在仓库根目录运行；否则用 vault=<name> 指定；文件用 file=<name>（wikilink 解析）或 path=<exact/path.md>。GitHub 模式要求已安装并认证 gh（gh auth status），读写前先 gh repo view <owner/repo> 检查访问权限。写入前先读取，提交保持小而聚焦。
限制与安全规则：禁止强推 main；GitHub 模式始终在特性分支写入并开 PR 审查；不得猜测仓库名。无 GUI 的无头 Linux/容器中通常没有 Obsidian CLI，应直接使用本地文件系统或 GitHub 模式，且常需显式 --repo。路径含 emoji 时必须加引号。若仓库根 list 也失败，应视为权限或账号问题。