ข้ามไปที่เนื้อหา

สำหรับผู้ใช้ Cline

Cline วางแผนก่อนลงมือ ให้แผนนั้นมีแผนที่

Cline อ่านไฟล์ รันคำสั่ง และถามก่อนเปลี่ยนแปลงอะไรก็ตาม Maguyva ทำดัชนีทั้งรีโพแล้วส่งกลับผ่าน MCP ทำให้โหมด Plan เริ่มจากจุดเรียกจริง แทนที่จะเริ่มจากรายการไดเรกทอรี

แผน Free: รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด ไม่ต้องใช้บัตรเครดิต

ใช้ .clinerules สำหรับวิธีทำงาน ใช้ Maguyva สำหรับสิ่งที่โค้ดบอกอยู่ตอนนี้

สิ่งที่ต้องรู้เกี่ยวกับ Cline

ข้อเท็จจริงสี่ข้อเฉพาะของ Cline

// ไฟล์คอนฟิก

cline_mcp_settings.json

เปิดจากไอคอน MCP Servers ในแผง Cline: แท็บ Configure แล้วเลือก Configure MCP Servers เซิร์ฟเวอร์อยู่ใต้ mcpServers

// การรับส่งข้อมูล

ระยะไกลผ่าน URL

Cline เชื่อมต่อกับ endpoint ของ Maguyva ผ่าน Streamable HTTP ไม่มีโปรเซสบนเครื่อง ไม่ต้องใช้ Node.js

// คีย์

เฮดเดอร์แบบตรงตัว

คีย์ใส่ลงในเฮดเดอร์ Authorization โดยตรง เหมือนตัวอย่างของ Cline เอง ไฟล์ตั้งค่าอยู่ในพื้นที่เก็บข้อมูลผู้ใช้ของเอดิเตอร์ ไม่ได้อยู่ในรีโพของคุณ

// ชนิด

streamableHttp ไม่ใช่ SSE

คง "type": "streamableHttp" ไว้ในรายการ: หากไม่ระบุชนิด Cline จะถือว่าเป็น SSE แบบเก่า ใส่เครื่องมือที่คุณเชื่อถือใน autoApprove เพื่อข้ามการขออนุมัติ

กฎของ Cline คือข้อตกลงในการทำงาน ใช้มันให้เต็มที่

# .clinerules/testing.md
- รันชุดทดสอบก่อนทำเครื่องหมายว่างานเสร็จ
- ถามก่อนเพิ่ม dependency

กฎของ workspace คือไฟล์ Markdown ใน .clinerules/ หรือ .cline/rules/ และ Cline ยังอ่าน AGENTS.md .cursorrules และ .windsurfrules ด้วย กฎเหมาะสำหรับ:

  • คำสั่งที่ Cline ควรรัน
  • ข้อจำกัดที่กำหนดขอบเขตเฉพาะพาธด้วย glob ใน frontmatter
  • ข้อตกลงของทีมที่คุณเบื่อจะพูดซ้ำ

กฎบอก Cline ว่าควรทำตัวอย่างไร แต่ไม่ได้บอกว่าบริการไหนบ้างที่อ่านตารางที่มันกำลังจะย้าย

เมื่อกฎและการอ่านไฟล์ไม่พอ

ช่องว่างสามจุดที่ Cline เติมด้วยการอ่านไฟล์เพิ่ม ทีละคำขอ

// แผนที่สร้างจากรายการไฟล์

โหมด Plan ให้เหตุผลจากสิ่งที่ Cline อ่านมาจนถึงตอนนั้น ในรีโพขนาดใหญ่นั่นคือโครงสร้างไดเรกทอรีกับไฟล์ไม่กี่ไฟล์ และแผนก็รับช่องว่างเหล่านั้นไปด้วย

// การอ่านแต่ละครั้งคือการไปกลับหนึ่งรอบ

ทุกไฟล์ที่ Cline เปิดเพื่อหาทิศทางใช้โทเค็นและคำขอโมเดลหนึ่งครั้ง การหาทิศทางในแพ็กเกจที่ไม่คุ้นเคยอาจใช้หน้าต่างบริบทไปเกือบหมดก่อนการแก้ไขครั้งแรก

// การค้นหาข้อความเจอสตริง ไม่ใช่ผู้เรียก

“มีใครเรียกสิ่งนี้อีกบ้าง?” เป็นคำถามเชิงกราฟ การค้นหาข้อความเจอสตริงนั้น แต่แยกผู้เรียกจริงออกจากคอมเมนต์ mock และเมธอดชื่อเดียวกันไม่ได้

Maguyva ในฐานะเซิร์ฟเวอร์ MCP ใน Cline

รายการ mcpServers เดียวให้สิ่งเหล่านี้แก่ Cline:

  • เครื่องมือ 11 รายการบนรีโพที่ทำดัชนีแล้วของคุณ การค้นหาเชิงความหมาย เชิงโครงสร้าง (AST) เชิงกราฟ และข้อความ รวมถึงการค้นหาสัญลักษณ์ ส่วนที่พึ่งพา และการดึงไฟล์
  • คำตอบพร้อมพาธไฟล์และหมายเลขบรรทัด ครอบคลุม 285+ ภาษา แผนจึงอ้างอิงไฟล์จริง
  • เครื่องมือที่อ่านอย่างเดียว เครื่องมือของ Maguyva สืบค้นดัชนี ไม่มีตัวไหนแก้ไขไฟล์ของคุณ

กฎของ Cline บอก Cline ว่าต้องทำงานอย่างไร

Maguyva มอบแผนที่สำหรับวางแผนให้ Cline

สองเวิร์กโฟลว์

วางแผนตามแผนที่ แล้วค่อยลงมือ

// workflow 01

วางแผนการเปลี่ยนแปลงจากจุดเรียกจริง

cline plan> ย้าย session refresh ไปไว้ในแพ็กเกจ auth

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ แผนระบุจุดเรียกทั้งสามก่อนโหมด Act เริ่ม
[exit 0]

แผนระบุชื่อทุกไฟล์ที่จะแตะ คุณจึงอนุมัติรายการ ไม่ใช่ลางสังหรณ์

// workflow 02

หาการอิมพลีเมนต์จริง ไม่ใช่ test fixture

cline> เราคำนวณ proration อย่างไร?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← การอิมพลีเมนต์
  test/billing/proration.spec.ts:7   ← fixture

→ Cline อ่านไฟล์เดียวแทนที่จะอ่านหกไฟล์
[exit 0]

ผลลัพธ์ที่จัดอันดับวางการอิมพลีเมนต์จริงไว้เหนือ fixture ที่ใช้ชื่อเดียวกัน

ตั้งค่าใน Cline

สามขั้นตอน แผน Free: รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด ไม่ต้องใช้บัตรเครดิต

  1. // step 01

    ทำดัชนีรีโพที่ maguyva.ai

    เลือกรีโพที่คุณรู้จักอยู่แล้ว เพื่อให้คุณประเมินคำตอบได้

  2. // step 02

    เพิ่ม Maguyva ในการตั้งค่า MCP ของ Cline

    cline_mcp_settings.json

    {
      "mcpServers": {
        "maguyva": {
          "type": "streamableHttp",
          "url": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer mgv_xxxx"
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
  3. // step 03

    แทนที่ตัวยึดตำแหน่งแล้วถามคำถามเดียว

    เปลี่ยน mgv_xxxx เป็นคีย์ API ของคุณแล้วบันทึกไฟล์ ถามหนึ่งคำถามที่คุณรู้คำตอบอยู่แล้ว จากนั้นเปิดไฟล์ที่ถูกอ้างอิง