Skip to main content

​
Cách 1 — Search.command / Search.bat (cho người mới)

Double-click setup/Search.command trong Finder.Terminal mở, gõ truy vấn tiếng Việt rồi Enter:
Nhập truy vấn: phong cảnh núi
Top 5 kết quả khớp ngữ nghĩa nhất sẽ hiển thị, kèm path file và score.
Double-click setup\Search.bat.Terminal mở, gõ truy vấn tiếng Việt rồi Enter:
Nhap truy van: phong canh nui
Nếu chữ vỡ font, đảm bảo terminal đang ở UTF-8 (chcp 65001).

​
Cách 2 — CLI search (dev, có filter)

.venv/bin/python -m tools.asset_index.search "phong cảnh núi" --top 5

​
Cờ thường dùng

CờVai tròVí dụ
--top NSố kết quả trả về (mặc định 5)--top 10
--media TYPELọc theo media type--media image / video / audio
--source SOURCELọc theo source--source raw_assets / jobs
--job JOB_IDChỉ tìm trong 1 job cụ thể--job 2026-04-25_001_test

​
Ví dụ

.venv/bin/python -m tools.asset_index.search "người đang nói chuyện" \
  --media image \
  --top 10

.venv/bin/python -m tools.asset_index.search "cảnh quay drone" \
  --media video \
  --source jobs \
  --job 2026-04-25_001_test

.venv/bin/python -m tools.asset_index.search "nhạc buồn" \
  --media audio \
  --source raw_assets \
  --top 3

​
Cách 3 — Python API (cho skill khác gọi)

from tools.asset_index.search import search_assets

results = search_assets(
    query="phong cảnh núi mùa thu",
    top_k=5,
    media_type="image",        # hoặc "video", "audio", None
    source="raw_assets",       # hoặc "jobs", None
)

for r in results:
    print(r.path, r.score, r.description)

​
Tips để query hiệu quả

Query càng cụ thể càng tốt. So sánh:
  • ❌ “ảnh đẹp” — quá chung, score thấp
  • ✅ “phong cảnh núi tuyết hoàng hôn” — match cao
Có thể query bằng tiếng Anh, mô hình embedding multilingual.
Score càng cao càng giống. Score < 0.5 thường là noise — nên ignore.

​
Bước tiếp theo

Kiểm tra trạng thái

Watcher đang chạy không, đã index bao nhiêu file.