@pcircle/memesh 3.2.1 → 4.0.1

package/README.pt.md

@@ -11,7 +11,6 @@
     <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>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — entenda o conhecimento do seu AI" width="100%" />
 </p>
 
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — grafo de conhecimento interativo com filtros de tipo e modo ego" width="100%" />
+</p>
+
 ---
 
 ## Para Quem É Isso?
@@ -122,7 +125,7 @@ Cole as ferramentas em qualquer chamada de API
 | **Configuração** | `npm i -g` — pronto | Neo4j + VectorDB + chaves de API | Neo4j + config |
 | **Armazenamento** | Arquivo SQLite único | Neo4j + Qdrant | Neo4j |
 | **Funciona offline** | Sim, sempre | Não | Não |
-| **Painel** | Integrado (5 abas) | Nenhum | Nenhum |
+| **Painel** | Integrado (7 abas + analytics) | Nenhum | Nenhum |
 | **Dependências** | 6 | 20+ | 10+ |
 | **Preço** | Grátis para sempre | Plano gratuito / Pago | Plano gratuito / Pago |
 
@@ -136,15 +139,31 @@ Você não precisa lembrar de tudo manualmente. O MeMesh possui **4 hooks** que
 
 | Quando | O que o MeMesh faz |
 |------|------------------|
-| **Início de cada sessão** | Carrega suas memórias mais relevantes (classificadas por algoritmo de pontuação) |
+| **Início de cada sessão** | Carrega suas memórias mais relevantes + avisos proativos de lições passadas |
 | **Após cada `git commit`** | Registra o que você alterou, com estatísticas do diff |
-| **Quando o Claude para** | Captura arquivos editados, erros corrigidos e decisões tomadas |
+| **Quando o Claude para** | Captura arquivos editados, erros corrigidos e gera automaticamente lições estruturadas a partir de falhas |
 | **Antes da compactação de contexto** | Salva o conhecimento antes que se perca por limite de contexto |
 
 > **Desative quando quiser:** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
+## Painel
+
+7 abas, 11 idiomas, zero dependências externas. Acesse em `http://localhost:3737/dashboard` quando o servidor estiver rodando.
+
+| Aba | O que você vê |
+|-----|---------------|
+| **Search** | Busca full-text + similaridade vetorial em todas as memórias |
+| **Browse** | Lista paginada de todas as entidades com arquivamento/restauração |
+| **Analytics** | Pontuação de Saúde da Memória (0-100), timeline de 30 dias, métricas de valor, cobertura de conhecimento, sugestões de limpeza, seus padrões de trabalho |
+| **Graph** | Grafo de conhecimento interativo dirigido por força com filtros de tipo, busca, modo ego, heatmap de recência |
+| **Lessons** | Lições estruturadas de falhas passadas (erro, causa raiz, correção, prevenção) |
+| **Manage** | Arquivar e restaurar entidades |
+| **Settings** | Configuração do provedor LLM, seletor de idioma |
+
+---
+
 ## Funcionalidades Inteligentes
 
 **🧠 Busca Inteligente** — Pesquise "login security" e encontre memórias sobre "OAuth PKCE". O MeMesh expande consultas com termos relacionados usando o LLM configurado.
@@ -183,7 +202,7 @@ memesh  # abre o painel → aba Configurações
 
 ---
 
-## Todas as 6 Ferramentas de Memória
+## Todas as 8 Ferramentas de Memória
 
 | Ferramenta | O que faz |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # abre o painel → aba Configurações
 | `consolidate` | Compressão de memórias longas com auxílio de LLM |
 | `export` | Compartilha memórias como JSON entre projetos ou membros da equipe |
 | `import` | Importa memórias com estratégias de mesclagem (pular / sobrescrever / anexar) |
+| `learn` | Registra lições estruturadas a partir de erros (erro, causa raiz, correção, prevenção) |
+| `user_patterns` | Analisa seus padrões de trabalho — agenda, ferramentas, pontos fortes, áreas de aprendizado |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # abre o painel → aba Configurações
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ O núcleo é independente de framework. A mesma lógica é executada a partir do
 ```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
+npm test -- --run    # 413 tests
 ```
 
 Painel: `cd dashboard && npm install && npm run dev`

package/README.th.md

@@ -11,7 +11,6 @@
     <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>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — ทำความเข้าใจความรู้ของ AI คุณ" width="100%" />
 </p>
 
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — กราฟความรู้แบบโต้ตอบพร้อมฟิลเตอร์ประเภทและโหมด ego" width="100%" />
+</p>
+
 ---
 
 ## เหมาะสำหรับใคร?
@@ -122,7 +125,7 @@ memesh export-schema \
 | **การตั้งค่า** | `npm i -g` — เสร็จ | Neo4j + VectorDB + API key | Neo4j + config |
 | **การจัดเก็บ** | ไฟล์ SQLite เดียว | Neo4j + Qdrant | Neo4j |
 | **ใช้ออฟไลน์ได้** | ได้ เสมอ | ไม่ได้ | ไม่ได้ |
-| **Dashboard** | ในตัว (5 แท็บ) | ไม่มี | ไม่มี |
+| **Dashboard** | ในตัว (7 แท็บ + analytics) | ไม่มี | ไม่มี |
 | **Dependencies** | 6 | 20+ | 10+ |
 | **ราคา** | ฟรีตลอดชีพ | แผนฟรี / เสียเงิน | แผนฟรี / เสียเงิน |
 
@@ -136,15 +139,31 @@ memesh export-schema \
 
 | เมื่อไหร่ | MeMesh ทำอะไร |
 |------|------------------|
-| **ทุกครั้งที่เริ่ม session** | โหลดความจำที่เกี่ยวข้องมากที่สุดของคุณ (จัดอันดับด้วย scoring algorithm) |
+| **ทุกครั้งที่เริ่ม session** | โหลดความจำที่เกี่ยวข้องมากที่สุด + การแจ้งเตือนเชิงรุกจากบทเรียนที่ผ่านมา |
 | **หลังทุก `git commit`** | บันทึกสิ่งที่คุณเปลี่ยน พร้อมสถิติ diff |
-| **เมื่อ Claude หยุดทำงาน** | จับไฟล์ที่แก้ไข บักที่แก้ไขแล้ว และการตัดสินใจที่เกิดขึ้น |
+| **เมื่อ Claude หยุดทำงาน** | จับไฟล์ที่แก้ไข บักที่แก้ไขแล้ว และสร้างบทเรียนที่มีโครงสร้างจากความล้มเหลวโดยอัตโนมัติ |
 | **ก่อนการบีบอัด context** | บันทึกความรู้ก่อนที่จะหายไปเพราะข้อจำกัดของ context |
 
 > **ปิดใช้งานได้ตลอดเวลา:** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
+## Dashboard
+
+7 แท็บ, 11 ภาษา, ไม่มี dependency ภายนอก เข้าถึงที่ `http://localhost:3737/dashboard` เมื่อเซิร์ฟเวอร์ทำงาน
+
+| แท็บ | สิ่งที่คุณเห็น |
+|------|----------------|
+| **Search** | ค้นหาเต็มรูปแบบ + ความคล้ายคลึงเชิงเวกเตอร์ในทุกความจำ |
+| **Browse** | รายการแบบแบ่งหน้าของ entity ทั้งหมดพร้อมการเก็บถาวร/กู้คืน |
+| **Analytics** | คะแนนสุขภาพหน่วยความจำ (0-100), ไทม์ไลน์ 30 วัน, ตัวชี้วัดมูลค่า, ความครอบคลุมของความรู้, คำแนะนำการทำความสะอาด, pattern การทำงาน |
+| **Graph** | กราฟความรู้แบบโต้ตอบ force-directed พร้อมฟิลเตอร์ประเภท, ค้นหา, โหมด ego, heatmap ความใหม่ |
+| **Lessons** | บทเรียนที่มีโครงสร้างจากความล้มเหลวในอดีต (ข้อผิดพลาด, สาเหตุหลัก, การแก้ไข, การป้องกัน) |
+| **Manage** | เก็บถาวรและกู้คืน entity |
+| **Settings** | ตั้งค่าผู้ให้บริการ LLM, เลือกภาษา |
+
+---
+
 ## ฟีเจอร์อัจฉริยะ
 
 **🧠 Smart Search** — ค้น "login security" แล้วพบความจำเกี่ยวกับ "OAuth PKCE" MeMesh ขยายคำค้นด้วยคำที่เกี่ยวข้องผ่าน LLM ที่ตั้งค่าไว้
@@ -183,7 +202,7 @@ memesh  # เปิด dashboard → แท็บ Settings
 
 ---
 
-## เครื่องมือหน่วยความจำทั้ง 6 อย่าง
+## เครื่องมือหน่วยความจำทั้ง 8 อย่าง
 
 | เครื่องมือ | หน้าที่ |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # เปิด dashboard → แท็บ Settings
 | `consolidate` | บีบอัดความจำที่ยืดเยื้อด้วย LLM |
 | `export` | แชร์ความจำในรูปแบบ JSON ระหว่างโปรเจกต์หรือสมาชิกทีม |
 | `import` | นำเข้าความจำด้วยกลยุทธ์การรวม (ข้าม / เขียนทับ / ต่อท้าย) |
+| `learn` | บันทึกบทเรียนที่มีโครงสร้างจากข้อผิดพลาด (ข้อผิดพลาด, สาเหตุหลัก, การแก้ไข, การป้องกัน) |
+| `user_patterns` | วิเคราะห์ pattern การทำงาน — ตารางเวลา, เครื่องมือ, จุดแข็ง, สิ่งที่ต้องเรียนรู้ |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # เปิด dashboard → แท็บ Settings
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ Core ไม่ขึ้นกับ framework ตรรกะเดียวก
 ```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
+npm test -- --run    # 413 tests
 ```
 
 Dashboard: `cd dashboard && npm install && npm run dev`

package/README.vi.md

@@ -11,7 +11,6 @@
     <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>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — hiểu rõ tri thức của AI bạn" width="100%" />
 </p>
 
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — đồ thị tri thức tương tác với bộ lọc loại và chế độ ego" width="100%" />
+</p>
+
 ---
 
 ## Dành Cho Ai?
@@ -122,7 +125,7 @@ Dán tools vào bất kỳ API call nào
 | **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ó |
+| **Dashboard** | Tích hợp sẵn (7 tab + phân tích) | 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í |
 
@@ -136,15 +139,31 @@ Bạn không cần phải tự ghi nhớ mọi thứ. MeMesh có **4 hook** tự
 
 | 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) |
+| **Mỗi khi bắt đầu phiên** | Tải các ký ức liên quan nhất + cảnh báo chủ động từ bài học trước đó |
 | **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 |
+| **Khi Claude kết thúc** | Thu thập file đã sửa, lỗi đã fix và tự động tạo bài học có cấu trúc từ các lỗi |
 | **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`
 
 ---
 
+## Dashboard
+
+7 tab, 11 ngôn ngữ, không phụ thuộc bên ngoài. Truy cập tại `http://localhost:3737/dashboard` khi server đang chạy.
+
+| Tab | Nội dung |
+|-----|----------|
+| **Search** | Tìm kiếm toàn văn + tương tự vector trên tất cả ký ức |
+| **Browse** | Danh sách phân trang của tất cả thực thể với lưu trữ/khôi phục |
+| **Analytics** | Điểm Sức khỏe Bộ nhớ (0-100), timeline 30 ngày, chỉ số giá trị, phạm vi kiến thức, đề xuất dọn dẹp, pattern làm việc |
+| **Graph** | Đồ thị tri thức tương tác dạng lực với bộ lọc loại, tìm kiếm, chế độ ego, heatmap mức độ mới |
+| **Lessons** | Bài học có cấu trúc từ các lỗi trước đó (lỗi, nguyên nhân gốc, cách sửa, phòng ngừa) |
+| **Manage** | Lưu trữ và khôi phục thực thể |
+| **Settings** | Cấu hình nhà cung cấp LLM, chọn ngôn ngữ |
+
+---
+
 ## 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.
@@ -183,7 +202,7 @@ memesh  # mở dashboard → tab Cài đặt
 
 ---
 
-## Tất Cả 6 Công Cụ Bộ Nhớ
+## Tất Cả 8 Công Cụ Bộ Nhớ
 
 | Công cụ | Chức năng |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # mở dashboard → tab Cài đặt
 | `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) |
+| `learn` | Ghi lại bài học có cấu trúc từ sai lầm (lỗi, nguyên nhân gốc, cách sửa, phòng ngừa) |
+| `user_patterns` | Phân tích pattern làm việc — lịch trình, công cụ, điểm mạnh, lĩnh vực cần học |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # mở dashboard → tab Cài đặt
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ Core độc lập với framework. Logic giống nhau chạy từ terminal, HTTP
 ```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
+npm test -- --run    # 413 tests
 ```
 
 Dashboard: `cd dashboard && npm install && npm run dev`

package/README.zh-CN.md

@@ -11,7 +11,6 @@
     <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>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — 深入了解 AI 的知识" width="100%" />
 </p>
 
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — 交互式知识图谱，支持类型筛选与自我模式" width="100%" />
+</p>
+
 ---
 
 ## 这是为谁设计的？
@@ -122,7 +125,7 @@ memesh export-schema \
 | **配置方式** | `npm i -g` — 完成 | Neo4j + VectorDB + API 密钥 | Neo4j + 配置 |
 | **存储方式** | 单一 SQLite 文件 | Neo4j + Qdrant | Neo4j |
 | **离线使用** | 支持，始终如此 | 不支持 | 不支持 |
-| **仪表板** | 内置（5 个标签页） | 无 | 无 |
+| **仪表板** | 内置（7 个标签页 + 分析） | 无 | 无 |
 | **依赖包** | 6 | 20+ | 10+ |
 | **价格** | 永久免费 | 免费方案／付费 | 免费方案／付费 |
 
@@ -136,15 +139,31 @@ memesh export-schema \
 
 | 时机 | MeMesh 做了什么 |
 |------|------------------|
-| **每次会话开始** | 依评分算法加载最相关的记忆 |
+| **每次会话开始** | 加载最相关的记忆 + 来自过去教训的主动警告 |
 | **每次 `git commit` 后** | 记录你的变更内容与差异统计 |
-| **Claude 结束时** | 捕获已编辑的文件、已修复的错误及做出的决策 |
+| **Claude 结束时** | 捕获已编辑的文件、已修复的错误，并自动从失败中生成结构化教训 |
 | **上下文压缩前** | 在知识因上下文限制消失前保存起来 |
 
 > **随时退出：** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
+## 仪表板
+
+7 个标签页、11 种语言、零外部依赖。服务器运行后在 `http://localhost:3737/dashboard` 访问。
+
+| 标签页 | 内容 |
+|--------|------|
+| **Search** | 跨所有记忆的全文搜索 + 向量相似度搜索 |
+| **Browse** | 所有实体的分页列表，支持归档/恢复 |
+| **Analytics** | 记忆健康分数（0-100）、30 天时间轴、价值指标、知识覆盖率、清理建议、你的工作模式 |
+| **Graph** | 交互式力导向知识图谱，支持类型筛选、搜索、自我模式、时间热力图 |
+| **Lessons** | 从过去失败中生成的结构化教训（错误、根因、修复方法、预防措施） |
+| **Manage** | 归档与恢复实体 |
+| **Settings** | LLM 提供者配置、语言选择 |
+
+---
+
 ## 智能功能
 
 **🧠 智能搜索** — 搜索「login security」就能找到关于「OAuth PKCE」的记忆。MeMesh 使用你配置的 LLM 将查询扩展为相关词汇。
@@ -183,7 +202,7 @@ memesh  # 打开仪表板 → 设置标签页
 
 ---
 
-## 全部 6 个记忆工具
+## 全部 8 个记忆工具
 
 | 工具 | 功能说明 |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # 打开仪表板 → 设置标签页
 | `consolidate` | LLM 驱动的冗长记忆压缩 |
 | `export` | 将记忆以 JSON 格式分享给其他项目或团队成员 |
 | `import` | 导入记忆，支持合并策略（跳过 / 覆盖 / 追加） |
+| `learn` | 记录来自错误的结构化教训（错误、根因、修复方法、预防措施） |
+| `user_patterns` | 分析你的工作模式 — 时间安排、工具、优势、学习方向 |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # 打开仪表板 → 设置标签页
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ memesh  # 打开仪表板 → 设置标签页
 ```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
+npm test -- --run    # 413 tests
 ```
 
 仪表板：`cd dashboard && npm install && npm run dev`

package/README.zh-TW.md

@@ -11,7 +11,6 @@
     <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>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — 深入了解 AI 的知識" width="100%" />
 </p>
 
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — 互動式知識圖譜，支援類型篩選與自我模式" width="100%" />
+</p>
+
 ---
 
 ## 這是為誰設計的？
@@ -122,7 +125,7 @@ memesh export-schema \
 | **設定方式** | `npm i -g` — 完成 | Neo4j + VectorDB + API 金鑰 | Neo4j + 設定 |
 | **儲存方式** | 單一 SQLite 檔案 | Neo4j + Qdrant | Neo4j |
 | **離線使用** | 支援，始終如此 | 不支援 | 不支援 |
-| **儀表板** | 內建（5 個頁籤） | 無 | 無 |
+| **儀表板** | 內建（7 個頁籤 + 分析） | 無 | 無 |
 | **依賴套件** | 6 | 20+ | 10+ |
 | **價格** | 永久免費 | 免費方案／付費 | 免費方案／付費 |
 
@@ -136,15 +139,31 @@ memesh export-schema \
 
 | 時機 | MeMesh 做了什麼 |
 |------|------------------|
-| **每次工作階段開始** | 依評分演算法載入最相關的記憶 |
+| **每次工作階段開始** | 載入最相關的記憶 + 來自過去教訓的主動警告 |
 | **每次 `git commit` 後** | 記錄你的變更內容與差異統計 |
-| **Claude 結束時** | 擷取已編輯的檔案、已修復的錯誤及做出的決策 |
+| **Claude 結束時** | 擷取已編輯的檔案、已修復的錯誤，並自動從失敗中產生結構化教訓 |
 | **上下文壓縮前** | 在知識因上下文限制消失前儲存起來 |
 
 > **隨時退出：** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
+## 儀表板
+
+7 個頁籤、11 種語言、零外部依賴。伺服器啟動後在 `http://localhost:3737/dashboard` 存取。
+
+| 頁籤 | 內容 |
+|------|------|
+| **Search** | 跨所有記憶的全文搜尋 + 向量相似度搜尋 |
+| **Browse** | 所有實體的分頁列表，支援封存/還原 |
+| **Analytics** | 記憶健康分數（0-100）、30 天時間軸、價值指標、知識覆蓋率、清理建議、你的工作模式 |
+| **Graph** | 互動式力導向知識圖譜，支援類型篩選、搜尋、自我模式、時間熱力圖 |
+| **Lessons** | 從過去失敗中產生的結構化教訓（錯誤、根因、修復方法、預防措施） |
+| **Manage** | 封存與還原實體 |
+| **Settings** | LLM 提供者設定、語言選擇 |
+
+---
+
 ## 智慧功能
 
 **🧠 智慧搜尋** — 搜尋「login security」就能找到關於「OAuth PKCE」的記憶。MeMesh 使用你設定的 LLM 將查詢擴展為相關詞彙。
@@ -183,7 +202,7 @@ memesh  # 開啟儀表板 → 設定頁籤
 
 ---
 
-## 全部 6 個記憶工具
+## 全部 8 個記憶工具
 
 | 工具 | 功能說明 |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # 開啟儀表板 → 設定頁籤
 | `consolidate` | LLM 驅動的冗長記憶壓縮 |
 | `export` | 將記憶以 JSON 格式分享給其他專案或團隊成員 |
 | `import` | 匯入記憶，支援合併策略（跳過 / 覆寫 / 附加） |
+| `learn` | 記錄來自錯誤的結構化教訓（錯誤、根因、修復方法、預防措施） |
+| `user_patterns` | 分析你的工作模式 — 時程、工具、強項、學習方向 |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # 開啟儀表板 → 設定頁籤
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ memesh  # 開啟儀表板 → 設定頁籤
 ```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
+npm test -- --run    # 413 tests
 ```
 
 儀表板：`cd dashboard && npm install && npm run dev`