📝 Lời Giới Thiệu Ngắn Gọn / Quick Overview

■ TÌM KIẾM TRỰC TIẾP BÊN TRONG KHUNG SOẠN THẢO (IN-EDITOR SEARCH)

🇻🇳 Vietnamese:

► Giới thiệu: SCP 2026++ Advanced Search (In-Editor Tool)

Đã bao giờ bạn chật vật dò tìm một từ khóa bên trong một thẻ Anki siêu dài và chứa đầy mã HTML phức tạp?

● SCP 2026++ Advanced Search chính là giải pháp bạn cần! Đây là tiện ích mang sức mạnh tìm kiếm chuẩn Notepad++ tích hợp trực tiếp vào ngay bên trong khung soạn thảo (Editor) của Anki. Không cần mở cửa sổ phụ, không làm gián đoạn mạch làm việc! Bạn có thể gõ tìm kiếm thời gian thực, trích xuất toàn bộ ngữ cảnh (Find All) và click-để-nhảy chính xác đến từng từ ngay khi đang chỉnh sửa thẻ. Tối ưu tuyệt đối cho văn bản đa ngôn ngữ và đa phương tiện!

🇬🇧 English:

► Introducing: SCP 2026++ Advanced Search (In-Editor Tool)

Struggling to locate specific keywords inside ultra-long, HTML-heavy Anki flashcards?

● SCP 2026++ Advanced Search brings the powerful Notepad++ search experience directly into your Anki Note Editor. No annoying popup windows, no workflow interruptions! Enjoy real-time highlighting, full contextual extraction ("Find All"), and precise click-to-jump navigation right where you type. Perfectly optimized for complex, multilingual, and multimedia-rich notes!

📖 TÀI LIỆU HƯỚNG DẪN SỬ DỤNG (README.md)

• Tên tiện ích: SCP 2026++ Advanced Search
• Tác giả: Dr.TMSS
• Tương thích: Anki 2.1.50+ đến bản mới nhất (25.09+) – Hỗ trợ cả Qt5 & Qt6.

1. Giới thiệu Tổng quan

SCP 2026++ Advanced Search là một hệ thống tìm kiếm nâng cao (Add-on) dành riêng cho khung soạn thảo (Editor) của Anki, được thiết kế theo chuẩn giao diện của Notepad++. Tiện ích này được tối ưu hóa đặc biệt để xử lý các mẫu thẻ có nội dung siêu dài, đa ngôn ngữ, và chứa nhiều thành phần đa phương tiện phức tạp (đặc biệt là hệ thống thẻ Smart Cloze Pro 2026++).

2. Các Tính năng Nổi bật

• Giao diện Tích hợp Nguyên bản (Native Integration): Thanh tìm kiếm trượt ra mượt mà ngay trên khung soạn thảo, không sử dụng cửa sổ popup gây cản trở tầm nhìn. Thuật toán tự động nhận diện Layout giúp giao diện không bao giờ bị vỡ hay chèn ép các thanh công cụ khác.
• Tìm kiếm & Theo dõi Thời gian thực (Live Highlight): Bôi đen từ khóa ngay khi bạn đang gõ.
• Thống kê Đa tầng (Notepad++ Style "Find All"):
  • Thống kê số lượng từ vựng của từng trường (Field) dữ liệu.
  • Đếm chính xác số lượng từ khóa xuất hiện.
  • Trích xuất một đoạn văn cảnh (Snippet) dài xung quanh từ khóa để đọc lướt nhanh mà không cần cuộn trang.
• Điều hướng Nhanh (Quick Jump): Nhấp chuột vào bất kỳ đoạn snippet nào trong bảng thống kê, hệ thống sẽ tự động cuộn và đặt con trỏ chuột đến đúng vị trí đó trong bài.
• Bóc tách HTML Thông minh: Thuật toán dọn dẹp HTML chuẩn doanh nghiệp, giúp tìm kiếm chính xác văn bản mà không bị dính các mã lệnh ẩn của hình ảnh, âm thanh hay thẻ điền khuyết (Cloze).

3. Hướng dẫn Cài đặt (Thủ công)

1. Mở ứng dụng Anki, trên thanh menu chọn Tools (Công cụ) > Add-ons (Tiện ích).
2. Nhấp vào nút View Files (Xem Tệp) ở góc dưới bên phải để mở thư mục addons21.
3. Tạo một thư mục mới có tên: Advanced_Search_SCP2026.
4. Mở thư mục vừa tạo, tạo một tệp văn bản mới và đặt tên chính xác là __init__.py (lưu ý có 2 dấu gạch dưới ở mỗi đầu).
5. Mở tệp __init__.py bằng Notepad, dán toàn bộ mã nguồn python vào và lưu lại.
6. Khởi động lại Anki.

4. Hướng dẫn Sử dụng

1. Kích hoạt: Mở cửa sổ Thêm thẻ (Add) hoặc Duyệt (Browse -> Edit). Bấm tổ hợp phím Ctrl + F hoặc nhấp vào nút "🔍 Tìm (SCP)" trên thanh định dạng.
2. Dò tìm nhanh: Nhập từ khóa vào ô tìm kiếm. Nhấn phím Enter (hoặc nút ↓ Next / ↑ Prev) để nhảy qua lại giữa các kết quả.
3. Thống kê toàn bộ: Nhấn nút "🔎 Find All" để xuất bảng phân tích toàn bộ thẻ. Nhấp đúp vào dòng kết quả trong bảng để di chuyển nhanh tới vị trí văn bản.
4. Đóng: Nhấn phím Esc hoặc nút "✕ Close" để dọn dẹp giao diện và xóa các vùng bôi đen.

⚖️ THỎA THUẬN VÀ TUYÊN BỐ MIỄN TRỪ TRÁCH NHIỆM (DISCLAIMER)

Bằng việc tải xuống, cài đặt và sử dụng mã nguồn/phần mềm "SCP 2026++ Advanced Search" (sau đây gọi tắt là "Phần mềm"), Người dùng mặc nhiên đồng ý và chấp thuận vô điều kiện các điều khoản pháp lý dưới đây:

Điều 1. Cung cấp nguyên trạng (As-Is Basis)

Phần mềm được cung cấp dưới dạng "nguyên trạng" (as is) và "có sẵn" (as available). Tác giả không đưa ra bất kỳ cam kết hay bảo đảm nào, dù tường minh hay ngụ ý, về sự hoàn hảo, tính không có lỗi, hoặc mức độ phù hợp của Phần mềm cho một mục đích cụ thể nằm ngoài thiết kế ban đầu.

Điều 2. Miễn trừ trách nhiệm về Dữ liệu và Thiết bị

Tác giả (TS. Đỗ Đặng Hoàng Ánh) hoàn toàn không chịu trách nhiệm pháp lý đối với bất kỳ tổn thất, thiệt hại, hoặc rủi ro nào phát sinh từ việc sử dụng hoặc không thể sử dụng Phần mềm. Các miễn trừ này bao gồm nhưng không giới hạn ở:

• Mất mát, hỏng hóc hoặc biến dạng cơ sở dữ liệu (Database) của thẻ Anki.
• Lỗi xung đột phần mềm với các Add-on bên thứ ba khác.
• Thiệt hại về thời gian, công sức hoặc các gián đoạn trong quá trình học tập, nghiên cứu.

Điều 3. Trách nhiệm của Người dùng (Khuyến cáo Sao lưu)

Phần mềm có can thiệp trực tiếp vào cấu trúc hiển thị (DOM/Webview) của ứng dụng Anki. Người dùng được khuyến cáo và có trách nhiệm phải sao lưu (Backup) toàn bộ bộ sưu tập dữ liệu (Collection) của mình trước khi cài đặt Phần mềm và duy trì thói quen sao lưu định kỳ trong suốt quá trình sử dụng.

Điều 4. Sở hữu Trí tuệ và Sử dụng

• Hệ thống này được thiết kế dựa trên kiến trúc và nhu cầu đặc thù của mẫu thẻ Smart Cloze Pro 2026++.
• Mọi quyền sở hữu trí tuệ liên quan đến giao diện tùy biến, thuật toán bóc tách dữ liệu tích hợp trong mã nguồn này thuộc về tác giả.
• Người dùng được quyền sử dụng nội bộ cho mục đích học tập cá nhân. Nghiêm cấm mọi hành vi sao chép mã nguồn, chỉnh sửa tên tác giả để phân phối lại nhằm mục đích thương mại hóa khi chưa có sự đồng ý bằng văn bản.

Sự tiếp tục lưu trữ và kích hoạt Phần mềm này trên hệ thống của bạn cấu thành việc bạn đã đọc, hiểu và chấp nhận toàn bộ các điều khoản của Thỏa thuận Miễn trừ Trách nhiệm này.