用途:在 Obsidian 笔记库中按语义查找笔记,或用 SQL 查询 frontmatter 元数据,替代部分 Dataview 功能。
主要能力:search.py 提供语义搜索,支持 --query、--n-results、--folder 前缀过滤、--where 元数据 SQL 条件与 --db-path,输出可读结果与 JSON。dataview.py 直接执行 SQL,提供 notes 表的 path、folder、filename、title、modified,以及 status、priority、due、scheduled、tags、projects、contexts 等 frontmatter 字段,还有 ticker、strategy、expiry 等投资字段,支持 table 或 json 输出。index.py 负责增量或全量重建索引,并可用 --stats 查看统计。
使用方式:技能依赖指定 Python 解释器 /Users/roasbeef/vault/.claude/venv/bin/python,需要 sqlite-vec 与 chromadb 包;数据库默认位于 .claude/vault_search/vault.db,包含 notes 与 vec_chunks 两张表。典型命令如 python scripts/search.py --query "options trading strategies" --n-results 5、python scripts/dataview.py --sql "SELECT path, due, priority FROM notes WHERE status = 'open' AND due < date('now', '+7 days') ORDER BY due"、python scripts/index.py --vault-path /Users/roasbeef/vault --rebuild。文件大量变动、结果过期或批量导入后可用 /vault-index 重建索引。
适用场景:查找与某主题相关的笔记、列任务、按状态或到期日过滤、聚合计数、构建看板,以及“查找关于 X 且为未完成任务”这类组合查询。
限制:嵌入使用 ChromaDB 默认的 ONNX MiniLM(384 维),分块按 Markdown 标题进行;.obsidian、.smart-env、.claude、assets、Templates 目录被排除。文档未提供收费、平台与效果等更多信息。