@pcircle/memesh 4.0.3 → 4.1.1

package/README.th.md

@@ -1,110 +1,284 @@
+<!-- translated from README.md @ ab9d25f8d9cb7c78c4cc271717709e2efb4bac76 -->
+<!-- DO NOT edit this file by hand. The maintainer regenerates it from README.md via a private toolkit script (see internal docs). Manual edits will be overwritten on next sync. -->
+
 🌐 [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>ชั้นความจำแบบ local สำหรับ Claude Code และ coding agents ที่รองรับ MCP</strong><br />
-    ใช้ SQLite ไฟล์เดียว ไม่ต้องมี Docker และไม่ต้องพึ่ง cloud
+    <strong>หน่วยความจำภายในเครื่องสำหรับ Claude Code และเอเจนต์ MCP</strong><br />
+    ไฟล์ SQLite เพียงตัวเดียว ไม่ต้อง Docker ไม่ต้องบริการบนคลาวด์
+  </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>
   </p>
 </p>
 
-> README ภาษาไทยฉบับนี้เป็นเวอร์ชันสรุป หากต้องการข้อมูลที่ครบและอัปเดตที่สุด ให้ยึด [English README](README.md) เป็นหลัก
+---
 
-## MeMesh แก้ปัญหาอะไร?
+## ปัญหา
 
-coding agent มักจะลืมบริบทเมื่อจบ session ไปแล้ว พอเริ่มงานรอบใหม่ ก็ต้องอธิบายการตัดสินใจทางสถาปัตยกรรม บั๊กที่เคยแก้ บทเรียนที่เคยได้ และข้อจำกัดของโปรเจกต์ซ้ำอีกครั้ง
+เอเจนต์คิดโค้ดลืมสิ่งที่เกิดขึ้นระหว่างเซสชัน ทุกการตัดสินใจด้านสถาปัตยกรรม การแก้บั๊ก การทดสอบที่ล้มเหลว และบทเรียนที่ยากที่สุดต้องอธิบายซ้ำ Claude Code เริ่มต้นใหม่ ค้นพบข้อจำกัดเดิม และใช้ context ไปกับสิ่งที่น่าจะรู้อยู่แล้ว
 
-**MeMesh ช่วยเก็บความรู้เหล่านี้ไว้ในเครื่องของคุณ ค้นหาได้ ตรวจสอบได้ และดึงกลับมาใช้ต่อได้**
+**MeMesh ให้หน่วยความจำภายในเครื่องที่ยั่งยืน ค้นหาได้ และวิวัฒนาได้สำหรับเอเจนต์คิดโค้ด**
 
-แพ็กเกจ npm นี้คือ MeMesh เวอร์ชัน plugin / package แบบ local ไม่ใช่ผลิตภัณฑ์ workspace บน cloud และไม่ใช่แพลตฟอร์ม enterprise แบบเต็มรูปแบบ
+แพคเกจนี้เป็นชั้นหน่วยความจำภายในของผลิตภัณฑ์ MeMesh ออกแบบให้เล็กและเปิดต้นฉบับ ติดตั้งด้วย npm เก็บหน่วยความจำในไฟล์ `~/.memesh/knowledge-graph.db` และเชื่อมต่อกับ Claude Code หรือไคลเอนต์ที่รองรับ MCP ผลิตภัณฑ์เวิร์กสเปซบนคลาวด์และระบบปฏิบัติการขององค์กรควรแยกออกจาก README และแผนพัฒนาของแพคเกจนี้
 
-## เริ่มได้ใน 60 วินาที
+---
 
-### 1. ติดตั้ง
+## เริ่มต้นใน 60 วินาที
+
+### ขั้นตอนที่ 1: ติดตั้ง
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-### 2. บันทึกการตัดสินใจหนึ่งรายการ
+### ขั้นตอนที่ 2: เก็บการตัดสินใจ
 
 ```bash
 memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
 ```
 
-### 3. เรียกกลับมาใช้ภายหลัง
+### ขั้นตอนที่ 3: เรียกใช้ภายหลัง
 
 ```bash
 memesh recall "login security"
-# → ต่อให้ใช้คำค้นคนละแบบ ก็ยังหา "OAuth 2.0 with PKCE" เจอได้
+# → Finds "OAuth 2.0 with PKCE" even though you searched different words
+```
+
+**เพียงเท่านี้** MeMesh จำและเรียกคืนข้อมูลข้ามเซสชันได้แล้ว
+
+หากต้องการตรวจสอบการติดตั้งและเส้นทางการเชื่อมต่อภายในตั้งแต่ต้นจนจบ:
+
+```bash
+memesh doctor
 ```
 
-เปิด dashboard:
+เปิดแดชบอร์ดเพื่อสำรวจหน่วยความจำ:
 
 ```bash
 memesh
 ```
 
-## เหมาะกับใคร?
+<p align="center">
+  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — find any memory instantly" width="100%" />
+</p>
+
+<p align="center">
+  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — health score, timeline, patterns, knowledge coverage" width="100%" />
+</p>
+
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — interactive knowledge graph with type filters and ego mode" width="100%" />
+</p>
+
+---
+
+## สำหรับใครบ้าง
+
+| ถ้าคุณเป็น... | MeMesh ช่วยคุณ... |
+|---|---|
+| **นักพัฒนาที่ใช้ Claude Code** | เรียกคืนการตัดสินใจโครงการ บทเรียนเฉพาะไฟล์ และความล้มเหลวที่ผ่านมาโดยอัตโนมัติขณะทำงาน |
+| **ผู้ใช้เอเจนต์คิดโค้ดขั้นสูง** | ใช้ชั้นหน่วยความจำภายในตัวเดียวร่วมกันบนเครื่องมือที่รองรับ MCP |
+| **ทีมทดลองเวิร์กโฟลว์คิดโค้ด AI** | ส่งออก/นำเข้าความรู้โครงการโดยไม่ต้องสถาปัตยกรรมบนคลาวด์ |
+| **นักพัฒนาเอเจนต์** | เพิ่มหน่วยความจำภายในผ่าน MCP HTTP CLI หรือ Python SDK |
+
+---
+
+## ออกแบบสำหรับเอเจนต์คิดโค้ดตั้งแต่แรก
+
+<table>
+<tr>
+<td width="33%" align="center">
+
+**Claude Code / Desktop**
+```bash
+memesh-mcp
+```
+เครื่องมือ MCP + hook Claude Code
+
+</td>
+<td width="33%" align="center">
+
+**ไคลเอนต์ HTTP ใด ๆ**
+```bash
+curl localhost:3737/v1/recall \
+  -H "Content-Type: application/json" \
+  -d '{"query":"auth"}'
+```
+`memesh serve` (REST API)
+
+</td>
+<td width="33%" align="center">
+
+**LLM ใด ๆ (รูปแบบ OpenAI)**
+```bash
+memesh export-schema \
+  --format openai
+```
+วางเครื่องมือในการเรียก API ใด ๆ
+
+</td>
+</tr>
+</table>
+
+---
 
-- นักพัฒนาที่ใช้ Claude Code และอยากเก็บบริบทของโปรเจกต์ข้าม session
-- ผู้ใช้ระดับสูงที่อยากใช้ความจำ local ชุดเดียวร่วมกันระหว่าง MCP coding agents
-- ทีม AI-native ขนาดเล็กที่อยากแชร์ความรู้ของโปรเจกต์ผ่าน export / import
-- นักพัฒนา agent ที่อยากเชื่อม memory local ผ่าน CLI, HTTP หรือ MCP
+## ทำไมไม่ใช้ OpenMemory Cursor Memories Mem0 หรือ Zep
 
-## ทำไมต้อง MeMesh?
+| | **MeMesh** | OpenMemory | Cursor Memories | Mem0 | Zep / Graphiti |
+|---|---|---|---|---|---|
+| **เหมาะสมสุด** | หน่วยความจำภายในสำหรับเอเจนต์คิดโค้ด | หน่วยความจำ MCP ข้ามไคลเอนต์ | หน่วยความจำโครงการ Cursor | หน่วยความจำแอปพลิเคชัน/เอเจนต์ที่มีการจัดการ | กราฟความรู้ชั่วคราว |
+| **รูปแบบการติดตั้ง** | `npm install -g @pcircle/memesh` | ไหลของแอปพลิเคชัน/เซิร์ฟเวอร์ภายใน | สร้างเข้า Cursor | Cloud API / SDK / MCP | การตั้งค่าบริการ/เฟรมเวิร์ก |
+| **ที่เก็บข้อมูล** | ไฟล์ SQLite ภายในตัวเดียว | สแต็คหน่วยความจำภายใน | กฎ/หน่วยความจำที่จัดการโดย Cursor | สแต็กบนคลาวด์หรือโครงการของตนเอง | ฐานข้อมูลกราฟ |
+| **ต้องใช้คลาวด์** | ไม่ | ไม่สำหรับโหมดภายใน | ขึ้นอยู่กับการตั้งค่าบัญชี/หน่วยความจำ Cursor | ใช่สำหรับแพลตฟอร์ม | บ่อยครั้งใช่/โครงการของตนเอง |
+| **hook Claude Code** | ระดับแรก | เครื่องมือ MCP | ไม่ | เครื่องมือ MCP | ไม่เฉพาะ Claude Code |
+| **แดชบอร์ด** | สร้างเข้า | สร้างเข้า | การตั้งค่า Cursor | แดชบอร์ดแพลตฟอร์ม | เครื่องมือแพลตฟอร์ม/กราฟ |
+| **การสลับกัน** | ชั้นภายในที่เรียบง่าย ไม่ใช่ขนาดองค์กร | ขอบเขตแอปพลิเคชันภายในที่กว้างขึ้น | ล็อคอยู่กับ Cursor | แพลตฟอร์มที่มีการจัดการแข็งแกร่ง ลดความเป็นท้องถิ่น | โมเดลกราฟแข็งแกร่ง การตั้งค่าที่หนัก |
 
-- local-first: ข้อมูลอยู่ในไฟล์ SQLite ของคุณเอง
-- ติดตั้งง่าย: `npm install -g` แล้วเริ่มใช้ได้เลย
-- เชื่อมต่อได้ตรงไปตรงมา: รองรับ CLI, HTTP และ MCP
-- เหมาะกับ Claude Code: มี hooks ช่วยดึงบริบทที่เกี่ยวข้องเข้ามาใน workflow
-- ตรวจสอบและจัดการได้: มี dashboard ให้ดูและจัดระเบียบ memory
-- มีขอบเขตความเชื่อถือที่ปลอดภัยกว่า: memory ที่ import เข้ามายังค้นหาได้ แต่จะไม่ถูก inject เข้า Claude hooks โดยอัตโนมัติ จนกว่าจะมีการตรวจทานหรือบันทึกใหม่ในเครื่อง
+**MeMesh เปลี่ยนโครงสร้างพื้นฐาน Enterprise Scale ที่มีการจัดการเป็นการตั้งค่าภายในแบบทันที ที่เก็บข้อมูลที่ตรวจสอบได้ และ hook เวิร์กโฟลว์เอเจนต์คิดโค้ด**
 
-## ใน Claude Code จะทำอะไรให้อัตโนมัติ?
+---
 
-ตอนนี้ MeMesh ช่วยใน 5 ช่วงหลัก:
+## สิ่งที่เกิดขึ้นโดยอัตโนมัติใน Claude Code
 
-- ตอนเริ่ม session จะโหลด memory ที่เกี่ยวข้องและบทเรียนที่เคยมี
-- ก่อนแก้ไฟล์ จะเรียก memory ที่เกี่ยวข้องกับไฟล์หรือโปรเจกต์
-- หลัง `git commit` จะบันทึกสิ่งที่เปลี่ยนไป
-- ตอนจบ session จะสรุปการแก้ไข ข้อผิดพลาด และ lessons learned
-- ก่อน compact context จะเก็บข้อมูลสำคัญกลับเข้า memory local
+ไม่ต้องจำข้อมูลทุกอย่างด้วยตนเอง MeMesh มี **6 hook** ที่บันทึกและแทรกความรู้ขณะทำงาน:
 
-## Dashboard มีอะไรบ้าง?
+| เมื่อ | MeMesh ทำอะไร |
+|---|---|
+| **เริ่มเซสชันทุกครั้ง** | โหลดหน่วยความจำที่เกี่ยวข้องมากที่สุด + คำเตือนจากบทเรียนที่ผ่านมา + แบนเนอร์การ orchestrate เอเจนต์ |
+| **ก่อนแก้ไขไฟล์** | เรียกคืนหน่วยความจำที่เชื่อมโยงกับไฟล์หรือโครงการก่อนที่ Claude เขียนโค้ด |
+| **ก่อนคำสั่ง bash** | แนะนำให้ Claude สั่งคำสั่งที่ยืนยันได้สูง (test build lint migrate deploy benchmark) เป็นเอเจนต์พื้นหลัง |
+| **หลังทุก `git commit`** | บันทึกสิ่งที่เปลี่ยนแปลง พร้อมสถิติ diff |
+| **เมื่อ Claude หยุด** | บันทึกไฟล์ที่แก้ไข บั๊กที่แก้ไข และสร้างบทเรียนโครงสร้างจากความล้มเหลวโดยอัตโนมัติ |
+| **ก่อนการบีบอัด context** | บันทึกความรู้ก่อนที่จะหายไปจากขีดจำกัด context |
 
-Dashboard ตอนนี้มี 7 แท็บ และรองรับ 11 ภาษา:
+> **ปิด ได้ตลอดเวลา:** `export MEMESH_AUTO_CAPTURE=false`
 
-- Search: ค้นหา memory
-- Browse: ดู memory ทั้งหมด
-- Analytics: ดูสุขภาพและแนวโน้ม
-- Graph: ดูความสัมพันธ์ของความรู้
-- Lessons: ทบทวนบทเรียนที่ผ่านมา
-- Manage: archive และ restore
-- Settings: ตั้งค่า LLM provider และภาษา
+---
 
-## Smart Mode คืออะไร?
+## แดชบอร์ด
 
-MeMesh ใช้งานแบบ offline ได้ตั้งแต่ต้น หากคุณใส่ LLM API key เพิ่ม ก็จะเปิดความสามารถเสริม เช่น
+7 แท็บ 11 ภาษา ไม่มีการพึ่งพิ่นภายนอก เข้าถึงได้ที่ `http://localhost:3737/dashboard` เมื่อเซิร์ฟเวอร์ทำงาน
 
-- query expansion
-- การสกัดข้อมูลอัตโนมัติที่ดีขึ้น
-- การจัดระเบียบและบีบอัดข้อมูลที่ฉลาดขึ้น
+| แท็บ | เห็นอะไร |
+|---|---|
+| **Search** | ค้นหาข้อความแบบเต็มรูป + ความคล้ายคลึงเวกเตอร์ข้ามหน่วยความจำทั้งหมด |
+| **Browse** | รายการหน่วยความจำทั้งหมดแบบหน้าต่อหน้า พร้อมเก็บ/คืนสถานะ |
+| **Analytics** | Memory Health Score (0-100) ไทม์ไลน์ 30 วัน เมตริกค่า ความครอบคลุมความรู้ คำแนะนำการทำความสะอาด รูปแบบการทำงาน |
+| **Graph** | กราฟความรู้แบบโต้ตอบด้วยแรงโดยตรง พร้อมตัวกรองประเภท ค้นหา โหมด ego แผนความร้อนความเสมียน |
+| **Lessons** | บทเรียนโครงสร้างจากความล้มเหลวที่ผ่านมา (ข้อผิดพลาด สาเหตุ การแก้ไข การป้องกัน) |
+| **Manage** | เก็บและคืนสถานะอักษร |
+| **Settings** | การตั้งค่าผู้ให้บริการ LLM ตัวเลือกภาษาแบบทันที |
 
-ถึงไม่มี API key ก็ยังใช้ฟังก์ชันหลักได้ตามปกติ
+---
 
-## อ่านต่อ
+## คุณสมบัติอัจฉริยะ
 
-- ฟีเจอร์ทั้งหมด การเปรียบเทียบ API และข้อมูล release: [English README](README.md)
-- คู่มือการเชื่อมต่อแพลตฟอร์ม: [docs/platforms/README.md](docs/platforms/README.md)
-- เอกสารอ้างอิง API: [docs/api/API_REFERENCE.md](docs/api/API_REFERENCE.md)
+**🧠 ค้นหาอัจฉริยะ** — ค้นหา "login security" และค้นหาหน่วยความจำเกี่ยวกับ "OAuth PKCE" MeMesh ขยายการค้นหาด้วยคำที่เกี่ยวข้องโดยใช้ LLM ที่ตั้งค่าไว้
 
-## การพัฒนาและการตรวจสอบ
+**📊 การจัดอันดับแบบให้คะแนน** — ผลลัพธ์อันดับตามความเกี่ยวข้อง (30%) + ความเพิ่งพ้อง (25%) + ความถี่ (15%) + ความมั่นใจ (15%) + ผลกระทบการเรียกคืน (10%) + ความถูกต้องชั่วคราว (5%)
+
+**🔄 วิวัฒนาการของความรู้** — การตัดสินใจเปลี่ยนแปลง `forget` เก็บหน่วยความจำเก่า (ไม่เคยลบ) `supersedes` ความสัมพันธ์เชื่อมโยงเก่า → ใหม่ AI เห็นรุ่นล่าสุดเสมอ
+
+**⚠️ การตรวจจับความขัดแย้ง** — ถ้าคุณมีหน่วยความจำสองอันที่ขัดแย้งกัน MeMesh เตือนคุณ
+
+**📦 การแบ่งปันทีม** — `memesh export > team-knowledge.json` → แบ่งปันกับทีม → `memesh import team-knowledge.json`
+บันเดิลนำเข้าสามารถค้นหาได้ แต่ MeMesh ไม่ได้แทรกหน่วยความจำนำเข้าโดยอัตโนมัติลงใน hook Claude จนกว่าคุณจะตรวจสอบหรือเก็บเป็นท้องถิ่นอีกครั้ง
+
+---
+
+## ตัวอย่างการใช้งาน
+
+> "MeMesh จำได้ว่าเราเลือก PKCE แทน implicit flow เมื่อสามสัปดาห์ที่แล้ว เมื่อฉันถามคำถาม Claude เกี่ยวกับการตรวจสอบสิทธิ์อีกครั้ง มันรู้อยู่แล้ว ไม่ต้องอธิบายใหม่"
+> — **นักพัฒนาคนเดียว สร้าง SaaS**
+
+> "เราส่งออกหน่วยความจำของทีมทุกวันศุกร์และนำเข้าจันทร์ Claude ของทุกคนเริ่มสัปดาห์รู้ว่าทีมเรียนรู้อะไรสัปดาห์ที่แล้ว"
+> — **เริ่มต้นขนาด 3 คน ฐานความรู้ร่วมกัน**
+
+> "แดชบอร์ดแสดงให้เห็นว่า 90% ของหน่วยความจำของฉันเป็นบันทึกเซสชันที่สร้างอัตโนมัติ ฉันเริ่มใช้ `remember` อย่างตั้งใจสำหรับการตัดสินใจด้านสถาปัตยกรรม เปลี่ยนเกม"
+> — **นักพัฒนาที่ค้นพบแท็บ Analytics**
+
+---
+
+## ปลดล็อค Smart Mode (ทางเลือก)
+
+MeMesh ทำงานแบบออฟไลน์โดยค่าเริ่มต้น เพิ่มคีย์ API LLM เฉพาะเมื่อต้องการการขยายการค้นหา การสกัดที่ชาญฉลาดกว่า และการบีบอัด:
+
+```bash
+memesh config set llm.provider anthropic
+memesh config set llm.api-key sk-ant-...
+```
+
+หรือใช้แท็บ Settings แดชบอร์ด (การตั้งค่าสายตา):
+
+```bash
+memesh  # opens dashboard → Settings tab
+```
+
+| | ระดับ 0 (ค่าเริ่มต้น) | ระดับ 1 (Smart Mode) |
+|---|---|---|
+| **Search** | FTS5 keyword matching | + LLM query expansion (~97% recall) |
+| **Auto-capture** | รูปแบบตามกฎ | + LLM สกัดการตัดสินใจ & บทเรียน |
+| **Compression** | ไม่พร้อมใช้ | `consolidate` บีบอัดหน่วยความจำที่มีเนื้อหามาก |
+| **Cost** | ฟรี ไม่ต้องคีย์ API | ~$0.0001 ต่อการค้นหา (Haiku) |
+
+---
+
+## เครื่องมือหน่วยความจำทั้ง 9 ตัว
+
+| เครื่องมือ | ทำอะไร |
+|---|---|
+| `remember` | เก็บความรู้พร้อมการสังเกต ความสัมพันธ์ และแท็ก |
+| `recall` | ค้นหาอัจฉริยะพร้อมการให้คะแนนหลายปัจจัยและการขยายการค้นหา LLM |
+| `forget` | เก็บแบบนุ่ม (ไม่เคยลบ) หรือลบการสังเกตเฉพาะ |
+| `consolidate` | การบีบอัดหน่วยความจำที่ขับเคลื่อนโดย LLM |
+| `export` | แบ่งปันหน่วยความจำเป็น JSON ระหว่างโครงการหรือสมาชิกทีม |
+| `import` | นำเข้าหน่วยความจำพร้อมกลยุทธ์ผสาน (ข้าม / เขียนทับ / ผนวก) |
+| `learn` | บันทึกบทเรียนโครงสร้างจากข้อผิดพลาด (ข้อผิดพลาด สาเหตุ การแก้ไข การป้องกัน) |
+| `user_patterns` | วิเคราะห์รูปแบบการทำงาน — ตารางเวลา เครื่องมือ จุดแข็ง พื้นที่เรียนรู้ |
+| `verify_agent_work` | คงรายงานการยืนยันสำหรับงานเอเจนต์พื้นหลัง ตรวจสอบความเป็นจริงการเปลี่ยนแปลงไฟล์ที่อ้างสิทธิ์เทียบกับ `git diff` |
+
+---
+
+## สถาปัตยกรรม
+
+```
+                    ┌─────────────────┐
+                    │   Core Engine   │
+                    │  (8 operations) │
+                    └────────┬────────┘
+           ┌─────────────────┼─────────────────┐
+           │                 │                 │
+     CLI (memesh)    HTTP API (serve)    MCP (memesh-mcp)
+           │                 │                 │
+           └─────────────────┼─────────────────┘
+                             │
+                    SQLite + FTS5 + sqlite-vec
+                    (~/.memesh/knowledge-graph.db)
+```
+
+Core เป็นอิสระจากเฟรมเวิร์ก ตรรมชาติเดียวกันทำงานจากเทอร์มินัล HTTP หรือ MCP
+
+---
+
+## บริจาค
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
-cd memesh-llm-memory
-npm install
-npm run build
-npm test
+cd memesh-llm-memory && npm install && npm run build
+npm test             # 489 tests
+npm run test:e2e-dashboard
 ```
+
+Dashboard: `cd dashboard && npm install && npm run dev`
+
+---
+
+<p align="center">
+  <strong>MIT</strong> — สร้างโดย <a href="https://pcircle.ai">PCIRCLE AI</a>
+</p>