FirmVault 搜尋
從 FirmVault 案件語料庫中檢索文件,支援語義相似度比對 + 結構化過濾。底層使用 qmd query 和一個 Python 包裝器,該包裝器增加了基於 frontmatter 的過濾和案件範圍自動偵測。
使用時機
- 「在 Whaley v. Acme 案件中尋找 Dr. 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": "Dr. Smith Clinic",
"document_type": "office_visit_note"
}
}
範圍自動偵測
如果未提供 --scope 或使用 --scope=case:
- CLI 會從當前工作目錄向上尋找
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 frontmatter 進行後過濾,因此未建立索引的欄位也能正常運作。
提示
- 使用 Read 工具讀取頂部結果的
file_path,以便向使用者展示詳細內容。 - 對於「找出所有 X」類型的查詢,可設定
--limit 25或更高,並進行摘要。 - 使用
snippet進行快速瀏覽 — 僅在必要時才讀取完整檔案。 - 當位於案件目錄內時,省略
--scope可自動獲得案件限縮的結果。