Cline-käyttäjille

Cline suunnittelee ennen kuin toimii. Anna suunnitelmalle kartta.

Cline lukee tiedostoja, ajaa komentoja ja kysyy ennen kuin muuttaa mitään. Maguyva indeksoi koko repon ja tarjoaa sen takaisin MCP:n yli, joten Plan-tila lähtee todellisista kutsukohdista eikä hakemistolistauksesta.

Aloita ilmaiseksi Lue Cline-asennus

Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

.clinerules kertoo, miten työskennellä. Maguyva kertoo, mitä koodi sanoo nyt.

Mitä Cline-laajennuksesta pitää tietää

Neljä Cline-laajennukselle ominaista asiaa.

// asetustiedosto

cline_mcp_settings.json

Avaa se Cline-paneelin MCP Servers -kuvakkeesta: välilehti Configure, sitten Configure MCP Servers. Palvelimet määritetään kohtaan mcpServers.

// siirto

Etänä, URL-osoitteella

Cline yhdistää Maguyva-päätepisteeseen Streamable HTTP:llä. Ei paikallista prosessia, ei Node.js:ää.

// avain

Otsake sellaisenaan

Avain menee suoraan Authorization-otsakkeeseen, kuten Cline-laajennuksen omissa esimerkeissä. Asetustiedosto on editorisi käyttäjätallennustilassa, ei repossasi.

// tyyppi

streamableHttp, ei SSE

Pidä merkinnässä "type": "streamableHttp": ilman tyyppiä Cline olettaa vanhan SSE:n. Listaa luotetut työkalut kohtaan autoApprove, niin niiden hyväksyntäkysely ohitetaan.

Cline-säännöt ovat työskentelysopimus. Käytä niitä.

# .clinerules/testing.md
- Aja testit ennen kuin merkitset tehtävän valmiiksi.
- Kysy ennen kuin lisäät riippuvuuden.

Työtilan säännöt ovat Markdown-tiedostoja hakemistossa .clinerules/ tai .cline/rules/; Cline lukee myös tiedostot AGENTS.md, .cursorrules ja .windsurfrules. Säännöt sopivat näihin:

Komennot, jotka Clinen pitää ajaa.
Suojakaiteet, jotka rajataan polkuun frontmatterin globilla.
Tiimin käytännöt, joita olet kyllästynyt toistamaan.

Säännöt kertovat Cline-laajennukselle, miten toimia. Ne eivät kerro, mitkä palvelut lukevat taulua, jota se on siirtämässä.

Missä säännöt ja tiedostojen lukeminen eivät enää riitä

Kolme aukkoa, jotka Cline paikkaa lukemalla lisää tiedostoja pyyntö kerrallaan.

// listauksesta tehty suunnitelma

Plan-tila päättelee sen perusteella, mitä Cline on tähän mennessä lukenut. Suuressa repossa se on hakemistopuu ja kourallinen tiedostoja, ja suunnitelma perii aukot.

// jokainen luku on edestakainen matka

Jokainen tiedosto, jonka Cline avaa suunnistaakseen, maksaa tokeneita ja yhden mallipyynnön. Tuntemattomaan pakettiin tutustuminen voi viedä suuren osan kontekstiikkunasta ennen ensimmäistä muokkausta.

// tekstihaku löytää merkkijonoja, ei kutsujia

“Kuka muu kutsuu tätä?” on graafikysymys. Tekstihaku löytää merkkijonon, mutta ei erota todellisia kutsujia kommentista, mockista ja samannimisestä metodista.

Maguyva MCP-palvelimena Cline-laajennuksessa

Yksi mcpServers-merkintä antaa Cline-laajennukselle:

11 työkalua indeksoituun repoosi semanttinen, rakenteellinen (AST-), graafi- ja tekstihaku sekä symbolihaku, riippuvaiset ja tiedostojen haku.
Vastaukset tiedostopoluilla ja rivinumeroilla yli 285 kielellä, joten suunnitelma viittaa todellisiin tiedostoihin.
Työkalut, jotka vain lukevat Maguyva-työkalut kyselevät indeksiä. Mikään niistä ei muokkaa tiedostojasi.

Cline-säännöt kertovat Cline-laajennukselle, miten työskennellä.
Maguyva antaa Cline-laajennukselle kartan suunnittelun pohjaksi.

Kaksi työnkulkua

Suunnittele kartan mukaan, toimi sitten.

// workflow 01

Suunnittele muutos todellisten kutsukohtien pohjalta

cline plan> siirrä istunnon uusiminen auth-pakettiin

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

→ Suunnitelma listaa kolme kutsukohtaa ennen Act-tilaa.
[exit 0]

Suunnitelma nimeää jokaisen tiedoston, johon se koskee, joten hyväksyt listan etkä aavistusta.

// workflow 02

Löydä todellinen toteutus, ei testifixturea

cline> miten laskemme suhteutetun laskutuksen?

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

→ Cline lukee yhden tiedoston kuuden sijaan.
[exit 0]

Priorisoidut tulokset nostavat toteutuksen samannimisen fixturen yläpuolelle.

Asennus Cline-laajennuksessa

Kolme vaihetta. Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

// step 01

Indeksoi repo osoitteessa maguyva.ai

Valitse jo tuntemasi repo, jotta voit arvioida vastauksia.

// step 02

Lisää Maguyva Cline-laajennuksen MCP-asetuksiin

cline_mcp_settings.json

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

// step 03

Korvaa paikkamerkki ja kysy yksi kysymys

Korvaa mgv_xxxx omalla API-avaimellasi ja tallenna tiedosto. Kysy yksi kysymys, jonka vastauksen jo tiedät, ja avaa sitten viitattu tiedosto.