obsidian-wiki-ingest

Obsidian Wiki 导入 — 自动化技能

你是将文档导入 Obsidian wiki 项目的自动化层。此技能负责协调导入工作流，确保去重、正确设置 frontmatter，并与现有页面建立交叉链接。

触发条件

• 用户说“导入到 wiki”“添加到 wiki”，或使用任何指向 obsidian-wiki 仓库的表述。
• 上下文：当前位于 /home/ubuntu/projects/obsidian-wiki 工作区。

职责

• 根据环境变量和清单状态验证目标 vault 路径。
• 根据用户输入或源文件的变更，决定使用 Append、Full 还是 Raw 导入模式。
• 调用 wiki-ingest 工作流处理新增或已修改的源文件。
• 使用导入元数据更新清单和日志文件。
• 按需创建或更新项目概览页面和交叉链接。

输入

• 来自 OBSIDIAN_SOURCES_DIR 或 _raw/ 的源文档（Markdown、PDF、文本、图像）
• 来自 OBSIDIAN_VAULT_PATH 的 vault 路径
• 可选：导入模式（append|full|raw）

输出

• 更新后的 wiki 页面，其中包含提炼后的知识
• 更新后的 .manifest.json 和日志条目
• 可选：新建或更新的项目概览页面

探查与安全

• 不要导入机密或敏感数据。
• 遵循现有页面结构，避免重复内容。
• 使用来源说明标记推断所得或有歧义的知识。

工作流示例（高级）

1. 确定导入模式和目标路径
2. 使用选定模式运行 wiki-ingest
3. 更新清单和日志，并刷新 wiki 索引
4. 简要汇总变更

后续步骤

• 如果你同意，我会创建一个小型封装脚本（scripts/ingest-wiki.sh），用于启动当前项目的导入并更新清单。然后添加一个简单的命令别名，从 CLI 触发此技能。

写入 Vault 后刷新 QMD

QMD 是搜索索引，并非事实来源。如果 $QMD_WIKI_COLLECTION 为空或未设置，请跳过此步骤。仅在此技能写入或重写 vault Markdown 后运行。如果 QMD 刷新失败，不要回滚 vault 变更；请单独报告 QMD 状态。

如果已设置 $QMD_CLI，请使用它；否则使用 qmd。

${QMD_CLI:-qmd} update

如果输出提示需要向量或嵌入可能已过时，请运行：

${QMD_CLI:-qmd} embed

请使用以下任一方式验证集合：

${QMD_CLI:-qmd} ls "$QMD_WIKI_COLLECTION"

或者，在已知特定页面路径时：

${QMD_CLI:-qmd} get "qmd://$QMD_WIKI_COLLECTION/<page>.md" -l 5

记录以下其中一项：

• QMD refreshed: update + embed + verified
• QMD refreshed: update only + verified
• QMD skipped: QMD_WIKI_COLLECTION unset
• QMD skipped: qmd CLI unavailable
• QMD failed: <short error summary>