File Indexer

Fast metadata-based file catalog. No content indexed — only filenames, sizes, dates, and extensions.

Usage

想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

# Build/rebuild the index (run once, or periodically)
python3 scripts/indexer.py --rebuild

# Update incrementally (fast — adds new, removes deleted)
python3 scripts/indexer.py --update

# Search by filename
python3 scripts/indexer.py --search "budget"

# Filter by extension
python3 scripts/indexer.py --search "report" --ext .pdf

# Filter by size
python3 scripts/indexer.py --search "" --min-size 10485760   # > 10MB

# Filter by date
python3 scripts/indexer.py --search "" --after 2026-03-01

# Index statistics
python3 scripts/indexer.py --stats

Security

• ALLOWED_ROOTS: Only ~/Documenti and ~/Scaricati — same as RAG
• BLOCKED_DIRS: .ssh, .gnupg, .config, credentials, .local, .cache, .Trash
• Zero content: Only metadata (name, size, date, extension) — never reads file contents
• No secrets: Paths to sensitive dirs are never indexed
• Local only: SQLite DB at ~/.local/share/file-indexer/catalog.db

What Gets Indexed

Automation

Add to cron or heartbeat for periodic updates:

python3 scripts/indexer.py --update

Works well alongside local-rag: use this for "where is that file?" and RAG for "what does that file say?"

質量很好。功能實用、執行穩定，搜尋速度快，安全性設計周全，能有效保護隱私。文件清晰易懂，對使用場景的劃分很明確。不過目前只能索引兩個固定資料夾，靈活度稍差；另外目前只支援英文和義大利語指令，希望後續能加上中文支援。