# 🚀 คู่มือการใช้งาน AiMe (Local MCP Bridge for ChatGPT)

> **AiMe** คือโปรแกรมเชื่อมต่อระหว่าง **ChatGPT** กับ **คอมพิวเตอร์ของคุณ (Windows)** อย่างปลอดภัย 100% ทำให้ ChatGPT สามารถอ่านโค้ด, แก้ไขไฟล์, ค้นหาโปรเจกต์, และรันคำสั่งทดสอบในเครื่องของคุณได้โดยตรงผ่านเทคโนโลยี Model Context Protocol (MCP)

---

## 📦 1. วิธีติดตั้งและเปิดใช้งานครั้งแรก (1-Click Setup)

1. **ดาวน์โหลดโปรแกรม** และแตกไฟล์ ZIP ลงในโฟลเดอร์ที่คุณต้องการ (เช่น `C:\AiMe` หรือโฟลเดอร์ใดก็ได้)
2. ดับเบิ้ลคลิกที่ไฟล์ **`Install-AiMe.cmd`**
   - ระบบจะตรวจเช็คสภาพแวดล้อมอัตโนมัติ
   - สร้างไอคอนชอร์ตคัตบน Desktop ให้คุณทันที 3 ตัว:
     - 🛡️ **`AiMe for ChatGPT`** (สำหรับเปิดใช้งานโปรแกรม)
     - ⚙️ **`AiMe Settings`** (สำหรับตั้งค่าโฟลเดอร์และระบบ)
     - 📁 **`AiMe Setup Wizard`** (สำหรับเลือกโฟลเดอร์ทำงาน)

---

## 🌐 2. วิธีเชื่อมต่อกับ ChatGPT (ทำตาม 3 ขั้นตอนนี้)

### ขั้นตอนที่ 1: เปิดโปรแกรม
- ดับเบิ้ลคลิกที่ไอคอน **`AiMe for ChatGPT`** บน Desktop ของคุณ
- โปรแกรมจะเปิดหน้าต่างทำงาน พร้อมเชื่อมต่อ HTTPS Tunnel ที่ปลอดภัย และส่งเสียงแจ้งเตือน **Chime**
- **URL สำหรับเชื่อมต่อจะถูกคัดลอกลง Clipboard ของคุณโดยอัตโนมัติทันที!**

### ขั้นตอนที่ 2: เพิ่ม MCP Server ใน ChatGPT
1. เปิดเว็บ [ChatGPT](https://chatgpt.com/)
2. คลิกที่รูปโปรไฟล์ของคุณมุมขวาล่าง/บน -> ไปที่ **การตั้งค่า (Settings)**
3. เลือกเมนู **ปลั๊กอินใหม่ / Model Context Protocol (MCP)**
4. ในช่อง **URL เซิร์ฟเวอร์ (Server URL)** ให้กด **Ctrl + V** เพื่อวาง URL ที่คัดลอกไว้
5. ช่องการพิสูจน์ตัวตน (Authentication) ให้เลือก **ไม่มีการพิสูจน์ตัวตน (None)**
6. ติ๊กถูกที่ช่อง **ฉันเข้าใจและฉันต้องการดำเนินการต่อ (I understand and wish to proceed)**
7. คลิกปุ่ม **สร้าง (Create)**

### ขั้นตอนที่ 3: เริ่มใช้งานได้ทันที!
- เมื่อเชื่อมต่อสำเร็จ จะขึ้นไฟสถานะ 🟢 Online และไอคอนรูปเครื่องมือบน ChatGPT
- คุณสามารถเริ่มพิมพ์สั่งงาน ChatGPT ได้ทันที เช่น:
  - *"สรุปภาพรวมโครงสร้างโปรเจกต์นี้ให้หน่อย"*
  - *"ช่วยหาฟังก์ชัน login ในโฟลเดอร์ src ให้ที"*
  - *"แก้บั๊กในไฟล์ app.ts ให้หน่อย แล้วรันเทสต์ดูว่าผ่านไหม"*

---

## 🛠️ 3. เครื่องมือทั้งหมด 25 Tools ที่ ChatGPT สามารถใช้งานได้

| กลุ่มเครื่องมือ | เครื่องมือ (Tool Name) | หน้าที่การทำงาน |
| :--- | :--- | :--- |
| **ภาพรวม & ตรวจสอบ** | `get_status` | ตรวจสอบสถานะการเชื่อมต่อและโฟลเดอร์ทำงาน |
| | `get_workspace_summary` | สรุปโครงสร้างโปรเจกต์, จำนวนไฟล์ และสัดส่วนภาษาโปรแกรม |
| | `get_file_hash` | คำนวณค่า SHA-256 / MD5 เพื่อตรวจสอบความถูกต้องของไฟล์ |
| **อ่าน & ค้นหาไฟล์** | `list_directory` | ดูรายการไฟล์และโฟลเดอร์ |
| | `read_text_file` | อ่านเนื้อหาภายในไฟล์ |
| | `search_text_files` | ค้นหาข้อความในไฟล์แบบง่าย |
| | `search_workspace_advanced`| ค้นหาโค้ดขั้นสูง รองรับ Regex, Glob และ Line Number |
| **ตรวจสอบไวยากรณ์** | `validate_syntax` | ตรวจสอบไวยากรณ์ TypeScript, JavaScript, JSON ก่อนเซฟ |
| **แก้ไขไฟล์ (SafeFs)** | `create_text_file` | สร้างไฟล์ใหม่พร้อมระบบสำรองข้อมูล |
| | `replace_text_file` | เขียนทับเนื้อหาไฟล์ |
| | `preview_patch` | ขอดูตัวอย่างความเปลี่ยนแปลงก่อนกดแก้ไขจริง |
| | `apply_patch` | แก้ไขไฟล์เฉพาะจุด (Patch) |
| | `apply_multi_patch` | แก้ไขหลายๆ ไฟล์พร้อมกันแบบ Transaction (All-or-Nothing) |
| | `rollback_change` | กู้คืนไฟล์กลับสู่สถานะเดิมได้ 100% |
| | `delete_text_file` | ลบไฟล์อย่างปลอดภัย (กู้คืนได้) |
| | `move_text_file` | ย้ายหรือเปลี่ยนชื่อไฟล์ |
| **Git Operations** | `git_status`, `git_diff`, `git_log` | ตรวจสอบสถานะ, diff และประวัติ commit |
| | `git_add`, `git_commit`, `git_checkout_file` | สั่ง staging, commit และ revert ไฟล์ (ตัดสิทธิ์ Hook ป้องกันไวรัส) |
| **Process Sandbox** | `run_process_preset` | รันคำสั่งเทสต์หรือบิลด์ภายใต้ Windows Job Object Sandboxing |
| | `get_process_task`, `cancel_process_task` | ตรวจดูผลการรันและยกเลิกคำสั่ง |
| **ความลับ & เสียงเตือน** | `get_env_info`, `set_safe_env` | จัดการตัวแปรแวดล้อมพร้อมระบบซ่อน Password / Secret อัตโนมัติ |
| | `play_notification_audio` | สั่งให้คอมพิวเตอร์ส่งเสียงแจ้งเตือนเมื่อทำงานเสร็จ |

---

## ⚙️ 4. การตั้งค่าและเปลี่ยนโฟลเดอร์ทำงาน (AiMe Settings GUI)

หากต้องการเปลี่ยนโฟลเดอร์โปรเจกต์ที่ ChatGPT มีสิทธิ์เข้าถึง:
1. ดับเบิ้ลคลิกที่ไอคอน **`AiMe Settings`** บน Desktop
2. กดปุ่ม **`Browse...`** แล้วเลือกโฟลเดอร์ที่คุณต้องการ
3. สามารถติ๊กเลือก **`Start AiMe automatically in background on Windows startup`** เพื่อให้เปิดตัวเองอัตโนมัติเมื่อเปิดเครื่อง
4. กดปุ่ม **`Save Settings`** เป็นอันเสร็จสิ้น

---

## ❓ 5. คำถามที่พบบ่อยและการแก้ปัญหา (FAQ & Troubleshooting)

### Q: ทำไม ChatGPT แจ้งเตือนว่าเชื่อมต่อไม่ได้?
- ตรวจสอบว่าหน้าต่าง `AiMe for ChatGPT` ยังเปิดอยู่หรือไม่
- เข้าไปที่ Web Dashboard ในเครื่องของคุณ: [http://localhost:3100/](http://localhost:3100/) เพื่อดูสถานะ
- หาก URL เปลี่ยนแปลง ให้กดปุ่ม **Copy Connection URL** ใน Dashboard แล้วนำไปอัปเดตใน ChatGPT อีกครั้ง

### Q: ปลอดภัยแค่ไหน? ChatGPT จะลบไฟล์สำคัญในเครื่องเราไหม?
- **ปลอดภัย 100%**:
  1. ChatGPT สามารถเข้าถึงได้**เฉพาะโฟลเดอร์ที่คุณเลือกเท่านั้น** (ไม่อนุญาตให้ออกนอกโฟลเดอร์)
  2. ทุกการแก้ไขหรือลบไฟล์ จะมีระบบ **`.aime-rollback`** สำรองไฟล์เดิมไว้เสมอ สามารถกู้คืนได้ตลอดเวลา
  3. คำสั่ง Process ทั้งหมดจะถูกรันใน Sandbox จำกัด RAM และ CPU ป้องกันเครื่องค้าง
