🌐 Đây là bản dịch tự động. Chúng tôi hoan nghênh các đóng góp từ cộng đồng!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Hệ thống nén bộ nhớ liên tục được xây dựng cho Claude Code.
Bắt Đầu Nhanh • Cách Hoạt Động • Công Cụ Tìm Kiếm • Tài Liệu • Cấu Hình • Khắc Phục Sự Cố • Giấy Phép
Claude-Mem duy trì ngữ cảnh liền mạch qua các phiên làm việc bằng cách tự động ghi lại các quan sát về việc sử dụng công cụ, tạo tóm tắt ngữ nghĩa và cung cấp chúng cho các phiên làm việc trong tương lai. Điều này giúp Claude duy trì tính liên tục của kiến thức về các dự án ngay cả sau khi phiên làm việc kết thúc hoặc kết nối lại.
Bắt đầu một phiên Claude Code mới trong terminal và nhập các lệnh sau:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
Khởi động lại Claude Code. Ngữ cảnh từ các phiên trước sẽ tự động xuất hiện trong các phiên mới.
Tính Năng Chính:
- 🧠 Bộ Nhớ Liên Tục - Ngữ cảnh được lưu giữ qua các phiên làm việc
- 📊 Tiết Lộ Tuần Tự - Truy xuất bộ nhớ theo lớp với khả năng hiển thị chi phí token
- 🔍 Tìm Kiếm Theo Kỹ Năng - Truy vấn lịch sử dự án với kỹ năng mem-search
- 🖥️ Giao Diện Web Viewer - Luồng bộ nhớ thời gian thực tại http://localhost:37777
- 💻 Kỹ Năng Claude Desktop - Tìm kiếm bộ nhớ từ các cuộc trò chuyện Claude Desktop
- 🔒 Kiểm Soát Quyền Riêng Tư - Sử dụng thẻ
<private>để loại trừ nội dung nhạy cảm khỏi lưu trữ - ⚙️ Cấu Hình Ngữ Cảnh - Kiểm soát chi tiết về ngữ cảnh được chèn vào
- 🤖 Hoạt Động Tự Động - Không cần can thiệp thủ công
- 🔗 Trích Dẫn - Tham chiếu các quan sát trong quá khứ với ID (truy cập qua http://localhost:37777/api/observation/{id} hoặc xem tất cả trong web viewer tại http://localhost:37777)
- 🧪 Kênh Beta - Dùng thử các tính năng thử nghiệm như Endless Mode thông qua chuyển đổi phiên bản
📚 Xem Tài Liệu Đầy Đủ - Duyệt trên trang web chính thức
- Hướng Dẫn Cài Đặt - Bắt đầu nhanh & cài đặt nâng cao
- Hướng Dẫn Sử Dụng - Cách Claude-Mem hoạt động tự động
- Công Cụ Tìm Kiếm - Truy vấn lịch sử dự án bằng ngôn ngữ tự nhiên
- Tính Năng Beta - Dùng thử các tính năng thử nghiệm như Endless Mode
- Kỹ Thuật Ngữ Cảnh - Các nguyên tắc tối ưu hóa ngữ cảnh cho AI agent
- Tiết Lộ Tuần Tự - Triết lý đằng sau chiến lược chuẩn bị ngữ cảnh của Claude-Mem
- Tổng Quan - Các thành phần hệ thống & luồng dữ liệu
- Phát Triển Kiến Trúc - Hành trình từ v3 đến v5
- Kiến Trúc Hooks - Cách Claude-Mem sử dụng lifecycle hooks
- Tham Chiếu Hooks - Giải thích 7 hook scripts
- Worker Service - HTTP API & quản lý Bun
- Cơ Sở Dữ Liệu - Schema SQLite & tìm kiếm FTS5
- Kiến Trúc Tìm Kiếm - Tìm kiếm kết hợp với cơ sở dữ liệu vector Chroma
- Cấu Hình - Biến môi trường & cài đặt
- Phát Triển - Xây dựng, kiểm thử, đóng góp
- Khắc Phục Sự Cố - Các vấn đề thường gặp & giải pháp
Các Thành Phần Cốt Lõi:
- 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts)
- Smart Install - Công cụ kiểm tra phụ thuộc được cache (pre-hook script, không phải lifecycle hook)
- Worker Service - HTTP API trên cổng 37777 với giao diện web viewer và 10 điểm cuối tìm kiếm, được quản lý bởi Bun
- SQLite Database - Lưu trữ các phiên, quan sát, tóm tắt
- mem-search Skill - Truy vấn ngôn ngữ tự nhiên với tiết lộ tuần tự
- Chroma Vector Database - Tìm kiếm kết hợp ngữ nghĩa + từ khóa để truy xuất ngữ cảnh thông minh
Xem Tổng Quan Kiến Trúc để biết chi tiết.
Claude-Mem cung cấp tìm kiếm thông minh thông qua kỹ năng mem-search tự động kích hoạt khi bạn hỏi về công việc trước đây:
Cách Hoạt Động:
- Chỉ cần hỏi một cách tự nhiên: "Chúng ta đã làm gì trong phiên trước?" hoặc "Chúng ta đã sửa lỗi này trước đây chưa?"
- Claude tự động gọi kỹ năng mem-search để tìm ngữ cảnh liên quan
Các Thao Tác Tìm Kiếm Có Sẵn:
- Search Observations - Tìm kiếm toàn văn trên các quan sát
- Search Sessions - Tìm kiếm toàn văn trên các tóm tắt phiên
- Search Prompts - Tìm kiếm các yêu cầu người dùng thô
- By Concept - Tìm theo thẻ khái niệm (discovery, problem-solution, pattern, v.v.)
- By File - Tìm các quan sát tham chiếu đến các tệp cụ thể
- By Type - Tìm theo loại (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Lấy ngữ cảnh phiên gần đây cho một dự án
- Timeline - Lấy dòng thời gian thống nhất của ngữ cảnh xung quanh một thời điểm cụ thể
- Timeline by Query - Tìm kiếm các quan sát và lấy ngữ cảnh dòng thời gian xung quanh kết quả khớp tốt nhất
- API Help - Lấy tài liệu API tìm kiếm
Ví Dụ Truy Vấn Ngôn Ngữ Tự Nhiên:
"What bugs did we fix last session?" "How did we implement authentication?" "What changes were made to worker-service.ts?" "Show me recent work on this project" "What was happening when we added the viewer UI?"
Xem Hướng Dẫn Công Cụ Tìm Kiếm để biết các ví dụ chi tiết.
Claude-Mem cung cấp kênh beta với các tính năng thử nghiệm như Endless Mode (kiến trúc bộ nhớ sinh học mô phỏng cho các phiên mở rộng). Chuyển đổi giữa các phiên bản ổn định và beta từ giao diện web viewer tại http://localhost:37777 → Settings.
Xem Tài Liệu Tính Năng Beta để biết chi tiết về Endless Mode và cách dùng thử.
- Node.js: 18.0.0 hoặc cao hơn
- Claude Code: Phiên bản mới nhất với hỗ trợ plugin
- Bun: JavaScript runtime và trình quản lý tiến trình (tự động cài đặt nếu thiếu)
- uv: Trình quản lý gói Python cho tìm kiếm vector (tự động cài đặt nếu thiếu)
- SQLite 3: Cho lưu trữ liên tục (đi kèm)
Cài đặt được quản lý trong ~/.claude-mem/settings.json (tự động tạo với giá trị mặc định khi chạy lần đầu). Cấu hình mô hình AI, cổng worker, thư mục dữ liệu, mức độ log và cài đặt chèn ngữ cảnh.
Xem Hướng Dẫn Cấu Hình để biết tất cả các cài đặt và ví dụ có sẵn.
Xem Hướng Dẫn Phát Triển để biết hướng dẫn xây dựng, kiểm thử và quy trình đóng góp.
Nếu gặp sự cố, hãy mô tả vấn đề cho Claude và kỹ năng troubleshoot sẽ tự động chẩn đoán và cung cấp các bản sửa lỗi.
Xem Hướng Dẫn Khắc Phục Sự Cố để biết các vấn đề thường gặp và giải pháp.
Tạo báo cáo lỗi toàn diện với trình tạo tự động:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Chúng tôi hoan nghênh các đóng góp! Vui lòng:
- Fork repository
- Tạo nhánh tính năng
- Thực hiện thay đổi của bạn kèm kiểm thử
- Cập nhật tài liệu
- Gửi Pull Request
Xem Hướng Dẫn Phát Triển để biết quy trình đóng góp.
Dự án này được cấp phép theo GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 Alex Newman (@thedotmack). Bảo lưu mọi quyền.
Xem tệp LICENSE để biết chi tiết đầy đủ.
Điều Này Có Nghĩa Là:
- Bạn có thể sử dụng, sửa đổi và phân phối phần mềm này tự do
- Nếu bạn sửa đổi và triển khai trên máy chủ mạng, bạn phải cung cấp mã nguồn của mình
- Các tác phẩm phái sinh cũng phải được cấp phép theo AGPL-3.0
- KHÔNG CÓ BẢO HÀNH cho phần mềm này
Lưu Ý Về Ragtime: Thư mục ragtime/ được cấp phép riêng theo PolyForm Noncommercial License 1.0.0. Xem ragtime/LICENSE để biết chi tiết.
- Tài Liệu: docs/
- Vấn Đề: GitHub Issues
- Repository: github.com/thedotmack/claude-mem
- Tác Giả: Alex Newman (@thedotmack)
Được Xây Dựng với Claude Agent SDK | Được Hỗ Trợ bởi Claude Code | Được Tạo với TypeScript
