用途:当 WIKI_STAGED_WRITES=true 时,审核等待人工批准的暂存页面,通过后提升(promote)到正式 wiki 位置;未启用该模式则不可用。
主要能力:通过 obsidian-wiki staging list --json 获取暂存清单(含 staged_path、live_path、kind、staged_revision、live_revision、staged_mtime);支持 /wiki-stage-commit 交互逐项审核、--all 全部接受、--reject-all 全部拒绝、--list 仅列清单。提交新页面用 staging promote --expect-new,更新页面用 --expect-live,拒绝用 staging discard(移入 _raw/rejected-<category>-<page>.md,同名不覆盖)。
使用方式:先用配置解析协议读取 OBSIDIAN_VAULT_PATH 与 WIKI_STAGED_WRITES。提交时需传入 Step 1 得到的修订号,防止基于过期信息覆盖。.patch.md 文件 promote 会拒绝,需人工读取目标页与补丁后合并增删、更新 frontmatter,再 discard 清除队列。冲突时 CLI 以退出码 9 报错且不移动文件,应重新 list 并向用户说明变化后再询问。完成后用 obsidian-wiki memory sync --takeaways 同步索引与热缓存;不要手工编辑 index.md、log.md、hot.md。
适用场景:知识库内容的暂存审批与提交流程。
限制:需开启暂存写入配置;_staging/ 不显示在 Obsidian 图谱视图;暂存文件与正式页面使用同一模板;补丁合并依赖人工判断;资料未提供其他功能、平台或收费信息。