@pcircle/memesh 2.8.11 → 2.9.0

package/README.th.md

@@ -0,0 +1,171 @@
+<div align="center">
+
+# 🧠 MeMesh Plugin
+
+### ปลั๊กอินเพิ่มประสิทธิภาพสำหรับ Claude Code
+
+หน่วยความจำ การวิเคราะห์งานอัจฉริยะ และระบบอัตโนมัติ — ทั้งหมดในปลั๊กอินเดียว
+
+[![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
+
+[ติดตั้ง](#ติดตั้ง) • [วิธีใช้](#วิธีใช้) • [แก้ไขปัญหา](#แก้ไขปัญหา)
+
+[English](README.md) • [繁體中文](README.zh-TW.md) • [简体中文](README.zh-CN.md) • [日本語](README.ja.md) • [한국어](README.ko.md) • [Français](README.fr.md) • [Deutsch](README.de.md) • [Español](README.es.md) • [Tiếng Việt](README.vi.md) • **ภาษาไทย** • [Bahasa Indonesia](README.id.md)
+
+</div>
+
+---
+
+## ทำไมถึงสร้างโปรเจกต์นี้
+
+ผมชอบ Claude Code มาก มันเปลี่ยนวิธีที่ผมสร้างซอฟต์แวร์
+
+โปรเจกต์นี้เริ่มต้นเพราะผมอยากช่วยให้คนมากขึ้น — โดยเฉพาะคนที่เพิ่งเริ่มเขียนโค้ด — ได้ใช้ประโยชน์จาก Claude Code สำหรับ vibe coding ให้เต็มที่ สิ่งหนึ่งที่ผมสังเกตคือ: เมื่อโปรเจกต์ใหญ่ขึ้น มันยากที่จะติดตามการตัดสินใจทั้งหมดที่ทำไปในแต่ละเซสชัน ผมเลยสร้างปลั๊กอิน (ร่วมกับ Claude Code แน่นอน) ที่จดจำให้คุณ
+
+> **หมายเหตุ**: โปรเจกต์นี้เดิมชื่อ "Claude Code Buddy" และถูกเปลี่ยนชื่อเป็น MeMesh Plugin เพื่อหลีกเลี่ยงปัญหาเครื่องหมายการค้า
+
+## มันทำอะไรได้?
+
+MeMesh Plugin ทำให้ Claude Code ฉลาดขึ้นและมีประสิทธิภาพมากขึ้น ไม่ใช่แค่หน่วยความจำ — เป็นชุดเครื่องมือครบครัน:
+
+**หน่วยความจำโปรเจกต์ที่ค้นหาได้** — บันทึกการตัดสินใจ รูปแบบ และบทเรียนที่ได้เรียนรู้โดยอัตโนมัติ ค้นหาด้วยความหมาย ไม่ใช่แค่คีย์เวิร์ด ถามว่า "เราตัดสินใจเรื่อง auth ยังไง?" แล้วได้คำตอบทันที
+
+**วิเคราะห์งานอัจฉริยะ** — เมื่อคุณพิมพ์ `buddy-do "เพิ่มระบบ auth"` MeMesh จะวิเคราะห์งาน ดึงบริบทที่เกี่ยวข้องจากงานที่ผ่านมา และให้แผนที่สมบูรณ์ก่อนลงมือทำ
+
+**ระบบอัตโนมัติ** — MeMesh ทำงานเบื้องหลังให้คุณ:
+- แสดงสรุปการทำงานครั้งก่อนเมื่อเริ่มเซสชัน
+- ติดตามไฟล์ที่แก้ไขและทดสอบ
+- เตือนให้รีวิวโค้ดก่อน commit
+- กำหนดเส้นทางงานไปยังโมเดลที่เหมาะสม
+
+**เรียนรู้จากข้อผิดพลาด** — บันทึกข้อผิดพลาดและการแก้ไขเพื่อสร้างฐานความรู้และไม่ทำผิดซ้ำ
+
+**ต่างจากหน่วยความจำในตัวของ Claude ยังไง?**
+
+Claude Code มี auto memory และ CLAUDE.md อยู่แล้ว — เหมาะสำหรับการตั้งค่าทั่วไป MeMesh เพิ่ม**เครื่องมือเฉพาะโปรเจกต์**: หน่วยความจำที่ค้นหาด้วยความหมาย การวิเคราะห์งานพร้อมบริบทที่ผ่านมา และเวิร์กโฟลว์อัตโนมัติที่ทำให้ทุกเซสชันมีประสิทธิภาพมากขึ้น
+
+ลองคิดแบบนี้:
+- **CLAUDE.md** = คู่มือการใช้งานสำหรับ Claude
+- **MeMesh** = สมุดบันทึกที่ค้นหาได้ + ผู้ช่วยอัจฉริยะที่เติบโตไปกับโปรเจกต์ของคุณ
+
+---
+
+## ติดตั้ง
+
+**สิ่งที่ต้องมี**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) และ Node.js 20+
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+รีสตาร์ท Claude Code เสร็จแล้ว
+
+**ตรวจสอบการติดตั้ง** — พิมพ์ใน Claude Code:
+
+```
+buddy-help
+```
+
+ถ้าเห็นรายการคำสั่ง แสดงว่าติดตั้งสำเร็จ
+
+<details>
+<summary>ติดตั้งจากซอร์สโค้ด (สำหรับผู้ร่วมพัฒนา)</summary>
+
+```bash
+git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
+cd claude-code-buddy
+npm install && npm run build
+```
+
+</details>
+
+---
+
+## วิธีใช้
+
+MeMesh เพิ่ม 3 คำสั่งใน Claude Code:
+
+| คำสั่ง | ทำอะไร |
+|--------|--------|
+| `buddy-do "งาน"` | รันงานพร้อมบริบทหน่วยความจำ |
+| `buddy-remember "หัวข้อ"` | ค้นหาการตัดสินใจและบริบทที่ผ่านมา |
+| `buddy-help` | แสดงคำสั่งที่ใช้ได้ |
+
+**ตัวอย่าง:**
+
+```bash
+buddy-do "อธิบาย codebase นี้"
+buddy-do "เพิ่มระบบยืนยันตัวตนผู้ใช้"
+buddy-remember "การตัดสินใจออกแบบ API"
+buddy-remember "ทำไมถึงเลือก PostgreSQL"
+```
+
+ข้อมูลทั้งหมดเก็บไว้ในเครื่องของคุณ การตัดสินใจเก็บไว้ 90 วัน บันทึกเซสชันเก็บไว้ 30 วัน
+
+---
+
+## รองรับแพลตฟอร์ม
+
+| แพลตฟอร์ม | สถานะ |
+|-----------|--------|
+| **macOS** | ✅ ใช้ได้ |
+| **Linux** | ✅ ใช้ได้ |
+| **Windows** | ✅ ใช้ได้ (แนะนำ WSL2) |
+
+**ใช้ร่วมกับ:**
+- Claude Code CLI (เทอร์มินัล)
+- Claude Code VS Code Extension
+- Cursor (ผ่าน MCP)
+- เอดิเตอร์อื่นที่รองรับ MCP
+
+**Claude Desktop (Cowork)**: คำสั่งพื้นฐานใช้ได้ แต่ฟีเจอร์หน่วยความจำต้องใช้เวอร์ชัน CLI ดู[รายละเอียด Cowork](docs/COWORK_SUPPORT.md)
+
+---
+
+## แก้ไขปัญหา
+
+**MeMesh ไม่แสดง?**
+
+```bash
+# ตรวจสอบการติดตั้ง
+npm list -g @pcircle/memesh
+
+# ตรวจสอบเวอร์ชัน Node.js (ต้อง 20+)
+node --version
+
+# รันเซ็ตอัพใหม่
+memesh setup
+```
+
+จากนั้นรีสตาร์ท Claude Code ใหม่ทั้งหมด
+
+ข้อมูลเพิ่มเติม: [คู่มือแก้ไขปัญหา](docs/TROUBLESHOOTING.md)
+
+---
+
+## เรียนรู้เพิ่มเติม
+
+- **[เริ่มต้นใช้งาน](docs/GETTING_STARTED.md)** — การตั้งค่าทีละขั้นตอน
+- **[คู่มือผู้ใช้](docs/USER_GUIDE.md)** — คู่มือฉบับเต็มพร้อมตัวอย่าง
+- **[คำสั่ง](docs/COMMANDS.md)** — คำสั่งทั้งหมดที่ใช้ได้
+- **[สถาปัตยกรรม](docs/ARCHITECTURE.md)** — วิธีทำงานเบื้องหลัง
+- **[ร่วมพัฒนา](CONTRIBUTING.md)** — อยากช่วย? เริ่มที่นี่
+- **[คู่มือพัฒนา](docs/DEVELOPMENT.md)** — สำหรับผู้ร่วมพัฒนา
+
+---
+
+## สัญญาอนุญาต
+
+MIT — ดู [LICENSE](LICENSE)
+
+---
+
+<div align="center">
+
+มีปัญหา? [เปิด Issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — เราตอบเร็ว
+
+[รายงานบัก](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [ขอฟีเจอร์](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+
+</div>

package/README.vi.md

@@ -0,0 +1,171 @@
+<div align="center">
+
+# 🧠 MeMesh Plugin
+
+### Plugin năng suất cho Claude Code
+
+Bộ nhớ, phân tích tác vụ thông minh và tự động hóa quy trình — tất cả trong một plugin.
+
+[![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
+
+[Cài đặt](#cài-đặt) • [Cách dùng](#cách-dùng) • [Xử lý sự cố](#xử-lý-sự-cố)
+
+[English](README.md) • [繁體中文](README.zh-TW.md) • [简体中文](README.zh-CN.md) • [日本語](README.ja.md) • [한국어](README.ko.md) • [Français](README.fr.md) • [Deutsch](README.de.md) • [Español](README.es.md) • **Tiếng Việt** • [ภาษาไทย](README.th.md) • [Bahasa Indonesia](README.id.md)
+
+</div>
+
+---
+
+## Tại sao tạo dự án này
+
+Tôi rất thích Claude Code. Nó đã thay đổi cách tôi xây dựng phần mềm.
+
+Dự án này bắt đầu vì tôi muốn giúp nhiều người hơn — đặc biệt là những người mới học lập trình — tận dụng tối đa Claude Code cho vibe coding. Một điều tôi nhận ra: khi dự án lớn dần, rất khó để theo dõi tất cả các quyết định đã được đưa ra qua các phiên làm việc. Vì vậy tôi đã xây dựng một plugin (cùng với Claude Code, tất nhiên) để ghi nhớ giúp bạn.
+
+> **Lưu ý**: Dự án này ban đầu có tên "Claude Code Buddy" và đã được đổi tên thành MeMesh Plugin để tránh các vấn đề về thương hiệu.
+
+## Nó làm được gì?
+
+MeMesh Plugin giúp Claude Code thông minh hơn và năng suất hơn. Không chỉ là bộ nhớ — mà là bộ công cụ hoàn chỉnh:
+
+**Bộ nhớ dự án có thể tìm kiếm** — Tự động lưu các quyết định, mẫu thiết kế và bài học. Tìm kiếm theo ý nghĩa, không chỉ từ khóa. Hỏi "chúng ta đã quyết định gì về auth?" và nhận câu trả lời ngay.
+
+**Phân tích tác vụ thông minh** — Khi bạn gõ `buddy-do "thêm auth"`, MeMesh phân tích tác vụ, lấy ngữ cảnh liên quan từ công việc trước đó, và đưa ra kế hoạch đầy đủ trước khi thực hiện.
+
+**Tự động hóa quy trình** — MeMesh tự động làm việc nền:
+- Hiển thị tóm tắt phiên trước khi bắt đầu
+- Theo dõi các file đã sửa và kiểm thử
+- Nhắc review code trước khi commit
+- Định tuyến tác vụ đến model tối ưu
+
+**Học từ lỗi** — Ghi lại lỗi và cách sửa để xây dựng cơ sở tri thức và tránh lặp lại sai lầm.
+
+**Khác gì so với bộ nhớ tích hợp của Claude?**
+
+Claude Code đã có auto memory và CLAUDE.md — tốt cho cài đặt chung. MeMesh bổ sung **công cụ chuyên dụng cho dự án**: bộ nhớ tìm kiếm theo ý nghĩa, phân tích tác vụ với ngữ cảnh trước đó, và quy trình tự động giúp mỗi phiên làm việc hiệu quả hơn.
+
+Hãy nghĩ như thế này:
+- **CLAUDE.md** = sách hướng dẫn sử dụng cho Claude
+- **MeMesh** = sổ tay tìm kiếm được + trợ lý thông minh phát triển cùng dự án
+
+---
+
+## Cài đặt
+
+**Bạn cần**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) và Node.js 20+
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+Khởi động lại Claude Code. Xong.
+
+**Kiểm tra hoạt động** — gõ lệnh này trong Claude Code:
+
+```
+buddy-help
+```
+
+Bạn sẽ thấy danh sách các lệnh.
+
+<details>
+<summary>Cài đặt từ mã nguồn (cho người đóng góp)</summary>
+
+```bash
+git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
+cd claude-code-buddy
+npm install && npm run build
+```
+
+</details>
+
+---
+
+## Cách dùng
+
+MeMesh thêm 3 lệnh vào Claude Code:
+
+| Lệnh | Chức năng |
+|------|-----------|
+| `buddy-do "nhiệm vụ"` | Chạy nhiệm vụ với ngữ cảnh bộ nhớ |
+| `buddy-remember "chủ đề"` | Tìm kiếm các quyết định và ngữ cảnh trước đó |
+| `buddy-help` | Hiển thị các lệnh có sẵn |
+
+**Ví dụ:**
+
+```bash
+buddy-do "giải thích codebase này"
+buddy-do "thêm xác thực người dùng"
+buddy-remember "quyết định thiết kế API"
+buddy-remember "tại sao chọn PostgreSQL"
+```
+
+Tất cả dữ liệu được lưu trên máy của bạn. Các quyết định được giữ 90 ngày, ghi chú phiên được giữ 30 ngày.
+
+---
+
+## Nền tảng hỗ trợ
+
+| Nền tảng | Trạng thái |
+|----------|-----------|
+| **macOS** | ✅ Hoạt động |
+| **Linux** | ✅ Hoạt động |
+| **Windows** | ✅ Hoạt động (khuyên dùng WSL2) |
+
+**Hoạt động với:**
+- Claude Code CLI (terminal)
+- Claude Code VS Code Extension
+- Cursor (qua MCP)
+- Các editor tương thích MCP khác
+
+**Claude Desktop (Cowork)**: Các lệnh cơ bản hoạt động, nhưng tính năng bộ nhớ cần phiên bản CLI. Xem [chi tiết Cowork](docs/COWORK_SUPPORT.md).
+
+---
+
+## Xử lý sự cố
+
+**MeMesh không hiển thị?**
+
+```bash
+# Kiểm tra đã cài đặt chưa
+npm list -g @pcircle/memesh
+
+# Kiểm tra phiên bản Node.js (cần 20+)
+node --version
+
+# Chạy lại setup
+memesh setup
+```
+
+Sau đó khởi động lại Claude Code hoàn toàn.
+
+Thêm trợ giúp: [Hướng dẫn xử lý sự cố](docs/TROUBLESHOOTING.md)
+
+---
+
+## Tìm hiểu thêm
+
+- **[Bắt đầu](docs/GETTING_STARTED.md)** — Hướng dẫn cài đặt từng bước
+- **[Hướng dẫn sử dụng](docs/USER_GUIDE.md)** — Hướng dẫn đầy đủ với ví dụ
+- **[Lệnh](docs/COMMANDS.md)** — Tất cả các lệnh có sẵn
+- **[Kiến trúc](docs/ARCHITECTURE.md)** — Cách hoạt động bên trong
+- **[Đóng góp](CONTRIBUTING.md)** — Muốn giúp? Bắt đầu tại đây
+- **[Hướng dẫn phát triển](docs/DEVELOPMENT.md)** — Cho người đóng góp
+
+---
+
+## Giấy phép
+
+MIT — Xem [LICENSE](LICENSE)
+
+---
+
+<div align="center">
+
+Có vấn đề? [Mở Issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — chúng tôi phản hồi nhanh.
+
+[Báo lỗi](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [Yêu cầu tính năng](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+
+</div>

package/README.zh-CN.md

@@ -0,0 +1,171 @@
+<div align="center">
+
+# 🧠 MeMesh Plugin
+
+### Claude Code 的生产力插件
+
+记忆、智能任务分析、工作流自动化 — 一个插件搞定。
+
+[![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
+
+[安装](#安装) • [使用方法](#使用方法) • [故障排除](#故障排除)
+
+[English](README.md) • [繁體中文](README.zh-TW.md) • **简体中文** • [日本語](README.ja.md) • [한국어](README.ko.md) • [Français](README.fr.md) • [Deutsch](README.de.md) • [Español](README.es.md) • [Tiếng Việt](README.vi.md) • [ภาษาไทย](README.th.md) • [Bahasa Indonesia](README.id.md)
+
+</div>
+
+---
+
+## 为什么做这个项目
+
+我很喜欢 Claude Code，它改变了我写软件的方式。
+
+这个项目的起点很简单：我想帮助更多人 — 特别是刚接触编程的新手 — 更好地用 Claude Code 来 vibe coding。我发现当项目越来越大，很难记住跨 session 做过的所有决策。所以我（跟 Claude Code 一起）做了一个插件，帮你记住。
+
+> **备注**：本项目原名「Claude Code Buddy」，为避免潜在商标问题已更名为 MeMesh Plugin。
+
+## 它能做什么？
+
+MeMesh Plugin 让 Claude Code 更聪明、更有生产力。不只是记忆 — 它是一整套工具：
+
+**可搜索的项目记忆** — 工作时自动保存决策、模式和经验教训。用语义搜索，不只是关键字。问「我们之前怎么决定 auth 的？」就能马上得到答案。
+
+**智能任务分析** — 当你说 `buddy-do "加上用户认证"`，MeMesh 会分析任务、从过去的工作中拉出相关上下文，在执行前给你一个完整的计划。
+
+**工作流自动化** — MeMesh 在后台自动帮你：
+- 开始新 session 时显示上次工作摘要
+- 追踪你改了哪些文件、测试了哪些
+- 在 commit 前提醒你做 code review
+- 把任务分配到最合适的模型（搜索用快的、规划用强的）
+
+**从错误中学习** — 记录错误和修复方式，避免重蹈覆辙。MeMesh 会建立一个什么有效、什么不行的知识库。
+
+**跟 Claude 内建记忆有什么不同？**
+
+Claude Code 已经有 auto memory 和 CLAUDE.md — 很适合存一般偏好和指令。MeMesh 在此基础上增加了项目级的**专用工具**：可用语义搜索的记忆、能拉取过去上下文的任务分析、以及让每个 session 都更有效率的自动化工作流。
+
+简单来说：
+- **CLAUDE.md** = 你写给 Claude 的使用手册
+- **MeMesh** = 可搜索的笔记本 + 随项目成长而学习的智能助手
+
+---
+
+## 安装
+
+**你需要**：[Claude Code](https://docs.anthropic.com/en/docs/claude-code) 和 Node.js 20+
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+重启 Claude Code，完成。
+
+**确认安装成功** — 在 Claude Code 中输入：
+
+```
+buddy-help
+```
+
+看到指令列表就代表安装成功。
+
+<details>
+<summary>从源码安装（给贡献者）</summary>
+
+```bash
+git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
+cd claude-code-buddy
+npm install && npm run build
+```
+
+</details>
+
+---
+
+## 使用方法
+
+MeMesh 在 Claude Code 中增加 3 个指令：
+
+| 指令 | 功能 |
+|------|------|
+| `buddy-do "任务"` | 带着记忆上下文执行任务 |
+| `buddy-remember "主题"` | 搜索过去的决策和上下文 |
+| `buddy-help` | 显示可用指令 |
+
+**示例：**
+
+```bash
+buddy-do "解释这个 codebase"
+buddy-do "加上用户认证"
+buddy-remember "API 设计决策"
+buddy-remember "为什么选 PostgreSQL"
+```
+
+所有数据都存在你的电脑上。决策保留 90 天，session 笔记保留 30 天。
+
+---
+
+## 支持环境
+
+| 平台 | 状态 |
+|------|------|
+| **macOS** | ✅ 正常 |
+| **Linux** | ✅ 正常 |
+| **Windows** | ✅ 正常（建议 WSL2）|
+
+**可搭配使用：**
+- Claude Code CLI（终端）
+- Claude Code VS Code 扩展
+- Cursor（通过 MCP）
+- 其他兼容 MCP 的编辑器
+
+**Claude Desktop (Cowork)**：基本指令可用，记忆功能需使用 CLI 版本。详见 [Cowork 说明](docs/COWORK_SUPPORT.md)。
+
+---
+
+## 故障排除
+
+**MeMesh 没出现？**
+
+```bash
+# 确认已安装
+npm list -g @pcircle/memesh
+
+# 确认 Node.js 版本（需要 20+）
+node --version
+
+# 重新设置
+memesh setup
+```
+
+然后完全重启 Claude Code。
+
+更多说明：[故障排除指南](docs/TROUBLESHOOTING.md)
+
+---
+
+## 了解更多
+
+- **[快速开始](docs/GETTING_STARTED.md)** — 一步步安装教程
+- **[使用指南](docs/USER_GUIDE.md)** — 完整使用示例
+- **[指令参考](docs/COMMANDS.md)** — 所有可用指令
+- **[架构说明](docs/ARCHITECTURE.md)** — 内部运作原理
+- **[贡献指南](CONTRIBUTING.md)** — 想帮忙？从这里开始
+- **[开发指南](docs/DEVELOPMENT.md)** — 给贡献者
+
+---
+
+## 许可证
+
+MIT — 详见 [LICENSE](LICENSE)
+
+---
+
+<div align="center">
+
+遇到问题？[提交 Issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — 我们会快速回应。
+
+[提交 Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [功能请求](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+
+</div>