Untuk pengguna VS Code

Copilot nampak ruang kerja anda. Maguyva memetakan repo.

Ejen dalam VS Code membaca fail yang anda lampirkan dan fail yang ditemuinya sendiri. Maguyva mengindeks seluruh repo dan menyajikannya melalui MCP, jadi sebelum mengedit, ejen bertanya di mana sesuatu simbol berada dan siapa yang memanggilnya.

Mula percuma Baca persediaan VS Code

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

Satu entri servers dalam .vscode/mcp.json: satu URL dan satu pengepala Authorization.

Perkara yang perlu diketahui tentang VS Code

Empat fakta khusus untuk VS Code.

// fail konfigurasi

.vscode/mcp.json

Pelayan diletakkan di bawah servers, bukan mcpServers. Untuk semua ruang kerja, jalankan MCP: Open User Configuration dan tambah entri yang sama ke mcp.json profil anda.

// pengangkutan

type: http

VS Code bersambung ke titik akhir Maguyva melalui Streamable HTTP dan hanya beralih ke SSE jika pelayan tidak menyokongnya. Tiada apa yang berjalan secara setempat.

// kunci

Rujukan env

Pengepalanya ialah Bearer ${env:MAGUYVA_API_KEY}, yang diselesaikan oleh VS Code daripada persekitaran tempat ia dimulakan, jadi kunci tidak masuk ke fail yang anda commit. Lebih suka ditanya? Pemboleh ubah input bertanya sekali dan menyimpan kunci itu.

// kepercayaan

Workspace Trust

Pelayan dalam .vscode/mcp.json bermula tanpa gesaan berasingan sebaik sahaja anda mempercayai ruang kerja, dan tidak pernah dalam mod terhad. Configure Tools dalam input sembang menghidupkan atau mematikan setiap alat.

Arahan tersuai ialah perjanjian kerja. Gunakannya.

# .github/copilot-instructions.md
- Jalankan npm test sebelum menganggap sesuatu perubahan selesai.
- Jangan sekali-kali edit fail terjana di bawah src/gen/.

VS Code membaca arahan untuk seluruh projek daripada .github/copilot-instructions.md atau AGENTS.md, dan arahan bersasar daripada fail .github/instructions/*.instructions.md yang mempunyai corak applyTo. Gunakannya untuk:

Arahan build, ujian dan lint.
Konvensyen yang asyik tersilap oleh ejen.
Folder yang tidak patut disentuh ejen.

Arahan memberitahu ejen cara bekerja. Ia tidak dapat memberitahu fail mana antara empat ribu yang mengimport jenis yang akan ditukar namanya.

Di mana pandangan ruang kerja berakhir

Tiga perkara yang tidak dapat dipelajari ejen daripada fail yang dibukanya.

// dilampirkan bukan segalanya

Ejen bekerja dengan apa yang anda lampirkan dan apa yang dipulangkan oleh cariannya. Pemanggil dalam pakej lain yang rosak selepas perubahan itu tiada dalam mana-mana senarai.

// padanan teks bukan rujukan

Carian ruang kerja menemui rentetan itu. Ia tidak dapat membezakan panggilan sebenar daripada komen, mock atau kaedah sama nama dalam kelas lain.

// setiap bacaan memakan konteks

Setiap fail yang dibuka ejen untuk berorientasi menghabiskan konteks yang diperlukannya untuk perubahan. Satu jawapan berperingkat dengan file:line lebih murah daripada sepuluh bacaan penerokaan.

Maguyva sebagai pelayan MCP dalam VS Code

Satu entri servers memberi ejen:

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 ejen membuka fail yang betul dahulu.
Alat yang hanya membaca Alat Maguyva menyoal indeks. Tiada satu pun yang menyunting fail anda, jadi setiap kelulusan ialah tentang membaca, bukan menulis.

VS Code memberi ejen ruang kerja anda.
Maguyva memberi ejen peta repo.

Dua aliran kerja

Tanya peta dahulu, kemudian sunting.

// workflow 01

Cari ujian sebelum mengubah parser

vscode agent> ujian mana yang melalui parseConfig?

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ Selepas mengedit, ejen menjalankan dua fail ini, bukan seluruh suite.
[exit 0]

Jawapan itu menamakan dua fail ujian yang sampai ke parser, jadi ejen menyemak perubahan di tempat yang boleh rosak.

// workflow 02

Ukur penukaran nama sebelum suntingan pertama

vscode agent> tukar nama OrderStatus.PENDING kepada OrderStatus.QUEUED

find_symbol("OrderStatus", references)
  23 rujukan dalam 9 fail

→ Ejen merancang satu laluan merentas sembilan fail.
[exit 0]

Kiraan rujukan tiba sebelum suntingan, bukan selepas pemeriksa jenis gagal.

Sediakan VS Code

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 ke .vscode/mcp.json

.vscode/mcp.json

{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

Tetapkan kunci anda dan mulakan pelayan

Tetapkan MAGUYVA_API_KEY dalam persekitaran tempat anda membuka VS Code, kemudian mulakan pelayan daripada code lens di atas entrinya. Tanya ejen satu soalan yang anda sudah tahu jawapannya.