Dành cho người dùng Cline

Cline lên kế hoạch trước khi hành động. Hãy cho kế hoạch một tấm bản đồ.

Cline đọc tệp, chạy lệnh và hỏi trước khi thay đổi bất cứ thứ gì. Maguyva lập chỉ mục toàn bộ repo và trả lại qua MCP, nên Plan mode bắt đầu từ các nơi gọi thật thay vì một danh sách thư mục.

Bắt đầu miễn phí Đọc hướng dẫn cài đặt Cline

Gói Free: 3 repository, Tối đa 50K dòng repo đã index, không cần thẻ tín dụng.

Dùng .clinerules cho cách làm việc. Dùng Maguyva cho những gì mã đang nói lúc này.

Những điều cần biết về Cline

Bốn điều riêng của Cline.

// tệp cấu hình

cline_mcp_settings.json

Mở từ biểu tượng MCP Servers trong bảng Cline: tab Configure, rồi Configure MCP Servers. Server nằm dưới mcpServers.

// giao thức truyền tải

Từ xa, qua URL

Cline kết nối tới endpoint của Maguyva bằng Streamable HTTP. Không có tiến trình cục bộ, không cần Node.js.

// khóa

Một header nguyên văn

Khóa đặt thẳng vào header Authorization, giống các ví dụ của chính Cline. Tệp cài đặt nằm trong vùng lưu trữ người dùng của editor, không nằm trong repo.

// kiểu

streamableHttp, không phải SSE

Giữ "type": "streamableHttp" trong mục: không có kiểu, Cline mặc định là SSE cũ. Liệt kê các công cụ bạn tin cậy trong autoApprove để bỏ qua lời nhắc phê duyệt của chúng.

Quy tắc của Cline là một thỏa thuận làm việc. Cứ dùng nó.

# .clinerules/testing.md
- Chạy bộ test trước khi đánh dấu tác vụ hoàn thành.
- Hỏi trước khi thêm một dependency.

Quy tắc workspace là các tệp Markdown trong .clinerules/ hoặc .cline/rules/; Cline cũng đọc AGENTS.md, .cursorrules và .windsurfrules. Quy tắc là nơi phù hợp cho:

Các lệnh Cline cần chạy.
Rào chắn giới hạn theo một đường dẫn bằng glob trong frontmatter.
Quy ước nhóm mà bạn đã chán nhắc lại.

Quy tắc cho Cline biết cách hành xử. Chúng không cho biết dịch vụ nào đang đọc bảng mà nó sắp di chuyển.

Khi quy tắc và việc đọc tệp không còn đủ

Ba khoảng trống Cline lấp bằng cách đọc thêm tệp, mỗi lần một yêu cầu.

// kế hoạch dựng từ một danh sách

Plan mode suy luận từ những gì Cline đã đọc tới lúc đó. Trên repo lớn, đó là một cây thư mục và vài tệp, và kế hoạch thừa hưởng các khoảng trống ấy.

// mỗi lần đọc là một vòng đi về

Mỗi tệp Cline mở để định hướng tốn token và một yêu cầu tới mô hình. Định hướng trong một package xa lạ có thể dùng hết phần lớn cửa sổ ngữ cảnh trước lần sửa đầu tiên.

// tìm kiếm văn bản tìm chuỗi, không tìm nơi gọi

“Còn ai gọi hàm này nữa?” là một câu hỏi đồ thị. Tìm kiếm văn bản tìm ra chuỗi; nó không tách nơi gọi thật khỏi một comment, một mock và một method trùng tên.

Maguyva làm MCP server trong Cline

Một mục mcpServers mang lại cho Cline:

11 công cụ trên repo đã lập chỉ mục của bạn tìm kiếm ngữ nghĩa, cấu trúc (AST), đồ thị và văn bản, cùng tra cứu ký hiệu, thành phần phụ thuộc và truy xuất tệp.
Câu trả lời kèm đường dẫn tệp và số dòng trên 285+ ngôn ngữ, nên kế hoạch dẫn chiếu tệp thật.
Công cụ chỉ đọc Công cụ của Maguyva truy vấn chỉ mục. Không công cụ nào sửa tệp của bạn.

Quy tắc của Cline cho Cline biết cách làm việc.
Maguyva cho Cline bản đồ để lên kế hoạch.

Hai quy trình làm việc

Lên kế hoạch theo bản đồ, rồi mới hành động.

// workflow 01

Lên kế hoạch thay đổi từ các nơi gọi thật

cline plan> chuyển session refresh vào package auth

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

→ Kế hoạch liệt kê ba nơi gọi trước khi Act mode bắt đầu.
[exit 0]

Kế hoạch nêu tên mọi tệp nó sẽ động vào, nên bạn phê duyệt một danh sách, không phải một linh cảm.

// workflow 02

Tìm phần triển khai thật, không phải test fixture

cline> chúng ta tính proration như thế nào?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← triển khai
  test/billing/proration.spec.ts:7   ← fixture

→ Cline đọc một tệp thay vì sáu.
[exit 0]

Kết quả xếp hạng đặt phần triển khai lên trên fixture trùng tên.

Cài đặt trong Cline

Ba bước. Gói Free: 3 repository, Tối đa 50K dòng repo đã index, không cần thẻ tín dụng.

// step 01

Lập chỉ mục một repo tại maguyva.ai

Chọn một repo bạn đã biết, để bạn có thể đánh giá các câu trả lời.

// step 02

Thêm Maguyva vào cài đặt MCP của Cline

cline_mcp_settings.json

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

// step 03

Thay placeholder và đặt một câu hỏi

Thay mgv_xxxx bằng khóa API của bạn rồi lưu tệp. Đặt một câu hỏi mà bạn đã biết câu trả lời, sau đó mở tệp được trích dẫn.