OmniRoute/docs/i18n/ms/docs/frameworks/OPENCODE.md

OpenCode Integration (Bahasa Melayu)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

Status: Tersedia secara umum. Khalayak: Pengendali yang menghubungkan OpenCode kepada pengerahan OmniRoute. Sumber rujukan utama (skema konfigurasi): src/shared/services/opencodeConfig.ts Sumber rujukan utama (pakej npm): @omniroute/opencode-provider/ (ruang kerja yang boleh diterbitkan)

OpenCode ialah klien AI CLI/desktop berasaskan ejen. Ia membaca katalog penyedianya daripada ~/.config/opencode/opencode.json (atau opencode.jsonc) dan mengikut skema di https://opencode.ai/config.json. OmniRoute menampilkan dirinya kepada OpenCode sebagai salah satu penyedia tersebut — setiap permintaan mengalir melalui permukaan /v1 serasi OpenAI standard OmniRoute, jadi OpenCode mendapat manfaat secara automatik daripada penghalaan Auto-Combo, pemutus litar, dasar kunci, kebolehcerapan dan sebagainya.

Terdapat dua laluan penyepaduan yang disokong. Pilih satu — kedua-duanya menjana konfigurasi yang sama.

---

Laluan 1 — Penjana CLI (tanpa pemasangan npm)

Disyorkan untuk pengguna akhir. Disertakan bersama OmniRoute. Menulis opencode.json di lokasi sedia ada.

# Selepas memasang OmniRoute (npm i -g @omniroute/cli atau klon setempat)
omniroute config opencode \
  --base-url http://localhost:20128 \
  --api-key "$OMNIROUTE_API_KEY"

Di sebalik tabir, CLI memanggil mergeOpenCodeConfigText() (src/shared/services/opencodeConfig.ts:104), jadi opencode.json sedia ada mengekalkan penyedia lain dan ulasannya. Entri OmniRoute ditambah/digantikan secara atomik.

Fail yang terhasil (katalog model lalai):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1",
        "apiKey": "<kunci-anda>",
      },
      "models": {
        "claude-opus-4-5-thinking": { "name": "claude-opus-4-5-thinking" },
        "claude-sonnet-4-5-thinking": { "name": "claude-sonnet-4-5-thinking" },
        "gemini-3.1-pro-high": { "name": "gemini-3.1-pro-high" },
        "gemini-3-flash": { "name": "gemini-3-flash" },
      },
    },
  },
}

---

Laluan 2 — Pakej npm @omniroute/opencode-provider

Disyorkan apabila anda menskripkan konfigurasi daripada Node/TS (talian paip CI, monorepo, aliran pemasang tersuai).

npm install --save-dev @omniroute/opencode-provider

import { writeFileSync } from "node:fs";
import { buildOmniRouteOpenCodeConfig } from "@omniroute/opencode-provider";

const config = buildOmniRouteOpenCodeConfig({
  baseURL: "http://localhost:20128",
  apiKey: process.env.OMNIROUTE_API_KEY ?? "sk_omniroute",
  // Pilihan: ganti katalog model yang didedahkan kepada OpenCode
  models: ["auto", "claude-opus-4-7", "gpt-5.5"],
  modelLabels: { auto: "Auto-Combo" },
});

writeFileSync("opencode.json", JSON.stringify(config, null, 2));

Untuk penggabungan tanpa memusnahkan kandungan fail sedia ada, replikasikan mergeOpenCodeConfigText() daripada opencodeConfig.ts atau panggil penjana CLI.

Lihat README pakej untuk API penuh.

---

Perkara yang sebenarnya dilakukan oleh masa jalan

Kedua-dua laluan menghasilkan provider.omniroute.npm: "@ai-sdk/openai-compatible" yang sama. Semasa masa jalan, OpenCode memuatkan @ai-sdk/openai-compatible (yang sudah menjadi kebergantungan transitif OpenCode) dan mengkonfigurasikannya dengan baseURL + apiKey. Dari situ:

UI/ejen OpenCode
   → @ai-sdk/openai-compatible
      → HTTP POST {baseURL}/chat/completions          (permukaan OpenAI OmniRoute)
         → pengendali OmniRoute /v1/chat/completions  (open-sse/handlers/chatCore.ts)
            → penghalaan combo / Auto-Combo / pelaksana
               → penyedia huluan

Pemalam tidak pernah berinteraksi dengan HTTP. Ia hanya menghasilkan konfigurasi.

---

Lalai katalog model

export const OMNIROUTE_DEFAULT_OPENCODE_MODELS = [
  "claude-opus-4-5-thinking",
  "claude-sonnet-4-5-thinking",
  "gemini-3.1-pro-high",
  "gemini-3-flash",
] as const;

Anda boleh menulis ganti melalui models: [...]. Penambahan yang disyorkan:

• "auto" — menyediakan penghala konfigurasi sifar Auto-Combo OmniRoute. Membolehkan OpenCode memilih "model terbaik yang tersedia" tanpa anda menetapkan katalog secara langsung dalam kod.
• "<combo-name>" — sebarang kombo yang telah anda takrifkan dalam papan pemuka; OmniRoute menyelesaikannya secara telus.

---

Penormalan URL

Pembantu menerima kedua-dua bentuk dan menghasilkan tepat satu /v1:

Input	Output (options.baseURL)
http://localhost:20128	http://localhost:20128/v1
http://localhost:20128/	http://localhost:20128/v1
http://localhost:20128/v1	http://localhost:20128/v1
http://localhost:20128/v1///	http://localhost:20128/v1

Penyahduplikasian ini ialah punca kerosakan paling lazim yang dilihat dalam konfigurasi lama. Jika anda mempunyai opencode.json daripada sebelum v3.8.0 yang menghala ke /v1/v1/..., jalankan semula penjana atau panggil createOmniRouteProvider sekali lagi.

---

Mod pengesahan

Tetapan OmniRoute	Nilai apiKey yang disyorkan
REQUIRE_API_KEY=false (lalai untuk setempat)	sk_omniroute (pemegang tempat literal)
REQUIRE_API_KEY=true	Kunci API sebenar bagi setiap pengguna daripada Papan Pemuka → Kunci API.

Bagi klien gaya Anthropic yang menghantar x-api-key + anthropic-version, extractApiKey OmniRoute turut menerima kunci daripada x-api-key. OpenCode menggunakan antara muka OpenAI, jadi ia akan sentiasa menghantar Authorization: Bearer ${apiKey} — tiada kes khas Anthropic dikenakan di sini.

---

Penyelesaian masalah

Gejala	Punca	Penyelesaian
404 pada setiap permintaan dengan URL yang mengandungi /v1/v1/	Konfigurasi lapuk daripada pemalam sebelum v3.8 yang menambahkan akhiran /v1 dua kali.	Jana semula melalui Laluan 1 atau 2.
401 Invalid API key	OmniRoute mempunyai REQUIRE_API_KEY=true dan kunci tersebut tidak dikenali.	Cipta kunci dalam papan pemuka, atau tetapkan REQUIRE_API_KEY=false (setempat sahaja) dan gunakan sk_omniroute.
Senarai model kosong dalam UI OpenCode	Kesemua 4 model lalai disembunyikan dalam keterlihatan penyedia OmniRoute.	Berikan models: ["auto", ...] untuk memaparkan model yang telah anda dayakan.
OpenCode 500 dengan cannot read property 'models'	OpenCode lama (< 0.1.x) tidak menerima models sebaris.	Naik taraf OpenCode kepada versi yang mematuhi skema v1 (opencode.ai/config.json).

---

Lihat juga

• Rujukan API — keseluruhan permukaan REST OmniRoute
• Auto-Combo — maksud model: "auto"
• @omniroute/opencode-provider README
• Sumber: src/shared/services/opencodeConfig.ts, src/lib/cli-helper/config-generator/opencode.ts, @omniroute/opencode-provider/src/index.ts