mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-21 14:22:14 +03:00

Files

Diego Rodrigues de Sa e Souza 8feea123bb feat(docs): mirror every docs/ page in all 65 locales (#14106 )

* 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.

2026-09-18 13:16:46 -03:00

16 KiB

Raw Blame History

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 · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇵🇭 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

ਸਥਿਤੀ: ਆਮ ਤੌਰ 'ਤੇ ਉਪਲਬਧ। ਦਰਸ਼ਕ: OmniRoute ਡਿਪਲੌਇਮੈਂਟ ਨਾਲ OpenCode ਨੂੰ ਜੋੜਨ ਵਾਲੇ ਓਪਰੇਟਰ। ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ (ਸੰਰਚਨਾ ਸਕੀਮਾ): 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));

ਕਿਸੇ ਮੌਜੂਦਾ ਫ਼ਾਈਲ ਨਾਲ ਗੈਰ-ਵਿਨਾਸ਼ਕਾਰੀ ਮਰਜ ਲਈ, opencodeConfig.ts ਵਿੱਚੋਂ mergeOpenCodeConfigText() ਨੂੰ ਦੁਹਰਾਓ ਜਾਂ 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 Keys ਤੋਂ ਹਰੇਕ ਵਰਤੋਂਕਾਰ ਲਈ ਅਸਲੀ API ਕੁੰਜੀ।

x-api-key + anthropic-version ਭੇਜਣ ਵਾਲੇ Anthropic-ਸ਼ੈਲੀ ਕਲਾਇੰਟਾਂ ਲਈ, OmniRoute ਦਾ extractApiKey ਵੀ x-api-key ਤੋਂ ਮਿਲੀ ਕੁੰਜੀ ਨੂੰ ਮੰਨਦਾ ਹੈ। OpenCode, OpenAI ਸਰਫੇਸ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ, ਇਸ ਲਈ ਇਹ ਹਮੇਸ਼ਾ Authorization: Bearer ${apiKey} ਭੇਜੇਗਾ — ਇੱਥੇ Anthropic ਵਾਲਾ ਕੋਈ ਖ਼ਾਸ ਮਾਮਲਾ ਲਾਗੂ ਨਹੀਂ ਹੁੰਦਾ।

ਸਮੱਸਿਆ-ਨਿਵਾਰਣ

ਲੱਛਣ	ਕਾਰਨ	ਹੱਲ
`/v1/v1/` ਵਾਲੇ URL ਸਮੇਤ ਹਰ ਬੇਨਤੀ ਉੱਤੇ `404`	v3.8 ਤੋਂ ਪਹਿਲਾਂ ਵਾਲੇ ਪਲੱਗਇਨ ਦੀ ਪੁਰਾਣੀ ਕੌਂਫਿਗ, ਜਿਸ ਨੇ `/v1` ਦੋ ਵਾਰ ਜੋੜਿਆ ਸੀ।	ਪਾਥ 1 ਜਾਂ 2 ਰਾਹੀਂ ਮੁੜ ਜਨਰੇਟ ਕਰੋ।
`401 Invalid API key`	OmniRoute ਵਿੱਚ `REQUIRE_API_KEY=true` ਹੈ ਅਤੇ ਕੁੰਜੀ ਅਣਜਾਣ ਹੈ।	ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਕੁੰਜੀ ਬਣਾਓ, ਜਾਂ `REQUIRE_API_KEY=false` (ਸਿਰਫ਼ ਲੋਕਲ) ਸੈੱਟ ਕਰੋ ਅਤੇ `sk_omniroute` ਵਰਤੋ।
OpenCode UI ਵਿੱਚ ਮਾਡਲ ਸੂਚੀ ਖਾਲੀ ਹੈ	ਸਾਰੇ 4 ਡਿਫੌਲਟ ਮਾਡਲ OmniRoute ਦੀ ਪ੍ਰਦਾਤਾ ਦਿੱਖ ਵਿੱਚ ਲੁਕੇ ਹੋਏ ਹਨ।	ਤੁਹਾਡੇ ਵੱਲੋਂ ਸਮਰੱਥ ਕੀਤੇ ਮਾਡਲ ਦਿਖਾਉਣ ਲਈ `models: ["auto", ...]` ਪਾਸ ਕਰੋ।
`cannot read property 'models'` ਨਾਲ OpenCode 500	ਪੁਰਾਣਾ OpenCode (< 0.1.x) ਇਨਲਾਈਨ `models` ਸਵੀਕਾਰ ਨਹੀਂ ਕਰਦਾ ਸੀ।	OpenCode ਨੂੰ ਉਸ ਵਰਜਨ ’ਤੇ ਅੱਪਗ੍ਰੇਡ ਕਰੋ ਜੋ v1 ਸਕੀਮਾ (`opencode.ai/config.json`) ਦੀ ਪਾਲਣਾ ਕਰਦਾ ਹੈ।

ਇਹ ਵੀ ਵੇਖੋ

API ਹਵਾਲਾ — ਪੂਰਾ OmniRoute REST ਇੰਟਰਫੇਸ
Auto-Combo — model: "auto" ਦਾ ਕੀ ਅਰਥ ਹੈ
@omniroute/opencode-provider README
ਸਰੋਤ: src/shared/services/opencodeConfig.ts, src/lib/cli-helper/config-generator/opencode.ts, @omniroute/opencode-provider/src/index.ts

16 KiB Raw Blame History