บทนำ

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

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

---

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

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

1. terminal อีมูเลเตอร์ที่ทันสมัยเช่น:

   • WezTerm ข้ามแพลตฟอร์ม
   • Alacritty ข้ามแพลตฟอร์ม
   • Ghostty, Linux และ macOS
   • Kitty, Linux และ macOS

2. API Key สำหรับผู้ให้บริการ LLM ที่คุณต้องการใช้

---

ติดตั้ง

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

curl -fsSL https://armin.com.cn/install | bash

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

• ใช้ Node.js

  npm

  npm install -g armin-ai

  Bun

  bun install -g armin-ai

  pnpm

  pnpm install -g armin-ai

  Yarn

  yarn global add armin-ai

• ใช้ Homebrew บน macOS และ Linux

  brew install anomalyco/tap/armin

  เราขอแนะนำให้ใช้ ArmIn tap เพื่อเผยแพร่ข้อมูลล่าสุด สูตร brew install armin อย่างเป็นทางการได้รับการดูแลโดยทีมงาน Homebrew และมีการอัปเดตไม่บ่อยนัก

• ใช้ Paru บน Arch Linux

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

Windows

แนะนำ: ใช้ WSL

เพื่อประสบการณ์ที่ดีที่สุดบน Windows เราขอแนะนำให้ใช้ ระบบย่อย Windows สำหรับ Linux (WSL) ให้ประสิทธิภาพที่ดีขึ้นและความเข้ากันได้เต็มรูปแบบกับคุณสมบัติของ ArmIn

• ใช้ Chocolatey

  choco install armin

• ใช้ Scoop

  scoop install armin

• การใช้ NPM

  npm install -g armin-ai

• ใช้ Mise

  mise use -g github:simon-cheung/arm-in

• ใช้ Docker

  docker run -it --rm ghcr.io/simon-cheung/arm-in

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

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

---

กำหนดค่า

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

หากคุณยังใหม่ต่อการใช้ผู้ให้บริการ LLM เราขอแนะนำให้ใช้ ArmIn Zen เป็นรายการโมเดลที่ได้รับการดูแลจัดการซึ่งได้รับการทดสอบและตรวจสอบโดย ArmIn ทีม.

1. เรียกใช้คำสั่ง /connect ใน TUI เลือก armin และไปที่ armin.com.cn/auth

   /connect

2. ลงชื่อเข้าใช้ เพิ่มรายละเอียดการเรียกเก็บเงินของคุณ และคัดลอกรหัส API ของคุณ

3. วางคีย์ API ของคุณ

   ┌ API key
   │
   │
   └ enter

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

---

เริ่มต้น

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

cd /path/to/project

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

armin

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

/init

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

Tip

คุณควรคอมมิตไฟล์ AGENTS.md ของโปรเจ็กต์ของคุณไปที่ Git

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

---

การใช้งาน

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

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

---

ถามคำถาม

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

Tip

ใช้ปุ่ม @ เพื่อค้นหาไฟล์ในโครงการอย่างคลุมเครือ

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

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

---

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

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

1. สร้างแผน

   ArmIn มีโหมด 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.

   คุณต้องการให้รายละเอียด ArmIn เพียงพอเพื่อทำความเข้าใจสิ่งที่คุณต้องการ มันช่วยได้ เพื่อพูดคุยเหมือนคุณกำลังพูดคุยกับนักพัฒนารุ่นน้องในทีมของคุณ

   Tip

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

2. ทบทวนแผน

   เมื่อมีแผนแล้ว คุณสามารถให้ข้อเสนอแนะหรือเพิ่มรายละเอียดเพิ่มเติมได้

   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.

   Tip

   ลากและวางรูปภาพลงใน terminal เพื่อเพิ่มลงในพรอมต์

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

3. สร้างฟีเจอร์

   เมื่อคุณรู้สึกพอใจกับแผนแล้ว ให้เปลี่ยนกลับเป็น Build mode ภายใน กดปุ่ม Tab อีกครั้ง

   <TAB>

   และขอให้ทำการเปลี่ยนแปลง

   Sounds good! Go ahead and make the changes.

---

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

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

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

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

---

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

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

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

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

/undo

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

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

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

Tip

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

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

/redo

---

แบ่งปัน

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

/share

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

Note

การสนทนาจะไม่ถูกแชร์โดยค่าเริ่มต้น

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

---

ปรับแต่ง

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

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