Larb

ไทย

English

ไทย

English

Appearance

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

⚠️ สถานะ: 0.1.0-alpha สำหรับนักพัฒนาที่ใช้คีย์ของตัวเองในช่วงแรกเท่านั้น API และคอนฟิกอาจเปลี่ยนได้ Larb ทำงาน อัตโนมัติ และรันคำสั่งบนเครื่องของคุณ — โปรดอ่านแบบจำลองความปลอดภัยก่อนนำไปพึ่งพาจริง

1. ติดตั้ง ​

Larb ต้องใช้ Node.js ≥ 20 ในช่วงอัลฟ่าจะเผยแพร่ภายใต้แท็ก alpha จึงติดตั้ง ด้วย @alpha:

bash
npm i -g @larb/cli@alpha
larb version

2. เลือกโมเดล (ใช้คีย์ของคุณเอง) ​

Larb ไม่ผูกกับโมเดลใด — ไม่มีผู้ให้บริการรายใดได้สิทธิพิเศษ เลือกด้วย kind ใน ~/.larb/config.toml แล้ว export คีย์ API ของผู้ให้บริการนั้น คุณเป็นเจ้าของคีย์ (อ่านจากสภาพแวดล้อม ไม่ใช่จากคอนฟิกในรีโพ) และเส้นทางการใช้งานเอง

toml
# ~/.larb/config.toml
[provider]
kind = "openai"      # anthropic · openai · ollama · deepseek · gemini · groq ·
                     # mistral · xai · openrouter · together · perplexity

[provider.models]    # ไม่บังคับ — ละไว้เพื่อใช้ค่าเริ่มต้นของผู้ให้บริการ
orchestrator = "gpt-4o"        # โมเดลแรง: วางแผนและขับเคลื่อนลูป
worker       = "gpt-4o-mini"   # โมเดลถูก/เร็ว: งานย่อยและการบีบอัด
bash
export OPENAI_API_KEY=sk-...    # ตัวแปรสภาพแวดล้อมของผู้ให้บริการที่คุณเลือก
larb providers                  # แสดงผู้ให้บริการ + คีย์ที่ตั้งไว้แล้ว

อยากใช้ฟรี/ในเครื่อง? ตั้ง kind = "ollama" แล้วรันโมเดลในเครื่อง — ไม่มีคีย์ ไม่มีค่าใช้จ่าย:

toml
[provider]
kind = "ollama"
[provider.models]
orchestrator = "llama3.1"

3. เซสชันแรกของคุณ ​

รัน larb เปล่า ๆ ในโปรเจกต์เพื่อเปิด เซสชันแบบโต้ตอบ — เป็นบทสนทนา ไม่ใช่คำสั่งครั้งเดียวจบ:

bash
cd your-project
larb

ครั้งแรก Larb จะถาม การตัดสินใจเชื่อถือ (ไม่มีการอ่านคอนฟิกที่เป็นโค้ดหรือส่ง ข้อมูลผ่านเครือข่ายก่อนคุณตัดสินใจ) จากนั้นพิมพ์งานและคำสั่งต่อเนื่องได้เลย — บทสนทนาต่อเนื่องข้ามงาน ทุกการแก้ไฟล์แสดง diff เพื่อขออนุมัติ และ:

  • Esc ขัดจังหวะการรันที่จุดปลอดภัยถัดไป เพื่อให้คุณกำกับทิศทางด้วยคำสั่งต่อเนื่อง
  • /plan <task> ร่างแผนแบบมีลำดับก่อนโดยไม่แก้ไขอะไร ตรวจแผนแล้วพิมพ์ go เพื่อลงมือ
  • /cost แสดงค่าใช้จ่ายเทียบเพดาน · /help แสดงคำสั่งทั้งหมด

ต้องการแบบครั้งเดียวจบ? ยังใช้ได้เหมือนเดิม:

bash
larb ask "โปรเจกต์นี้ทำอะไร?"                 # อ่านอย่างเดียว
larb run "เพิ่มแฟลก --version ให้กับ CLI"      # งานเดียวภายใต้การควบคุม
larb run "แก้เทสต์ที่พัง" --yes               # แบบ headless (CI/สคริปต์; ต้อง
                                              # `larb trust --full` ก่อน; เพิ่ม
                                              # --json เพื่อผลลัพธ์แบบอ่านด้วยเครื่อง)

งานยังไม่ "เสร็จ" จนกว่าคำสั่งตรวจสอบที่คุณตั้งไว้จะผ่าน:

toml
verify = ["npm run -s typecheck", "npm test"]
# ทางเลือก: วินิจฉัยแบบเร็วหลังการแก้ไข "ทุกครั้ง" (เห็นข้อผิดพลาดทันที)
check = ["npm run -s typecheck"]

4. สิ่งที่ควรเข้าใจก่อนนำไปพึ่งพาจริง ​

Larb เป็นเอเจนต์ที่ยึด ความปลอดภัยมาก่อน — สิ่งเหล่านี้เปิดใช้งานโดยค่าเริ่มต้น:

  • เชื่อถือก่อนทำสิ่งใด — ไม่อ่านคอนฟิกที่เป็นโค้ดและไม่เรียกเครือข่ายจนกว่าคุณ จะตัดสินใจเชื่อถือไดเรกทอรี
  • สิทธิ์ตามความสามารถ — การเขียนไฟล์ คำสั่ง เครือข่าย และการเรียก MCP ล้วน ต้องอนุมัติ (ครั้งเดียว / เซสชัน / เสมอ / ปฏิเสธ) และ บันทึกทุกการอนุมัติ ดู ได้ด้วย larb audit
  • เพดานค่าใช้จ่ายเด็ดขาด — บัญชีโทเคน/ดอลลาร์แบบสดหยุดเอเจนต์ก่อนใช้จ่ายเกิน ปรับได้ใต้ [limits]
  • แซนด์บ็อกซ์การรันจริง — คำสั่งรันในคอนเทนเนอร์ rootless (docker/podman) โดย กันความลับของโฮสต์ไว้และปิดเครือข่ายโดยค่าเริ่มต้น หากไม่มีรันไทม์จะถอยไปใช้ ซับโพรเซสบนโฮสต์ที่แยกตัวน้อยลง และบอกระดับที่ใช้งานตอนเริ่มทุกการรัน

อ่าน**แบบจำลองความปลอดภัย**ฉบับเต็มก่อนใช้งานแบบไม่มีคนดูแล

5. ก้าวต่อไป ​

  • คำแนะนำของโปรเจกต์ — วางไฟล์ AGENTS.md ในรีโพเพื่อบอก Larb ถึงคำสั่ง build/test และแนวปฏิบัติของคุณ (เชิงแนะนำ — ลบล้างสิทธิ์ไม่ได้)
  • หน่วยความจำของโปรเจกต์ — เอเจนต์บันทึกข้อเท็จจริงที่คงทน (จุดแปลกของ build, แนวปฏิบัติ) ด้วยเครื่องมือ remember เป็นมาร์กดาวน์ที่ตรวจดูได้ใต้ .larb/memory และถูกโหลดเข้าทุกเซสชันถัดไป
  • เครื่องมือภายนอก (MCP) — เพิ่มเซิร์ฟเวอร์ [[mcp]] ในคอนฟิกระดับโกลบอล แล้ว ตรวจดูด้วย larb mcp / larb mcp probe ดูเพิ่มที่สถาปัตยกรรม
  • สกิล — ติดตั้งส่วนขยายที่ควบคุมและเซ็นรับรอง: larb skill <cmd>
  • รันถาวร — larb runs แสดงสแน็ปช็อต; larb resume ทำงานต่อจากที่ค้างไว้ (ใช้แบบ headless ได้ด้วย: larb resume --yes)
  • VS Code — ส่วนขยายรุ่น MVP บนโปรโตคอล larb bridge อยู่ที่ editors/vscode (build จากซอร์ส; จะขึ้น marketplace ภายหลัง)
  • Windows — รองรับและยืนยันด้วย CI (typecheck/tests/build/smoke บนแมทริกซ์ ubuntu·macos·windows)

ถัดไป ​