Pengambilalihan Satu Klik Alat Pengaturcaraan AI

Pengambilalihan Satu Klik (Takeover) membolehkan anda mengarahkan alat CLI pengaturcaraan AI yang biasa digunakan ke gerbang AI setempat tanpa perlu mengedit mana-mana fail konfigurasi secara manual. Selepas pengambilalihan, permintaan alat-alat ini akan dihalakan secara bersatu melalui http://127.0.0.1:11580 ke saluran penyedia yang anda konfigurasikan dalam gerbang, dan dimasukkan ke dalam statistik penggunaan serta kos yang bersatu.

Cara Ia Berfungsi

Apabila menjalankan Pengambilalihan Satu Klik untuk setiap alat, gerbang akan melakukan secara berurutan:

1. Menyemak status kesihatan gerbang, mengesahkan titik akhir proksi tersedia.
2. Mencipta Kunci Maya khusus secara automatik (gerbang akan menulisnya ke dalam konfigurasi alat; teks biasa boleh diambil semula pada bila-bila masa di halaman kunci).
3. Membuat sandaran fail konfigurasi asal dengan akhiran .bak (contohnya ~/.claude/settings.json.bak).
4. Menulis dengan tepat / menggabungkan secara mendalam konfigurasi yang menunjuk ke gerbang, mengekalkan tetapan anda yang lain tanpa diubah.
5. Menyegarkan status antara muka, memaparkan keadaan pengambilalihan semasa.

Apabila menghentikan pengambilalihan, ia juga merupakan "pembuangan tepat": hanya apabila konfigurasi benar-benar menunjuk ke gerbang ini, kunci berkaitan akan dibuang, bagi mengelakkan pemadaman tersilap tetapan lain yang anda konfigurasikan secara manual; pada masa yang sama, kunci maya yang dicipta secara automatik semasa pengambilalihan akan dibatalkan.

Status Pengambilalihan

Setiap alat akan memaparkan salah satu daripada empat status pada halaman Gerbang AI → Pengurusan Akses → Klien:

Status	Maksud
Diambil Alih (Gerbang Ini)	Alat telah dihalakan ke gerbang AI setempat
Disambung (Alamat Lain)	Alat telah dikonfigurasikan dengan alamat lain (anda konfigurasikan secara manual atau menunjuk ke gerbang lain), gerbang tidak akan menimpa secara sewenang-wenangnya
Belum Diambil Alih	Alat dikesan, tetapi belum dihalakan ke gerbang
Tidak Dikesan	Direktori konfigurasi alat tidak ditemui pada mesin ini

Prasyarat

• Telah log masuk ke akaun ServBay, dan telah mengkonfigurasi sekurang-kurangnya satu saluran yang tersedia di halaman Saluran.
• Alat AI sasaran telah dipasang pada mesin ini (gerbang menentukan kewujudannya berdasarkan direktori konfigurasinya).

Operasi Pengambilalihan Satu Klik

Pergi ke halaman Gerbang AI → Pengurusan Akses → Klien, cari alat sasaran dalam senarai alat, dan klik Pengambilalihan Satu Klik. Selepas pengambilalihan berjaya, status akan bertukar kepada "Diambil Alih (Gerbang Ini)". Untuk menarik balik, klik Hentikan Pengambilalihan.

Butiran Pengambilalihan bagi Setiap Alat

Jadual di bawah menyenaraikan fail konfigurasi dan kandungan yang sebenarnya diubah apabila setiap alat diambil alih, bagi memudahkan anda memahami dan menyelesaikan masalah:

Alat	Fail Konfigurasi	Kandungan yang Ditulis	Alamat Gerbang
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	Bahagian [model_providers.servbay] + model_provider = "servbay" peringkat atas	http://127.0.0.1:11580/v1
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (serasi OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	Bahagian [model_providers.servbay] + definisi model	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Gabungan mendalam nod model servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Gabungan mendalam nod provider.servbay (mengagregatkan model setiap saluran)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Gabungan mendalam nod providers.servbay	http://127.0.0.1:11580/v1

Mengapa alamat Claude Code tidak mempunyai /v1

Claude Code menggunakan protokol Anthropic, gerbang akan menyambung sendiri laluan seperti /v1/messages, jadi ANTHROPIC_BASE_URL mesti merupakan alamat akar gerbang (tanpa /v1). Kebanyakan alat lain menggunakan protokol serasi OpenAI, perlu ada akhiran /v1. Pengambilalihan Satu Klik akan mengisi secara automatik mengikut konvensyen setiap alat, anda tidak perlu membezakan secara manual.

Pemulihan dan Penyelesaian Masalah

• Pulihkan konfigurasi asal — Klik Buang, gerbang akan membuang konfigurasi yang menunjuk ke gerbang ini dengan tepat. Anda juga boleh memulihkan secara manual menggunakan fail sandaran .bak dalam direktori yang sama.
• Status memaparkan "Disambung (Alamat Lain)" — Ini bermakna alat tersebut kini menunjuk ke alamat lain (anda konfigurasikan secara manual atau menunjuk ke gerbang lain). Untuk mengelakkan menimpa tetapan anda, gerbang tidak akan mengambil alih secara automatik; anda boleh bersihkan konfigurasi tersebut secara manual dahulu sebelum mengambil alih.
• Selepas pengambilalihan, alat masih melaporkan ralat — Pastikan perkhidmatan proksi gerbang sedang berjalan, saluran berkaitan sihat, kunci maya tidak dibatalkan, dan anda boleh melihat di halaman Statistik dan Pemantauan sama ada permintaan sampai ke gerbang.

Soalan Lazim (FAQ)

• S：Adakah Pengambilalihan Satu Klik akan merosakkan konfigurasi alat asal saya?
  • J：Tidak. Gerbang hanya menulis / menggabungkan kunci berkaitan gerbang dengan tepat, dan membuat sandaran fail asal sebagai .bak sebelum menulis. Tetapan lain kekal tidak berubah.
• S：Selepas pengambilalihan, bolehkah saya mengubahnya kembali secara manual?
  • J：Boleh. Klik "Buang" untuk membuangnya melalui gerbang, atau pulihkan secara manual menggunakan sandaran .bak.
• S：Di manakah kunci maya yang digunakan untuk pengambilalihan?
  • J： Gerbang akan mencipta kunci maya khusus secara automatik untuk setiap alat yang diambil alih, yang boleh dilihat dan diurus di halaman Kunci.
• S：Alat dalam senarai menunjukkan "Tidak Dikesan"?
  • J： Ini bermakna direktori konfigurasi alat itu tidak ditemui pada mesin ini. Sila pasang dan jalankan alat itu sekali dahulu supaya ia menjana direktori konfigurasi sebelum mengambil alih.

Ringkasan

Pengambilalihan Satu Klik meringkaskan perkara yang menyusahkan dan mudah tersalah — "mengedit fail konfigurasi setiap alat secara manual" — menjadi satu klik: mencipta kunci secara automatik, membuat sandaran secara automatik, menulis dengan tepat, dan memulihkan pada bila-bila masa. Dengan saluran dan statistik penggunaan yang bersatu, anda boleh membolehkan semua alat pengaturcaraan AI anda berkongsi set konfigurasi penyedia dan paparan kos yang sama. Jika anda ingin memanggil gerbang dalam kod anda sendiri, sila rujuk Titik Akhir dan Pemboleh Ubah Persekitaran.