nanobot OpenCode Go eksik oturum başlığı: sürüm ve rota kontrolleri

nanobot, 15 Eylül 2026'da yayımlanan v0.3.5 sürümünde x-opencode-session başlığını göndermeye başladı; v0.3.0 ve önceki sürümler yalnızca genel bir x-session-affinity kimliği gönderiyordu. OpenCode Go ile yaşanan eksik oturum başlığı hatasının nedeni bu sürüm farkıdır. Başka herhangi bir şeyi değiştirmeden önce nanobot --version komutunu çalıştırın: v0.3.0 veya daha eski bir sürüm bildiriyorsa, yükseltme bu tek başlıkla ilgili sorunu tamamen çözer. Ancak yükseltme, OpenCode Go'nun istemci sözleşmesinin geri kalanını çözüme kavuşturmaz; bağlantı yolunun sorunsuz çalıştığı sonucuna varmadan önce okunması gereken kısım da budur.

Önce bir ayrımı netleştirelim; çünkü adlar çakışıyor. Buradaki OpenCode Go, opencode.ai/docs/go adresinde belgelenen canlı, aylık 10 ABD doları tutarındaki model aboneliğidir — özgün yazar ve Charm ekibiyle birlikte projenin Crush adıyla sürdürüldüğünü belirten README'ye sahip arşivlenmiş Go dilindeki OpenCode terminal aracısı değildir. Bu, kullanımdan kaldırılmış bir ürünle ilgili geçiş notu değil; şu anda satılan ve bir istemci gereksinimini sıkılaştırmış bir hizmetle ilgili sorun giderme sayfasıdır. Buradaki nanobot ise obot-platform'daki aynı adlı Go projesi değil, MIT lisanslı Python kişisel aracı çerçevesi olan HKUDS/nanobot'tur — 48.459 yıldızlı, arşivlenmemiş ve bu kontrolün yapıldığı gün son kez gönderim almış projedir (GitHub API, 21 Eylül 2026).

Hata ve bu hatayı taşıyan nanobot sürümleri

Bu süreci başlatan bildirim, dokümantasyon olarak değil, sağlayıcı bildirimi olarak abonelere ulaştı. Bir kullanıcı, OpenCode'un kendi istemcisine karşı 5 Eylül 2026'da açılan anomalyco/opencode#47438 numaralı konuda bildirimi kelimesi kelimesine alıntıladı; bildirim, model sağlayıcısından e-posta yoluyla gelen şu mesaj olarak tanımlanıyordu: "OpenCode Go'ya yaptığınız bazı isteklerde x-opencode-session üst bilgisi eksik. Bu bilgi olmadan hizmetimizi gerektiği gibi optimize edemiyoruz. 09/06 tarihinden itibaren bu üst bilginin eksik olduğu istekler hata verebilir." Bulabildiğimiz hiçbir OpenCode belgesinde bu ifade yer almıyor. 21 Eylül 2026'da okunan OpenCode değişiklik günlüğü, v1.18.31'de 4 Ağustos ile 14 Eylül 2026 arasını kapsıyor ve x-opencode-session ifadesinden hiç bahsetmiyor. Go belgeleri bunu ret olarak değil, istek olarak ifade ediyor: "Yönlendirmeyi ve istem önbelleğe almayı optimize edebilmemiz için her görüşmede x-opencode-session içinde sabit bir oturum kimliği gönderin."

09/06 tarihinin kendisi, dokümantasyona ait olmayan ancak resmî bir kamuya açık kaynağa dayanıyor: nanobot'un issue #5661 ve PR #5662 kayıtları, 3 Eylül 2026 tarihli bir @opencode X gönderisine atıfta bulunuyor; bu gönderide, üst bilgisi eksik olan araçların istem önbelleği optimizasyonunu kaybettiği ve "09/06 tarihinden itibaren bu üst bilginin eksik olduğu istekler hata verebilir" denildiğini aktarıyorlar. nanobot düzeltmesi bu gönderideki duyuruya dayanarak yazıldı; bu sayfa gönderiyi bağımsız olarak almamıştır.

Kesin hata yalnızca üçüncü taraf kanıtlarıyla destekleniyor. 7 Eylül 2026'da açılıp kapatılan vastsa/PI-Desktop#48, "type": "MissingSessionID" ile HTTP 400 döndüğünü ve istekte x-opencode-session eksik olduğunu, verimli şekilde yönlendirilemediğini belirten bir mesaj içeriyor ve Go belgelerindeki bağlantıya yönlendiriyor. OpenCode'un Go belgelerinde bu durum kodunu veya bu tür dizesini listeleyen bir hata referansı bulunmuyor; bu nedenle belgelenen yükümlülük ile bildirilen reddi, aynı sağlayıcıya ait iki farklı güçte iddia olarak değerlendirin.

Etiket geçmişinde v0.3.1 ile v0.3.4 arasında hiçbir sürüm bulunmuyor; dolayısıyla etkilenen aralığın tamamı "v0.3.0 ve öncesi"dir. 21 Eylül 2026'da iki kontrol, sürüm eşlemesini çıkarım yapmadan doğruladı: sürüm açıklaması PR #5662'yi numarasıyla listeliyor ve bir GitHub karşılaştırma çağrısı v0.3.5'in 20f115bf kimlikli commit ile karşılaştırıldığında 84 commit ileride ve sıfır commit gerisinde olduğunu bildiriyor; bu da söz konusu commit'in etiket içinde bulunduğunu gösteriyor. nanobot'un v0.3.5 belgelerinde üst bilgiden hiç bahsedilmediğini unutmayın — değişikliğin tek kayıtları sürüm notları, PR ve issue'dur.

Düzeltmenin gerçekte yaptığı ve onu tetikleyen şey

v0.3.5 etiketinde nanobot/providers/openai_compat_provider.py dosyasında okunduğunda mantık küçük ama tam olarak bilinmeye değer. nanobot, sağlayıcı belirtiminin adı opencode, opencode_zen veya opencode_go olduğunda ya da temel URL'nin ana bilgisayar adı opencode.ai veya onun bir alt alan adı olduğunda hedefi OpenCode hedefi olarak değerlendirir. Görüşme bağlamı varsa üst bilgi değeri, oturum kimliğinin SHA-256 onaltılık özetidir; bu, ASCII dışı kimlikler için değeri opak ve ASCII açısından güvenli tutar. Görüşme bağlamı yoksa sağlayıcı örneği, kendi ömrü boyunca sabit kalan rastgele bir UUID'ye geri döner — görüşme başına değil, o örnek için sabittir. Kendiniz yapılandırdığınız bir üst bilgi, ad eşleşmesi büyük/küçük harfe duyarlı olmadan her ikisine de üstün gelir.

Ana bilgisayar adı koşulu akılda tutulması gereken cümledir: üst bilgi, yazdığınız sağlayıcı bloğuna göre değil, isteğin nereye gittiğine göre eklenir. providers.custom bloğu bir opencode.ai temel URL'sine yönlendirilse bile üst bilgiyi alır. Başka herhangi bir ana bilgisayara yapılan istek bu üst bilgiyi almaz — o ana bilgisayarın gerektirdiği şey kendi sağlayıcısının konusudur ve buradaki hiçbir şey bu soruyu yanıtlamaz.

Yükseltme işlemi olağandır: PyPI paketinin adı nanobot-ai olup bu etiketin pyproject.toml dosyasında sürümü 0.3.5 olarak belirtilmiştir ve v0.3.5 README'si uv tool install nanobot-ai ile python -m pip install nanobot-ai komutlarını belgeler. nanobot --version komutuyla veya giriş noktası PATH üzerinde değilse python -m nanobot --version ile doğrulayın; ardından CLI referansının, bir model çağırmadan sağlayıcı ve model hazır olma durumunu kontrol ettiğini belirttiği nanobot status komutunu çalıştırın.

OpenCode Go neden sıradan bir OpenAI uyumlu uç nokta değildir?

Üst bilgi düzeltmesinin eksik hissettirmesine neden olan kısım budur. OpenCode Go, sıradan bir OpenAI uyumlu temel URL'nin belirtmediği çeşitli istemci tarafı koşullar belirler ve oturum üst bilgisi bunlardan yalnızca biridir. Aşağıdaki tüm satırlar, 21 Eylül 2026'da kontrol edilen kendi belgelerinden alınmıştır.

Kullanıcı aracısı satırı dikkat gerektirir. PR #5662 yalnızca oturum üst bilgisini değiştirdi. nanobot v0.3.5 kaynak kodu incelendiğinde, opencode, opencode_zen ve opencode_go belirtimlerini sunan OpenAI uyumlu sağlayıcı modülünün hiçbir yerde User-Agent ayarlamadığı, GitHub Copilot, xAI Grok ve OpenAI Codex sağlayıcı modüllerinin ise nanobot markalı bir kullanıcı aracısı ayarladığı görülür. Dolayısıyla bu yolda istek, alttaki SDK'nın varsayılan olarak gönderdiği değeri taşır. Değeri gözlemlemek için burada ağ üzerinden istek gönderilmedi ve OpenCode bu satır için herhangi bir yaptırım yayımlamadı; bu nedenle bu, yeniden üretilmiş bir arızadan ziyade kaynak kodunun okunmasına dayalıdır. Belgelenen çözüm, kendiniz ayarladığınız bir üst bilgidir — nanobot referansı providers.<name>.extraHeaders alanını sağlayıcı isteklerine eklenen üst bilgiler olarak tanımlar:

{
  "providers": {
    "opencodeGo": {
      "apiKey": "${OPENCODE_API_KEY}",
      "extraHeaders": { "User-Agent": "nanobot/0.3.5" }
    }
  },
  "modelPresets": {
    "primary": {
      "provider": "opencode_go",
      "model": "opencode-go/<a model OpenCode lists under chat/completions>",
      "maxTokens": 8192,
      "contextWindowTokens": 65536
    }
  }
}

Kendi istemcinizi burada doğru ve gerçeğe uygun şekilde adlandırın. OpenCode'un doğrulanmış istemci adlarından birini bu alana yazmak, tanımlama değil kimliğe bürünme olur ve belgelerin istediği şey bu değildir.

Uç nokta satırının hiçbir üst bilginin çözemeyeceği, nanobot'a özgü bir sonucu vardır. v0.3.5 sağlayıcı referansı, OpenCode'un chat/completions uç noktası altında listelediği model kimliklerinin kullanılmasını söyler; çünkü yalnızca responses, messages veya sağlayıcıya özgü uç noktalar altında listelenen modeller bu OpenAI uyumlu yol tarafından işlenmez. Yapılandırmada OpenCode Go, providers.opencodeGo değeridir ve ön ayarındaki provider alanı opencode_go değerini taşır; model kimlikleri nanobot'un göndermeden önce kaldırdığı opencode-go/ önekini taşır. Son olarak OpenCode'un Go sayfası, doğrulanmış istemcilerin (Hermes, Claude Code, Codex, ZCode, Pi, jcode ve Kilo Code CLI) yanı sıra oturum desteği eksik veya tamamlanmamış istemcilerin (DeepSeek Harness, GitHub Copilot Chat, Kimi Code ve MiMo Code) listesini yayımlar. 21 Eylül 2026 itibarıyla nanobot bu listelerin hiçbirinde değildir — bu, yayımlanmış bir kararın bulunmadığını gösterir; onay veya engelleme anlamına gelmez. Bu sayfa ayrıca istemci başına sürüm gereksinimlerine de değinir; bunlar burada kaydedilmediğinden, bu istemcilerden herhangi biri için asgari sürüm bilgisini bu sayfadan çıkarmayın.

Tek bir redakte edilmiş istekle doğrulayın

nanobot'un v0.3.5 belgeleri, gönderdiği üst bilgileri yazdırmanın bir yolunu açıklamaz; bu nedenle istemci hakkında herhangi bir sonuca varmadan önce sözleşmeyi doğrudan kendi aboneliğiniz üzerinden doğrulayın. Yalnızca durum satırını okuyun.

# Read the status line only. Key redacted; session id is your own, stable per conversation.
curl -sS -o /dev/null -D - https://opencode.ai/zen/go/v1/chat/completions \
  -H "authorization: Bearer $OPENCODE_API_KEY" \
  -H "x-opencode-session: $(printf 'my-conversation-1' | shasum -a 256 | cut -d' ' -f1)" \
  -H "user-agent: nanobot/0.3.5" \
  -H "content-type: application/json" \
  -d '{"model":"<model-id>","messages":[{"role":"user","content":"ping"}],"max_tokens":8}'

Bu, iki arızayı net biçimde ayırır: MissingSessionID adını içeren bir 400 hatası üst bilgidir; başka herhangi bir şey üst bilgi değildir. Hatanın ortadan kalkması için her istekte yeni bir rastgele kimlik döndürmeyin ve başka bir istemcinin adını ödünç almayın. Belgeler, yönlendirme ve istem önbelleğe alma işlemleri bu kimliğe göre anahtarlanabildiği için her görüşme başına sabit bir kimlik ister; dolayısıyla istek başına kimlik kullanmak, çözüm gibi görünürken ücretini ödediğiniz önbelleğe almayı etkisizleştirir. Meşru iki yanıt, yükseltmek veya bu gereksinimi taşımayan bir rotaya geçmektir.

Bunun maliyeti ve hangi rotanın üstün olduğu

Yazılımı token'lardan ayrı değerlendirin. nanobot'un kendisi $0'dır — 21 Eylül 2026'da okunan depo kaydına göre MIT lisanslı ve kendi sunucunuzda barındırılır — dolayısıyla aşağıdaki her şey model faturası ve modelin çalıştığı makineyle ilgilidir.

Zen satırı, 21 Eylül 2026'da okunan kendi belgelerinden alınmıştır; Zen ve Go ayrı ayrı faturalandırılan ürünlerdir, bu nedenle Zen fiyatı bir Go abonesinin ödediği fiyat değildir ve Zen'in kendi listesi, sağlayıcılar geri bildirim toplarken bazı modelleri geçici olarak ücretsiz işaretler. OpenCode fiyatlandırması, istemcinin kendi maliyet tarafını kapsar.

Abonelik aşağıdaki tabloya dönüştürülemez ve aksini varsaymak buradaki en kolay hatadır. Go'nun kotası Go'nun model başına kendi fiyatlarıyla dolar cinsinden belirlenir ve her modelin kendi üst sınırı vardır: belgelerdeki örnek, 5 saatte 12 ABD doları ve haftada 30 ABD doları kullanıma izin veren, aylık 60 ABD doları tutarındaki bir modeldir; 21 Eylül 2026'da okunan model satırlarında ise GLM-5.3-Flash için 1 milyon token başına 0,15 ABD doları girdi ve 0,50 ABD doları çıktı fiyatı, aylık 60 ABD doları limiti ve ayda tahmini 31.580 istek gösterilir. Bunlar OpenCode'un kendi kataloğu için yaptığı tahminlerdir, garanti değildir ve satırlardan biri bu yazıdan kısa süre sonra sona eren tarihli bir promosyon içeriyordu. Go'nun model listesine ve pencerelerine uyan bir iş yükü için 10 ABD doları, ölçümlenen kullanım açısından oldukça geniştir; asıl karşılaştırma, modellerinizin ve yoğun kullanım aralıklarınızın bu sınırlar içinde kalıp kalmadığıyla ilgilidir.

Ölçümlenen bir ağ geçidi aynı iş yükünü farklı fiyatlandırır. Bunlar ölçülmüş görev maliyetleri veya fatura üst sınırı değil, örnek token aritmetiğidir: ayda 3.000.000 önbelleğe alınmamış girdi ve 300.000 çıktı token'ı tüketen tek bir nanobot asistanı ve milyon token başına güncel Kunavo kataloğu fiyatları varsayalım.

Bunları bütçe olarak değerlendirmeden önce kendi trafiğinize göre ölçeklendirin ve arka plan zamanlamasının girdi sütununu model seçiminden çok daha fazla değiştirebileceğini unutmayın — nanobot API maliyeti ve kurulumu, nanobot'un varsayılan olarak etkinleştirdiği çalışma sıklığını ele alır. Kunavo kataloğundaki tutar bir üst sınır değil, faturalandırma tabanıdır: üst sağlayıcı ücretini bildirdiğinde fatura, katalog maliyeti ile üst sağlayıcı maliyetinin geçerli fiyat artışıyla çarpımından büyük olanıdır. Önbellek ücretleri, araçlar ve barındırma bu örneğin dışındadır; ön ödemeli kredide minimum yükleme $10 tutarındadır — bir finansman minimumudur, görev ücreti veya abonelik değildir. Faturalandırma ayrıntılarına bakın.

Kunavo'nun yardımcı olduğu ve olmadığı noktalar

Bu konuda açık konuşmak, dönüşümden daha önemlidir. Kunavo, OpenCode Go veya Zen'i yeniden satmaz ve nanobot'u https://api.kunavo.com/v1 uç noktasına yönlendirmek OpenCode Go aboneliğini onarmaz. Bunun yerine gereksinimden kaçınır; çünkü x-opencode-session, opencode.ai ana bilgisayarlarına aittir — v0.3.5 kaynak kodundaki ana bilgisayar adı kuralı gereği nanobot bu üst bilgiyi başka hiçbir temel URL'de de eklemez. Kunavo'nun uç noktasının böyle bir üst bilgiyle ne yapacağı burada test edilmedi; nanobot'un Kunavo'ya karşı çalışması da test edilmedi: nanobot entegrasyon sayfası bulunmuyor ve yukarıdaki her yapılandırma ifadesi bir uyumluluk sonucundan değil, sağlayıcı belgeleri ile yayımlanmış kaynak kodunun okunmasından elde edilmiştir.

Bu nedenle rotaları bir düzeltme ve geçici çözüm olarak değil, farklı ödünleşimlere sahip alternatifler olarak değerlendirin. Ölçümlenen bir OpenAI uyumlu rota iş yüküne uygunsa hızlı başlangıç uç nokta kuralını açıklar; Kunavo hesabı oluşturmak ise bir anahtara bakiye yüklemeden önceki adımdır — denerken çalışan bir rotayı hazır tutun, sınırları belirlenmiş tek bir görev çalıştırın ve ardından hesabınızın bu görev için kaydettiği bilgileri okuyun. Abonelik yerine arşivlenmiş Go terminal aracısını arıyorsanız Crush entegrasyonu belgesi onun halefini, OpenCode entegrasyonu belgesi ise güncel TypeScript istemcisini kapsar. Daha geniş bir karşılaştırma için OpenAI uyumlu API ve aracı API dizinine; farklı bir OpenCode hatası içinse sağlayıcı veya model bulunamadı sayfasına bakın.

Sık sorulan sorular

21 Eylül 2026'da kontrol edildi: opencode.ai'nin Go ve Zen belgeleri ile değişiklik günlüğü; HKUDS/nanobot sürümleri, etiketleri, PR #5662'si, issue #5661'i ve işlemin v0.3.5 etiketi içinde olduğunu kanıtlayan karşılaştırma çağrısı için GitHub API; alıntılanan bildirim ve bildirilen 400 hatası için anomalyco/opencode#47438 ve vastsa/PI-Desktop#48; nanobot'un gönderdiği her şeyle ilgili iddialar için v0.3.5 kaynak arşivi. 09/06 tarihi, nanobot'un issue ve PR kayıtlarının alıntıladığı 3 Eylül 2026 tarihli bir @opencode X gönderisine dayanıyor; ancak bu sayfa gönderiyi almadı. Alıntılanan abone bildirimi ve 400 hata sözleşmesi kullanıcılar tarafından bildirildi; ikisi de OpenCode'un belgelerinde veya değişiklik günlüğünde yer almıyor. Burada hiç kimse nanobot'u OpenCode Go'ya veya Kunavo'ya karşı çalıştırmadı ya da hatayı yeniden üretmedi; Kunavo token fiyatları canlı katalogdan alınmıştır ve her dolar tutarı belirtilen varsayımlara dayalı örnek aritmetiktir.