FirmVault 搜索
从 FirmVault 案例库中通过语义相似度 + 结构化筛选器检索文档。基于 qmd query 和一个 Python 包装器实现,该包装器添加了基于前置元数据的过滤器和案件范围自动检测功能。
何时使用
- “在 Whaley v. Acme 案件中查找 Smith 医生的笔记”
- “显示 2025 年 10 月的所有医疗记录”
- “保险理算员上个月说了什么?”
- “跨案件搜索提及肩袖的手术记录”
- “在当前案件中查找与 State Farm 的所有通信”
- “调出 Acme 事项的法律文件”
如何调用
uv run firmvault_search "<查询文本>" \
[--scope all|case|<slug>] \
[--category medical|legal|insurance|communication] \
[--case <slug>] \
[--date 2025-10-15] \
[--date-range 2025-10-01..2025-10-31] \
[--provider <名称>] \
[--limit 10]
输出是一个 JSON 数组 — 每个命中结果一个对象:
{
"file_path": "/Users/.../FirmVault/cases/<slug>/medical/2025-10-15-dr-smith-visit.md",
"score": 0.87,
"snippet": "患者就诊时表现为...",
"frontmatter_excerpt": {
"case_slug": "whaley-v-acme",
"document_category": "medical",
"document_date": "2025-10-15",
"provider": "Smith 医生诊所",
"document_type": "office_visit_note"
}
}
范围自动检测
如果未提供 --scope,或 --scope=case:
- CLI 会从当前工作目录 (
cwd) 向上查找FirmVault/cases/<slug>/目录。如果找到,搜索会自动限定在该 slug 对应的案件范围内。 - 如果不存在这样的上级目录,搜索会回退到跨案件(所有案件)模式。
使用 --scope=all 强制进行跨案件搜索。使用 --scope=<slug> 明确指定目标案件。
筛选器
--category— 精确匹配document_category(medical|legal|insurance|communication)--case— 精确匹配case_slug(--scope=<slug>的替代选项)--date— 精确匹配document_date(格式:YYYY-MM-DD)--date-range START..END— 包含首尾日期的document_date范围--provider— 对provider/sender/recipient字段进行大小写不敏感的子串匹配--limit— 返回的最大命中数(默认:10)
筛选器在 Python 端针对 Markdown 前置元数据进行后过滤,因此即使未索引的字段也能正常工作。
提示
- 使用读取工具打开排名最高的结果的
file_path,将详细信息展示给用户。 - 对于“查找所有 X”之类的查询,设置
--limit 25或更高,并总结结果。 - 使用
snippet片段进行快速浏览 — 仅在需要时读取完整文件。 - 当位于案件目录内时,省略
--scope即可自动获得案件范围限定的结果。