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

OpenCode Integration (ខ្មែរ)

🌐 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 · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 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

---

ស្ថានភាព: អាចប្រើប្រាស់បានជាទូទៅ។ អ្នកអានគោលដៅ: ប្រតិបត្តិករដែលតភ្ជាប់ OpenCode ទៅកាន់ការដាក់ពង្រាយ OmniRoute។ ប្រភពយោងផ្លូវការ (គ្រោងការកំណត់រចនាសម្ព័ន្ធ): src/shared/services/opencodeConfig.ts ប្រភពយោងផ្លូវការ (កញ្ចប់ npm): @omniroute/opencode-provider/ (workspace ដែលអាចបោះពុម្ពផ្សាយបាន)

OpenCode គឺជាកម្មវិធីអតិថិជន AI បែបភ្នាក់ងារដែលដំណើរការជា CLI/លើកុំព្យូទ័រ។ វាអានកាតាឡុកអ្នកផ្តល់សេវារបស់វាពី ~/.config/opencode/opencode.json (ឬ opencode.jsonc) ហើយអនុវត្តតាមគ្រោងការនៅ https://opencode.ai/config.json។ OmniRoute បង្ហាញខ្លួនទៅកាន់ OpenCode ជាអ្នកផ្តល់សេវាមួយក្នុងចំណោមអ្នកផ្តល់សេវាទាំងនោះ — រាល់សំណើទាំងអស់ឆ្លងកាត់ចំណុចប្រទាក់ /v1 ស្តង់ដាររបស់ OmniRoute ដែលឆបគ្នាជាមួយ OpenAI ដូច្នេះ OpenCode ទទួលបានអត្ថប្រយោជន៍ដោយស្វ័យប្រវត្តិពីការបញ្ជូនផ្លូវ Auto-Combo, circuit breakers, គោលការណ៍សោ, ការសង្កេតតាមដាន និងមុខងារផ្សេងៗទៀត។

មាន វិធីសាស្ត្រសមាហរណកម្មដែលគាំទ្រចំនួនពីរ។ ជ្រើសរើសមួយ — វិធីទាំងពីរបង្កើតការកំណត់រចនាសម្ព័ន្ធដូចគ្នា។

---

វិធីទី 1 — កម្មវិធីបង្កើតតាម CLI (មិនចាំបាច់ដំឡើង npm)

ត្រូវបានណែនាំសម្រាប់អ្នកប្រើប្រាស់ទូទៅ។ វាភ្ជាប់មកជាមួយ OmniRoute។ វាសរសេរទៅក្នុង opencode.json ដោយផ្ទាល់។

# បន្ទាប់ពីដំឡើង OmniRoute (npm i -g @omniroute/cli ឬ local clone)
omniroute config opencode \
  --base-url http://localhost:20128 \
  --api-key "$OMNIROUTE_API_KEY"

នៅពីក្រោយដំណើរការ CLI ហៅ mergeOpenCodeConfigText() (src/shared/services/opencodeConfig.ts:104) ដូច្នេះ opencode.json ដែលមានស្រាប់នៅតែរក្សាអ្នកផ្តល់សេវាផ្សេងៗ និងមតិយោបល់របស់វា។ ធាតុ OmniRoute ត្រូវបានបន្ថែម/ជំនួសដោយអាតូមិក។

ឯកសារលទ្ធផល (កាតាឡុកម៉ូដែលលំនាំដើម):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1",
        "apiKey": "<your-key>",
      },
      "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" },
      },
    },
  },
}

---

វិធីទី 2 — កញ្ចប់ npm @omniroute/opencode-provider

ត្រូវបានណែនាំនៅពេលអ្នកកំពុងសរសេរស្គ្រីបការកំណត់រចនាសម្ព័ន្ធពី Node/TS (CI pipelines, monorepos, លំហូរកម្មវិធីដំឡើងផ្ទាល់ខ្លួន)។

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",
  // ជាជម្រើស៖ កំណត់ជំនួសកាតាឡុកម៉ូដែលដែលបង្ហាញទៅកាន់ OpenCode
  models: ["auto", "claude-opus-4-7", "gpt-5.5"],
  modelLabels: { auto: "Auto-Combo" },
});

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

សម្រាប់ការបញ្ចូលរួមគ្នាដែលមិនបំផ្លាញទិន្នន័យជាមួយឯកសារដែលមានស្រាប់ សូមបង្កើតឡើងវិញតាម mergeOpenCodeConfigText() ពី opencodeConfig.ts ឬហៅកម្មវិធីបង្កើតតាម CLI។

សូមមើល README របស់កញ្ចប់ សម្រាប់ API ពេញលេញ។

---

អ្វីដែល runtime ធ្វើជាក់ស្តែង

វិធីទាំងពីរបង្កើត provider.omniroute.npm: "@ai-sdk/openai-compatible" ដូចគ្នា។ នៅពេល runtime ដំណើរការ OpenCode ផ្ទុក @ai-sdk/openai-compatible (ដែលជាភាពអាស្រ័យបន្តរបស់ OpenCode រួចហើយ) និងកំណត់រចនាសម្ព័ន្ធវាដោយប្រើ baseURL + apiKey។ ចាប់ពីចំណុចនោះ៖

UI/ភ្នាក់ងារ OpenCode
   → @ai-sdk/openai-compatible
      → HTTP POST {baseURL}/chat/completions          (ចំណុចប្រទាក់ OpenAI របស់ OmniRoute)
         → កម្មវិធីដោះស្រាយ OmniRoute /v1/chat/completions     (open-sse/handlers/chatCore.ts)
            → ការបញ្ជូនផ្លូវ combo / Auto-Combo / executor
               → អ្នកផ្តល់សេវាដើម

កម្មវិធីជំនួយមិនដែលប៉ះពាល់ HTTP ឡើយ។ វាគ្រាន់តែបញ្ចេញការកំណត់រចនាសម្ព័ន្ធប៉ុណ្ណោះ។

---

លំនាំដើមនៃកាតាឡុកម៉ូដែល

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;

អ្នកអាចកំណត់ជំនួសតាមរយៈ models: [...]។ ជម្រើសបន្ថែមដែលបានណែនាំ៖

• "auto" — បង្ហាញរ៉ោតទ័រដែលមិនត្រូវការការកំណត់រចនាសម្ព័ន្ធ Auto-Combo របស់ OmniRoute។ អនុញ្ញាតឱ្យ OpenCode ជ្រើសរើស "ម៉ូដែលដែលល្អបំផុតដែលមាន" ដោយអ្នកមិនចាំបាច់សរសេរកាតាឡុកថេរនៅក្នុងកូដ។
• "<combo-name>" — បន្សំណាមួយដែលអ្នកបានកំណត់ក្នុងផ្ទាំងគ្រប់គ្រង; OmniRoute នឹងដោះស្រាយវាដោយតម្លាភាព។

---

ការធ្វើឱ្យ URL មានទម្រង់ស្តង់ដារ

កម្មវិធីជំនួយនេះទទួលយកទម្រង់ទាំងពីរ ហើយបញ្ចេញ /v1 តែមួយគត់៖

ទិន្នន័យបញ្ចូល	ទិន្នន័យបញ្ចេញ (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

ការលុបភាពស្ទួននេះគឺជា មូលហេតុខូចដែលកើតញឹកញាប់បំផុត ក្នុងការកំណត់រចនាសម្ព័ន្ធចាស់ៗ។ ប្រសិនបើអ្នកមាន opencode.json ពីមុន v3.8.0 ដែលចង្អុលទៅ /v1/v1/... សូមដំណើរការកម្មវិធីបង្កើតម្តងទៀត ឬហៅ createOmniRouteProvider ម្តងទៀត។

---

របៀបផ្ទៀងផ្ទាត់អត្តសញ្ញាណ

ការកំណត់ OmniRoute	តម្លៃ apiKey ដែលបានណែនាំ
REQUIRE_API_KEY=false (លំនាំដើមសម្រាប់មូលដ្ឋាន)	sk_omniroute (តម្លៃជំនួសតាមព្យញ្ជនៈ)
REQUIRE_API_KEY=true	សោ API ពិតប្រាកដសម្រាប់អ្នកប្រើនីមួយៗពីផ្ទាំងគ្រប់គ្រង → API Keys។

សម្រាប់កម្មវិធីភ្ញៀវបែប Anthropic ដែលផ្ញើ x-api-key + anthropic-version នោះ extractApiKey របស់ OmniRoute ក៏ទទួលស្គាល់សោពី x-api-key ផងដែរ។ OpenCode ប្រើចំណុចប្រទាក់ OpenAI ដូច្នេះវានឹងផ្ញើ Authorization: Bearer ${apiKey} ជានិច្ច — គ្មានករណីពិសេសសម្រាប់ Anthropic ត្រូវបានអនុវត្តនៅទីនេះទេ។

---

ការដោះស្រាយបញ្ហា

រោគសញ្ញា	មូលហេតុ	ដំណោះស្រាយ
404 លើគ្រប់សំណើដែលមាន URL ផ្ទុក /v1/v1/	ការកំណត់រចនាសម្ព័ន្ធចាស់ពីកម្មវិធីបន្ថែមមុន v3.8 ដែលបានបន្ថែមបច្ច័យ /v1 ពីរដង។	បង្កើតឡើងវិញតាមវិធីទី 1 ឬ 2។
401 Invalid API key	OmniRoute មាន REQUIRE_API_KEY=true ហើយមិនស្គាល់សោនោះ។	បង្កើតសោនៅក្នុងផ្ទាំងគ្រប់គ្រង ឬកំណត់ REQUIRE_API_KEY=false (សម្រាប់មូលដ្ឋានប៉ុណ្ណោះ) ហើយប្រើ sk_omniroute។
បញ្ជីម៉ូដែលទទេនៅក្នុង UI របស់ OpenCode	ម៉ូដែលលំនាំដើមទាំង 4 ត្រូវបានលាក់ក្នុងការកំណត់ភាពមើលឃើញរបស់អ្នកផ្តល់សេវា OmniRoute។	ផ្តល់ models: ["auto", ...] ដើម្បីបង្ហាញម៉ូដែលដែលអ្នកបានបើកប្រើ។
OpenCode បង្ហាញ 500 ជាមួយ cannot read property 'models'	OpenCode កំណែចាស់ (< 0.1.x) មិនទទួលយក models ដែលបានកំណត់នៅនឹងកន្លែងទេ។	ដំឡើង OpenCode ទៅកំណែដែលអនុវត្តតាមគ្រោងការណ៍ v1 (opencode.ai/config.json)។

---

សូមមើលផងដែរ

• ឯកសារយោង API — ផ្ទៃប្រើប្រាស់ OmniRoute REST ពេញលេញ
• Auto-Combo — អត្ថន័យនៃ model: "auto"
• README របស់ @omniroute/opencode-provider
• កូដប្រភព៖ src/shared/services/opencodeConfig.ts, src/lib/cli-helper/config-generator/opencode.ts, @omniroute/opencode-provider/src/index.ts