Untuk pengguna Cline

Cline merancang sebelum bertindak. Beri rancangan itu sebuah peta.

Cline membaca fail, menjalankan arahan dan bertanya sebelum mengubah apa-apa. Maguyva mengindeks seluruh repo dan menyajikannya semula melalui MCP, jadi Plan mode bermula daripada tapak panggilan sebenar, bukan senarai direktori.

Mula percuma Baca persediaan Cline

Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

Guna .clinerules untuk cara bekerja. Guna Maguyva untuk apa yang kod katakan sekarang.

Apa yang perlu diketahui tentang Cline

Empat fakta khusus untuk Cline.

// fail konfigurasi

cline_mcp_settings.json

Buka daripada ikon MCP Servers dalam panel Cline: tab Configure, kemudian Configure MCP Servers. Pelayan diletakkan di bawah mcpServers.

// pengangkutan

Jauh, melalui URL

Cline bersambung ke titik akhir Maguyva melalui Streamable HTTP. Tiada proses setempat, tiada Node.js.

// kunci

Pengepala literal

Kunci terus masuk ke pengepala Authorization, seperti dalam contoh Cline sendiri. Fail tetapan berada dalam storan pengguna editor anda, bukan dalam repo anda.

// jenis

streamableHttp, bukan SSE

Kekalkan "type": "streamableHttp" dalam entri: tanpa jenis, Cline menganggapnya SSE lama. Senaraikan alat yang anda percayai dalam autoApprove untuk melangkau gesaan kelulusannya.

Peraturan Cline ialah persetujuan kerja. Gunakannya.

# .clinerules/testing.md
- Jalankan suite ujian sebelum menandakan tugas selesai.
- Tanya dahulu sebelum menambah kebergantungan.

Peraturan ruang kerja ialah fail Markdown dalam .clinerules/ atau .cline/rules/; Cline juga membaca AGENTS.md, .cursorrules dan .windsurfrules. Peraturan ialah tempat yang sesuai untuk:

Arahan yang perlu dijalankan oleh Cline.
Pagar keselamatan yang dihadkan pada satu laluan melalui glob dalam frontmatter.
Konvensyen pasukan yang anda sudah jemu ulang.

Peraturan memberitahu Cline cara berkelakuan. Ia tidak memberitahu perkhidmatan mana yang membaca jadual yang hendak dipindahkannya.

Apabila peraturan dan bacaan fail tidak mencukupi

Tiga jurang yang Cline isi dengan membaca lebih banyak fail, satu permintaan pada satu masa.

// rancangan dibina daripada senarai

Plan mode menaakul daripada apa yang Cline sudah baca setakat ini. Pada repo besar, itu ialah pepohon direktori dan beberapa fail, dan rancangan mewarisi jurang tersebut.

// setiap bacaan ialah satu perjalanan pergi balik

Setiap fail yang dibuka Cline untuk orientasi menggunakan token dan satu permintaan model. Orientasi dalam pakej yang tidak biasa boleh menghabiskan sebahagian besar tetingkap konteks sebelum suntingan pertama.

// carian teks menemui rentetan, bukan pemanggil

“Siapa lagi yang memanggil ini?” ialah soalan graf. Carian teks menemui rentetan itu; ia tidak memisahkan pemanggil sebenar daripada komen, mock dan kaedah bernama sama.

Maguyva sebagai pelayan MCP dalam Cline

Satu entri mcpServers memberi Cline:

11 alat merentasi repo anda yang diindeks carian semantik, struktur (AST), graf dan teks, ditambah carian simbol, dependen dan pengambilan fail.
Jawapan dengan laluan fail dan nombor baris merentasi 285+ bahasa, jadi rancangan merujuk fail sebenar.
Alat yang hanya membaca Alat Maguyva menyoal indeks. Tiada satu pun yang menyunting fail anda.

Peraturan Cline memberitahu Cline cara bekerja.
Maguyva memberi Cline peta untuk merancang.

Dua aliran kerja

Rancang berpandukan peta, kemudian bertindak.

// workflow 01

Rancang perubahan daripada tapak panggilan sebenar

cline plan> pindahkan session refresh ke pakej auth

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

→ Rancangan menyenaraikan tiga tapak panggilan sebelum Act mode bermula.
[exit 0]

Rancangan menamakan setiap fail yang akan disentuhnya, jadi anda meluluskan senarai, bukan firasat.

// workflow 02

Cari pelaksanaan sebenar, bukan fixture ujian

cline> bagaimana kita mengira proration?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← pelaksanaan
  test/billing/proration.spec.ts:7   ← fixture

→ Cline membaca satu fail, bukan enam.
[exit 0]

Keputusan tersusun meletakkan pelaksanaan di atas fixture yang berkongsi namanya.

Sediakan Cline

Tiga langkah. Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

// step 01

Indeks repo di maguyva.ai

Pilih satu yang anda sudah kenali, supaya anda boleh menilai jawapannya.

// step 02

Tambah Maguyva pada tetapan MCP Cline

cline_mcp_settings.json

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

// step 03

Ganti pemegang tempat dan tanya satu soalan

Tukar mgv_xxxx kepada kunci API anda dan simpan fail. Tanya satu soalan yang anda sudah tahu jawapannya, kemudian buka fail yang disebut.