8feea123bb
* feat(docs): mirror every docs/ page in all 65 locales Extends the documentation mirrors from the 22-page core set (#13940) to every Markdown page under docs/: 152 sources x 65 locales = 9,880 mirrors (6,208 new), language bars rewritten for the full locale list, state adopted so the blocking drift gate now covers all 152 pages. run-translation.mjs: an oversized block made only of table rows or list items (PROVIDER_REFERENCE.md 244-row table, FREE_TIERS.md 71-item list) is cut at item boundaries and rejoined without a blank line — the single 16-40 KB request outlived the backend socket for verbose scripts. 48 older mirrors whose tables had lost rows were retranslated with --force. * docs(i18n): refresh mirrors for the sources the base changed since the branch cut Section-level retranslation of the 29 docs (and README.md) whose source or mirrors moved on release/v3.8.51 during the run, then state adoption; the drift gate is green again on the merged tree.
17 KiB
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 · 🇰🇭 km · 🇮🇳 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/(გამოსაქვეყნებელი სამუშაო სივრცე)
OpenCode არის აგენტური CLI/დესკტოპ AI-კლიენტი. ის პროვაიდერების კატალოგს კითხულობს ~/.config/opencode/opencode.json-დან (ან opencode.jsonc-დან) და მიჰყვება სქემას მისამართზე https://opencode.ai/config.json. OmniRoute საკუთარ თავს OpenCode-ს ერთ-ერთ ასეთ პროვაიდერად წარუდგენს — თითოეული მოთხოვნა OmniRoute-ის სტანდარტულ, OpenAI-თან თავსებად /v1 ზედაპირზე გადის, ამიტომ OpenCode ავტომატურად სარგებლობს Auto-Combo მარშრუტიზაციით, ავარიული გამთიშველებით, გასაღებების პოლიტიკებით, დაკვირვებადობით და ა.შ.
მხარდაჭერილია ინტეგრაციის ორი გზა. აირჩიეთ ერთ-ერთი — ორივე ერთსა და იმავე კონფიგურაციას ქმნის.
გზა 1 — CLI გენერატორი (npm-ის ინსტალაციის გარეშე)
რეკომენდებულია საბოლოო მომხმარებლებისთვის. მოჰყვება OmniRoute-ს. ადგილზე წერს opencode.json-ს.
# OmniRoute-ის ინსტალაციის შემდეგ (npm i -g @omniroute/cli ან ლოკალური კლონი)
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 კონვეიერები, მონორეპოზიტორიები, ინსტალატორის მორგებული პროცესები).
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 გენერატორი.
სრული API-ის სანახავად იხილეთ პაკეტის README.
რას აკეთებს რეალურად გაშვების გარემო
ორივე გზა ქმნის ერთსა და იმავე provider.omniroute.npm: "@ai-sdk/openai-compatible"-ს. გაშვების დროს OpenCode ტვირთავს @ai-sdk/openai-compatible-ს (რომელიც უკვე OpenCode-ის ტრანზიტიული დამოკიდებულებაა) და აკონფიგურირებს მას baseURL + apiKey-ით. ამის შემდეგ:
OpenCode UI/აგენტი
→ @ai-sdk/openai-compatible
→ HTTP POST {baseURL}/chat/completions (OmniRoute-ის OpenAI ზედაპირი)
→ OmniRoute /v1/chat/completions დამმუშავებელი (open-sse/handlers/chatCore.ts)
→ კომბინირებული მარშრუტიზაცია / Auto-Combo / შემსრულებელი
→ ზედა დონის პროვაიდერი
პლაგინი 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"— ხელმისაწვდომს ხდის OmniRoute-ის Auto-Combo ნულოვანი კონფიგურაციის მქონე როუტერს. 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 |
დუბლირების ეს აღმოფხვრა ძველ კონფიგურაციებში აღმოჩენილი ყველაზე გავრცელებული გაუმართაობაა. თუ გაქვთ v3.8.0-მდე შექმნილი opencode.json, რომელიც /v1/v1/...-ზე მიუთითებს, ხელახლა გაუშვით გენერატორი ან კვლავ გამოიძახეთ createOmniRouteProvider.
ავთენტიფიკაციის რეჟიმები
| OmniRoute-ის პარამეტრი | რეკომენდებული apiKey მნიშვნელობა |
|---|---|
REQUIRE_API_KEY=false (ლოკალურისთვის ნაგულისხმევი) |
sk_omniroute (სიტყვასიტყვითი ჩანაცვლების მნიშვნელობა) |
REQUIRE_API_KEY=true |
რეალური, მომხმარებლისთვის ინდივიდუალური API გასაღები დაფიდან → API Keys. |
Anthropic-ის სტილის კლიენტებისთვის, რომლებიც აგზავნიან x-api-key + anthropic-version-ს, OmniRoute-ის extractApiKey ასევე ითვალისწინებს x-api-key-დან მიღებულ გასაღებს. OpenCode იყენებს OpenAI-ის ინტერფეისს, ამიტომ ის ყოველთვის გაგზავნის Authorization: Bearer ${apiKey}-ს — Anthropic-ისთვის განკუთვნილი სპეციალური შემთხვევა აქ არ გამოიყენება.
პრობლემების აღმოფხვრა
| სიმპტომი | მიზეზი | გამოსწორება |
|---|---|---|
404 ყველა მოთხოვნაზე, რომლის URL შეიცავს /v1/v1/-ს |
v3.8-მდე არსებული პლაგინის მოძველებული კონფიგურაცია, რომელიც /v1-ს ორჯერ ამატებდა. |
ხელახლა დააგენერირეთ Path 1-ის ან 2-ის მეშვეობით. |
401 Invalid API key |
OmniRoute-ში მითითებულია REQUIRE_API_KEY=true და გასაღები უცნობია. |
შექმენით გასაღები დაფაზე ან მიუთითეთ REQUIRE_API_KEY=false (მხოლოდ ლოკალურად) და გამოიყენეთ sk_omniroute. |
| OpenCode-ის ინტერფეისში მოდელების სია ცარიელია | ოთხივე ნაგულისხმევი მოდელი დამალულია 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" @omniroute/opencode-providerREADME- წყარო:
src/shared/services/opencodeConfig.ts,src/lib/cli-helper/config-generator/opencode.ts,@omniroute/opencode-provider/src/index.ts