SuperAPI AI 工具集

obsidian-search

办公与效率

查看项目

更新于 10-16 02:32

技能介绍

用途:在 Obsidian 库中查找 Markdown 笔记与任务,无需把整个库载入上下文。

主要能力与路由:主题/模糊/“关于 X 的笔记”走 scripts/meili_search.py,基于 Meilisearch 索引做容错全文检索,适合记不住确切词时使用;精确内容、frontmatter、标签、任务符号用直接 rg;自然语言日期、逾期比较、CJK 词提取用 scripts/vault_search.py。若 Meilisearch 不可达或未配置(脚本非零退出),回退到第 2–3 层,它们只需本地库。

环境变量:OBSIDIAN_VAULT(库根)、MEILI_URL(默认 http://127.0.0.1:7700)、MEILI_SEARCH_KEY(文件回退 ~/meilisearch/search-key.txt)、MEILI_INDEX(默认 notes)。

用法示例:uv run scripts/meili_search.py "spaced repetition" --limit 5 --fields "title,path";uv run scripts/meili_search.py "prompt caching" --filter "tags=ai" --sort "updated:desc" --json;uv run scripts/vault_search.py "recent week psychology";uv run scripts/vault_search.py "overdue tasks";uv run scripts/vault_search.py "找3-2-1技巧" --raw。命中 path 为库相对路径,需与 $OBSIDIAN_VAULT 拼接后打开。

直接模式:rg "keyword" --glob "*.md" "$OBSIDIAN_VAULT";标签、created 月份、任务日期与优先级可用 rg 匹配。

限制与说明:created: YYYY-MM-DD frontmatter 驱动日期,vault_search.py 回退到文件 mtime;任务标记(Tasks 插件)为 📅 截止、🛫 开始、⏳ 计划、⏫/🔼/🔽 优先级;同义词扩展由智能体负责,脚本不做。不要将原始命中直接倒入上下文,应使用 --fields 和较小的 --limit。