mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-20 13:52:28 +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

17 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 · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

สถานะ: พร้อมใช้งานทั่วไป กลุ่มเป้าหมาย: ผู้ดูแลระบบที่เชื่อมต่อ OpenCode เข้ากับการติดตั้งใช้งาน OmniRoute แหล่งข้อมูลอ้างอิงหลัก (สคีมาการกำหนดค่า): src/shared/services/opencodeConfig.ts แหล่งข้อมูลอ้างอิงหลัก (แพ็กเกจ npm): @omniroute/opencode-provider/ (เวิร์กสเปซที่เผยแพร่ได้)

OpenCode เป็นไคลเอนต์ AI แบบเอเจนต์สำหรับ CLI/เดสก์ท็อป โดยอ่านแค็ตตาล็อกผู้ให้บริการจาก ~/.config/opencode/opencode.json (หรือ opencode.jsonc) และเป็นไปตามสคีมาที่ https://opencode.ai/config.json OmniRoute จะแสดงตัวต่อ OpenCode ในฐานะหนึ่งในผู้ให้บริการเหล่านั้น โดยทุกคำขอจะไหลผ่านพื้นผิว /v1 มาตรฐานของ OmniRoute ที่เข้ากันได้กับ OpenAI ทำให้ 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 จากนั้นกระบวนการจะเป็นดังนี้:

UI/เอเจนต์ของ OpenCode
   → @ai-sdk/openai-compatible
      → HTTP POST {baseURL}/chat/completions          (พื้นผิว OpenAI ของ OmniRoute)
         → ตัวจัดการ /v1/chat/completions ของ OmniRoute     (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" — แสดงเราเตอร์แบบไม่ต้องกำหนดค่า 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

สำหรับไคลเอนต์รูปแบบ 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 — รายละเอียด REST API ทั้งหมดของ OmniRoute
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

17 KiB Raw Blame History