Gemini Scribe là plugin Obsidian mã nguồn mở giúp bạn tích hợp sức mạnh AI của Google Gemini (và cả mô hình cục bộ qua Ollama) vào ngay vault ghi chú. Nó không chỉ là chatbot; nó là một AI agent có thể tìm kiếm, đọc, tạo, chỉnh sửa ghi chú, lập lịch tác vụ và phản ứng với sự kiện vault – biến Obsidian thành trợ lý cá nhân thực thụ dựa trên toàn bộ tri thức bạn đã tích lũy.
Thank you for reading this post, don't forget to subscribe!Những điểm chính
- AI agent chủ động: tìm file, đọc, tạo, sửa, di chuyển, xóa ghi chú với quyền kiểm soát chi tiết và xem trước thay đổi trước khi áp dụng.
- Tích hợp cloud & local: chọn Google Gemini miễn phí hoặc chạy Ollama nội bộ để giữ dữ liệu hoàn toàn offline.
- Tìm kiếm ngữ nghĩa: lập chỉ mục toàn bộ vault, kể cả PDF, tìm kiếm theo ý nghĩa thay vì từ khóa – cực kỳ hữu ích khi bạn quên chính xác từ.
- Tự động hóa thông minh: lên lịch cron, lifecycle hooks cho phép agent chạy nền, xử lý ghi chú mới, tạo báo cáo tự động.
- Kỹ năng mở rộng và dự án: gói kỹ năng theo chuẩn agentskills.io, profile dự án theo thư mục, và hỗ trợ MCP server để mở rộng không giới hạn.
Gemini Scribe là gì và giải quyết vấn đề gì?
Đây là plugin Obsidian được thiết kế để AI hiểu và làm việc trực tiếp trên kho dữ liệu cá nhân của bạn. Thay vì phải copy-paste nội dung qua lại giữa các ứng dụng, Gemini Scribe đọc hiểu vault, dùng các ghi chú làm ngữ cảnh, và thực thi thao tác qua hơn 15 công cụ (search, read, edit, move, delete, web search, deep research…). Nó giải quyết triệt để vấn đề ‘AI không biết gì về ghi chú của tôi’ bằng cách giữ mọi tương tác bên trong Obsidian, dữ liệu không gửi qua bên thứ ba ngoài Google (nếu dùng cloud), và lưu toàn bộ lịch sử dưới dạng markdown trong vault để bạn kiểm soát.
Plugin hỗ trợ hai nhà cung cấp: Google Gemini (cloud) với API key miễn phí, hoặc Ollama (local) cho phép chạy mô hình như llama3.2 hoàn toàn ngoại tuyến. Điều này đồng nghĩa bạn có thể bắt đầu miễn phí với Gemini Flash, hoặc giữ riêng tư tuyệt đối với máy nội bộ. Toàn bộ code nằm tại repository GitHub của Gemini Scribe và được cấp phép MIT.
Những tính năng nổi bật nào khiến Gemini Scribe khác biệt?
Gemini Scribe mang đến một bộ công cụ AI toàn diện chưa từng có trong hệ sinh thái Obsidian: từ agent thao tác vault, tìm kiếm ngữ nghĩa, đến lập lịch và kỹ năng mở rộng. Dưới đây là những điểm nhấn đáng giá nhất.
Agent Mode với Tool Calling
Trái tim của plugin là AI agent có thể gọi công cụ: tìm file theo tên, grep nội dung, đọc file (text, ảnh, PDF, video qua Gemini), tạo/sửa/xóa ghi chú, di chuyển file, tạo thư mục, tìm kiếm web, deep research, và kích hoạt kỹ năng. Tất cả đều có diff review – bạn xem trước thay đổi và duyệt trước khi ghi đè. Hệ thống phân quyền chi tiết: presets (Read only, Cautious, Edit mode, YOLO) hoặc tùy chỉnh từng tool, giúp bạn kiểm soát hoàn toàn.
Tìm kiếm ngữ nghĩa – Semantic Vault Search
Plugin sử dụng Google File Search API để lập chỉ mục vault trong nền. Bạn có thể tìm kiếm bằng ý nghĩa, không cần từ khoá chính xác. Hỗ trợ PDF và đính kèm, với nút tạm dừng/tiếp tục và theo dõi tiến trình. Khi quên mất tiêu đề, chỉ cần mô tả nội dung, agent vẫn tìm ra.
Tự động hóa: Scheduled Tasks & Lifecycle Hooks
Lên lịch chạy agent theo cron hoặc khung giờ cố định – ví dụ: tóm tắt ghi chú mỗi sáng, tạo báo cáo tuần. Hỗ trợ catch-up nếu Obsidian đóng lúc đến giờ chạy. Lifecycle hooks (opt-in) cho phép kích hoạt agent khi file được tạo, sửa, xóa, đổi tên, với bộ lọc glob và giới hạn tốc độ để kiểm soát API cost.
IDE-Style Completions & Custom Prompts
Tính năng gợi ý văn bản theo thời gian thực như IDE, nhấn Tab để chấp nhận. Hỗ trợ hệ thống prompt tùy chỉnh (Handlebars templates), giúp bạn định nghĩa phong cách hoặc quy trình riêng cho từng phiên agent. Kết hợp với Project và Skills, bạn có thể tạo các profile chuyên biệt cho từng thư mục vault.
MCP Server, Background Tasks, Vault Context
Kết nối Model Context Protocol server (stdio/HTTP) để mở rộng thêm công cụ bên ngoài. Deep research và sinh ảnh chạy ngầm dưới dạng background tasks. Tính năng ‘Initialize vault context’ giúp agent nắm tổng quan vault để phản hồi chính xác hơn.
Hướng dẫn cài đặt và sử dụng Gemini Scribe từ A đến Z
Việc cài đặt cực kỳ đơn giản, bạn chỉ cần Obsidian và một API key (hoặc cài Ollama). Dưới đây là các bước cơ bản để bắt đầu.
- Mở Obsidian, vào Settings > Community plugins, tắt Restricted mode, bấm Browse và tìm
Gemini Scribe. Nhấn Install, sau đó Enable. - Lấy API key miễn phí tại Google AI Studio (nếu dùng Gemini cloud). Đối với local, cài Ollama, chạy
ollama pull llama3.2(hoặc mô hình khác). - Vào Settings > Gemini Scribe, chọn Provider là Google Gemini (cloud) hoặc Ollama (local). Dán API key nếu dùng cloud; với Ollama, để ý base URL mặc định
http://localhost:11434. - Cấu hình model: chọn model chat (mặc định gemini-flash-latest), model tóm tắt, và model completions. Các model Gemini được tự động tải về và cache 24h; có nút Refresh nếu Google ra model mới.
- Mở Agent Chat bằng biểu tượng ribbon hoặc command palette (
Gemini Scribe: Open Gemini chat). Chat ngay, agent tự động dùng note hiện tại làm ngữ cảnh. Bạn có thể @mention file để thêm vào context. - Để kích hoạt tính năng nâng cao: bật Enable session history để lưu hội thoại, vào Automation để tạo Scheduled tasks hoặc Lifecycle hooks, và khám phá Projects/Skills từ giao diện.
Lưu ý: nếu dùng Ollama, bạn sẽ thiếu vài tính năng như Google Search, Deep Research, RAG, nhưng vẫn có agent, semantic search (cần cấu hình riêng) và chat offline.
Ai nên dùng Gemini Scribe, ai không nên?
Gemini Scribe lý tưởng cho người xem Obsidian là não bộ thứ hai và muốn AI hiểu biết ngữ cảnh cá nhân sâu sắc: nhà nghiên cứu tổng hợp tài liệu, nhà văn sáng tạo nội dung, developer quản lý knowledge base, người làm dự án cần tự động tổng kết, hoặc bất kỳ ai muốn khai thác vault một cách thông minh. Nếu bạn đã quen dùng Obsidian hàng ngày và có nhiều ghi chú chuyên sâu, plugin này sẽ tiết kiệm hàng giờ tìm kiếm và xử lý thông tin.
Ngược lại, nếu bạn chỉ dùng Obsidian để ghi vài dòng tản mạn, chưa có nhu cầu AI, hoặc vault quá nhỏ (dưới vài trăm note), Gemini Scribe có thể hơi nặng đô. Chi phí API cũng cần cân nhắc nếu bạn lạm dụng agent; tuy nhiên, Google AI Studio có free tier khá hào phóng, và Ollama hoàn toàn miễn phí. Những ai quá lo ngại về quyền riêng tư dữ liệu khi dùng cloud có thể chọn local provider để yên tâm tuyệt đối.
Câu hỏi thường gặp
Gemini Scribe có hỗ trợ mô hình Gemini nào?
Plugin tự động tải danh sách model từ Gemini API (cache 24h), hỗ trợ tất cả model có function calling như gemini-2.0-flash, gemini-2.0-pro… Bạn có thể chọn riêng model cho chat, tóm tắt và completions. Với Ollama, bạn pull model bất kỳ và chọn trong settings.
Plugin có hoạt động offline không?
Có, nếu bạn chọn provider Ollama (local). Lúc đó mọi tương tác chạy trên máy, không cần Internet (trừ khi dùng web search qua API, nhưng tính năng đó chỉ có trên Gemini cloud). Tuy nhiên, một số tính năng như semantic search dùng Google API vẫn cần mạng.
Dữ liệu của tôi có bị gửi ra ngoài không?
Khi dùng Gemini cloud, dữ liệu được gửi trực tiếp từ máy bạn tới Google API, không qua máy chủ trung gian. Với Ollama, dữ liệu hoàn toàn nằm trên máy. Mọi lịch sử chat được lưu trong vault dưới dạng markdown, bạn toàn quyền kiểm soát.
Làm sao để thêm kỹ năng riêng cho agent?
Bạn tạo skill package theo chuẩn agentskills.io và đặt vào thư mục plugin state. Agent tự động phát hiện và kích hoạt khi cần, hoặc bạn dùng tool edit_skill để chỉnh sửa, có diff review.
Sự khác biệt giữa Google Gemini cloud và Ollama là gì?
Cloud Gemini cho phép dùng web search, deep research, sinh ảnh, RAG, và nhúng Google Maps, không cần GPU. Ollama local thì riêng tư, offline, không giới hạn request nhưng thiếu các tính năng trên, và tốc độ phụ thuộc vào phần cứng. Chi tiết so sánh có trong tài liệu ollama-setup.md của plugin.
Kết luận
Gemini Scribe là một trong những plugin AI toàn diện nhất cho Obsidian hiện nay, biến vault thành trợ lý cá nhân biết suy nghĩ và hành động. Từ agent tương tác trực tiếp, tìm kiếm ngữ nghĩa, đến tự động hóa schedule và lifecycle hooks, plugin đáp ứng cả nhu cầu của người dùng cá nhân lẫn chuyên nghiệp. Tải ngay từ Community Plugins và dùng thử – bắt đầu với Gemini Flash miễn phí hoặc cài Ollama để trải nghiệm offline. Đừng quên ghé repo GitHub chính thức để đọc tài liệu chi tiết và đóng góp nếu bạn thấy hữu ích.
