README.th.md

🌐 นี่คือการแปลอัตโนมัติ ยินดีต้อนรับการแก้ไขจากชุมชน!

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 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

ระบบการบีบอัดหน่วยความจำถาวรที่สร้างขึ้นสำหรับ Claude Code

เริ่มต้นอย่างรวดเร็ว • วิธีการทำงาน • เครื่องมือค้นหา • เอกสาร • การกำหนดค่า • การแก้ไขปัญหา • ใบอนุญาต

Claude-Mem รักษาบริบทข้ามเซสชันได้อย่างราบรื่นโดยการบันทึกผลการสังเกตจากการใช้เครื่องมือโดยอัตโนมัติ สร้างสรุปความหมาย และทำให้พร้อมใช้งานสำหรับเซสชันในอนาคต สิ่งนี้ช่วยให้ Claude สามารถรักษาความต่อเนื่องของความรู้เกี่ยวกับโปรเจกต์ได้แม้หลังจากเซสชันสิ้นสุดหรือเชื่อมต่อใหม่

---

เริ่มต้นอย่างรวดเร็ว

ติดตั้งด้วยคำสั่งเดียว:

npx claude-mem install

หรือติดตั้งสำหรับ OpenCode:

npx claude-mem install --ide opencode

หรือติดตั้งสำหรับ Antigravity CLI (คู่มือการตั้งค่า):

npx claude-mem install --ide antigravity

หรือติดตั้งจาก plugin marketplace ภายใน Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

รีสตาร์ท Claude Code บริบทจากเซสชันก่อนหน้าจะปรากฏในเซสชันใหม่โดยอัตโนมัติ

หมายเหตุ: Claude-Mem ยังถูกเผยแพร่บน npm ด้วย แต่ npm install -g claude-mem จะติดตั้งเฉพาะ SDK/library เท่านั้น — จะไม่ลงทะเบียน plugin hooks หรือตั้งค่า worker service ให้ ควรติดตั้งผ่าน npx claude-mem install หรือคำสั่ง /plugin ด้านบนเสมอ

🦞 OpenClaw Gateway

ติดตั้ง claude-mem เป็นปลั๊กอินหน่วยความจำถาวรบนเกตเวย์ OpenClaw ด้วยคำสั่งเดียว:

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

ตัวติดตั้งจะจัดการ dependencies การตั้งค่าปลั๊กอิน การกำหนดค่า AI provider การเริ่มต้น worker และฟีดการสังเกตแบบเรียลไทม์ที่เป็นทางเลือกไปยัง Telegram, Discord, Slack และอื่นๆ ดู คู่มือการผสานรวม OpenClaw สำหรับรายละเอียด

คุณสมบัติหลัก:

• 🧠 หน่วยความจำถาวร - บริบทยังคงอยู่ข้ามเซสชัน
• 📊 การเปิดเผยแบบก้าวหน้า - การดึงหน่วยความจำแบบชั้นพร้อมการแสดงต้นทุนโทเค็น
• 🔍 การค้นหาตามทักษะ - สืบค้นประวัติโปรเจกต์ของคุณด้วยทักษะ mem-search
• 🖥️ Web Viewer UI - สตรีมหน่วยความจำแบบเรียลไทม์ที่ URL ของ worker ซึ่งพิมพ์ออกมาตอนเริ่มต้น
• 💻 Claude Desktop Skill - ค้นหาหน่วยความจำจากการสนทนา Claude Desktop
• 🔒 การควบคุมความเป็นส่วนตัว - ใช้แท็ก <private> เพื่อยกเว้นเนื้อหาที่ละเอียดอ่อนจากการจัดเก็บ
• ⚙️ การกำหนดค่าบริบท - ควบคุมบริบทที่ถูกฉีดเข้ามาได้อย่างละเอียด
• 🤖 การทำงานอัตโนมัติ - ไม่ต้องแทรกแซงด้วยตนเอง
• 🔗 การอ้างอิง - อ้างอิงการสังเกตในอดีตด้วย ID ผ่าน worker API หรือดูทั้งหมดใน web viewer

---

เอกสาร

📚 ดูเอกสารฉบับเต็ม - เรียกดูบนเว็บไซต์อย่างเป็นทางการ

เริ่มต้นใช้งาน

• คู่มือการติดตั้ง - เริ่มต้นอย่างรวดเร็วและการติดตั้งขั้นสูง
• คู่มือการใช้งาน - วิธีที่ Claude-Mem ทำงานโดยอัตโนมัติ
• เครื่องมือค้นหา - สืบค้นประวัติโปรเจกต์ของคุณด้วยภาษาธรรมชาติ

แนวปฏิบัติที่ดี

• Context Engineering - หลักการปรับบริบทสำหรับเอเจนต์ AI
• Progressive Disclosure - ปรัชญาเบื้องหลังกลยุทธ์การเตรียมบริบทของ Claude-Mem

สถาปัตยกรรม

• ภาพรวม - ส่วนประกอบของระบบและการไหลของข้อมูล
• วิวัฒนาการของสถาปัตยกรรม - การเดินทางจาก v3 สู่ v5
• สถาปัตยกรรม Hooks - วิธีที่ Claude-Mem ใช้ lifecycle hooks
• การอ้างอิง Hooks - อธิบาย hook scripts ทั้ง 7 ตัว
• Worker Service - HTTP API และการจัดการ Bun
• ฐานข้อมูล - SQLite schema และการค้นหา FTS5
• สถาปัตยกรรมการค้นหา - การค้นหาแบบไฮบริดด้วยฐานข้อมูลเวกเตอร์ Chroma

การกำหนดค่าและการพัฒนา

• การกำหนดค่า - ตัวแปรสภาพแวดล้อมและการตั้งค่า
• การพัฒนา - การสร้าง การทดสอบ การมีส่วนร่วม
• Release Branches - ลำดับการไหลของ branch แบบ stable, core-dev และ community-edge
• การแก้ไขปัญหา - ปัญหาและการแก้ไขทั่วไป

---

วิธีการทำงาน

ส่วนประกอบหลัก:

1. 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts)
2. Smart Install - ตัวตรวจสอบการพึ่งพาที่ถูกแคช (pre-hook script, ไม่ใช่ lifecycle hook)
3. Worker Service - HTTP API ในเครื่องพร้อม web viewer UI และ search endpoints จัดการโดย Bun
4. SQLite Database - จัดเก็บเซสชัน การสังเกต สรุป
5. mem-search Skill - คิวรีภาษาธรรมชาติพร้อมการเปิดเผยแบบก้าวหน้า
6. Chroma Vector Database - การค้นหาแบบไฮบริดทางความหมาย + คีย์เวิร์ดสำหรับการดึงบริบทอัจฉริยะ

ดู ภาพรวมสถาปัตยกรรม สำหรับรายละเอียด

---

MCP Search Tools

Claude-Mem มอบการค้นหาหน่วยความจำอัจฉริยะผ่าน MCP tools 4 ตัว โดยใช้รูปแบบ workflow 3 ชั้นที่ประหยัดโทเค็น:

Workflow 3 ชั้น:

1. search - รับดัชนีแบบกระชับพร้อม ID (~50-100 โทเค็น/ผลลัพธ์)
2. timeline - รับบริบทตามลำดับเวลารอบผลลัพธ์ที่น่าสนใจ
3. get_observations - ดึงรายละเอียดฉบับเต็มเฉพาะสำหรับ ID ที่กรองแล้ว (~500-1,000 โทเค็น/ผลลัพธ์)

วิธีการทำงาน:

• Claude ใช้ MCP tools ในการค้นหาหน่วยความจำของคุณ
• เริ่มด้วย search เพื่อรับดัชนีของผลลัพธ์
• ใช้ timeline เพื่อดูว่าเกิดอะไรขึ้นรอบๆ การสังเกตเฉพาะ
• ใช้ get_observations เพื่อดึงรายละเอียดฉบับเต็มสำหรับ ID ที่เกี่ยวข้อง
• ประหยัดโทเค็นได้ประมาณ 10 เท่า โดยการกรองก่อนที่จะดึงรายละเอียด

MCP Tools ที่มีให้ใช้งาน:

1. search - ค้นหาดัชนีหน่วยความจำด้วยคิวรีข้อความเต็ม กรองตามประเภท/วันที่/โปรเจกต์
2. timeline - รับบริบทตามลำดับเวลารอบการสังเกตหรือคิวรีเฉพาะ
3. get_observations - ดึงรายละเอียดการสังเกตฉบับเต็มด้วย ID (ควรรวม ID หลายตัวเป็นชุดเสมอ)

ตัวอย่างการใช้งาน:

// ขั้นตอนที่ 1: ค้นหาเพื่อรับดัชนี
search(query="authentication bug", type="bugfix", limit=10)

// ขั้นตอนที่ 2: ตรวจสอบดัชนี ระบุ ID ที่เกี่ยวข้อง (เช่น #123, #456)

// ขั้นตอนที่ 3: ดึงรายละเอียดฉบับเต็ม
get_observations(ids=[123, 456])

ดู คู่มือเครื่องมือค้นหา สำหรับตัวอย่างโดยละเอียด

---

Release Branches

รุ่นเสถียร (Stable) จะถูกปล่อยจาก main และเผยแพร่ไปยัง npm ส่วน core-dev และ community-edge เป็น branch ที่รันจาก source สำหรับการแก้ไขความน่าเชื่อถือในช่วงแรกและ การผสานรวมของชุมชน ดู Release Branches สำหรับลำดับการไหลของ branch และคำแนะนำการรันเวอร์ชันที่ไม่เสถียร

---

ความต้องการของระบบ

• Node.js: 20.0.0 หรือสูงกว่า
• Claude Code: เวอร์ชันล่าสุดพร้อมการสนับสนุนปลั๊กอิน
• Bun: JavaScript runtime และตัวจัดการกระบวนการ (ติดตั้งอัตโนมัติหากไม่มี)
• uv: ตัวจัดการแพ็คเกจ Python สำหรับการค้นหาเวกเตอร์ (ติดตั้งอัตโนมัติหากไม่มี)
• SQLite 3: สำหรับการจัดเก็บถาวร (รวมอยู่)

---

หมายเหตุการตั้งค่าสำหรับ Windows

หากคุณเห็นข้อผิดพลาดคล้ายกับ:

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

ตรวจสอบให้แน่ใจว่าได้ติดตั้ง Node.js และ npm แล้ว และเพิ่มลงใน PATH ของคุณ ดาวน์โหลดตัวติดตั้ง Node.js ล่าสุดจาก https://nodejs.org และรีสตาร์ทเทอร์มินัลของคุณหลังจากการติดตั้ง

---

การกำหนดค่า

การตั้งค่าจะถูกจัดการใน ~/.claude-mem/settings.json (สร้างอัตโนมัติพร้อมค่าเริ่มต้นในการรันครั้งแรก) กำหนดค่าโมเดล AI พอร์ต worker ไดเรกทอรีข้อมูล ระดับ log และการตั้งค่าการฉีดบริบท

ดู คู่มือการกำหนดค่า สำหรับการตั้งค่าทั้งหมดที่มีและตัวอย่าง

การกำหนดค่าโหมดและภาษา

Claude-Mem รองรับโหมด workflow และภาษาหลายแบบผ่านการตั้งค่า CLAUDE_MEM_MODE

ตัวเลือกนี้ควบคุมทั้งสองสิ่งนี้:

• พฤติกรรมของ workflow (เช่น code, chill, investigation)
• ภาษาที่ใช้ในการสังเกตที่สร้างขึ้น

วิธีการกำหนดค่า

แก้ไขไฟล์การตั้งค่าของคุณที่ ~/.claude-mem/settings.json:

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

โหมดต่างๆ ถูกกำหนดไว้ใน plugin/modes/ เพื่อดูโหมดทั้งหมดที่มีในเครื่อง:

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

โหมดที่มีให้ใช้งาน

โหมด	คำอธิบาย
code	โหมดภาษาอังกฤษเริ่มต้น
code--zh	โหมดภาษาจีนตัวย่อ
code--ja	โหมดภาษาญี่ปุ่น

โหมดเฉพาะภาษาปฏิบัติตามรูปแบบ code--[lang] โดยที่ [lang] คือรหัสภาษา ISO 639-1 (เช่น zh สำหรับภาษาจีน, ja สำหรับภาษาญี่ปุ่น, es สำหรับภาษาสเปน)

หมายเหตุ: code--zh (ภาษาจีนตัวย่อ) มีอยู่ในตัวแล้ว — ไม่จำเป็นต้องติดตั้งเพิ่มเติมหรืออัปเดตปลั๊กอิน

หลังจากเปลี่ยนโหมด

รีสตาร์ท Claude Code เพื่อใช้การกำหนดค่าโหมดใหม่

การพัฒนา

ดู คู่มือการพัฒนา สำหรับคำแนะนำการสร้าง การทดสอบ และขั้นตอนการมีส่วนร่วม

---

การแก้ไขปัญหา

หากพบปัญหา อธิบายปัญหาให้ Claude ฟังและทักษะ troubleshoot จะวินิจฉัยและให้การแก้ไขโดยอัตโนมัติ

ดู คู่มือการแก้ไขปัญหา สำหรับปัญหาและการแก้ไขทั่วไป

---

รายงานบั๊ก

สร้างรายงานบั๊กที่ครอบคลุมด้วยตัวสร้างอัตโนมัติ:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

การมีส่วนร่วม

ยินดีรับการมีส่วนร่วม! กรุณา:

1. Fork repository
2. สร้าง feature branch
3. ทำการเปลี่ยนแปลงพร้อมการทดสอบ
4. อัปเดตเอกสาร
5. ส่ง Pull Request

Claude-Mem เผยแพร่จากสาม branch: main (stable), core-dev, และ community-edge มีเพียง main เท่านั้นที่เผยแพร่ไปยัง npm ส่วนที่เหลือรันจาก source ดู Release Branches สำหรับ กลยุทธ์และคำแนะนำการรันในเครื่อง

ดู คู่มือการพัฒนา สำหรับขั้นตอนการมีส่วนร่วม

---

ใบอนุญาต

Claude-Mem อยู่ภายใต้ใบอนุญาต Apache License 2.0

เราเลือก Apache-2.0 เพราะหน่วยความจำแบบเอเจนต์ถาวรควรฝังตัวได้ง่ายในเครื่องมือของนักพัฒนา เอเจนต์ในเครื่อง เซิร์ฟเวอร์ MCP ระบบองค์กร สแตกหุ่นยนต์ และ production agent harness

ดูไฟล์ LICENSE สำหรับรายละเอียดฉบับเต็ม ดู docs/license.md และ docs/ip-boundary.md สำหรับขอบเขตของใบอนุญาตและ ขอบเขตระหว่างโอเพนซอร์ส/เชิงพาณิชย์

หมายเหตุเกี่ยวกับ Ragtime: ไดเรกทอรี ragtime/ อยู่ภายใต้ใบอนุญาต Apache License 2.0 ดู ragtime/LICENSE สำหรับรายละเอียด

---

การสนับสนุน

• เอกสาร: docs/
• ปัญหา: GitHub Issues
• Repository: github.com/thedotmack/claude-mem
• บัญชี X อย่างเป็นทางการ: @Claude_Memory
• Discord อย่างเป็นทางการ: เข้าร่วม Discord
• ผู้เขียน: Alex Newman (@thedotmack)

---

สร้างด้วย Claude Agent SDK | ใช้งานร่วมกับ Claude Code | สร้างด้วย TypeScript

---

CMEM คืออะไร?

CMEM เป็นโทเค็นที่สร้างขึ้นโดยบุคคลที่สาม แต่ได้รับการยอมรับอย่างเป็นทางการจากผู้สร้าง Claude-Mem (Alex Newman, @thedotmack) โทเค็นนี้ทำหน้าที่เป็นตัวเร่งของชุมชนสำหรับการเติบโตและเป็นช่องทางในการนำ CMEM ไปสู่นักพัฒนาและผู้ปฏิบัติงานด้านความรู้ที่ต้องการมันมากที่สุด

Official BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3