Ambil Alih Alat Pengaturcaraan AI dengan Sekali Klik

Fungsi Ambil Alih (Takeover) membolehkan anda mengarahkan alat pengaturcaraan AI CLI kegemaran anda ke AI Gateway tempatan tanpa perlu menyunting sebarang fail konfigurasi secara manual. Selepas diambil alih, semua permintaan alat tersebut akan dihantar melalui http://127.0.0.1:11580 dan secara automatik dihalakan ke saluran pembekal yang telah anda tetapkan dalam Gateway, beserta statistik penggunaan dan kos yang disatukan.

Cara Kerja

Setiap kali anda menjalankan fungsi ambil alih pada mana-mana alat, Gateway akan melaksanakan proses berikut:

1. Periksa kesihatan Gateway, pastikan endpoint proksi boleh dicapai.
2. Cipta Kunci Maya unik secara automatik (dihantar sekali sahaja dalam bentuk teks jelas, dan akan ditulis ke Fail Konfigurasi alat).
3. Sandarkan fail konfigurasi asal dengan menambah akhiran .bak (contoh: ~/.claude/settings.json.bak).
4. Tulis dengan tepat / gabung mendalam konfigurasi yang menghalakan ke Gateway, tanpa mengubah tetapan anda yang lain.
5. Segarkan status antaramuka, memaparkan status ambil alih semasa.

Apabila ambil alih dialihkan semula (dikeluarkan), proses "hapus tepat" juga diterapkan: hanya kekunci yang benar-benar menghalakan ke Gateway akan dibuang bagi mengelakkan tetapan manual anda terpadam secara tidak sengaja.

Status Ambil Alih

Pada halaman AI Gateway → Endpoints, setiap alat akan menunjukkan salah satu daripada empat status berikut:

Status	Maksud
Telah Diambil Alih (Gateway Ini)	Alat telah diarahkan ke AI Gateway tempatan
Telah Disambung (Alamat Lain)	Alat telah dikonfigurasi ke alamat lain (dirubah manual atau ke gateway lain), Gateway tidak akan menimpa secara automatik
Belum Diambil Alih	Alat dikesan tetapi belum dihalakan ke Gateway
Tidak Dikesan	Tidak jumpa direktori konfigurasi alat pada mesin ini

Syarat Asas

• Telah log masuk akaun ServBay, dan sekurang-kurangnya satu saluran aktif telah dikonfigurasi pada halaman Saluran.
• AI tools sasaran telah dipasang pada mesin ini (Gateway mengesan kehadiran berdasarkan direktori konfigurasi).

Cara Menggunakan Ambil Alih Sekali Klik

Pergi ke halaman AI Gateway → Endpoints, cari alat sasaran dalam senarai, dan klik pada Ambil Alih Sekali Klik. Setelah berjaya, status akan berubah menjadi "Telah Diambil Alih (Gateway Ini)". Untuk mengembalikan semula, klik sahaja Keluarkan / Pulihkan.

Perincian Ambil Alih Bagi Setiap Alat

Jadual di bawah menunjukkan fail konfigurasi yang dimodifikasi dan kandungannya bagi setiap alat yang diambil alih, untuk memudahkan semakan dan penyelesaian masalah:

Alat	Fail Konfigurasi	Kandungan Ditulis	Alamat Gateway
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (tanpa /v1)
Codex	~/.codex/config.toml	Segmen [model_providers.servbay] + model_provider = "servbay" pada paras utama	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	Dua baris: GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (serasi OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	Segmen [model_providers.servbay] + definisi model	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Gabungan mendalam pada nod model servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Gabungan mendalam untuk nod provider.servbay (menggabungkan model pelbagai saluran)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Gabungan mendalam pada nod providers.servbay	http://127.0.0.1:11580/v1

Kenapa alamat Claude Code tidak mempunyai /v1

Claude Code menggunakan protokol Anthropic, di mana Gateway akan menambah /v1/messages dan lain-lain secara automatik. Oleh itu, ANTHROPIC_BASE_URL mesti menjadi alamat root Gateway (tanpa /v1). Kebanyakan alat lain menggunakan protokol serasi OpenAI yang memerlukan akhiran /v1. Fungsi Ambil Alih Sekali Klik akan mengisi secara automatik mengikut tetapan setiap alat, jadi anda tidak perlu membezakan secara manual.

Pemulihan & Penyelesaian Masalah

• Pulihkan konfigurasi asal — Klik Keluarkan, Gateway akan membuang hanya konfigurasi yang mengarah ke Gateway ini. Anda juga boleh pulihkan secara manual dengan fail sandaran .bak yang tersimpan dalam direktori yang sama.
• Status memaparkan "Telah Disambung (Alamat Lain)" — Ini bermakna alat sedang diarahkan ke alamat lain (sama ada anda tukar sendiri atau ke gateway lain). Untuk mengelakkan tertindih, Gateway tidak akan mengambil alih secara automatik; anda perlu padamkan konfigurasi lama secara manual sebelum ambil alih.
• Alat masih gagal berfungsi selepas ambil alih — Sila pastikan servis proksi Gateway sedang berjalan, saluran yang berkaitan berada dalam keadaan sihat, dan kunci maya belum dibatalkan. Anda juga boleh semak pada halaman Statistik & Pemantauan sama ada permintaan telah tiba ke Gateway.

Soalan Lazim (FAQ)

• S: Adakah fungsi Ambil Alih Sekali Klik akan merosakkan konfigurasi alat asal?
  • J: Tidak akan. Gateway hanya menulis / menggabungkan kekunci konfigurasi berkaitan sahaja, dan menyimpan salinan fail asal sebagai .bak. Tetapan lain tidak berubah.
• S: Bolehkan saya pulihkan atau ubah semula secara manual selepas Ambil Alih?
  • J: Boleh. Hanya klik "Keluarkan" untuk undur semula melalui Gateway, atau pulihkan fail sandaran .bak secara manual.
• S: Di mana kunci maya hasil ambil alih disimpan?
  • J: Gateway akan mencipta kunci maya khusus untuk setiap alat, yang boleh diurus pada halaman Kunci.
• S: Kenapa sesetengah alat tersenarai sebagai "Tidak Dikesan"?
  • J: Ini bermaksud direktori konfigurasi tidak ditemui pada mesin anda. Pastikan alat telah dipasang dan dijalankan sekali untuk menjana direktori sebelum lakukan ambil alih.

Ringkasan

Ciri Ambil Alih Sekali Klik menyederhanakan proses rumit dan terdedah kepada kesilapan seperti penyuntingan manual fail konfigurasi alat ke satu klik sahaja: cipta kunci automatik, sandaran konfigurasi, tulis tepat, dan boleh dipulihkan bila-bila masa. Bersama statistik saluran dan penggunaan yang disatukan, semua alat pengaturcaraan AI anda kini berkongsi paparan konfigurasi pembekal dan kos yang sama. Jika anda ingin panggil Gateway dari kod anda, sila rujuk pada Endpoints dan Pemboleh Ubah Persekitaran.