docs(go): translate client compatibility guidance (#47901)

This commit is contained in:
Jack
2026-09-08 14:50:35 +08:00
committed by GitHub
parent ecbc6ccac8
commit eebd85f5d1
17 changed files with 573 additions and 100 deletions
+35 -6
View File
@@ -83,15 +83,44 @@ OpenCode Go هو اشتراك منخفض التكلفة بقيمة **$10/شهر
## أين يمكنني استخدامه؟
صُمّم OpenCode Go للاستخدام مع [OpenCode](https://opencode.ai) وغيره من وكلاء البرمجة الشائعين الذين ينشئون أنواعًا مماثلة من الطلبات.
صُمّم OpenCode Go للاستخدام مع [OpenCode](https://opencode.ai) ووكلاء البرمجة الآخرين
الذين ينشئون أنواعًا مماثلة من الطلبات. وتتم مراقبة حركة المرور لرصد إساءة الاستخدام التي
تؤدي إلى تدهور تجربة المستخدمين الآخرين.
تتم مراقبة حركة المرور لرصد الاستخدام المسيء الذي يؤدي إلى تدهور تجربة المستخدمين الآخرين.
ينبغي لعميلك أن:
لتجنب وضع علامة على حسابك، تأكد من أن الأداة التي تستخدمها
1. يرسل حركة المرور المعتادة لوكلاء البرمجة.
2. يعرّف عن نفسه باستخدام وكيل المستخدم الخاص به، مثل `my-coding-agent/1.0`، بدلًا
من اسم عام لحزمة SDK أو مكتبة HTTP.
3. يرسل معرّف جلسة ثابتًا في `x-opencode-session` لكل محادثة حتى نتمكن من تحسين التوجيه
والتخزين المؤقت للمطالبات.
1\. لا تنشئ حركة مرور مسيئة
2\. تعرّف عن نفسها بشكل صحيح (من دون معرّفات وكيل مستخدم عامة)
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)، ولم يُدمج بعد. |
## حدود الاستخدام
+35 -6
View File
@@ -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.
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.
Saobraćaj se nadzire radi otkrivanja zloupotrebe koja narušava iskustvo drugih korisnika.
Vaš klijent treba:
Kako vaš račun ne bi bio označen, pobrinite se da alat koji koristite
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.
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
### 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
+35 -6
View File
@@ -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.
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.
Trafikken overvåges for misbrug, der forringer oplevelsen for andre brugere.
Din klient skal:
For at sikre, at din konto ikke bliver markeret, skal du sørge for, at det værktøj, du bruger,
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.
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
### 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
+35 -6
View File
@@ -85,15 +85,44 @@ Die Liste der Modelle kann sich ändern, während wir neue testen und hinzufüge
## Wo kann ich es verwenden?
OpenCode Go wurde für die Verwendung mit [OpenCode](https://opencode.ai) und anderen beliebten Coding-Agenten entwickelt, die ähnliche Arten von Anfragen erzeugen.
OpenCode Go wurde für [OpenCode](https://opencode.ai) und andere Coding-Agenten entwickelt,
die ähnliche Arten von Anfragen erzeugen. Der Datenverkehr wird auf Missbrauch überwacht,
der das Nutzungserlebnis anderer beeinträchtigt.
Der Datenverkehr wird auf missbräuchlichen Traffic überwacht, der das Nutzungserlebnis anderer beeinträchtigt.
Dein Client sollte:
Damit dein Konto nicht markiert wird, stelle sicher, dass das von dir verwendete Tool
1. typischen Datenverkehr eines Coding-Agenten senden
2. sich mit einem eigenen User-Agent wie `my-coding-agent/1.0` identifizieren und
nicht mit dem allgemeinen Namen eines SDKs oder einer HTTP-Bibliothek.
3. für jede Unterhaltung eine stabile Sitzungs-ID in `x-opencode-session` senden, damit wir das Routing und
Prompt-Caching optimieren können.
1\. keinen missbräuchlichen Traffic erzeugt
2\. sich ordnungsgemäß identifiziert (keine allgemeinen User-Agents)
3\. den Header `x-opencode-session` enthält, damit wir das Prompt-Caching optimieren können
### Validierte Clients
Neben OpenCode wurden die folgenden Clients für die ordnungsgemäße Verwendung mit
OpenCode Go validiert. Wir garantieren jedoch nicht, dass sie auch in Zukunft funktionieren werden.
| Client | Sitzungsunterstützung |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | Builds mit [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) senden den Header bei Haupt- und zusätzlichen OpenCode-Anfragen. Der Fix wurde nach v0.21.0 gemergt; diese Version allein enthält ihn nicht. |
| **Claude Code** | Go erkennt seinen nativen Sitzungs-Header. Es ist kein Wrapper für benutzerdefinierte Header erforderlich. |
| **Codex** | Go erkennt seinen nativen Sitzungs-Header. Einige Versionen und Proxy-Konfigurationen lassen ihn weiterhin weg; stelle sicher, dass der Sitzungs-Header beim Weiterleiten von Anfragen erhalten bleibt. |
| **ZCode** | Go erkennt seinen nativen Sitzungs-Header. Unsere [Anfrage für `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) ist weiterhin offen, aber es ist nicht mehr erforderlich, genau diesen Header zu senden. |
| **Pi** | Aktuelle Builds senden Sitzungsinformationen für OpenCode. Aktualisiere ältere Installationen. |
| **jcode** | Aktualisiere auf **v0.81.6 oder neuer**. Diese Version enthält den [Fix für den Sitzungs-Header](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | Builds mit [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) stellen OpenCode-Sitzungs-Header wieder her. Dieser Fix gilt für die CLI, nicht für die VS-Code-Erweiterung. Siehe [Issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |
### Bekannte problematische Clients
Bei diesen Clients fehlt in den von uns untersuchten Versionen die Sitzungsunterstützung
oder sie ist unvollständig. Die verlinkten Berichte dokumentieren Fixes und Problemumgehungen.
| Client | Status und Nachverfolgung |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **DeepSeek Harness** | Sitzungsinformationen werden bei einigen Modellpfaden übermittelt, fehlen aber bei anderen. Wir erkennen seinen nativen Header; dieser muss noch von allen Adaptern gesendet werden. [Diskussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | Automatische Unterstützung für Sitzungs-Header wurde in [VS Code Issue #334186](https://github.com/microsoft/vscode/issues/334186) angefragt. |
| **Kimi Code** | Automatische Unterstützung für Sitzungs-Header wurde in [Issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506) angefragt. |
| **MiMo Code** | Für [Issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) gibt es einen vorgeschlagenen Fix in [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), der noch nicht gemergt wurde. |
## Nutzungslimits
+35 -6
View File
@@ -93,15 +93,44 @@ La lista de modelos puede cambiar a medida que probamos y agregamos otros nuevos
## ¿Dónde puedo usarlo?
OpenCode Go está diseñado para usarse con [OpenCode](https://opencode.ai) y otros agentes de programación populares que generan tipos de peticiones similares.
OpenCode Go está diseñado para [OpenCode](https://opencode.ai) y otros agentes de programación
que generan tipos de peticiones similares. El tráfico se supervisa para detectar abusos que
perjudiquen la experiencia de otros usuarios.
El tráfico se supervisa para detectar tráfico abusivo que perjudique la experiencia de otros usuarios.
Tu cliente debe:
Para evitar que tu cuenta sea marcada, asegúrate de que la herramienta que usas
1. Enviar el tráfico habitual de un agente de programación
2. Identificarse con su propio agente de usuario, como `my-coding-agent/1.0`, en lugar
del nombre genérico de un SDK o una biblioteca HTTP.
3. Enviar un ID de sesión estable en `x-opencode-session` para cada conversación, de modo que podamos optimizar el enrutamiento y
el almacenamiento en caché de prompts.
1\. no genere tráfico abusivo
2\. se identifique correctamente (sin agentes de usuario genéricos)
3\. incluya el encabezado `x-opencode-session` para que podamos optimizar el almacenamiento en caché de prompts
### Clientes validados
Además de OpenCode, se ha validado que los siguientes clientes funcionan correctamente
con OpenCode Go. Sin embargo, no garantizamos que sigan funcionando en el futuro.
| Cliente | Compatibilidad con sesiones |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | Las compilaciones que incluyen el [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) envían el encabezado en las peticiones principales y auxiliares de OpenCode. La corrección se fusionó después de v0.21.0; esa versión por sí sola no la incluye. |
| **Claude Code** | Go reconoce su encabezado de sesión nativo. No se necesita ningún wrapper para encabezados personalizados. |
| **Codex** | Go reconoce su encabezado de sesión nativo. Algunas versiones y configuraciones de proxy aún lo omiten; conserva el encabezado de sesión al reenviar peticiones. |
| **ZCode** | Go reconoce su encabezado de sesión nativo. Nuestra [solicitud de `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) sigue abierta, pero ya no es necesario enviar ese encabezado específico. |
| **Pi** | Las compilaciones actuales envían información de sesión para OpenCode. Actualiza las instalaciones antiguas. |
| **jcode** | Actualiza a la versión **v0.81.6 o posterior**, que incluye la [corrección del encabezado de sesión](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | Las compilaciones que incluyen el [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) restauran los encabezados de sesión de OpenCode. Esta corrección cubre la CLI, no la extensión de VS Code. Consulta el [issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |
### Clientes con problemas conocidos
Estos clientes tienen una compatibilidad con sesiones ausente o incompleta en las versiones que
investigamos. Los informes enlazados permiten seguir las correcciones y las soluciones alternativas.
| Cliente | Estado y seguimiento |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **DeepSeek Harness** | La información de sesión llega por algunas rutas de modelos, pero falta en otras. Reconocemos su encabezado nativo; aún es necesario enviarlo a través de todos los adaptadores. [Discusión #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | La compatibilidad automática con el encabezado de sesión se solicitó en el [issue #334186 de VS Code](https://github.com/microsoft/vscode/issues/334186). |
| **Kimi Code** | La compatibilidad automática con el encabezado de sesión se solicitó en el [issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506). |
| **MiMo Code** | El [issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) tiene una corrección propuesta en el [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), que aún no se ha fusionado. |
## Límites de uso
+35 -6
View File
@@ -83,15 +83,44 @@ La liste des modèles peut changer au fur et à mesure que nous en testons et en
## Où puis-je l'utiliser ?
OpenCode Go est conçu pour être utilisé avec [OpenCode](https://opencode.ai) et d'autres agents de codage populaires qui génèrent des types de requêtes similaires.
OpenCode Go est conçu pour [OpenCode](https://opencode.ai) et d'autres agents de codage
qui produisent des types de requêtes similaires. Le trafic est surveillé afin de détecter les abus qui
dégradent l'expérience des autres utilisateurs.
Le trafic est surveillé afin de détecter tout trafic abusif qui dégrade l'expérience des autres utilisateurs.
Votre client doit :
Pour éviter que votre compte ne soit signalé, assurez-vous que l'outil que vous utilisez
1. Envoyer le trafic habituel d'un agent de codage
2. S'identifier avec son propre agent utilisateur, tel que `my-coding-agent/1.0`, plutôt
qu'avec le nom générique d'un SDK ou d'une bibliothèque HTTP.
3. Envoyer un ID de session stable dans `x-opencode-session` pour chaque conversation afin que nous puissions optimiser le routage et
la mise en cache des prompts.
1\. ne génère pas de trafic abusif
2\. s'identifie correctement (pas d'agents utilisateur génériques)
3\. inclut l'en-tête `x-opencode-session` afin que nous puissions optimiser la mise en cache des prompts
### Clients validés
Outre OpenCode, le bon fonctionnement des clients suivants avec OpenCode Go a été
validé. Nous ne garantissons toutefois pas qu'ils continueront à fonctionner à l'avenir.
| Client | Prise en charge des sessions |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | Les builds contenant la [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) envoient l'en-tête sur les requêtes OpenCode principales et auxiliaires. Le correctif a été fusionné après la v0.21.0 ; cette version seule ne l'inclut pas. |
| **Claude Code** | Go reconnaît son en-tête de session natif. Aucun wrapper d'en-tête personnalisé n'est nécessaire. |
| **Codex** | Go reconnaît son en-tête de session natif. Certaines versions et configurations de proxy l'omettent encore ; conservez l'en-tête de session lors du transfert des requêtes. |
| **ZCode** | Go reconnaît son en-tête de session natif. Notre [demande concernant `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) reste ouverte, mais il n'est plus nécessaire d'envoyer spécifiquement cet en-tête. |
| **Pi** | Les builds actuels envoient les informations de session pour OpenCode. Mettez à jour les installations plus anciennes. |
| **jcode** | Passez à la version **v0.81.6 ou ultérieure**, qui inclut le [correctif de l'en-tête de session](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | Les builds contenant la [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) rétablissent les en-têtes de session OpenCode. Ce correctif concerne la CLI, pas l'extension VS Code. Consultez l'[issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |
### Clients connus pour poser problème
Dans les versions que nous avons examinées, ces clients ne prennent pas en charge les sessions
ou ne les prennent en charge que partiellement. Les rapports associés permettent de suivre les correctifs et les solutions de contournement.
| Client | État et suivi |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **DeepSeek Harness** | Les informations de session sont présentes pour certains chemins de modèles, mais absentes pour d'autres. Nous reconnaissons son en-tête natif ; il reste à l'envoyer depuis tous les adaptateurs. [Discussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | La prise en charge automatique de l'en-tête de session fait l'objet de l'[issue VS Code #334186](https://github.com/microsoft/vscode/issues/334186). |
| **Kimi Code** | La prise en charge automatique de l'en-tête de session fait l'objet de l'[issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506). |
| **MiMo Code** | L'[issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) dispose d'un correctif proposé dans la [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), qui n'a pas encore été fusionnée. |
## Limites d'utilisation
+35 -6
View File
@@ -91,15 +91,44 @@ L'elenco dei modelli potrebbe cambiare man mano che ne testiamo e aggiungiamo di
## Dove posso usarlo?
OpenCode Go è progettato per essere utilizzato con [OpenCode](https://opencode.ai) e altri agenti di programmazione popolari che generano tipi di richieste simili.
OpenCode Go è progettato per [OpenCode](https://opencode.ai) e altri agenti di programmazione
che producono tipi di richieste simili. Il traffico viene monitorato per rilevare gli abusi che
compromettono l'esperienza degli altri utenti.
Il traffico viene monitorato per rilevare traffico abusivo che compromette l'esperienza degli altri utenti.
Il tuo client deve:
Per evitare che il tuo account venga segnalato, assicurati che lo strumento che utilizzi
1. Inviare il traffico tipico di un agente di programmazione
2. Identificarsi con un proprio user agent, ad esempio `my-coding-agent/1.0`, anziché
con il nome generico di un SDK o di una libreria HTTP.
3. Inviare un ID di sessione stabile in `x-opencode-session` per ogni conversazione, in modo da consentirci di ottimizzare il routing e
il caching dei prompt.
1\. non generi traffico abusivo
2\. si identifichi correttamente (senza user agent generici)
3\. includa l'header `x-opencode-session` in modo da consentirci di ottimizzare il caching dei prompt
### Client convalidati
Oltre a OpenCode, è stato verificato che i seguenti client funzionino correttamente
con OpenCode Go. Tuttavia, non garantiamo che continueranno a funzionare in futuro.
| Client | Supporto delle sessioni |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | Le build contenenti la [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) inviano l'header nelle richieste OpenCode principali e ausiliarie. La correzione è stata unita dopo la v0.21.0; quella versione da sola non la include. |
| **Claude Code** | Go riconosce il suo header di sessione nativo. Non è necessario alcun wrapper per header personalizzati. |
| **Codex** | Go riconosce il suo header di sessione nativo. Alcune versioni e configurazioni proxy continuano a ometterlo; mantieni l'header di sessione quando inoltri le richieste. |
| **ZCode** | Go riconosce il suo header di sessione nativo. La nostra [richiesta per `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) è ancora aperta, ma non è più necessario inviare proprio quell'header. |
| **Pi** | Le build attuali inviano le informazioni di sessione per OpenCode. Aggiorna le installazioni meno recenti. |
| **jcode** | Aggiorna alla versione **v0.81.6 o successiva**, che include la [correzione dell'header di sessione](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | Le build contenenti la [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) ripristinano gli header di sessione OpenCode. Questa correzione riguarda la CLI, non l'estensione VS Code. Consulta l'[issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |
### Client con problemi noti
Nelle versioni che abbiamo esaminato, questi client non supportano le sessioni
o le supportano solo parzialmente. Le segnalazioni collegate consentono di seguire le correzioni e le soluzioni alternative.
| Client | Stato e segnalazioni |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **DeepSeek Harness** | Le informazioni di sessione arrivano tramite alcuni percorsi dei modelli, ma mancano in altri. Riconosciamo il suo header nativo; resta da inviarlo attraverso tutti gli adapter. [Discussione #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | Il supporto automatico dell'header di sessione è stato richiesto nell'[issue #334186 di VS Code](https://github.com/microsoft/vscode/issues/334186). |
| **Kimi Code** | Il supporto automatico dell'header di sessione è stato richiesto nell'[issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506). |
| **MiMo Code** | L'[issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) ha una correzione proposta nella [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), che non è stata ancora unita. |
## Limiti di utilizzo
+32 -6
View File
@@ -83,15 +83,41 @@ OpenCode Goをサブスクライブできるのは、1つのワークスペー
## どこで使用できますか?
OpenCode Goは、[OpenCode](https://opencode.ai)や、同様の種類のリクエストを生成するその他の一般的なコーディングエージェントで使用することを想定しています。
OpenCode Goは、[OpenCode](https://opencode.ai)および同様の種類のリクエストを生成するその他のコーディングエージェント向けに設計されています。
他のユーザーの利用体験を損なう不正利用がないか、トラフィックを監視しています。
他のユーザーの利用体験を損なう不正なトラフィックがないか監視されています。
クライアントは以下の要件を満たす必要があります。
アカウントにフラグが付けられないよう、使用するツールが以下の条件を満たしていることを確認してください。
1. 一般的なコーディングエージェントのトラフィックを送信する。
2. 汎用的なSDK名やHTTPライブラリ名ではなく、`my-coding-agent/1.0`のような独自のユーザーエージェントで自身を識別する。
3. ルーティングとプロンプトキャッシュを最適化できるよう、会話ごとに安定したセッションIDを`x-opencode-session`で送信する。
1\. 不正なトラフィックを生成しない
2\. 自身を適切に識別する(汎用的すぎるユーザーエージェントを使用しない)
3\. プロンプトキャッシュを最適化できるよう、`x-opencode-session`ヘッダーを含める
### 動作確認済みのクライアント
OpenCodeに加えて、以下のクライアントがOpenCode Goで正常に動作することを確認しています。
ただし、今後も動作し続けることを保証するものではありません。
| クライアント | セッション対応 |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864)を含むビルドでは、OpenCodeのメインリクエストと補助リクエストの両方でヘッダーが送信されます。この修正はv0.21.0より後にマージされたため、v0.21.0自体には含まれていません。 |
| **Claude Code** | GoはClaude Code固有のセッションヘッダーを認識します。カスタムヘッダーを追加するラッパーは不要です。 |
| **Codex** | GoはCodex固有のセッションヘッダーを認識します。一部のバージョンやプロキシ設定では引き続きヘッダーが省略されるため、リクエストを転送するときはセッションヘッダーを保持してください。 |
| **ZCode** | GoはZCode固有のセッションヘッダーを認識します。[`x-opencode-session`の追加リクエスト](https://github.com/zai-org/feedback/issues/492)は未解決ですが、この特定のヘッダーを送信する必要はなくなりました。 |
| **Pi** | 現在のビルドはOpenCodeにセッション情報を送信します。古いインストールは更新してください。 |
| **jcode** | [セッションヘッダーの修正](https://github.com/1jehuang/jcode/issues/1167)を含む**v0.81.6以降**に更新してください。 |
| **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** | 一部のモデルパスではセッション情報が届きますが、他のパスでは欠落します。Goは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)で修正案がありますが、まだマージされていません。 |
## 利用制限
+32 -6
View File
@@ -83,15 +83,41 @@ workspace당 한 명의 멤버만 OpenCode Go를 구독할 수 있습니다.
## 어디에서 사용할 수 있나요?
OpenCode Go는 [OpenCode](https://opencode.ai) 및 유사한 유형의 요청을 생성하는 다른 인기 코딩 에이전트와 함께 사용하도록 설계되었습니다.
OpenCode Go는 [OpenCode](https://opencode.ai) 및 유사한 유형의 요청을 생성하는 다른 코딩 에이전트용으로 설계되었습니다.
다른 사용자의 이용 경험을 저해하는 악용이 있는지 트래픽을 모니터링합니다.
다른 사용자의 이용 경험을 저해하는 악성 트래픽이 있는지 모니터링합니다.
클라이언트는 다음 요건을 충족해야 합니다.
계정에 플래그가 지정되지 않도록 사용 중인 도구가 다음 조건을 충족하는지 확인하세요.
1. 일반적인 코딩 에이전트 트래픽을 전송합니다.
2. 일반적인 SDK 또는 HTTP 라이브러리 이름이 아닌 `my-coding-agent/1.0`과 같은 자체 user agent로 식별합니다.
3. 라우팅과 프롬프트 캐싱을 최적화할 수 있도록 각 대화에서 안정적인 세션 ID를 `x-opencode-session`으로 전송합니다.
1\. 악성 트래픽을 생성하지 않음
2\. 자체 정보를 올바르게 표시함(포괄적인 사용자 에이전트를 사용하지 않음)
3\. 프롬프트 캐싱을 최적화할 수 있도록 `x-opencode-session` 헤더를 포함함
### 검증된 클라이언트
OpenCode 외에도 다음 클라이언트가 OpenCode Go에서 올바르게 작동하는 것으로 검증되었습니다.
다만 앞으로도 계속 작동할 것이라고 보장하지는 않습니다.
| 클라이언트 | 세션 지원 |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864)가 포함된 빌드는 OpenCode의 기본 요청과 보조 요청 모두에서 헤더를 전송합니다. 이 수정은 v0.21.0 이후에 병합되었으므로 v0.21.0 릴리스 자체에는 포함되지 않습니다. |
| **Claude Code** | Go는 Claude Code의 고유 세션 헤더를 인식합니다. 사용자 지정 헤더 래퍼가 필요하지 않습니다. |
| **Codex** | Go는 Codex의 고유 세션 헤더를 인식합니다. 일부 버전과 프록시 설정에서는 여전히 이 헤더가 누락되므로 요청을 전달할 때 세션 헤더를 유지하세요. |
| **ZCode** | Go는 ZCode의 고유 세션 헤더를 인식합니다. [`x-opencode-session` 요청](https://github.com/zai-org/feedback/issues/492)은 아직 열려 있지만 이제 해당 헤더를 별도로 전송할 필요는 없습니다. |
| **Pi** | 현재 빌드는 OpenCode에 세션 정보를 전송합니다. 이전 설치 버전은 업데이트하세요. |
| **jcode** | [세션 헤더 수정](https://github.com/1jehuang/jcode/issues/1167)이 포함된 **v0.81.6 이상**으로 업데이트하세요. |
| **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** | 일부 모델 경로에서는 세션 정보가 전달되지만 다른 경로에서는 누락됩니다. Go는 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)로 수정안이 제안되었지만 아직 병합되지 않았습니다. |
## 사용 한도
+35 -6
View File
@@ -93,15 +93,44 @@ Listen over modeller kan endres etter hvert som vi tester og legger til nye.
## Hvor kan jeg bruke det?
OpenCode Go er utviklet for bruk med [OpenCode](https://opencode.ai) og andre populære kodeagenter som genererer lignende typer forespørsler.
OpenCode Go er utviklet for [OpenCode](https://opencode.ai) og andre kodeagenter
som sender lignende typer forespørsler. Trafikken overvåkes for misbruk som
forringer opplevelsen for andre brukere.
Trafikken overvåkes for misbruk som forringer opplevelsen for andre brukere.
Klienten din skal:
For å sikre at kontoen din ikke blir flagget, må du sørge for at verktøyet du bruker,
1. Sende typisk trafikk fra en kodeagent.
2. Identifisere seg med sin egen user agent, for eksempel `my-coding-agent/1.0`, i stedet
for et generisk navn på et SDK eller HTTP-bibliotek.
3. Sende en stabil sesjons-ID i `x-opencode-session` for hver samtale, slik at vi kan optimalisere ruting og
promptbufring.
1\. ikke genererer misbrukstrafikk
2\. identifiserer seg korrekt (ingen generiske User-Agent-identifikatorer)
3\. inkluderer `x-opencode-session`-headeren, slik at vi kan optimalisere promptbufring
### Validerte klienter
I tillegg til OpenCode er følgende klienter validert for å fungere riktig
med OpenCode Go. Vi garanterer imidlertid ikke at de vil fortsette å fungere i fremtiden.
| Klient | Sesjonsstøtte |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | Bygg som inneholder [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864), sender headeren i primære og sekundære OpenCode-forespørsler. Rettelsen ble slått sammen etter v0.21.0; den versjonen inneholder den ikke alene. |
| **Claude Code** | Go gjenkjenner den innebygde sesjonsheaderen. En wrapper for en egendefinert header er ikke nødvendig. |
| **Codex** | Go gjenkjenner den innebygde sesjonsheaderen. Noen versjoner og proxyoppsett utelater den fortsatt; behold sesjonsheaderen når forespørsler videresendes. |
| **ZCode** | Go gjenkjenner den innebygde sesjonsheaderen. Vår [forespørsel om `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) er fortsatt åpen, men det er ikke lenger nødvendig å sende akkurat denne headeren. |
| **Pi** | Gjeldende bygg sender sesjonsinformasjon for OpenCode. Oppdater eldre installasjoner. |
| **jcode** | Oppdater til **v0.81.6 eller nyere**, som inneholder [rettelsen for sesjonsheaderen](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | Bygg som inneholder [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752), gjenoppretter OpenCode-sesjonsheadere. Denne rettelsen dekker CLI-en, ikke VS Code-utvidelsen. Se [issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |
### Kjente problematiske klienter
Disse klientene mangler sesjonsstøtte eller har ufullstendig støtte i versjonene vi
undersøkte. De lenkede rapportene følger rettelser og midlertidige løsninger.
| Klient | Status og oppfølging |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **DeepSeek Harness** | Sesjonsinformasjon mottas på noen modellbaner, men mangler på andre. Vi gjenkjenner den innebygde headeren; det gjenstående arbeidet er å sende den gjennom alle adaptere. [Discussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | Automatisk støtte for sesjonsheaderen er etterspurt i [VS Code issue #334186](https://github.com/microsoft/vscode/issues/334186). |
| **Kimi Code** | Automatisk støtte for sesjonsheaderen er etterspurt 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ått rettelse i [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), som ennå ikke er slått sammen. |
## Bruksgrenser
+35 -6
View File
@@ -87,15 +87,44 @@ Lista modeli może ulec zmianie w miarę testowania i dodawania nowych.
## Gdzie można z tego korzystać?
OpenCode Go jest przeznaczony do użytku z [OpenCode](https://opencode.ai) i innymi popularnymi agentami kodującymi, którzy generują podobne rodzaje żądań.
OpenCode Go jest przeznaczony dla [OpenCode](https://opencode.ai) i innych agentów kodujących,
którzy wysyłają podobne rodzaje żądań. Ruch jest monitorowany pod kątem nadużyć,
które pogarszają komfort korzystania z usługi przez innych użytkowników.
Ruch jest monitorowany pod kątem nadużyć, które pogarszają komfort korzystania z usługi przez innych użytkowników.
Twój klient powinien:
Aby Twoje konto nie zostało oznaczone, upewnij się, że używane przez Ciebie narzędzie
1. Wysyłać ruch typowy dla agenta kodującego.
2. Identyfikować się za pomocą własnego user agenta, na przykład `my-coding-agent/1.0`, zamiast
ogólnej nazwy SDK lub biblioteki HTTP.
3. Wysyłać stabilny identyfikator sesji w nagłówku `x-opencode-session` dla każdej rozmowy, aby umożliwić optymalizację routingu i
buforowania promptów.
1\. nie generuje ruchu stanowiącego nadużycie
2\. prawidłowo się identyfikuje (bez ogólnych identyfikatorów User-Agent)
3\. zawiera nagłówek `x-opencode-session`, abyśmy mogli zoptymalizować buforowanie promptów
### Zweryfikowane klienty
Poza OpenCode zweryfikowano, że poniżsi klienci działają prawidłowo
z OpenCode Go. Nie gwarantujemy jednak, że będą nadal działać w przyszłości.
| Klient | Obsługa sesji |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | Kompilacje zawierające [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) wysyłają nagłówek w głównych i pomocniczych żądaniach OpenCode. Poprawkę scalono po wersji v0.21.0; samo to wydanie jej nie zawiera. |
| **Claude Code** | Go rozpoznaje jego natywny nagłówek sesji. Wrapper dodający niestandardowy nagłówek nie jest potrzebny. |
| **Codex** | Go rozpoznaje jego natywny nagłówek sesji. Niektóre wersje i konfiguracje proxy nadal go pomijają; podczas przekazywania żądań należy zachować nagłówek sesji. |
| **ZCode** | Go rozpoznaje jego natywny nagłówek sesji. Nasza [prośba o `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) pozostaje otwarta, ale wysyłanie tego konkretnego nagłówka nie jest już konieczne. |
| **Pi** | Aktualne kompilacje wysyłają informacje o sesji dla OpenCode. Zaktualizuj starsze instalacje. |
| **jcode** | Zaktualizuj do wersji **v0.81.6 lub nowszej**, która zawiera [poprawkę nagłówka sesji](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | Kompilacje zawierające [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) przywracają nagłówki sesji OpenCode. Ta poprawka obejmuje CLI, ale nie rozszerzenie VS Code. Zobacz [issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |
### Klienty ze znanymi problemami
W badanych przez nas wersjach tych klientów obsługa sesji jest niepełna lub jej brakuje.
Raporty pod podanymi linkami służą do śledzenia poprawek i obejść.
| Klient | Stan i śledzenie |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **DeepSeek Harness** | Informacje o sesji docierają w niektórych ścieżkach modeli, ale brakuje ich w innych. Rozpoznajemy jego natywny nagłówek; pozostaje zapewnić jego wysyłanie przez wszystkie adaptery. [Discussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | Prośbę o automatyczną obsługę nagłówka sesji zgłoszono w [VS Code issue #334186](https://github.com/microsoft/vscode/issues/334186). |
| **Kimi Code** | Prośbę o automatyczną obsługę nagłówka sesji zgłoszono w [issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506). |
| **MiMo Code** | Dla [issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) zaproponowano poprawkę w [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), który nie został jeszcze scalony. |
## Limity użycia
+35 -6
View File
@@ -93,15 +93,44 @@ A lista de modelos pode mudar conforme testamos e adicionamos novos.
## Onde posso usá-lo?
O OpenCode Go foi projetado para ser usado com o [OpenCode](https://opencode.ai) e outros agentes de programação populares que geram tipos de requisições semelhantes.
O OpenCode Go foi projetado para o [OpenCode](https://opencode.ai) e outros agentes de programação
que produzem tipos semelhantes de requisições. O tráfego é monitorado para detectar abusos que
prejudiquem a experiência de outros usuários.
O tráfego é monitorado para detectar tráfego abusivo que prejudique a experiência de outros usuários.
Seu cliente deve:
Para evitar que sua conta seja sinalizada, verifique se a ferramenta que você está usando
1. Enviar o tráfego típico de um agente de programação
2. Identificar-se com seu próprio user agent, como `my-coding-agent/1.0`, em vez
do nome genérico de um SDK ou de uma biblioteca HTTP.
3. Enviar um ID de sessão estável em `x-opencode-session` para cada conversa, para que possamos otimizar o roteamento e
o cache de prompts.
1\. não gera tráfego abusivo
2\. se identifica corretamente (sem user agents genéricos)
3\. inclui o header `x-opencode-session` para que possamos otimizar o cache de prompts
### Clientes validados
Além do OpenCode, os clientes a seguir foram validados para funcionar corretamente
com o OpenCode Go. No entanto, não garantimos que continuarão funcionando no futuro.
| Cliente | Suporte a sessões |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Hermes** | As builds que contêm o [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) enviam o header nas requisições principais e auxiliares do OpenCode. A correção foi incorporada após a v0.21.0; essa versão por si só não a inclui. |
| **Claude Code** | O Go reconhece seu header de sessão nativo. Não é necessário usar um wrapper para headers personalizados. |
| **Codex** | O Go reconhece seu header de sessão nativo. Algumas versões e configurações de proxy ainda o omitem; preserve o header de sessão ao encaminhar requisições. |
| **ZCode** | O Go reconhece seu header de sessão nativo. Nossa [solicitação de `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) continua aberta, mas não é mais necessário enviar especificamente esse header. |
| **Pi** | As builds atuais enviam informações de sessão para o OpenCode. Atualize instalações mais antigas. |
| **jcode** | Atualize para a versão **v0.81.6 ou posterior**, que inclui a [correção do header de sessão](https://github.com/1jehuang/jcode/issues/1167). |
| **Kilo Code CLI** | As builds que contêm o [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) restauram os headers de sessão do OpenCode. Essa correção abrange a CLI, não a extensão do VS Code. Consulte a [issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |
### Clientes com problemas conhecidos
Esses clientes não têm suporte a sessões ou apresentam suporte incompleto nas versões que
investigamos. Os relatórios vinculados acompanham correções e soluções alternativas.
| Cliente | Status e acompanhamento |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **DeepSeek Harness** | As informações de sessão chegam por alguns caminhos de modelos, mas não por outros. Reconhecemos seu header nativo; ainda é necessário enviá-lo por todos os adaptadores. [Discussão #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | O suporte automático ao header de sessão foi solicitado na [issue #334186 do VS Code](https://github.com/microsoft/vscode/issues/334186). |
| **Kimi Code** | O suporte automático ao header de sessão foi solicitado na [issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506). |
| **MiMo Code** | A [issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) tem uma correção proposta no [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), que ainda não foi incorporada. |
## Limites de uso
+35 -6
View File
@@ -93,15 +93,44 @@ OpenCode Go работает так же, как и любой другой пр
## Где можно использовать OpenCode Go?
OpenCode Go предназначен для использования с [OpenCode](https://opencode.ai) и другими популярными агентами для программирования, которые создают запросы схожих типов.
OpenCode Go предназначен для [OpenCode](https://opencode.ai) и других агентов для программирования,
которые отправляют запросы схожих типов. Трафик отслеживается для выявления злоупотреблений,
ухудшающих работу сервиса для других пользователей.
Трафик отслеживается для выявления злоупотреблений, ухудшающих работу сервиса для других пользователей.
Ваш клиент должен:
Чтобы ваша учетная запись не была отмечена, убедитесь, что используемый вами инструмент
1. Отправлять трафик, типичный для агента программирования.
2. Идентифицировать себя с помощью собственного user agent, например `my-coding-agent/1.0`, а не
универсального названия SDK или HTTP-библиотеки.
3. Отправлять стабильный идентификатор сессии в заголовке `x-opencode-session` для каждого диалога, чтобы мы могли оптимизировать маршрутизацию и
кеширование промптов.
1\. не создает трафик, представляющий собой злоупотребление
2\. правильно идентифицирует себя (без универсальных значений User-Agent)
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), который еще не объединен. |
## Лимиты использования
+32 -6
View File
@@ -83,15 +83,41 @@ OpenCode Go ทำงานเหมือนกับผู้ให้บร
## ใช้งานได้ที่ไหน?
OpenCode Go ออกแบบมาเพื่อใช้กับ [OpenCode](https://opencode.ai) และเอเจนต์เขียนโค้ดยอดนิยมอื่นๆ ที่สร้างคำขอในลักษณะเดียวกัน
OpenCode Go ออกแบบมาสำหรับ [OpenCode](https://opencode.ai) และ coding agent อื่นๆ ที่สร้างคำขอประเภทเดียวกัน
ระบบจะตรวจสอบทราฟฟิกเพื่อหาการใช้งานในทางที่ผิดซึ่งทำให้ประสบการณ์ของผู้ใช้รายอื่นแย่ลง
ระบบจะตรวจสอบการรับส่งข้อมูลเพื่อค้นหาการใช้งานในทางที่ผิดซึ่งส่งผลกระทบต่อประสบการณ์ของผู้ใช้รายอื่น
ไคลเอนต์ของคุณควร:
เพื่อให้แน่ใจว่าบัญชีของคุณจะไม่ถูกตั้งค่าสถานะ โปรดตรวจสอบว่าเครื่องมือที่คุณใช้
1. ส่งทราฟฟิกตามปกติของ coding agent
2. ระบุตัวตนด้วย user agent ของตนเอง เช่น `my-coding-agent/1.0` แทนชื่อ SDK หรือไลบรารี HTTP แบบทั่วไป
3. ส่ง session ID ที่คงที่ใน `x-opencode-session` สำหรับแต่ละบทสนทนา เพื่อให้เราปรับ routing และ prompt caching ให้เหมาะสมได้
1\. ไม่สร้างการรับส่งข้อมูลที่เป็นการใช้งานในทางที่ผิด
2\. ระบุตัวตนอย่างถูกต้อง (ไม่ใช้ข้อมูลระบุตัวแทนผู้ใช้แบบกว้างเกินไป)
3\. มีส่วนหัว `x-opencode-session` เพื่อให้เราสามารถปรับการแคชพรอมต์ให้เหมาะสมได้
### ไคลเอนต์ที่ผ่านการตรวจสอบแล้ว
นอกจาก OpenCode แล้ว ไคลเอนต์ต่อไปนี้ได้รับการตรวจสอบแล้วว่าทำงานกับ OpenCode Go ได้อย่างถูกต้อง
อย่างไรก็ตาม เราไม่รับประกันว่าไคลเอนต์เหล่านี้จะยังคงทำงานได้ต่อไปในอนาคต
| ไคลเอนต์ | การรองรับเซสชัน |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Hermes** | บิลด์ที่มี [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) จะส่งส่วนหัวในคำขอ OpenCode ทั้งคำขอหลักและคำขอเสริม การแก้ไขนี้ถูก merge หลัง v0.21.0 ดังนั้นตัวรีลีส v0.21.0 เองจึงยังไม่มีการแก้ไขนี้ |
| **Claude Code** | Go รู้จักส่วนหัวเซสชันแบบ native ของ Claude Code จึงไม่ต้องใช้ wrapper เพื่อเพิ่มส่วนหัวแบบกำหนดเอง |
| **Codex** | Go รู้จักส่วนหัวเซสชันแบบ native ของ Codex แต่บางเวอร์ชันและการตั้งค่า proxy ยังไม่ส่งส่วนหัวนี้ โปรดคงส่วนหัวเซสชันไว้เมื่อ forward คำขอ |
| **ZCode** | Go รู้จักส่วนหัวเซสชันแบบ native ของ ZCode [คำขอให้เพิ่ม `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** | ข้อมูลเซสชันส่งมาถึงใน model path บางรายการ แต่ขาดหายไปในรายการอื่น Go รู้จักส่วนหัวแบบ native ของ DeepSeek Harness งานที่เหลือคือการส่งส่วนหัวนี้ผ่าน adapter ทั้งหมด [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) ซึ่งยังไม่ได้ merge |
## Usage limits
+32 -6
View File
@@ -83,15 +83,41 @@ Test edip yenilerini ekledikçe model listesi değişebilir.
## Nerede kullanabilirim?
OpenCode Go, [OpenCode](https://opencode.ai) ve benzer türde istekler üreten diğer popüler kodlama aracılarıyla kullanılmak üzere tasarlanmıştır.
OpenCode Go, [OpenCode](https://opencode.ai) ve benzer türde istekler üreten diğer kodlama aracıları için tasarlanmıştır.
Trafik, diğer kullanıcıların deneyimini olumsuz etkileyen kötüye kullanımlara karşı izlenir.
Trafik, diğer kullanıcıların deneyimini olumsuz etkileyen kötüye kullanım amaçlı trafiğe karşı izlenir.
İstemciniz şunları yapmalıdır:
Hesabınızın işaretlenmemesi için kullandığınız aracın
1. Tipik kodlama aracısı trafiği göndermelidir.
2. Genel bir SDK veya HTTP kitaplığı adı yerine `my-coding-agent/1.0` gibi kendine ait bir user agent ile kendini tanıtmalıdır.
3. Yönlendirmeyi ve istem önbelleğe almayı optimize edebilmemiz için her konuşmada `x-opencode-session` içinde değişmeyen bir oturum kimliği göndermelidir.
1\. kötüye kullanım amaçlı trafik oluşturmadığından
2\. kendisini doğru şekilde tanıttığından (genel kapsamlı kullanıcı aracıları kullanmadığından)
3\. istem önbelleğe almayı optimize edebilmemiz için `x-opencode-session` başlığını içerdiğinden emin olun
### Doğrulanmış İstemciler
OpenCode'un yanı sıra aşağıdaki istemcilerin OpenCode Go ile düzgün çalıştığı doğrulanmıştır.
Ancak gelecekte de çalışmaya devam edeceklerini garanti etmiyoruz.
| İstemci | Oturum desteği |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hermes** | [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) içeren derlemeler, ana ve yardımcı OpenCode isteklerinde başlığı gönderir. Düzeltme v0.21.0'dan sonra birleştirilmiştir; dolayısıyla v0.21.0 sürümü tek başına bu düzeltmeyi içermez. |
| **Claude Code** | Go, Claude Code'un yerel oturum başlığını tanır. Özel başlık ekleyen bir sarmalayıcı gerekmez. |
| **Codex** | Go, Codex'in yerel oturum başlığını tanır. Bazı sürümler ve proxy yapılandırmaları hâlâ bu başlığı göndermemektedir; istekleri iletirken oturum başlığını koruyun. |
| **ZCode** | Go, ZCode'un yerel oturum başlığını tanır. [`x-opencode-session` talebimiz](https://github.com/zai-org/feedback/issues/492) hâlâ açıktır ancak artık özellikle bu başlığın gönderilmesi gerekli değildir. |
| **Pi** | Güncel derlemeler OpenCode için oturum bilgilerini gönderir. Eski kurulumları güncelleyin. |
| **jcode** | [Oturum başlığı düzeltmesini](https://github.com/1jehuang/jcode/issues/1167) içeren **v0.81.6 veya sonraki bir sürüme** güncelleyin. |
| **Kilo Code CLI** | [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) içeren derlemeler OpenCode oturum başlıklarını geri getirir. Bu düzeltme CLI'ı kapsar, VS Code uzantısını kapsamaz. Bkz. [issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |
### Sorunlu Olduğu Bilinen İstemciler
Bu istemcilerin incelediğimiz sürümlerinde oturum desteği eksik veya tamamlanmamıştır.
Bağlantı verilen bildirimlerden düzeltmeleri ve geçici çözümleri takip edebilirsiniz.
| İstemci | Durum ve takip |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **DeepSeek Harness** | Oturum bilgileri bazı model yollarında ulaşırken diğerlerinde eksiktir. Go, DeepSeek Harness'ın yerel başlığını tanır; yapılması gereken, bu başlığın tüm adaptörlerden gönderilmesidir. [Discussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
| **GitHub Copilot Chat** | Otomatik oturum başlığı desteği [VS Code issue #334186](https://github.com/microsoft/vscode/issues/334186) içinde talep edilmiştir. |
| **Kimi Code** | Otomatik oturum başlığı desteği [issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506) içinde talep edilmiştir. |
| **MiMo Code** | [Issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) için [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327) içinde bir düzeltme önerilmiştir ancak henüz birleştirilmemiştir. |
## Kullanım limitleri
+30 -5
View File
@@ -83,15 +83,40 @@ OpenCode Go 的工作方式与 OpenCode 中的其他提供商一样。
## 可以在哪里使用?
OpenCode Go 适用于 [OpenCode](https://opencode.ai) 以及其他会产生类似请求的主流编程 Agent。
OpenCode Go 适用于 [OpenCode](https://opencode.ai) 以及其他会产生类似请求的编程 Agent。
我们会监控流量,以识别影响其他用户体验的滥用行为。
为避免你的账户被标记为异常,请确保你使用的工具:
你的客户端应当:
1\. 不产生滥用流量
2\. 明确标识自身(不要使用过于笼统的 user agent 标识)
3\. 包含 `x-opencode-session` 请求头,以便我们优化提示词缓存
1. 发送典型的编程 Agent 流量。
2. 使用自身专属的 user agent 标识(例如 `my-coding-agent/1.0`),而不是通用的 SDK 或 HTTP 库名称。
3. 为每段对话在 `x-opencode-session` 请求头中发送稳定的会话 ID,以便我们优化路由和提示词缓存。
### 已验证的客户端
除 OpenCode 外,以下客户端已通过验证,能够正常使用 OpenCode Go。但我们无法保证它们未来仍能正常使用。
| 客户端 | 会话支持 |
| --- | --- |
| **Hermes** | 包含 [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) 的构建版本会在主要和辅助 OpenCode 请求中发送该请求头。此修复在 v0.21.0 发布后才合并,因此 v0.21.0 本身并不包含该修复。 |
| **Claude Code** | Go 能识别其原生会话请求头,无需额外封装来添加自定义请求头。 |
| **Codex** | Go 能识别其原生会话请求头。某些版本和代理配置仍会遗漏该请求头;转发请求时请保留会话请求头。 |
| **ZCode** | Go 能识别其原生会话请求头。我们[请求支持 `x-opencode-session` 的 issue](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** | 某些模型调用路径会传递会话信息,但其他路径中缺失。我们能识别其原生请求头;剩余工作是在所有适配器中发送该请求头。参见[讨论 #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),但尚未合并。 |
## 使用限制
+30 -5
View File
@@ -83,15 +83,40 @@ OpenCode Go 的運作方式與 OpenCode 中的任何其他供應商相同。
## 可以在哪裡使用?
OpenCode Go 適用於 [OpenCode](https://opencode.ai) 以及其他會產生類似請求的主流程式設計 Agent。
OpenCode Go 適用於 [OpenCode](https://opencode.ai) 以及其他會產生類似請求的程式設計 Agent。
我們會監控流量,以識別影響其他使用者體驗的濫用行為。
為避免您的帳戶被標記為異常,請確保您使用的工具:
您的用戶端應:
1\. 不產生濫用流量
2\. 明確標識自身(不要使用過於籠統的 user agent 識別資訊)
3\. 包含 `x-opencode-session` 請求標頭,以便我們最佳化提示詞快取
1. 傳送典型的程式設計 Agent 流量。
2. 使用自身專屬的 user agent 識別資訊(例如 `my-coding-agent/1.0`),而非通用的 SDK 或 HTTP 函式庫名稱。
3. 為每段對話在 `x-opencode-session` 請求標頭中傳送穩定的工作階段 ID,以便我們最佳化路由和提示詞快取。
### 已驗證的用戶端
除了 OpenCode,以下用戶端已通過驗證,可正常使用 OpenCode Go。但我們無法保證它們未來仍能正常使用。
| 用戶端 | 工作階段支援 |
| --- | --- |
| **Hermes** | 包含 [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) 的建置版本會在主要和輔助 OpenCode 請求中傳送該標頭。此修正是在 v0.21.0 發布後才合併,因此 v0.21.0 本身並未包含此修正。 |
| **Claude Code** | Go 可辨識其原生工作階段標頭,無須額外封裝來新增自訂標頭。 |
| **Codex** | Go 可辨識其原生工作階段標頭。部分版本和代理伺服器設定仍會遺漏該標頭;轉送請求時請保留工作階段標頭。 |
| **ZCode** | Go 可辨識其原生工作階段標頭。我們[請求支援 `x-opencode-session` 的 issue](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** | 部分模型呼叫路徑會傳遞工作階段資訊,但其他路徑中缺少這些資訊。我們可辨識其原生標頭;剩餘工作是在所有配接器中傳送該標頭。請參閱[討論 #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),但尚未合併。 |
## 使用限制