@pcircle/memesh 3.0.1 → 3.1.0

package/README.vi.md

@@ -0,0 +1,234 @@
+🌐 [English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Tiếng Việt](README.vi.md) | [Español](README.es.md) | [ภาษาไทย](README.th.md)
+
+<p align="center">
+  <h1 align="center">MeMesh LLM Memory</h1>
+  <p align="center">
+    <strong>Lớp bộ nhớ AI phổ quát nhẹ nhất.</strong><br />
+    Một file SQLite. Mọi LLM. Không cần đám mây.
+  </p>
+  <p align="center">
+    <a href="https://www.npmjs.com/package/@pcircle/memesh"><img src="https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=3b82f6&label=npm" alt="npm" /></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-22c55e?style=flat-square" alt="MIT" /></a>
+    <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-22c55e?style=flat-square" alt="Node" /></a>
+    <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-a855f7?style=flat-square" alt="MCP" /></a>
+    <a href="https://pypi.org/project/memesh/"><img src="https://img.shields.io/badge/pip-memesh-3b82f6?style=flat-square" alt="PyPI" /></a>
+  </p>
+</p>
+
+---
+
+## Vấn Đề
+
+AI của bạn quên sạch mọi thứ sau mỗi phiên làm việc. Mọi quyết định, mọi lần sửa lỗi, mọi bài học rút ra — biến mất. Bạn phải giải thích lại cùng một bối cảnh, Claude lại khám phá lại cùng một pattern, và kiến thức AI của cả nhóm cứ reset về không mỗi lần.
+
+**MeMesh trao cho mọi AI bộ nhớ bền vững, có thể tìm kiếm và không ngừng phát triển.**
+
+---
+
+## Bắt Đầu Trong 60 Giây
+
+### Bước 1: Cài đặt
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+### Bước 2: AI của bạn ghi nhớ
+
+```bash
+memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
+```
+
+### Bước 3: AI của bạn gợi nhớ
+
+```bash
+memesh recall "login security"
+# → Tìm thấy "OAuth 2.0 with PKCE" dù tìm bằng từ khác
+```
+
+**Vậy là xong.** MeMesh đã bắt đầu ghi nhớ và gợi nhớ xuyên suốt các phiên làm việc.
+
+Mở dashboard để khám phá bộ nhớ của bạn:
+
+```bash
+memesh
+```
+
+<p align="center">
+  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — tìm bất kỳ ký ức nào ngay lập tức" width="100%" />
+</p>
+
+<p align="center">
+  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — hiểu rõ tri thức của AI bạn" width="100%" />
+</p>
+
+---
+
+## Dành Cho Ai?
+
+| Nếu bạn là... | MeMesh giúp bạn... |
+|---------------|---------------------|
+| **Lập trình viên dùng Claude Code** | Tự động ghi nhớ quyết định, pattern và bài học qua các phiên làm việc |
+| **Nhóm xây dựng sản phẩm với LLM** | Chia sẻ kiến thức nhóm qua xuất/nhập, giữ ngữ cảnh AI của mọi người đồng bộ |
+| **Nhà phát triển AI agent** | Trao cho agent bộ nhớ bền vững qua MCP, HTTP API hoặc Python SDK |
+| **Người dùng nặng với nhiều công cụ AI** | Một lớp bộ nhớ dùng được với Claude, GPT, LLaMA, Ollama hoặc bất kỳ MCP client nào |
+
+---
+
+## Tương Thích Với Tất Cả
+
+<table>
+<tr>
+<td width="33%" align="center">
+
+**Claude Code / Desktop**
+```bash
+memesh-mcp
+```
+Giao thức MCP (tự động cấu hình)
+
+</td>
+<td width="33%" align="center">
+
+**Python / LangChain**
+```python
+from memesh import MeMesh
+m = MeMesh()
+m.recall("auth")
+```
+`pip install memesh`
+
+</td>
+<td width="33%" align="center">
+
+**Mọi LLM (định dạng OpenAI)**
+```bash
+memesh export-schema \
+  --format openai
+```
+Dán tools vào bất kỳ API call nào
+
+</td>
+</tr>
+</table>
+
+---
+
+## Tại Sao Không Dùng Mem0 / Zep?
+
+| | **MeMesh** | Mem0 | Zep |
+|---|---|---|---|
+| **Thời gian cài đặt** | 5 giây | 30–60 phút | 30+ phút |
+| **Cấu hình** | `npm i -g` — xong | Neo4j + VectorDB + API key | Neo4j + config |
+| **Lưu trữ** | Một file SQLite | Neo4j + Qdrant | Neo4j |
+| **Hoạt động offline** | Có, luôn luôn | Không | Không |
+| **Dashboard** | Tích hợp sẵn (5 tab) | Không có | Không có |
+| **Phụ thuộc** | 6 | 20+ | 10+ |
+| **Giá** | Miễn phí mãi mãi | Gói miễn phí / Trả phí | Gói miễn phí / Trả phí |
+
+**MeMesh đánh đổi:** tính năng multi-tenant cấp doanh nghiệp để lấy **cài đặt tức thì, không hạ tầng, bảo mật 100%**.
+
+---
+
+## Những Gì Xảy Ra Tự Động
+
+Bạn không cần phải tự ghi nhớ mọi thứ. MeMesh có **4 hook** tự động thu thập kiến thức mà không cần bạn làm gì:
+
+| Khi nào | MeMesh làm gì |
+|------|------------------|
+| **Mỗi khi bắt đầu phiên** | Tải các ký ức liên quan nhất (xếp hạng theo thuật toán scoring) |
+| **Sau mỗi `git commit`** | Ghi lại những gì bạn thay đổi, kèm thống kê diff |
+| **Khi Claude kết thúc** | Thu thập file đã sửa, lỗi đã fix và quyết định đã đưa ra |
+| **Trước khi nén context** | Lưu kiến thức trước khi mất do giới hạn context |
+
+> **Tắt bất cứ lúc nào:** `export MEMESH_AUTO_CAPTURE=false`
+
+---
+
+## Tính Năng Thông Minh
+
+**🧠 Tìm kiếm thông minh** — Tìm "login security" là ra ký ức về "OAuth PKCE". MeMesh mở rộng truy vấn bằng các thuật ngữ liên quan qua LLM đã cấu hình.
+
+**📊 Xếp hạng theo điểm** — Kết quả được xếp hạng theo mức liên quan (35%) + thời gian sử dụng gần nhất (25%) + tần suất (20%) + độ tin cậy (15%) + thông tin còn hiệu lực không (5%).
+
+**🔄 Tiến hóa kiến thức** — Quyết định thay đổi. `forget` lưu trữ ký ức cũ (không bao giờ xóa thật sự). Quan hệ `supersedes` nối cũ với mới. AI của bạn luôn thấy phiên bản mới nhất.
+
+**⚠️ Phát hiện mâu thuẫn** — Nếu có hai ký ức mâu thuẫn nhau, MeMesh sẽ cảnh báo.
+
+**📦 Chia sẻ nhóm** — `memesh export > team-knowledge.json` → chia sẻ với nhóm → `memesh import team-knowledge.json`
+
+---
+
+## Mở Khóa Chế Độ Thông Minh (Tùy Chọn)
+
+MeMesh hoạt động hoàn toàn offline theo mặc định. Thêm API key của LLM để mở khóa tìm kiếm thông minh hơn:
+
+```bash
+memesh config set llm.provider anthropic
+memesh config set llm.api-key sk-ant-...
+```
+
+Hoặc dùng tab Cài đặt trong dashboard (cấu hình trực quan):
+
+```bash
+memesh  # mở dashboard → tab Cài đặt
+```
+
+| | Cấp 0 (mặc định) | Cấp 1 (Chế độ thông minh) |
+|---|---|---|
+| **Tìm kiếm** | Khớp từ khóa FTS5 | + Mở rộng truy vấn bằng LLM (~97% recall) |
+| **Tự động thu thập** | Pattern dựa trên quy tắc | + LLM trích xuất quyết định & bài học |
+| **Nén** | Không có | `consolidate` nén ký ức dài dòng |
+| **Chi phí** | Miễn phí, không cần API key | ~$0.0001 mỗi tìm kiếm (Haiku) |
+
+---
+
+## Tất Cả 6 Công Cụ Bộ Nhớ
+
+| Công cụ | Chức năng |
+|------|-------------|
+| `remember` | Lưu kiến thức kèm quan sát, quan hệ và thẻ nhãn |
+| `recall` | Tìm kiếm thông minh với scoring đa nhân tố và mở rộng truy vấn bằng LLM |
+| `forget` | Lưu trữ mềm (không bao giờ xóa thật) hoặc xóa quan sát cụ thể |
+| `consolidate` | Nén ký ức dài dòng bằng LLM |
+| `export` | Chia sẻ ký ức dạng JSON giữa dự án hoặc thành viên nhóm |
+| `import` | Nhập ký ức với chiến lược gộp (bỏ qua / ghi đè / nối thêm) |
+
+---
+
+## Kiến Trúc
+
+```
+                    ┌─────────────────┐
+                    │   Core Engine   │
+                    │  (6 operations) │
+                    └────────┬────────┘
+           ┌─────────────────┼─────────────────┐
+           │                 │                 │
+     CLI (memesh)    HTTP API (serve)    MCP (memesh-mcp)
+           │                 │                 │
+           └─────────────────┼─────────────────┘
+                             │
+                    SQLite + FTS5 + sqlite-vec
+                    (~/.memesh/knowledge-graph.db)
+```
+
+Core độc lập với framework. Logic giống nhau chạy từ terminal, HTTP hoặc MCP.
+
+---
+
+## Đóng Góp
+
+```bash
+git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
+cd memesh-llm-memory && npm install && npm run build
+npm test -- --run    # 289 tests
+```
+
+Dashboard: `cd dashboard && npm install && npm run dev`
+
+---
+
+<p align="center">
+  <strong>MIT</strong> — Được tạo bởi <a href="https://pcircle.ai">PCIRCLE AI</a>
+</p>

package/README.zh-CN.md

@@ -0,0 +1,234 @@
+🌐 [English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Tiếng Việt](README.vi.md) | [Español](README.es.md) | [ภาษาไทย](README.th.md)
+
+<p align="center">
+  <h1 align="center">MeMesh LLM Memory</h1>
+  <p align="center">
+    <strong>最轻量的通用 AI 记忆层。</strong><br />
+    一个 SQLite 文件。任何 LLM。零云端依赖。
+  </p>
+  <p align="center">
+    <a href="https://www.npmjs.com/package/@pcircle/memesh"><img src="https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=3b82f6&label=npm" alt="npm" /></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-22c55e?style=flat-square" alt="MIT" /></a>
+    <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-22c55e?style=flat-square" alt="Node" /></a>
+    <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-a855f7?style=flat-square" alt="MCP" /></a>
+    <a href="https://pypi.org/project/memesh/"><img src="https://img.shields.io/badge/pip-memesh-3b82f6?style=flat-square" alt="PyPI" /></a>
+  </p>
+</p>
+
+---
+
+## 问题所在
+
+你的 AI 在每次对话结束后都会忘记一切。每一个决策、每一次修复、每一个学到的教训——全部归零。你不断重新解释相同的背景，Claude 反复重新发现相同的模式，而你的 AI 知识库每次都从零开始。
+
+**MeMesh 让每个 AI 都能拥有持久、可搜索、持续进化的记忆。**
+
+---
+
+## 60 秒快速上手
+
+### 第一步：安装
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+### 第二步：AI 开始记忆
+
+```bash
+memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
+```
+
+### 第三步：AI 召回记忆
+
+```bash
+memesh recall "login security"
+# → 搜索「login security」也能找到「OAuth 2.0 with PKCE」
+```
+
+**就这样。** MeMesh 已开始在不同对话之间记忆与召回。
+
+运行以下命令探索你的记忆库：
+
+```bash
+memesh
+```
+
+<p align="center">
+  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — 瞬间找到任何记忆" width="100%" />
+</p>
+
+<p align="center">
+  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — 深入了解 AI 的知识" width="100%" />
+</p>
+
+---
+
+## 这是为谁设计的？
+
+| 如果你是… | MeMesh 能帮你… |
+|---------------|---------------------|
+| **使用 Claude Code 的开发者** | 自动记忆决策、模式与每次对话中的心得 |
+| **以 LLM 打造产品的团队** | 通过导出/导入共享团队知识，让每个人的 AI 上下文保持一致 |
+| **AI Agent 开发者** | 通过 MCP、HTTP API 或 Python SDK 赋予 Agent 持久记忆 |
+| **同时使用多款 AI 工具的重度用户** | 一个记忆层，兼容 Claude、GPT、LLaMA、Ollama 或任何 MCP 客户端 |
+
+---
+
+## 与所有工具兼容
+
+<table>
+<tr>
+<td width="33%" align="center">
+
+**Claude Code / Desktop**
+```bash
+memesh-mcp
+```
+MCP 协议（自动配置）
+
+</td>
+<td width="33%" align="center">
+
+**Python / LangChain**
+```python
+from memesh import MeMesh
+m = MeMesh()
+m.recall("auth")
+```
+`pip install memesh`
+
+</td>
+<td width="33%" align="center">
+
+**任何 LLM（OpenAI 格式）**
+```bash
+memesh export-schema \
+  --format openai
+```
+粘贴到任何 API 调用
+
+</td>
+</tr>
+</table>
+
+---
+
+## 为何不用 Mem0 / Zep？
+
+| | **MeMesh** | Mem0 | Zep |
+|---|---|---|---|
+| **安装时间** | 5 秒 | 30–60 分钟 | 30+ 分钟 |
+| **配置方式** | `npm i -g` — 完成 | Neo4j + VectorDB + API 密钥 | Neo4j + 配置 |
+| **存储方式** | 单一 SQLite 文件 | Neo4j + Qdrant | Neo4j |
+| **离线使用** | 支持，始终如此 | 不支持 | 不支持 |
+| **仪表板** | 内置（5 个标签页） | 无 | 无 |
+| **依赖包** | 6 | 20+ | 10+ |
+| **价格** | 永久免费 | 免费方案／付费 | 免费方案／付费 |
+
+**MeMesh 的取舍：** 放弃企业级多租户功能，换来**即时安装、零基础设施、百分之百隐私**。
+
+---
+
+## 自动运作的功能
+
+你不需要手动记忆每一件事。MeMesh 有 **4 个 Hook**，在你不做任何事的情况下自动捕获知识：
+
+| 时机 | MeMesh 做了什么 |
+|------|------------------|
+| **每次会话开始** | 依评分算法加载最相关的记忆 |
+| **每次 `git commit` 后** | 记录你的变更内容与差异统计 |
+| **Claude 结束时** | 捕获已编辑的文件、已修复的错误及做出的决策 |
+| **上下文压缩前** | 在知识因上下文限制消失前保存起来 |
+
+> **随时退出：** `export MEMESH_AUTO_CAPTURE=false`
+
+---
+
+## 智能功能
+
+**🧠 智能搜索** — 搜索「login security」就能找到关于「OAuth PKCE」的记忆。MeMesh 使用你配置的 LLM 将查询扩展为相关词汇。
+
+**📊 评分排名** — 结果依相关性（35%）+ 最近使用时间（25%）+ 使用频率（20%）+ 可信度（15%）+ 信息时效性（5%）排序。
+
+**🔄 知识演进** — 决策会改变。`forget` 是归档旧记忆（从不真正删除）。`supersedes` 关系将旧记忆与新记忆链接。你的 AI 始终看到最新版本。
+
+**⚠️ 冲突检测** — 若有两条记忆相互矛盾，MeMesh 会发出警告。
+
+**📦 团队共享** — `memesh export > team-knowledge.json` → 分享给团队 → `memesh import team-knowledge.json`
+
+---
+
+## 启用智能模式（可选）
+
+MeMesh 默认完全离线运作。加入 LLM API 密钥即可解锁更聪明的搜索：
+
+```bash
+memesh config set llm.provider anthropic
+memesh config set llm.api-key sk-ant-...
+```
+
+或使用仪表板的设置标签页（可视化配置）：
+
+```bash
+memesh  # 打开仪表板 → 设置标签页
+```
+
+| | 第 0 级（默认） | 第 1 级（智能模式） |
+|---|---|---|
+| **搜索** | FTS5 关键字匹配 | + LLM 查询扩展（约 97% 召回率） |
+| **自动捕获** | 规则式模式 | + LLM 提取决策与心得 |
+| **压缩** | 不支持 | `consolidate` 压缩冗长记忆 |
+| **费用** | 免费，无需 API 密钥 | 约 $0.0001 每次搜索（Haiku） |
+
+---
+
+## 全部 6 个记忆工具
+
+| 工具 | 功能说明 |
+|------|-------------|
+| `remember` | 存储知识，支持观察记录、关联关系与标签 |
+| `recall` | 智能搜索，结合多因子评分与 LLM 查询扩展 |
+| `forget` | 软归档（从不真正删除）或移除特定观察记录 |
+| `consolidate` | LLM 驱动的冗长记忆压缩 |
+| `export` | 将记忆以 JSON 格式分享给其他项目或团队成员 |
+| `import` | 导入记忆，支持合并策略（跳过 / 覆盖 / 追加） |
+
+---
+
+## 架构
+
+```
+                    ┌─────────────────┐
+                    │   Core Engine   │
+                    │  (6 operations) │
+                    └────────┬────────┘
+           ┌─────────────────┼─────────────────┐
+           │                 │                 │
+     CLI (memesh)    HTTP API (serve)    MCP (memesh-mcp)
+           │                 │                 │
+           └─────────────────┼─────────────────┘
+                             │
+                    SQLite + FTS5 + sqlite-vec
+                    (~/.memesh/knowledge-graph.db)
+```
+
+核心引擎与框架无关。无论从终端、HTTP 还是 MCP 调用，逻辑完全相同。
+
+---
+
+## 贡献
+
+```bash
+git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
+cd memesh-llm-memory && npm install && npm run build
+npm test -- --run    # 289 tests
+```
+
+仪表板：`cd dashboard && npm install && npm run dev`
+
+---
+
+<p align="center">
+  <strong>MIT</strong> — 由 <a href="https://pcircle.ai">PCIRCLE AI</a> 开发
+</p>

package/README.zh-TW.md

@@ -0,0 +1,234 @@
+🌐 [English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Tiếng Việt](README.vi.md) | [Español](README.es.md) | [ภาษาไทย](README.th.md)
+
+<p align="center">
+  <h1 align="center">MeMesh LLM Memory</h1>
+  <p align="center">
+    <strong>最輕量的通用 AI 記憶層。</strong><br />
+    一個 SQLite 檔案。任何 LLM。零雲端依賴。
+  </p>
+  <p align="center">
+    <a href="https://www.npmjs.com/package/@pcircle/memesh"><img src="https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=3b82f6&label=npm" alt="npm" /></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-22c55e?style=flat-square" alt="MIT" /></a>
+    <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-22c55e?style=flat-square" alt="Node" /></a>
+    <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-a855f7?style=flat-square" alt="MCP" /></a>
+    <a href="https://pypi.org/project/memesh/"><img src="https://img.shields.io/badge/pip-memesh-3b82f6?style=flat-square" alt="PyPI" /></a>
+  </p>
+</p>
+
+---
+
+## 問題所在
+
+你的 AI 在每次對話結束後都會忘記一切。每一個決策、每一次修復、每一個學到的教訓——全部歸零。你不斷重新解釋相同的背景，Claude 反覆重新發現相同的模式，而你的 AI 知識庫每次都從零開始。
+
+**MeMesh 讓每個 AI 都能擁有持久、可搜尋、持續進化的記憶。**
+
+---
+
+## 60 秒快速上手
+
+### 步驟一：安裝
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+### 步驟二：AI 開始記憶
+
+```bash
+memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
+```
+
+### 步驟三：AI 召回記憶
+
+```bash
+memesh recall "login security"
+# → 搜尋「login security」也能找到「OAuth 2.0 with PKCE」
+```
+
+**就這樣。** MeMesh 已開始在不同對話之間記憶與召回。
+
+執行以下指令探索你的記憶庫：
+
+```bash
+memesh
+```
+
+<p align="center">
+  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — 瞬間找到任何記憶" width="100%" />
+</p>
+
+<p align="center">
+  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — 深入了解 AI 的知識" width="100%" />
+</p>
+
+---
+
+## 這是為誰設計的？
+
+| 如果你是… | MeMesh 能幫你… |
+|---------------|---------------------|
+| **使用 Claude Code 的開發者** | 自動記憶決策、模式與每次對話中的心得 |
+| **以 LLM 打造產品的團隊** | 透過匯出/匯入共享團隊知識，讓每個人的 AI 脈絡保持一致 |
+| **AI Agent 開發者** | 透過 MCP、HTTP API 或 Python SDK 賦予 Agent 持久記憶 |
+| **同時使用多款 AI 工具的重度用戶** | 一個記憶層，相容 Claude、GPT、LLaMA、Ollama 或任何 MCP 客戶端 |
+
+---
+
+## 與所有工具相容
+
+<table>
+<tr>
+<td width="33%" align="center">
+
+**Claude Code / Desktop**
+```bash
+memesh-mcp
+```
+MCP 協議（自動設定）
+
+</td>
+<td width="33%" align="center">
+
+**Python / LangChain**
+```python
+from memesh import MeMesh
+m = MeMesh()
+m.recall("auth")
+```
+`pip install memesh`
+
+</td>
+<td width="33%" align="center">
+
+**任何 LLM（OpenAI 格式）**
+```bash
+memesh export-schema \
+  --format openai
+```
+貼入任何 API 呼叫
+
+</td>
+</tr>
+</table>
+
+---
+
+## 為何不用 Mem0 / Zep？
+
+| | **MeMesh** | Mem0 | Zep |
+|---|---|---|---|
+| **安裝時間** | 5 秒 | 30–60 分鐘 | 30+ 分鐘 |
+| **設定方式** | `npm i -g` — 完成 | Neo4j + VectorDB + API 金鑰 | Neo4j + 設定 |
+| **儲存方式** | 單一 SQLite 檔案 | Neo4j + Qdrant | Neo4j |
+| **離線使用** | 支援，始終如此 | 不支援 | 不支援 |
+| **儀表板** | 內建（5 個頁籤） | 無 | 無 |
+| **依賴套件** | 6 | 20+ | 10+ |
+| **價格** | 永久免費 | 免費方案／付費 | 免費方案／付費 |
+
+**MeMesh 的取捨：** 放棄企業級多租戶功能，換來**即時安裝、零基礎設施、百分之百隱私**。
+
+---
+
+## 自動運作的功能
+
+你不需要手動記憶每一件事。MeMesh 有 **4 個 Hook**，在你不做任何事的情況下自動擷取知識：
+
+| 時機 | MeMesh 做了什麼 |
+|------|------------------|
+| **每次工作階段開始** | 依評分演算法載入最相關的記憶 |
+| **每次 `git commit` 後** | 記錄你的變更內容與差異統計 |
+| **Claude 結束時** | 擷取已編輯的檔案、已修復的錯誤及做出的決策 |
+| **上下文壓縮前** | 在知識因上下文限制消失前儲存起來 |
+
+> **隨時退出：** `export MEMESH_AUTO_CAPTURE=false`
+
+---
+
+## 智慧功能
+
+**🧠 智慧搜尋** — 搜尋「login security」就能找到關於「OAuth PKCE」的記憶。MeMesh 使用你設定的 LLM 將查詢擴展為相關詞彙。
+
+**📊 評分排名** — 結果依相關性（35%）+ 最近使用時間（25%）+ 使用頻率（20%）+ 可信度（15%）+ 資訊時效性（5%）排序。
+
+**🔄 知識演進** — 決策會改變。`forget` 是封存舊記憶（從不真正刪除）。`supersedes` 關係將舊記憶與新記憶連結。你的 AI 始終看到最新版本。
+
+**⚠️ 衝突偵測** — 若有兩條記憶相互矛盾，MeMesh 會發出警告。
+
+**📦 團隊共享** — `memesh export > team-knowledge.json` → 分享給團隊 → `memesh import team-knowledge.json`
+
+---
+
+## 啟用智慧模式（選用）
+
+MeMesh 預設完全離線運作。加入 LLM API 金鑰即可解鎖更聰明的搜尋：
+
+```bash
+memesh config set llm.provider anthropic
+memesh config set llm.api-key sk-ant-...
+```
+
+或使用儀表板的設定頁籤（視覺化設定）：
+
+```bash
+memesh  # 開啟儀表板 → 設定頁籤
+```
+
+| | 第 0 級（預設） | 第 1 級（智慧模式） |
+|---|---|---|
+| **搜尋** | FTS5 關鍵字匹配 | + LLM 查詢擴展（約 97% 召回率） |
+| **自動擷取** | 規則式模式 | + LLM 擷取決策與心得 |
+| **壓縮** | 不支援 | `consolidate` 壓縮冗長記憶 |
+| **費用** | 免費，無需 API 金鑰 | 約 $0.0001 每次搜尋（Haiku） |
+
+---
+
+## 全部 6 個記憶工具
+
+| 工具 | 功能說明 |
+|------|-------------|
+| `remember` | 儲存知識，支援觀察記錄、關聯關係與標籤 |
+| `recall` | 智慧搜尋，結合多因子評分與 LLM 查詢擴展 |
+| `forget` | 軟封存（從不真正刪除）或移除特定觀察記錄 |
+| `consolidate` | LLM 驅動的冗長記憶壓縮 |
+| `export` | 將記憶以 JSON 格式分享給其他專案或團隊成員 |
+| `import` | 匯入記憶，支援合併策略（跳過 / 覆寫 / 附加） |
+
+---
+
+## 架構
+
+```
+                    ┌─────────────────┐
+                    │   Core Engine   │
+                    │  (6 operations) │
+                    └────────┬────────┘
+           ┌─────────────────┼─────────────────┐
+           │                 │                 │
+     CLI (memesh)    HTTP API (serve)    MCP (memesh-mcp)
+           │                 │                 │
+           └─────────────────┼─────────────────┘
+                             │
+                    SQLite + FTS5 + sqlite-vec
+                    (~/.memesh/knowledge-graph.db)
+```
+
+核心引擎與框架無關。無論從終端機、HTTP 還是 MCP 呼叫，邏輯完全相同。
+
+---
+
+## 貢獻
+
+```bash
+git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
+cd memesh-llm-memory && npm install && npm run build
+npm test -- --run    # 289 tests
+```
+
+儀表板：`cd dashboard && npm install && npm run dev`
+
+---
+
+<p align="center">
+  <strong>MIT</strong> — 由 <a href="https://pcircle.ai">PCIRCLE AI</a> 開發
+</p>