Skip to content

docs(go): translate client compatibility guidance #47901

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MrMushrooooom merged 2 commits into from
Sep 8, 2026
Merged

docs(go): translate client compatibility guidance #47901

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d04a805
docs(go): translate client compatibility guidance
MrMushrooooom Sep 8, 2026
aef9902
docs(go): refine traditional Chinese disclaimer
MrMushrooooom Sep 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 38 additions & 9 deletions packages/web/src/content/docs/ar/go.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,15 +83,44 @@ OpenCode Go هو اشتراك منخفض التكلفة بقيمة **$10/شهر

## أين يمكنني استخدامه؟

صُمّم OpenCode Go للاستخدام مع [OpenCode](https://opencode.ai) وغيره من وكلاء البرمجة الشائعين الذين ينشئون أنواعًا مماثلة من الطلبات.

تتم مراقبة حركة المرور لرصد الاستخدام المسيء الذي يؤدي إلى تدهور تجربة المستخدمين الآخرين.

لتجنب وضع علامة على حسابك، تأكد من أن الأداة التي تستخدمها

1\. لا تنشئ حركة مرور مسيئة
2\. تعرّف عن نفسها بشكل صحيح (من دون معرّفات وكيل مستخدم عامة)
3\. تتضمن ترويسة `x-opencode-session` حتى نتمكن من تحسين التخزين المؤقت للمطالبات
صُمّم OpenCode Go للاستخدام مع [OpenCode](https://opencode.ai) ووكلاء البرمجة الآخرين
الذين ينشئون أنواعًا مماثلة من الطلبات. وتتم مراقبة حركة المرور لرصد إساءة الاستخدام التي
تؤدي إلى تدهور تجربة المستخدمين الآخرين.

ينبغي لعميلك أن:

1. يرسل حركة المرور المعتادة لوكلاء البرمجة.
2. يعرّف عن نفسه باستخدام وكيل المستخدم الخاص به، مثل `my-coding-agent/1.0`، بدلًا
من اسم عام لحزمة SDK أو مكتبة HTTP.
3. يرسل معرّف جلسة ثابتًا في `x-opencode-session` لكل محادثة حتى نتمكن من تحسين التوجيه
والتخزين المؤقت للمطالبات.

### العملاء الذين تم التحقق منهم

بالإضافة إلى OpenCode، تم التحقق من أن العملاء التاليين يعملون بصورة صحيحة
مع OpenCode Go، مع أننا لا نضمن استمرارهم في العمل مستقبلًا.

| العميل | دعم الجلسات |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Hermes** | ترسل البُنى التي تتضمن [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) الترويسة في طلبات OpenCode الرئيسية والمساعدة. دُمج الإصلاح بعد v0.21.0؛ ولا يتضمن ذلك الإصدار وحده الإصلاح. |
| **Claude Code** | يتعرف Go على ترويسة الجلسة الأصلية الخاصة به. ولا حاجة إلى غلاف لإضافة ترويسة مخصصة. |
| **Codex** | يتعرف Go على ترويسة الجلسة الأصلية الخاصة به. لا تزال بعض الإصدارات وإعدادات الوكيل تحذفها؛ لذا حافظ على ترويسة الجلسة عند إعادة توجيه الطلبات. |
| **ZCode** | يتعرف Go على ترويسة الجلسة الأصلية الخاصة به. لا يزال [طلبنا لإضافة `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) مفتوحًا، لكن إرسال هذه الترويسة بعينها لم يعد ضروريًا. |
| **Pi** | ترسل الإصدارات الحالية معلومات الجلسة إلى OpenCode. حدّث عمليات التثبيت الأقدم. |
| **jcode** | حدّث إلى **v0.81.6 أو إصدار أحدث**، إذ يتضمن [إصلاح ترويسة الجلسة](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | تعيد الإصدارات التي تتضمن [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) ترويسات جلسات OpenCode. يشمل هذا الإصلاح CLI، وليس إضافة VS Code. راجع [issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |

### العملاء المعروف وجود مشكلات لديهم

دعم الجلسات مفقود أو غير مكتمل في إصدارات هؤلاء العملاء التي
تحققنا منها. وتتابع البلاغات المرتبطة الإصلاحات والحلول البديلة.

| العميل | الحالة والمتابعة |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **DeepSeek Harness** | تصل معلومات الجلسة عبر بعض مسارات النماذج، لكنها تكون مفقودة عبر مسارات أخرى. نتعرف على ترويسة الجلسة الأصلية الخاصة به؛ والعمل المتبقي هو إرسالها عبر جميع المحولات. [Discussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | طُلب دعم ترويسة الجلسة تلقائيًا في [VS Code issue #334186](https://github.com/microsoft/vscode/issues/334186). |
| **Kimi Code** | طُلب دعم ترويسة الجلسة تلقائيًا في [issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506). |
| **MiMo Code** | يتضمن [Issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) إصلاحًا مقترحًا في [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327)، ولم يُدمج بعد. |

## حدود الاستخدام

Expand Down
47 changes: 38 additions & 9 deletions packages/web/src/content/docs/bs/go.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,15 +93,44 @@ Lista modela se može mijenjati dok testiramo i dodajemo nove.

## Gdje ga mogu koristiti?

OpenCode Go je osmišljen za korištenje s [OpenCode-om](https://opencode.ai) i drugim popularnim agentima za programiranje koji generišu slične vrste zahtjeva.

Saobraćaj se nadzire radi otkrivanja zloupotrebe koja narušava iskustvo drugih korisnika.

Kako vaš račun ne bi bio označen, pobrinite se da alat koji koristite

1\. ne generiše saobraćaj koji predstavlja zloupotrebu
2\. se ispravno identifikuje (bez generičkih User-Agent identifikatora)
3\. uključuje zaglavlje `x-opencode-session` kako bismo mogli optimizovati keširanje promptova
OpenCode Go je osmišljen za [OpenCode](https://opencode.ai) i druge agente za programiranje
koji šalju slične vrste zahtjeva. Saobraćaj se nadzire radi otkrivanja zloupotrebe koja
drugim korisnicima narušava iskustvo.

Vaš klijent treba:

1. Slati tipičan saobraćaj agenta za programiranje.
2. Identifikovati se vlastitim user agentom, kao što je `my-coding-agent/1.0`, a ne
generičkim nazivom SDK-a ili HTTP biblioteke.
3. Slati stabilan ID sesije u zaglavlju `x-opencode-session` za svaki razgovor kako bismo mogli optimizovati usmjeravanje i
keširanje promptova.

### Provjereni klijenti

Pored OpenCode-a, potvrđeno je da sljedeći klijenti ispravno rade
s OpenCode Go. Ipak, ne garantiramo da će nastaviti raditi i u budućnosti.

| Klijent | Podrška za sesije |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | Buildovi koji sadrže [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) šalju zaglavlje u glavnim i pomoćnim OpenCode zahtjevima. Ispravka je spojena nakon verzije v0.21.0; samo to izdanje je ne sadrži. |
| **Claude Code** | Go prepoznaje njegovo izvorno zaglavlje sesije. Wrapper za prilagođeno zaglavlje nije potreban. |
| **Codex** | Go prepoznaje njegovo izvorno zaglavlje sesije. Neke verzije i proxy konfiguracije ga i dalje izostavljaju; sačuvajte zaglavlje sesije pri prosljeđivanju zahtjeva. |
| **ZCode** | Go prepoznaje njegovo izvorno zaglavlje sesije. Naš [zahtjev za `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) i dalje je otvoren, ali slanje tog konkretnog zaglavlja više nije potrebno. |
| **Pi** | Trenutni buildovi šalju informacije o sesiji za OpenCode. Ažurirajte starije instalacije. |
| **jcode** | Ažurirajte na **v0.81.6 ili noviju**, koja uključuje [ispravku zaglavlja sesije](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | Buildovi koji sadrže [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) vraćaju OpenCode zaglavlja sesije. Ova ispravka obuhvata CLI, ali ne i VS Code ekstenziju. Pogledajte [issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |

### Poznati problematični klijenti

Ovim klijentima nedostaje podrška za sesije ili je ona nepotpuna u verzijama koje smo
istražili. Povezani izvještaji prate ispravke i zaobilazna rješenja.

| Klijent | Status i praćenje |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **DeepSeek Harness** | Informacije o sesiji stižu za neke putanje modela, ali nedostaju za druge. Prepoznajemo njegovo izvorno zaglavlje; preostaje da se ono šalje kroz sve adaptere. [Discussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | Automatska podrška za zaglavlje sesije zatražena je u [VS Code issue #334186](https://github.com/microsoft/vscode/issues/334186). |
| **Kimi Code** | Automatska podrška za zaglavlje sesije zatražena je u [issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506). |
| **MiMo Code** | [Issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) ima predloženu ispravku u [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), koji još nije spojen. |

## Ograničenja upotrebe

Expand Down
47 changes: 38 additions & 9 deletions packages/web/src/content/docs/da/go.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,15 +93,44 @@ Listen over modeller kan ændre sig, efterhånden som vi tester og tilføjer nye

## Hvor kan jeg bruge det?

OpenCode Go er designet til brug med [OpenCode](https://opencode.ai) og andre populære kodningsagenter, der genererer lignende typer anmodninger.

Trafikken overvåges for misbrug, der forringer oplevelsen for andre brugere.

For at sikre, at din konto ikke bliver markeret, skal du sørge for, at det værktøj, du bruger,

1\. ikke genererer misbrugstrafik
2\. identificerer sig korrekt (ingen generiske User-Agent-identifikatorer)
3\. inkluderer `x-opencode-session`-headeren, så vi kan optimere prompt-caching
OpenCode Go er udviklet til [OpenCode](https://opencode.ai) og andre kodningsagenter,
der sender lignende typer anmodninger. Trafikken overvåges for misbrug, der
forringer oplevelsen for andre brugere.

Din klient skal:

1. Sende typisk trafik fra en kodningsagent.
2. Identificere sig med sin egen user agent, f.eks. `my-coding-agent/1.0`, i stedet
for et generisk navn på et SDK eller HTTP-bibliotek.
3. Sende et stabilt sessions-id i `x-opencode-session` for hver samtale, så vi kan optimere routing og
prompt-caching.

### Validerede klienter

Ud over OpenCode er følgende klienter blevet valideret til at fungere korrekt
med OpenCode Go. Vi garanterer dog ikke, at de fortsat vil fungere fremover.

| Klient | Sessionsunderstøttelse |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | Builds, der indeholder [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864), sender headeren i primære og sekundære OpenCode-anmodninger. Rettelsen blev merged efter v0.21.0; den version indeholder den ikke i sig selv. |
| **Claude Code** | Go genkender dens indbyggede sessionsheader. En wrapper til en brugerdefineret header er ikke nødvendig. |
| **Codex** | Go genkender dens indbyggede sessionsheader. Nogle versioner og proxyopsætninger udelader den stadig; bevar sessionsheaderen, når anmodninger videresendes. |
| **ZCode** | Go genkender dens indbyggede sessionsheader. Vores [anmodning om `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) er stadig åben, men det er ikke længere nødvendigt at sende netop denne header. |
| **Pi** | Aktuelle builds sender sessionsoplysninger til OpenCode. Opdater ældre installationer. |
| **jcode** | Opdater til **v0.81.6 eller nyere**, som indeholder [rettelsen til sessionsheaderen](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | Builds, der indeholder [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752), gendanner OpenCode-sessionsheadere. Denne rettelse dækker CLI'en, men ikke VS Code-udvidelsen. Se [issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |

### Kendte problematiske klienter

Disse klienter mangler sessionsunderstøttelse eller har ufuldstændig understøttelse i de versioner, vi
undersøgte. De linkede rapporter følger rettelser og løsninger.

| Klient | Status og opfølgning |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **DeepSeek Harness** | Sessionsoplysninger modtages på nogle modelstier, men mangler på andre. Vi genkender dens indbyggede header; det resterende arbejde er at sende den gennem alle adaptere. [Discussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | Automatisk understøttelse af sessionsheaderen er efterspurgt i [VS Code issue #334186](https://github.com/microsoft/vscode/issues/334186). |
| **Kimi Code** | Automatisk understøttelse af sessionsheaderen er efterspurgt i [issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506). |
| **MiMo Code** | [Issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) har en foreslået rettelse i [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), som endnu ikke er merged. |

## Forbrugsgrænser

Expand Down
Loading
Loading