09/10/2026 · VietTechies · Biên tập
WanderLog là ứng dụng sổ tay dã ngoại nguồn mở ưu tiên lưu trữ cục bộ (local-first) được xây dựng dưới dạng máy chủ Model Context Protocol (MCP), giúp người dùng ghi chép và tìm kiếm các quan sát tự nhiên hoàn toàn trên thiết bị cá nhân. Do nhà phát triển Pranesh Nikhar phát hành theo giấy phép MIT, ứng dụng hỗ trợ những người đi bộ đường dài và xem chim ghi lại các ghi chú giọng nói từ các chuyến dã ngoại, sau đó chuyển đổi chúng thành các nhật ký có cấu trúc và dễ dàng tìm kiếm mà không cần gửi dữ liệu vị trí hay quan sát lên các máy chủ bên thứ ba.
Kiến trúc ưu tiên lưu trữ cục bộ cho hoạt động ngoại tuyến
Hệ thống vận hành dựa trên tập hợp các công cụ nguồn mở chạy trực tiếp trên phần cứng cục bộ thông qua một tệp cơ sở dữ liệu SQLite duy nhất. Khi người dùng ghi lại đoạn ghi âm ngắn trên đường đi, WanderLog sẽ chuyển đổi nội dung lời nói thành các bản ghi JSON có cấu trúc bao gồm thông tin về các chuyến đi dạo, địa điểm và các loài quan sát được. Những bản ghi đã qua xử lý này được lưu trữ trực tiếp trên ổ cứng người dùng cùng các vector nhúng (vector embedding), giúp loại bỏ hoàn toàn nhu cầu đăng ký dịch vụ đám mây hay sử dụng cơ sở dữ liệu bên ngoài.
Tìm kiếm vector và các mô hình xử lý trên thiết bị
WanderLog thực hiện tìm kiếm ngữ nghĩa nhờ mô hình công khai trọng số sentence transformer all-MiniLM-L6-v2, được thực thi cục bộ ngay trong tiến trình thông qua Transformers.js và ONNX Runtime. Mô hình vector nhúng này chỉ chiếm khoảng 23 megabyte dung lượng khi lưu vào bộ nhớ đệm, cho phép tính điểm tương đồng ngoại tuyến. Để giải đáp truy vấn bằng ngôn ngữ tự nhiên và phân tích bản ghi âm, dự án tích hợp với các mô hình ngôn ngữ cục bộ như gemma3:4b của Google thông qua Ollama. Các truy vấn được xếp hạng bằng công thức kết hợp giữa độ tương đồng cosine của vector ở mức 75% và khớp từ khóa ở mức 25%, đồng thời ưu tiên các quan sát gần đây hơn.
Xử lý giọng nói và kiểm soát quyền riêng tư
Để chuyển đổi các bản ghi âm thành văn bản, WanderLog mặc định sử dụng API ElevenLabs Scribe nhưng vẫn cung cấp các cờ thiết lập rõ ràng nhằm quản lý việc lưu trữ dữ liệu. Người dùng muốn hoạt động ngoại tuyến hoàn toàn có thể bỏ qua toàn bộ kết nối mạng bên ngoài bằng cách cung cấp trực tiếp các tệp văn bản đã được chuyển đổi trước thông qua các đối số dòng lệnh. Bên cạnh đó, công cụ còn tích hợp các thuộc tính đo lường từ xa của Sentry để theo dõi khoảng thời gian thực thi mô hình cục bộ, số lượng token sử dụng và các thao tác tìm kiếm mà không làm thay đổi thiết kế lưu trữ cục bộ cốt lõi.
Ảnh minh họa do AI tạo, không phải ảnh tư liệu.
Nguồn: WanderLog: an offline field journal that answers "where did I see that kingfisher last time?"