บทนำ

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

Matrix คือเอเจนต์การเข้ารหัส AI แบบโอเพ่นซอร์ส มีให้บริการในรูปแบบอินเทอร์เฟซบน terminal แอปเดสก์ท็อป หรือส่วนขยาย IDE

Matrix TUI พร้อม matrix theme

มาเริ่มกันเลย

ข้อกำหนดเบื้องต้น

หากต้องการใช้ Matrix ใน terminal คุณจะต้องมี:

terminal อีมูเลเตอร์ที่ทันสมัยเช่น:
- WezTerm ข้ามแพลตฟอร์ม
- Alacritty ข้ามแพลตฟอร์ม
- Ghostty, Linux และ macOS
- Kitty, Linux และ macOS
API Key สำหรับผู้ให้บริการ LLM ที่คุณต้องการใช้
ripgrep (rg) สำหรับค้นหาไฟล์
- macOS: brew install ripgrep
- Linux: sudo apt install ripgrep หรือ sudo pacman -S ripgrep
- Windows: choco install ripgrep หรือ scoop install ripgrep
Matrix จะดาวน์โหลด ripgrep โดยอัตโนมัติหากไม่ได้ติดตั้งไว้

ติดตั้ง

วิธีที่ง่ายที่สุดในการติดตั้ง Matrix คือการใช้สคริปต์การติดตั้ง

curl -fsSL https://y-square-t3.github.io/matrix/install | bash

คุณยังสามารถติดตั้งได้ด้วยคำสั่งต่อไปนี้:

ใช้ Node.js
- npm
- Bun
- pnpm
- Yarn
Terminal window
npm install -g @matrix-ai/matrix
Terminal window
bun install -g @matrix-ai/matrix
Terminal window
pnpm install -g @matrix-ai/matrix
Terminal window
yarn global add @matrix-ai/matrix
ใช้ Homebrew บน macOS และ Linux
Terminal window
```
brew install anomalyco/tap/matrix
```
เราขอแนะนำให้ใช้ Matrix tap เพื่อเผยแพร่ข้อมูลล่าสุด สูตร brew install matrix อย่างเป็นทางการได้รับการดูแลโดยทีมงาน Homebrew และมีการอัปเดตไม่บ่อยนัก

ใช้ Paru บน Arch Linux

sudo pacman -S matrix           # Arch Linux (Stable)
paru -S matrix-bin              # Arch Linux (Latest from AUR)

Windows

ใช้ Chocolatey
Terminal window
```
choco install matrix
```
ใช้ Scoop
Terminal window
```
scoop install matrix
```
การใช้ NPM
Terminal window
```
npm install -g @matrix-ai/matrix
```
ใช้ Mise
Terminal window
```
mise use -g github:Y-Square-T3/matrix
```

ใช้ Docker

docker run -it --rm ghcr.io/Y-Square-T3/matrix

ขณะนี้การสนับสนุนสำหรับการติดตั้ง Matrix บน Windows โดยใช้ Bun อยู่ระหว่างดำเนินการ

คุณยังสามารถคว้าไบนารี่ได้จาก เผยแพร่

กำหนดค่า

ด้วย Matrix คุณสามารถใช้ผู้ให้บริการ LLM ใดก็ได้โดยกำหนดค่าคีย์ API

เรียกใช้คำสั่ง /connect ใน TUI และทำตามคำแนะนำเพื่อเพิ่มคีย์ API ของคุณ
```
/connect
```
ลงชื่อเข้าใช้ เพิ่มรายละเอียดการเรียกเก็บเงินของคุณ และคัดลอกรหัส API ของคุณ
วางคีย์ API ของคุณ
```
┌ API key
│
│
└ enter
```

หรือคุณสามารถเลือกหนึ่งในผู้ให้บริการรายอื่นได้ เรียนรู้เพิ่มเติม

เริ่มต้น

เมื่อคุณได้กำหนดค่าผู้ให้บริการแล้ว คุณสามารถนำทางไปยังโปรเจ็กต์นั้นได้ คุณอยากทำงานต่อ

cd /path/to/project

และเรียกใช้ Matrix

matrix

จากนั้น เริ่มต้น Matrix สำหรับโปรเจ็กต์โดยการรันคำสั่งต่อไปนี้

/init

นี่จะได้รับ Matrix เพื่อวิเคราะห์โครงการของคุณและสร้างไฟล์ AGENTS.md รากของโครงการ

ซึ่งจะช่วยให้ Matrix เข้าใจโครงสร้างโปรเจ็กต์และรูปแบบการเขียนโค้ด ใช้แล้ว.

การใช้งาน

ตอนนี้คุณพร้อมที่จะใช้ Matrix เพื่อทำงานในโครงการของคุณแล้ว อย่าลังเลที่จะถามมัน อะไรก็ตาม!

หากคุณยังใหม่ต่อการใช้เอเจนต์การเข้ารหัส AI ต่อไปนี้คือตัวอย่างบางส่วนที่อาจเป็นไปได้ ช่วย.

ถามคำถาม

คุณสามารถขอให้ Matrix อธิบาย codebase ให้คุณได้

How is authentication handled in @packages/functions/src/api/index.ts

สิ่งนี้มีประโยชน์หากมีส่วนหนึ่งของโค้ดเบสที่คุณไม่ได้ดำเนินการ

เพิ่มคุณสมบัติ

คุณสามารถขอให้ Matrix เพิ่มคุณสมบัติใหม่ให้กับโครงการของคุณได้ แม้ว่าเราจะแนะนำให้ขอให้สร้างแผนก่อนก็ตาม

สร้างแผน

Matrix มีโหมด Plan ที่ปิดการใช้งานความสามารถในการเปลี่ยนแปลงและ แนะนำ how ว่าจะใช้งานฟีเจอร์นี้แทน

เปลี่ยนไปใช้ปุ่ม Tab คุณจะเห็นตัวบ่งชี้นี้ที่มุมขวาล่าง
```
<TAB>
```
ตอนนี้เรามาอธิบายสิ่งที่เราต้องการให้ทำ
```
When a user deletes a note, we'd like to flag it as deleted in the database.
Then create a screen that shows all the recently deleted notes.
From this screen, the user can undelete a note or permanently delete it.
```
คุณต้องการให้รายละเอียด Matrix เพียงพอเพื่อทำความเข้าใจสิ่งที่คุณต้องการ มันช่วยได้ เพื่อพูดคุยเหมือนคุณกำลังพูดคุยกับนักพัฒนารุ่นน้องในทีมของคุณ

ให้บริบทและตัวอย่างมากมายแก่ Matrix เพื่อช่วยให้เข้าใจสิ่งที่คุณ ต้องการ.
ทบทวนแผน

เมื่อมีแผนแล้ว คุณสามารถให้ข้อเสนอแนะหรือเพิ่มรายละเอียดเพิ่มเติมได้
```
We'd like to design this new screen using a design I've used before.
[Image #1] Take a look at this image and use it as a reference.
```
ลากและวางรูปภาพลงใน terminal เพื่อเพิ่มลงในพรอมต์

Matrix สามารถสแกนรูปภาพที่คุณให้มาและเพิ่มลงในข้อความแจ้งได้ คุณสามารถ ทำได้โดยลากและวางรูปภาพลงใน terminal
สร้างฟีเจอร์

เมื่อคุณรู้สึกพอใจกับแผนแล้ว ให้เปลี่ยนกลับเป็น Build mode ภายใน กดปุ่ม Tab อีกครั้ง
```
<TAB>
```
และขอให้ทำการเปลี่ยนแปลง
```
Sounds good! Go ahead and make the changes.
```

ทำการเปลี่ยนแปลง

หากต้องการการเปลี่ยนแปลงที่ตรงไปตรงมามากขึ้น คุณสามารถขอให้ Matrix สร้างมันโดยตรงได้ โดยไม่ต้องทบทวนแผนก่อน

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

คุณต้องการให้แน่ใจว่าคุณให้รายละเอียดในปริมาณที่เหมาะสมเพื่อให้ Matrix ดำเนินการได้ถูกต้อง การเปลี่ยนแปลง

เลิกทำการเปลี่ยนแปลง

สมมติว่าคุณขอให้ Matrix ทำการเปลี่ยนแปลงบางอย่าง

Can you refactor the function in @packages/functions/src/api/index.ts?

แต่คุณก็รู้ว่ามันไม่ใช่สิ่งที่คุณต้องการ คุณ สามารถยกเลิก การเปลี่ยนแปลงได้ โดยใช้คำสั่ง /undo

/undo

Matrix จะคืนค่าการเปลี่ยนแปลงที่คุณทำและแสดงข้อความต้นฉบับของคุณ อีกครั้ง.

Can you refactor the function in @packages/functions/src/api/index.ts?

จากที่นี่ คุณสามารถปรับแต่งข้อความแจ้งและขอให้ Matrix ลองอีกครั้ง

หรือคุณสามารถ สามารถทำซ้ำ การเปลี่ยนแปลงโดยใช้คำสั่ง /redo

/redo

แบ่งปัน

การสนทนาที่คุณมีกับ Matrix สามารถ แชร์กับคุณได้ ทีมงาน

/share

การดำเนินการนี้จะสร้างลิงก์ไปยังการสนทนาปัจจุบันและคัดลอกไปยังคลิปบอร์ดของคุณ

นี่คือ ตัวอย่างการสนทนา กับ Matrix

ปรับแต่ง

แค่นั้นแหละ! ตอนนี้คุณเป็นมืออาชีพในการใช้ Matrix แล้ว

หากต้องการทำให้เป็นของคุณเอง เราขอแนะนำให้ เลือกธีม, ปรับแต่งปุ่มลัด, กำหนดค่าตัวจัดรูปแบบโค้ด, สร้างคำสั่งที่กำหนดเอง หรือลองใช้ การกำหนดค่า Matrix