🌐 นี่คือการแปลอัตโนมัติ ยินดีต้อนรับการแก้ไขจากชุมชน!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
ระบบการบีบอัดหน่วยความจำถาวรที่สร้างขึ้นสำหรับ Claude Code
เริ่มต้นอย่างรวดเร็ว • วิธีการทำงาน • เครื่องมือค้นหา • เอกสาร • การกำหนดค่า • การแก้ไขปัญหา • ใบอนุญาต
Claude-Mem รักษาบริบทข้ามเซสชันได้อย่างราบรื่นโดยการบันทึกผลการสังเกตจากการใช้เครื่องมือโดยอัตโนมัติ สร้างสรุปความหมาย และทำให้พร้อมใช้งานสำหรับเซสชันในอนาคต ทำให้ Claude สามารถรักษาความต่อเนื่องของความรู้เกี่ยวกับโปรเจกต์แม้หลังจากเซสชันสิ้นสุดหรือเชื่อมต่อใหม่
เริ่มเซสชัน Claude Code ใหม่ในเทอร์มินัลและป้อนคำสั่งต่อไปนี้:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
รีสตาร์ท Claude Code บริบทจากเซสชันก่อนหน้าจะปรากฏในเซสชันใหม่โดยอัตโนมัติ
คุณสมบัติหลัก:
- 🧠 หน่วยความจำถาวร - บริบทยังคงอยู่ข้ามเซสชัน
- 📊 การเปิดเผยแบบก้าวหน้า - การดึงหน่วยความจำแบบชั้นพร้อมการแสดงต้นทุนโทเค็น
- 🔍 การค้นหาตามทักษะ - สืบค้นประวัติโปรเจกต์ของคุณด้วยทักษะ mem-search
- 🖥️ Web Viewer UI - สตรีมหน่วยความจำแบบเรียลไทม์ที่ http://localhost:37777
- 💻 Claude Desktop Skill - ค้นหาหน่วยความจำจากการสนทนา Claude Desktop
- 🔒 การควบคุมความเป็นส่วนตัว - ใช้แท็ก
<private>เพื่อยกเว้นเนื้อหาที่ละเอียดอ่อนจากการจัดเก็บ - ⚙️ การกำหนดค่าบริบท - ควบคุมบริบทที่ถูกฉีดเข้ามาได้อย่างละเอียด
- 🤖 การทำงานอัตโนมัติ - ไม่ต้องแทรกแซงด้วยตนเอง
- 🔗 การอ้างอิง - อ้างอิงการสังเกตในอดีตด้วย ID (เข้าถึงผ่าน http://localhost:37777/api/observation/{id} หรือดูทั้งหมดใน web viewer ที่ http://localhost:37777)
- 🧪 Beta Channel - ลองคุณสมบัติทดลองเช่น Endless Mode ผ่านการสลับเวอร์ชัน
📚 ดูเอกสารฉบับเต็ม - เรียกดูบนเว็บไซต์อย่างเป็นทางการ
- คู่มือการติดตั้ง - เริ่มต้นอย่างรวดเร็วและการติดตั้งขั้นสูง
- คู่มือการใช้งาน - วิธีที่ Claude-Mem ทำงานโดยอัตโนมัติ
- เครื่องมือค้นหา - สืบค้นประวัติโปรเจกต์ของคุณด้วยภาษาธรรมชาติ
- คุณสมบัติ Beta - ลองคุณสมบัติทดลองเช่น Endless Mode
- 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
- การกำหนดค่า - ตัวแปรสภาพแวดล้อมและการตั้งค่า
- การพัฒนา - การสร้าง การทดสอบ การมีส่วนร่วม
- การแก้ไขปัญหา - ปัญหาและการแก้ไขทั่วไป
ส่วนประกอบหลัก:
- 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts)
- Smart Install - ตัวตรวจสอบการพึ่งพาที่ถูกแคช (pre-hook script, ไม่ใช่ lifecycle hook)
- Worker Service - HTTP API บนพอร์ต 37777 พร้อม web viewer UI และ 10 search endpoints, จัดการโดย Bun
- SQLite Database - จัดเก็บเซสชัน การสังเกต สรุป
- mem-search Skill - คิวรีภาษาธรรมชาติพร้อมการเปิดเผยแบบก้าวหน้า
- Chroma Vector Database - การค้นหาแบบไฮบริดทางความหมาย + คีย์เวิร์ดสำหรับการดึงบริบทอัจฉริยะ
ดู ภาพรวมสถาปัตยกรรม สำหรับรายละเอียด
Claude-Mem ให้บริการการค้นหาอัจฉริยะผ่านทักษะ mem-search ที่เรียกใช้อัตโนมัติเมื่อคุณถามเกี่ยวกับงานที่ผ่านมา:
วิธีการทำงาน:
- เพียงถามตามธรรมชาติ: "เราทำอะไรในเซสชันที่แล้ว?" หรือ "เราแก้บั๊กนี้ไปแล้วหรือยัง?"
- Claude เรียกใช้ทักษะ mem-search โดยอัตโนมัติเพื่อค้นหาบริบทที่เกี่ยวข้อง
การดำเนินการค้นหาที่มี:
- Search Observations - การค้นหาข้อความเต็มข้ามการสังเกต
- Search Sessions - การค้นหาข้อความเต็มข้ามสรุปเซสชัน
- Search Prompts - ค้นหาคำขอผู้ใช้แบบดิบ
- By Concept - ค้นหาตามแท็กแนวคิด (discovery, problem-solution, pattern, ฯลฯ)
- By File - ค้นหาการสังเกตที่อ้างอิงไฟล์เฉพาะ
- By Type - ค้นหาตามประเภท (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - รับบริบทเซสชันล่าสุดสำหรับโปรเจกต์
- Timeline - รับไทม์ไลน์รวมของบริบทรอบจุดเวลาเฉพาะ
- Timeline by Query - ค้นหาการสังเกตและรับบริบทไทม์ไลน์รอบการจับคู่ที่ดีที่สุด
- API Help - รับเอกสาร search API
ตัวอย่างคิวรีภาษาธรรมชาติ:
"What bugs did we fix last session?" "How did we implement authentication?" "What changes were made to worker-service.ts?" "Show me recent work on this project" "What was happening when we added the viewer UI?"
ดู คู่มือเครื่องมือค้นหา สำหรับตัวอย่างโดยละเอียด
Claude-Mem นำเสนอ beta channel พร้อมคุณสมบัติทดลองเช่น Endless Mode (สถาปัตยกรรมหน่วยความจำแบบชีวมิติสำหรับเซสชันที่ขยายออกไป) สลับระหว่างเวอร์ชันเสถียรและเบต้าจาก web viewer UI ที่ http://localhost:37777 → Settings
ดู เอกสารคุณสมบัติ Beta สำหรับรายละเอียดเกี่ยวกับ Endless Mode และวิธีการลอง
- Node.js: 18.0.0 หรือสูงกว่า
- Claude Code: เวอร์ชันล่าสุดพร้อมการสนับสนุนปลั๊กอิน
- Bun: JavaScript runtime และตัวจัดการกระบวนการ (ติดตั้งอัตโนมัติหากไม่มี)
- uv: ตัวจัดการแพ็คเกจ Python สำหรับการค้นหาเวกเตอร์ (ติดตั้งอัตโนมัติหากไม่มี)
- SQLite 3: สำหรับการจัดเก็บถาวร (รวมอยู่)
การตั้งค่าจะถูกจัดการใน ~/.claude-mem/settings.json (สร้างอัตโนมัติพร้อมค่าเริ่มต้นในการรันครั้งแรก) กำหนดค่าโมเดล AI พอร์ต worker ไดเรกทอรีข้อมูล ระดับ log และการตั้งค่าการฉีดบริบท
ดู คู่มือการกำหนดค่า สำหรับการตั้งค่าทั้งหมดที่มีและตัวอย่าง
ดู คู่มือการพัฒนา สำหรับคำแนะนำการสร้าง การทดสอบ และขั้นตอนการมีส่วนร่วม
หากพบปัญหา อธิบายปัญหาให้ Claude ฟังและทักษะ troubleshoot จะวินิจฉัยและให้การแก้ไขโดยอัตโนมัติ
ดู คู่มือการแก้ไขปัญหา สำหรับปัญหาและการแก้ไขทั่วไป
สร้างรายงานบั๊กที่ครอบคลุมด้วยตัวสร้างอัตโนมัติ:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
ยินดีรับการมีส่วนร่วม! กรุณา:
- Fork repository
- สร้าง feature branch
- ทำการเปลี่ยนแปลงพร้อมการทดสอบ
- อัปเดตเอกสาร
- ส่ง Pull Request
ดู คู่มือการพัฒนา สำหรับขั้นตอนการมีส่วนร่วม
โปรเจกต์นี้ได้รับอนุญาตภายใต้ GNU Affero General Public License v3.0 (AGPL-3.0)
Copyright (C) 2025 Alex Newman (@thedotmack) สงวนลิขสิทธิ์ทั้งหมด
ดูไฟล์ LICENSE สำหรับรายละเอียดทั้งหมด
ความหมาย:
- คุณสามารถใช้ ดัดแปลง และแจกจ่ายซอฟต์แวร์นี้ได้อย่างอิสระ
- หากคุณดัดแปลงและปรับใช้บนเซิร์ฟเวอร์เครือข่าย คุณต้องทำให้ซอร์สโค้ดของคุณพร้อมใช้งาน
- งานที่เป็นอนุพันธ์ต้องได้รับอนุญาตภายใต้ AGPL-3.0 ด้วย
- ไม่มีการรับประกันสำหรับซอฟต์แวร์นี้
หมายเหตุเกี่ยวกับ Ragtime: ไดเรกทอรี ragtime/ ได้รับอนุญาตแยกต่างหากภายใต้ PolyForm Noncommercial License 1.0.0 ดู ragtime/LICENSE สำหรับรายละเอียด
- เอกสาร: docs/
- ปัญหา: GitHub Issues
- Repository: github.com/thedotmack/claude-mem
- ผู้เขียน: Alex Newman (@thedotmack)
สร้างด้วย Claude Agent SDK | ขับเคลื่อนโดย Claude Code | สร้างด้วย TypeScript
