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

<h1 align="center">
  <br>
  <a href="https://github.com/thedotmack/claude-mem">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-dark-mode.webp">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp" alt="Claude-Mem" width="400">
    </picture>
  </a>
  <br>
  <a href="https://vercel.com/open-source-program">
    <img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
  </a>
</h1>

<p align="center">
  <a href="docs/i18n/README.zh.md">🇨🇳 中文</a> •
  <a href="docs/i18n/README.zh-tw.md">🇹🇼 繁體中文</a> •
  <a href="docs/i18n/README.ja.md">🇯🇵 日本語</a> •
  <a href="docs/i18n/README.pt.md">🇵🇹 Português</a> •
  <a href="docs/i18n/README.pt-br.md">🇧🇷 Português</a> •
  <a href="docs/i18n/README.ko.md">🇰🇷 한국어</a> •
  <a href="docs/i18n/README.es.md">🇪🇸 Español</a> •
  <a href="docs/i18n/README.de.md">🇩🇪 Deutsch</a> •
  <a href="docs/i18n/README.fr.md">🇫🇷 Français</a> •
  <a href="docs/i18n/README.he.md">🇮🇱 עברית</a> •
  <a href="docs/i18n/README.ar.md">🇸🇦 العربية</a> •
  <a href="docs/i18n/README.ru.md">🇷🇺 Русский</a> •
  <a href="docs/i18n/README.pl.md">🇵🇱 Polski</a> •
  <a href="docs/i18n/README.cs.md">🇨🇿 Čeština</a> •
  <a href="docs/i18n/README.nl.md">🇳🇱 Nederlands</a> •
  <a href="docs/i18n/README.tr.md">🇹🇷 Türkçe</a> •
  <a href="docs/i18n/README.uk.md">🇺🇦 Українська</a> •
  <a href="docs/i18n/README.vi.md">🇻🇳 Tiếng Việt</a> •
  <a href="docs/i18n/README.tl.md">🇵🇭 Tagalog</a> •
  <a href="docs/i18n/README.id.md">🇮🇩 Indonesia</a> •
  <a href="docs/i18n/README.th.md">🇹🇭 ไทย</a> •
  <a href="docs/i18n/README.hi.md">🇮🇳 हिन्दी</a> •
  <a href="docs/i18n/README.bn.md">🇧🇩 বাংলা</a> •
  <a href="docs/i18n/README.ur.md">🇵🇰 اردو</a> •
  <a href="docs/i18n/README.ro.md">🇷🇴 Română</a> •
  <a href="docs/i18n/README.sv.md">🇸🇪 Svenska</a> •
  <a href="docs/i18n/README.it.md">🇮🇹 Italiano</a> •
  <a href="docs/i18n/README.el.md">🇬🇷 Ελληνικά</a> •
  <a href="docs/i18n/README.hu.md">🇭🇺 Magyar</a> •
  <a href="docs/i18n/README.fi.md">🇫🇮 Suomi</a> •
  <a href="docs/i18n/README.da.md">🇩🇰 Dansk</a> •
  <a href="docs/i18n/README.no.md">🇳🇴 Norsk</a>
</p>

<h4 align="center">Hệ thống nén bộ nhớ liên tục được xây dựng cho <a href="https://claude.com/claude-code" target="_blank">Claude Code</a>.</h4>

<p align="center">
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/version-13.4.0-green.svg" alt="Version">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg" alt="Node">
  </a>
  <a href="https://github.com/thedotmack/awesome-claude-code">
    <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code">
  </a>
</p>

<p align="center">
  <a href="https://trendshift.io/repositories/15496" target="_blank">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge-dark.svg">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg" alt="thedotmack/claude-mem | Trendshift" width="250" height="55"/>
    </picture>
  </a>
</p>

<br>

<table align="center">
  <tr>
    <td align="center">
      <a href="https://github.com/thedotmack/claude-mem">
        <picture>
          <img
            src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/cm-preview.gif"
            alt="Claude-Mem Preview"
            width="500"
          >
        </picture>
      </a>
    </td>
    <td align="center">
      <a href="https://www.star-history.com/#thedotmack/claude-mem&Date">
        <picture>
          <source
            media="(prefers-color-scheme: dark)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&theme=dark&legend=top-left"
          />
          <source
            media="(prefers-color-scheme: light)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
          />
          <img
            alt="Star History Chart"
            src="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
            width="500"
          />
        </picture>
      </a>
    </td>
  </tr>
</table>

<p align="center">
  <a href="#bắt-đầu-nhanh">Bắt Đầu Nhanh</a> •
  <a href="#cách-hoạt-động">Cách Hoạt Động</a> •
  <a href="#công-cụ-tìm-kiếm-mcp">Công Cụ Tìm Kiếm</a> •
  <a href="#tài-liệu">Tài Liệu</a> •
  <a href="#cấu-hình">Cấu Hình</a> •
  <a href="#khắc-phục-sự-cố">Khắc Phục Sự Cố</a> •
  <a href="#giấy-phép">Giấy Phép</a>
</p>

<p align="center">
  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.
</p>

---

## Bắt Đầu Nhanh

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

```bash
npx claude-mem install
```

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

```bash
npx claude-mem install --ide opencode
```

Hoặc cài đặt cho Antigravity CLI ([hướng dẫn cài đặt](https://docs.claude-mem.ai/antigravity-cli/setup)):

```bash
npx claude-mem install --ide antigravity
```

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

```bash
/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](https://openclaw.ai) chỉ với một lệnh duy nhất:

```bash
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](https://docs.claude-mem.ai/openclaw-integration) để 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 Đủ](https://docs.claude-mem.ai/)** - Duyệt trên trang web chính thức

### Bắt Đầu

- **[Hướng Dẫn Cài Đặt](https://docs.claude-mem.ai/installation)** - Bắt đầu nhanh & cài đặt nâng cao
- **[Hướng Dẫn Sử Dụng](https://docs.claude-mem.ai/usage/getting-started)** - Cách Claude-Mem hoạt động tự động
- **[Công Cụ Tìm Kiếm](https://docs.claude-mem.ai/usage/search-tools)** - Truy vấn lịch sử dự án bằng ngôn ngữ tự nhiên

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

- **[Kỹ Thuật Ngữ Cảnh](https://docs.claude-mem.ai/context-engineering)** - Các nguyên tắc tối ưu hóa ngữ cảnh cho AI agent
- **[Tiết Lộ Tuần Tự](https://docs.claude-mem.ai/progressive-disclosure)** - Triết lý đằng sau chiến lược chuẩn bị ngữ cảnh của Claude-Mem

### Kiến Trúc

- **[Tổng Quan](https://docs.claude-mem.ai/architecture/overview)** - Các thành phần hệ thống & luồng dữ liệu
- **[Phát Triển Kiến Trúc](https://docs.claude-mem.ai/architecture-evolution)** - Hành trình từ v3 đến v5
- **[Kiến Trúc Hooks](https://docs.claude-mem.ai/hooks-architecture)** - Cách Claude-Mem sử dụng lifecycle hooks
- **[Tham Chiếu Hooks](https://docs.claude-mem.ai/architecture/hooks)** - Giải thích 7 hook scripts
- **[Worker Service](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API & quản lý Bun
- **[Cơ Sở Dữ Liệu](https://docs.claude-mem.ai/architecture/database)** - Schema SQLite & tìm kiếm FTS5
- **[Kiến Trúc Tìm Kiếm](https://docs.claude-mem.ai/architecture/search-architecture)** - Tìm kiếm kết hợp với cơ sở dữ liệu vector Chroma

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

- **[Cấu Hình](https://docs.claude-mem.ai/configuration)** - Biến môi trường & cài đặt
- **[Phát Triển](https://docs.claude-mem.ai/development)** - Xây dựng, kiểm thử, đóng góp
- **[Nhánh Phát Hành](https://docs.claude-mem.ai/branches)** - Luồng các nhánh stable, core-dev, và community-edge
- **[Khắc Phục Sự Cố](https://docs.claude-mem.ai/troubleshooting)** - Các vấn đề thường gặp & giải pháp

---

## 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](https://docs.claude-mem.ai/architecture/overview) để 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:**

```typescript
// 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](https://docs.claude-mem.ai/usage/search-tools) để 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](https://docs.claude-mem.ai/branches)**
để 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ư:

```powershell
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](https://docs.claude-mem.ai/configuration)** để 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`:

```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ộ:

```bash
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](https://docs.claude-mem.ai/development)** để 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ố](https://docs.claude-mem.ai/troubleshooting)** để 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:

```bash
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](https://docs.claude-mem.ai/branches) để 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](https://docs.claude-mem.ai/development) để 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](LICENSE) để biết đầy đủ chi tiết. Xem [docs/license.md](docs/license.md)
và [docs/ip-boundary.md](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](ragtime/LICENSE) để biết chi tiết.

---

## Hỗ Trợ

- **Tài Liệu**: [docs/](docs/)
- **Vấn Đề**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **Tài Khoản X Chính Thức**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Discord Chính Thức**: [Tham gia Discord](https://discord.com/invite/J4wttp9vDu)
- **Tác Giả**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**Đượ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