Skip to content

README.vi.md

Latest commit

 

History

History
431 lines (316 loc) · 19.7 KB

README.vi.md

File metadata and controls

431 lines (316 loc) · 19.7 KB
Raw

🌐 Đây là bản dịch tự động. Chúng tôi hoan nghênh các đóng góp từ cộng đồng!


Claude-Mem
Vercel OSS Program

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 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.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

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 Nhanh

Cài đặt chỉ với một lệnh duy nhất:

npx claude-mem install

Hoặc cài đặt cho OpenCode:

npx claude-mem install --ide opencode

Hoặc cài đặt cho Antigravity CLI (hướng dẫn cài đặt):

npx claude-mem install --ide antigravity

Hoặc cài đặt từ chợ plugin ngay trong Claude Code:

/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.

Lưu ý: Claude-Mem cũng được phát hành trên npm, nhưng npm install -g claude-mem chỉ cài đặt SDK/thư viện — nó không đăng ký các hook của plugin hay thiết lập dịch vụ worker. Hãy luôn cài đặt qua npx claude-mem install hoặc các lệnh /plugin ở trên.

🦞 OpenClaw Gateway

Cài đặt claude-mem như một plugin bộ nhớ liên tục trên các gateway OpenClaw chỉ với một lệnh duy nhất:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

Trình cài đặt xử lý các phần phụ thuộc, thiết lập plugin, cấu hình nhà cung cấp AI, khởi động worker, và tùy chọn gửi luồng quan sát thời gian thực đến Telegram, Discord, Slack, và nhiều hơn nữa. Xem Hướng Dẫn Tích Hợp OpenClaw để biết chi tiết.

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 URL worker được in ra khi khởi động
  • 💻 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 thông qua API worker hoặc xem tất cả trong web viewer

Tài Liệu

📚 Xem Tài Liệu Đầy Đủ - Duyệt trên trang web chính thức

Bắt Đầu

Thực Hành Tốt Nhất

Kiến Trúc

Cấu Hình & Phát Triển

Cách Hoạt Động

Các Thành Phần Cốt Lõi:

  1. 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts)
  2. Smart Install - Công cụ kiểm tra phụ thuộc được cache (pre-hook script, không phải lifecycle hook)
  3. Worker Service - HTTP API cục bộ với giao diện web viewer và các điểm cuối tìm kiếm, được quản lý bởi Bun
  4. SQLite Database - Lưu trữ các phiên, quan sát, tóm tắt
  5. mem-search Skill - Truy vấn ngôn ngữ tự nhiên với tiết lộ tuần tự
  6. 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.

Công Cụ Tìm Kiếm MCP

Claude-Mem cung cấp tìm kiếm bộ nhớ thông minh thông qua 4 công cụ MCP theo một mô hình quy trình 3 lớp tối ưu về token:

Quy Trình 3 Lớp:

  1. search - Lấy chỉ mục gọn nhẹ kèm ID (~50-100 token/kết quả)
  2. timeline - Lấy ngữ cảnh theo trình tự thời gian xung quanh các kết quả đáng chú ý
  3. get_observations - Chỉ lấy thông tin chi tiết đầy đủ cho các ID đã lọc (~500-1.000 token/kết quả)

Cách Hoạt Động:

  • Claude sử dụng các công cụ MCP để tìm kiếm bộ nhớ của bạn
  • Bắt đầu với search để lấy chỉ mục kết quả
  • Sử dụng timeline để xem những gì đã xảy ra xung quanh các quan sát cụ thể
  • Sử dụng get_observations để lấy thông tin chi tiết đầy đủ cho các ID liên quan
  • Tiết kiệm ~10 lần số token bằng cách lọc trước khi lấy chi tiết

Các Công Cụ MCP Có Sẵn:

  1. search - Tìm kiếm chỉ mục bộ nhớ với truy vấn toàn văn, lọc theo loại/ngày/dự án
  2. timeline - Lấy ngữ cảnh theo trình tự thời gian xung quanh một quan sát hoặc truy vấn cụ thể
  3. get_observations - Lấy thông tin chi tiết quan sát đầy đủ theo ID (luôn nhóm nhiều ID lại)

Ví Dụ Sử Dụng:

// Bước 1: Tìm kiếm để lấy chỉ mục
search(query="authentication bug", type="bugfix", limit=10)

// Bước 2: Xem xét chỉ mục, xác định các ID liên quan (ví dụ: #123, #456)

// Bước 3: Lấy thông tin chi tiết đầy đủ
get_observations(ids=[123, 456])

Xem Hướng Dẫn Công Cụ Tìm Kiếm để biết các ví dụ chi tiết.

Nhánh Phát Hành

Các bản phát hành ổn định được xây dựng từ main và phát hành lên npm. core-dev và community-edge là các nhánh chạy trực tiếp từ mã nguồn dành cho các bản sửa lỗi độ tin cậy sớm và các tích hợp cộng đồng. Xem Nhánh Phát Hành để biết luồng nhánh và hướng dẫn chạy phiên bản không ổn định.

Yêu Cầu Hệ Thống

  • Node.js: 20.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)

Lưu Ý Cài Đặt Trên Windows

Nếu bạn gặp lỗi như:

npm : The term 'npm' is not recognized as the name of a cmdlet

Hãy đảm bảo rằng Node.js và npm đã được cài đặt và thêm vào PATH của bạn. Tải trình cài đặt Node.js mới nhất từ https://nodejs.org và khởi động lại terminal sau khi cài đặt.

Cấu Hình

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.

Cấu Hình Chế Độ & Ngôn Ngữ

Claude-Mem hỗ trợ nhiều chế độ làm việc và ngôn ngữ thông qua cài đặt CLAUDE_MEM_MODE.

Tùy chọn này kiểm soát cả:

  • Hành vi quy trình làm việc (ví dụ: code, chill, investigation)
  • Ngôn ngữ được sử dụng trong các quan sát được tạo ra

Cách Cấu Hình

Chỉnh sửa tệp cài đặt của bạn tại ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

Các chế độ được định nghĩa trong plugin/modes/. Để xem tất cả các chế độ có sẵn cục bộ:

ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/

Các Chế Độ Có Sẵn

Chế Độ Mô Tả
code Chế độ tiếng Anh mặc định
code--zh Chế độ tiếng Trung giản thể
code--ja Chế độ tiếng Nhật

Các chế độ theo ngôn ngữ cụ thể tuân theo mẫu code--[lang] trong đó [lang] là mã ngôn ngữ ISO 639-1 (ví dụ: zh cho tiếng Trung, ja cho tiếng Nhật, es cho tiếng Tây Ban Nha).

Lưu ý: code--zh (tiếng Trung giản thể) đã được tích hợp sẵn — không cần cài đặt thêm hay cập nhật plugin.

Sau Khi Thay Đổi Chế Độ

Khởi động lại Claude Code để áp dụng cấu hình chế độ mới.

Phát Triể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.

Khắc Phục Sự Cố

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.

Báo Cáo Lỗi

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

Đóng Góp

Chúng tôi hoan nghênh các đóng góp! Vui lòng:

  1. Fork repository
  2. Tạo nhánh tính năng
  3. Thực hiện thay đổi của bạn kèm kiểm thử
  4. Cập nhật tài liệu
  5. Gửi Pull Request

Claude-Mem được phát hành từ ba nhánh: main (ổn định), core-dev, và community-edge. Chỉ main được phát hành lên npm; các nhánh còn lại được chạy từ mã nguồn. Xem Nhánh Phát Hành để biết chiến lược và hướng dẫn chạy cục bộ.

Xem Hướng Dẫn Phát Triển để biết quy trình đóng góp.

Giấy Phép

Claude-Mem được cấp phép theo Apache License 2.0.

Chúng tôi chọn Apache-2.0 vì bộ nhớ agentic bền vững nên dễ dàng được tích hợp vào các công cụ dành cho nhà phát triển, các agent cục bộ, máy chủ MCP, hệ thống doanh nghiệp, các nền tảng robot, và các bộ khung agent sản xuất.

Xem tệp LICENSE để biết đầy đủ chi tiết. Xem docs/license.md và docs/ip-boundary.md để biết phạm vi cấp phép và ranh giới mở/thương mại.

Lưu ý về Ragtime: Thư mục ragtime/ được cấp phép theo Apache License 2.0. Xem ragtime/LICENSE để biết chi tiết.

Hỗ Trợ

Được Xây Dựng với Claude Agent SDK | Hoạt Động cùng Claude Code | Được Tạo với TypeScript

Còn CMEM Thì Sao?

CMEM là một token được tạo ra bởi bên thứ ba nhưng được đón nhận chính thức bởi người sáng tạo ra Claude-Mem (Alex Newman, @thedotmack). Token này đóng vai trò là chất xúc tác cộng đồng cho sự phát triển và là phương tiện đưa CMEM đến với các nhà phát triển và người lao động tri thức cần nó nhất.

Official BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3