tomevault-io Obsidian Vault Pipeline Skill
概述
此 skill 用于帮助用户运行 Obsidian Vault Pipeline 自动化知识管理流程。
安装
pip install obsidian-vault-pipeline
Vault 位置设置
Pipeline 自动检测 vault 位置（按优先级）：
- 当前工作目录 - 默认使用
cwd - **
--vault-dir参数** - 显式指定 - 环境变量 -
VAULT_DIR
最佳实践：
cd /path/to/my-vault # 进入 vault 目录
ovp --check # 检查环境
ovp --full # 运行完整 pipeline
可用命令
| 命令 | 说明 |
|---|---|
ovp --check |
检查环境配置 |
ovp --init |
初始化配置（交互式） |
ovp --full |
运行完整 pipeline |
ovp-article --process-inbox |
处理 50-Inbox/01-Raw/ 中的文章 |
ovp-evergreen --recent 7 |
提取最近7天的 Evergreen 笔记 |
ovp-moc --scan |
扫描并更新 MOC 索引 |
ovp-quality --recent 7 |
质量检查 |
标准操作流程
1. 首次使用
# 进入 vault 目录
cd my-vault
# 检查环境
ovp --check
# 如果提示未配置，运行初始化
ovp --init
2. 日常处理
# 放入新文章到 50-Inbox/01-Raw/
cp article.md my-vault/50-Inbox/01-Raw/
# 运行 pipeline
ovp --full
3. WIGS 完整性检查
# 5层一致性检查
./60-Logs/scripts/check-consistency.sh
# 自动修复低风险问题
./60-Logs/scripts/repair.sh --auto
配置文件
在 vault 根目录创建 .env：
AUTO_VAULT_API_KEY=your_api_key
AUTO_VAULT_API_BASE=https://api.minimaxi.com/anthropic
AUTO_VAULT_MODEL=minimax/MiniMax-M2.5
触发词映射
| 用户说 | 执行命令 |
|---|---|
| "运行 WIGS 流程" | ./60-Logs/scripts/check-consistency.sh |
| "整理 Obsidian" | ovp --full |
| "处理文章" | ovp-article --process-inbox |
| "提取 Evergreen" | ovp-evergreen --recent 7 |
| "更新 MOC" | ovp-moc --scan |
| "质量检查" | ovp-quality --recent 7 |
| "检查一致性" | ./60-Logs/scripts/check-consistency.sh |
处理流程
50-Inbox/01-Raw/ → ovp-article → 20-Areas/深度解读
20-Areas/ → ovp-evergreen → 10-Knowledge/Evergreen/
20-Areas/ → ovp-moc → 10-Knowledge/Atlas/MOC-*.md
错误处理
| 错误 | 解决方案 |
|---|---|
| API Key 未配置 | ovp --init |
| .env 未找到 | 在 vault 目录创建 .env |
| 找不到 vault | 确保在 vault 目录运行，或用 --vault-dir 指定 |
| 文章未处理 | 检查 50-Inbox/01-Raw/ 是否存在 .md 文件 |
相关仓库
- Template: https://github.com/fakechris/obsidian_vault_pipeline
- Showcase: https://github.com/fakechris/obsidian_vault_showcase
- PyPI: https://pypi.org/project/obsidian-vault-pipeline/
Source: fakechris/obsidian_vault_pipeline — distributed by TomeVault.