用途:对 Obsidian 知识库执行有破坏性的归档、重建与恢复操作,适用于增量修复不合适的整体重启或恢复场景。
三种模式:仅归档(对当前知识库做时间戳快照,不改动内容);归档后重建(先归档,再清空实时知识库内容,交由用户按需重新摄取数据);从归档恢复(先列出可用归档,确认后先归档当前状态再还原所选归档)。归档位于 $OBSIDIAN_VAULT_PATH/_archives/ 下,含各分类目录、index.md、log.md、.manifest.json 及 archive-meta.json。
使用方式:先按 llm-wiki/SKILL.md 的配置解析流程确定 OBSIDIAN_VAULT_PATH 及可选 QMD 设置,读取 .manifest.json 了解现状,并与用户确认模式。重建后由用户自行选择并运行 wiki-status、claude-history-ingest、codex-history-ingest、wiki-ingest 等技能进行重新摄取。QMD 为搜索索引,重建与恢复后需刷新;仅归档为可选。可用时执行 ${QMD_CLI:-qmd} update,必要时再执行 ${QMD_CLI:-qmd} embed,并用 ${QMD_CLI:-qmd} ls "$QMD_WIKI_COLLECTION" 验证;恢复时可用 ${QMD_CLI:-qmd} get "qmd://$QMD_WIKI_COLLECTION/<restored-page>.md" -l 5 校验页面。
限制与安全规则:操作前必须先归档、必须经用户确认方可清空实时知识库,不得自动替用户执行摄取。.obsidian/ 目录不得触碰,除用户明确要求外不得删除归档。若 QMD 刷新失败,不回滚归档、重建或恢复,仅报告失败并保留 Markdown 知识库。若 QMD_WIKI_COLLECTION 未设置或为空则跳过。若 qmd CLI 不可用则报告跳过。具体配置项与项目细节以原始资料为准,未提供处暂未说明。