Pemasangan goose dan Konfigurasi Provider Tersuai

goose ialah pembantu AI serba guna yang berjalan pada komputer anda. Selain mengendalikan kod, ia juga boleh melakukan carian, penulisan, automasi dan penyusunan data. Anda boleh menggunakannya melalui versi desktop, terminal atau API. Versi desktop dan terminal berkongsi konfigurasi model yang sama. Ia sesuai untuk mengendalikan kerja pengekodan berulang serta boleh disambungkan kepada GitHub, pangkalan data dan fail.

Persediaan sebelum pemasangan

goose menyediakan dua kaedah pemasangan, iaitu Desktop dan CLI. Desktop ialah versi desktop dengan tetingkap, manakala CLI digunakan dengan memasukkan arahan dalam terminal. Kedua-duanya berkongsi konfigurasi teras, termasuk Provider dan model. Provider boleh difahami sebagai konfigurasi sambungan yang “memberitahu goose perkhidmatan model yang perlu digunakan”.

Mahukan tetingkap

goose Desktop

• Muat turun zip untuk macOS
• Atau gunakan brew cask
• Gunakan pakej pemasangan untuk Linux

Hanya perlukan terminal

goose CLI

• download_cli.sh
• Atau Homebrew CLI
• Kemudian jalankan goose session

Windows

Pilih persekitaran dahulu

• Git Bash atau MSYS2
• PowerShell juga boleh digunakan
• Tambahkan PATH jika perintah tidak ditemukan

Sebelum bermula, sediakan ID model daripada senarai model semasa. ID model ialah nama yang digunakan oleh perkhidmatan model untuk mengenal pasti model tertentu dan perlu disalin sepenuhnya apabila digunakan.

Pasang dan lancarkan buat kali pertama

Jika anda mahukan tetingkap

Terdapat dua kaedah pemasangan rasmi untuk macOS:

• Muat turun daripada halaman pemasangan. Halaman tersebut menyediakan macOS Silicon dan macOS Intel. Selepas memuat turun, ekstrak fail zip dan jalankan program di dalamnya.
• Atau gunakan Homebrew:

brew install --cask block-goose

Kaedah ini memuat turun aplikasi yang sama dan juga boleh mengendalikan kemas kini.

Jika anda menggunakan Apple Mac M3 dan tiada tetingkap muncul selepas aplikasi dibuka, semak sama ada ~/.config boleh dibaca dan ditulis. goose perlu menggunakan direktori ini untuk menulis log.

Untuk versi desktop Linux, muat turun daripada halaman pemasangan. Pakej yang disenaraikan ialah DEB（Ubuntu/Debian）、RPM（RHEL/Fedora）dan Flatpak. Bagi Debian atau Ubuntu, langkahnya ialah: muat turun DEB, pergi ke direktori tempat fail itu disimpan, jalankan sudo dpkg -i (filename).deb, kemudian buka goose daripada menu aplikasi. Gantikan (filename) dengan nama fail sebenar.

Untuk versi desktop Windows, muat turun daripada halaman pemasangan, ekstrak fail zip dan jalankan program di dalamnya.

Jika anda hanya memerlukan terminal

Pada macOS dan Linux, jalankan:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

Jika anda tidak mahu melakukan konfigurasi interaktif semasa pemasangan, tambahkan CONFIGURE=false di hadapan:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

Pada macOS, anda juga boleh menjalankan:

brew install block-goose-cli

Untuk mengemas kini CLI yang telah dipasang, gunakan:

goose update

Untuk Windows, salah satu daripada tiga persekitaran berikut diperlukan: Git Bash（disertakan dengan Git for Windows dan ditandakan sebagai pilihan yang disyorkan）、MSYS2 atau PowerShell yang terbina dalam Windows 10/11. Bagi Git Bash dan MSYS2, gunakan arahan download_cli.sh yang sama di atas. Untuk PowerShell, muat turun skrip terlebih dahulu, kemudian jalankannya:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"
.\download_cli.ps1

Jika terdapat mesej bahawa goose tiada dalam PATH, ikuti halaman pemasangan untuk menambahkan ~/.local/bin atau %USERPROFILE%\.local\bin pada konfigurasi shell semasa, kemudian buka semula terminal. PATH ialah satu set direktori yang digunakan oleh terminal untuk mencari lokasi program. Jika direktori tersebut belum ditambahkan, anda mungkin tidak dapat menjalankan program dengan menaip namanya secara terus walaupun program sudah dipasang.

Versi CLI pada 2026-10-09 ialah 1.54.0. Secara lalai, skrip pemasangan meletakkan program dalam ~/.local/bin. Pemboleh ubah persekitaran GOOSE_BIN_DIR boleh digunakan untuk menukar direktori ini. Selepas ia diubah, skrip tidak akan menulis konfigurasi shell secara automatik dan terminal akan memaklumkan bahawa direktori tersebut tiada dalam PATH. Tambahkan direktori itu pada PATH atau jalankan program menggunakan laluan penuh.

Semasa penggunaan kali pertama, goose akan meminta anda mengkonfigurasi Provider. Anda boleh melangkau penyedia terbina dalam terlebih dahulu dan menambahkan Provider tersuai mengikut bahagian seterusnya. Dalam terminal, pergi ke direktori tempat anda mahu bekerja, kemudian jalankan:

goose session

Dapatkan parameter sambungan daripada OmniProxy

Sediakan alamat, kunci dan nama model daripada OmniProxy anda sendiri. Contoh rasmi untuk Provider tersuai menetapkan base_url sehingga /v1/chat/completions, jadi panduan ini turut menggunakan format tersebut:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Salin daripada senarai model OmniProxy semasa; pisahkan beberapa model dengan koma standard

Salin keseluruhan nama model daripada senarai semasa OmniProxy dan kekalkan garis miring. Dua ID perbandingan dalam dokumentasi penyedia pada 2026-10-09 ialah grok-4.7 untuk Grok dan gpt-6-luna dalam dokumentasi OpenAI. gpt-6-luna menyokong Chat Completions; dalam Chat Completions, panggilan fungsi hanya disokong apabila reasoning_effort ditetapkan kepada none. Jangan salin nama yang tiada dalam senarai.

Isi konfigurasi alat

Provider tersuai menggunakan format yang serasi dengan OpenAI, Anthropic atau Ollama. Format serasi bermaksud alat menghantar permintaan mengikut antara muka umum tertentu. Apabila menyambungkan OmniProxy, pilih OpenAI Compatible.

Versi desktop

1. Klik butang di penjuru kiri atas untuk membuka bar sisi.
2. Klik Settings.
3. Klik Models.
4. Klik Configure providers.
5. Klik Add Custom Provider di bahagian bawah tetingkap.
6. Untuk Provider Type, pilih OpenAI Compatible. Display Name boleh ditetapkan kepada OmniProxy. Masukkan alamat daripada bahagian sebelumnya dalam API URL. Jika kunci diperlukan, tandakan pilihan yang mewajibkan API Key dan masukkan kunci OmniProxy. Dalam Available Models, masukkan nama model dan pisahkan beberapa model dengan koma standard.
7. Klik Create Provider.

Versi desktop pada masa ini tidak boleh menetapkan pengepala permintaan tersuai dalam tetingkap ini. Jika pengepala permintaan diperlukan, ubah fail konfigurasi selepas Provider dicipta.

Terminal

Jalankan:

goose configure

Pilih Custom Providers, kemudian pilih Add A Custom Provider. Untuk API Type, pilih OpenAI Compatible, kemudian ikut arahan untuk memasukkan nama, API URL, sama ada kunci diperlukan, nama model dan sama ada respons penstriman disokong.

Semasa konfigurasi manual pada Windows, jika keychain menghasilkan ralat, arahan pada halaman pemasangan ialah memilih untuk tidak menyimpan ke keyring apabila ditanya, kemudian gunakan pemboleh ubah persekitaran. Selepas itu, jalankan semula goose configure. Keychain ialah storan selamat kecil yang digunakan oleh sistem untuk menyimpan kunci.

Fail konfigurasi

Direktori yang diberikan ialah:

• macOS dan Linux: ~/.config/goose/custom_providers/
• Windows: %APPDATA%\Block\goose\config\custom_providers\

Fail boleh dibuat mengikut contoh berikut. Gantikan nama, alamat dan model dengan nilai anda sendiri. Simpan kunci dalam pemboleh ubah persekitaran yang ditentukan oleh api_key_env; jangan tulis kunci sebenar dalam fail:

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Kekalkan satu nombor untuk context_limit seperti dalam contoh. Konteks sebenar bergantung pada model dan OmniProxy; jangan anggap nombor contoh ini sebagai had rasmi model tersebut. Sebelum menggunakannya, jalankan:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Selepas masuk ke direktori kerja:

goose session --provider omniproxy --model grok-4.7

Gantikan nilai --model dengan ID penuh daripada senarai. goose session tidak mempunyai subperintah start. --provider dan --model juga boleh ditetapkan melalui pemboleh ubah persekitaran GOOSE_PROVIDER dan GOOSE_MODEL. Jika get laluan tidak mengesahkan kunci, OMNIPROXY_API_KEY masih perlu mempunyai nilai; anda boleh menggunakan rentetan pemegang tempat yang hanya digunakan pada komputer setempat. Pada 2026-10-09, kaedah ini berjaya membaca fail.

Tetingkap

Settings

• Settings pada bar sisi
• Halaman Models
• Add Custom Provider

Terminal

goose configure

• Pilih Custom Providers
• Kemudian pilih tambah
• Pilih OpenAI Compatible sebagai jenis

Fail

custom_providers

• macOS dan Linux berada dalam ~/.config
• Windows berada dalam APPDATA
• Tetapkan base_url mengikut contoh rasmi

Sahkan dengan tugasan sebenar

Pergi ke direktori yang mengandungi fail biasa, kemudian jalankan goose session daripada bahagian sebelumnya. Minta goose membaca baris pertama fail yang anda tentukan. Ia perlu memberikan kandungan fail, bukan sekadar memaparkan bahawa konfigurasi telah disimpan.

Untuk membaca fail atau menjalankan arahan, sesi memerlukan sambungan Developer. Sambungan Developer boleh difahami sebagai modul alat yang membolehkan goose mengendalikan fail dan arahan setempat. Konfigurasi lalai biasanya menyertakannya. Jika goose menjawab bahawa ia tidak mempunyai alat fail, tambahkan yang berikut pada arahan:

--with-builtin developer

Jangan tambahkan --no-profile pada masa yang sama kerana parameter itu akan mematikan sambungan lalai.

Pada 2026-10-09, goose 1.54.0 berjaya membaca baris pertama fail yang ditentukan. Respons pertama mungkin mengambil masa sekitar satu minit.

Kemudian, semak sumber dan nama model dalam rekod panggilan OmniProxy.

Permulaan

Boleh memasuki sesi

• goose session
• Provider ialah yang baru ditambahkan
• Nama model berada dalam senarai

Tugas

Ia benar-benar melaksanakannya

• Contohnya, senaraikan direktori semasa
• Lihat responsnya
• Jangan hanya melihat bahawa simpanan berjaya

Rekod

Kelihatan dalam get laluan

• Gunakan alamat daripada contoh dokumentasi
• Jangan tulis kunci ke dalam repositori
• ID model sepadan dengan senarai

Ralat lazim

• Arahan goose tidak ditemukan: ikuti halaman pemasangan untuk menambahkan direktori pemasangan pada PATH, kemudian buka semula terminal.
• Tiada tetingkap pada versi desktop M3: semak kebenaran baca dan tulis untuk ~/.config.
• Keychain gagal: jangan simpan ke keyring; gunakan pemboleh ubah persekitaran.
• Model tiada dalam senarai: dalam versi desktop, anda boleh memilih Use custom model dan memasukkan nama model secara manual. goose configure tidak boleh menerima nama model tersuai; untuk terminal, gunakan versi desktop atau ubah GOOSE_MODEL dalam konfigurasi secara terus.
• Alamat tidak dapat disambungkan: pastikan API URL berakhir dengan /v1/chat/completions seperti dalam contoh dan OmniProxy sedang berjalan.
• goose menyatakan bahawa ia tidak boleh membaca fail: tambahkan sambungan Developer dan jangan gunakan --no-profile.
• Mengembalikan unsupported Responses role: system: alamat biasanya betul. Tukar kepada ID penuh lain daripada senarai model.

Rujukan rasmi

Untuk pemasangan, lihat Install goose. Untuk Provider tersuai, lihat goose providers. Untuk ID model yang digunakan dalam contoh, lihat halaman model xAI dan GPT-6 Luna.

Gantikan setiap penanda tempat dengan nilai dari konfigurasi OmniProxy anda sendiri. Jangan pernah terbitkan kunci sebenar.

Hasil tersimpan atau HTTP 200 sahaja tidak membuktikan keserasian Agen penuh. Semak sumber dan model dalam rekod panggilan OmniProxy.

Sumber rasmi · goose ↗