BIGONE
Nasıl çalışır

Bir komut nereye gider, ne zaman sorulur

BigOne'da zekâ tek bir süreçte, senin oturumunda çalışır. İstemciler yalnızca arayüzdür. Bu sayfa bir komutun o süreç içinde izlediği yolu, katmanları ve bilgisayarında açılan portları anlatır.

01 · Komutun yolculuğu

Önce kurallar, sonra model, değişiklikten önce sen

Bir komutun yolculuğu Komut istemciden API'ye, oradan beyne gider. Hızlı yol eşleşirse skill doğrudan çalışır. Eşleşmezse dil modeli bir araç çağırır; değişiklik yapan çağrı önce kullanıcıya önizleme olarak gösterilir, onaydan sonra hedef yeniden hesaplanıp çalıştırılır ve geri alma kaydı yazılır. Cevap ve denetim kaydı istemciye döner. hızlı yol eşleşti · model yok eşleşmedi · LLM döngüsü, en çok 8 tur Sen İstemci masaüstü · CLI API FastAPI Beyin Agent Hızlı yol FastPath LLM LLMRouter Skill Runner + izin Windows komut (yazı ya da ses) POST /v1/command · Bearer olay → Agent.handle FastPath.match skill + parametreler L0/L1: çalıştır sistem + hafıza + araçlar araç çağrısı origin=model risk L2 → onay gerekir Onay gerekiyor (L2): önizleme Onayla hedef yeniden hesaplanır çalıştır + geri alma kaydı cevap · audit_log cevap
04Bir komutun istemciden Windows'a gidişi. Amber kutu: model bir araç çağırdığı, değişiklik yapan iş onaya düştüğü kısım.

Hızlı yol

  • Komut normalleştirilir: baştaki "BigOne," ve sondaki noktalama atılır, Türkçe kurallarıyla küçük harfe çevrilir, kesme işaretinden sonraki ek düşer ("Chrome'u" → chrome).
  • Skill'lerin manifestindeki düzenli ifadeler sırayla denenir: önce yerleşik skill'ler, sonra priority değeri küçük olan. Adlandırılmış gruplar parametre olur.
  • Skill'in can_handle() metodu son kararı verir: klasör var mı, adres geçerli mi, uygulama kurulu mu.
  • Türkçe harf kullanmadan yazılan komutlar da tanınır ("indirilenleri ac").

LLM döngüsü

  • Sistem istemi sırası: anayasa (sabit kurallar) → kişilik → kullanıcının ek kuralları → araç kuralları → anlamca en yakın 3 hafıza ve gözlem notları.
  • Skill'ler modele araç olarak verilir; döngü en çok 8 tur sürer. Bir sağlayıcı hata verirse sıradaki devralır, tur ortasında bile: mesajlar sağlayıcıdan bağımsız tiplerle tutulur.
  • Değişiklik yapan bir araç çağrısında skill önce dry_run ile önizlenir, onay kaydı yazılır ve döngü orada durur; kalan araç çağrıları çalışmaz.
  • Onaydan sonra hedef yeniden hesaplanır. Bu arada değişmişse hiçbir şey çalışmaz (target_changed).
  • Model bir işi yapmadan "yaptım" derse fark edilir: önce uyarılır, tekrar ederse sana "hiçbir şey değişmedi" denir ve denetim kaydına yazılır.
02 · Katmanlar

Her katman yalnızca altındakini kullanır

Çekirdek paketleri arasında içe aktarma yönü kuralla sabit: örneğin LLM paketi beyin paketini hiç içe aktarmaz. Böylece dil modeli sağlayıcısı, konuşma tanıma ya da depolama değişirken üst katmanlar değişmez.

Katmanlı mimari Beş katman: istemciler; FastAPI ile API ve kimlik doğrulama; zihin, beyin, hızlı yol ve onay yöneticisi; LLM yönlendirici, skill yöneticisi, hafıza ve izin katmanı; en altta Ollama, bulut API'leri, SQLite, Windows API ve Kimlik Bilgisi Yöneticisi. Her katman yalnızca altındakini kullanır. İstemci Masaüstü Tauri 2 · Svelte Android Kotlin · Compose Komut satırı bigone Ses mikrofon · hoparlör Arayüz API Gateway FastAPI · REST + WebSocket Kimlik doğrulama yerel token · cihaz token'ı Uygulama Zihin olay kuyruğu Beyin Agent döngüsü Hızlı yol kural eşleştirici Onay yöneticisi önizleme · süre Alan LLM yönlendirici sıra · yedeğe düşme Skill yöneticisi üç kaynak · öncelik Hafıza embedding · not İzin katmanı risk · korunan alan Altyapı Ollama :11434 Bulut API isteğe bağlı SQLite bigone.db Windows API dosya · süreç Kimlik Yön. anahtarlar
05Katmanlı mimari. Amber: işin sana sorulduğu ve izinlerin denetlendiği yerler.
03 · Süreçler ve portlar

Bilgisayarında neler çalışır, hangi portu açar

Varsayılan olarak API yalnızca 127.0.0.1'i dinler; ağdan erişilemez. Telefon kapısı ancak "Telefon ekle" ile eşleştirme başlayınca açılır, telefon eşleşik kaldıkça açık kalır ve TLS ile cihaz token'ı ister. Son telefon kaldırılınca 12 saniye sonra kapanır.

Süreçler, portlar ve veri Masaüstü uygulaması bigone-core sürecine 127.0.0.1:8765 üzerinden token ile bağlanır. Çekirdek API'yi, telefon kapısını (eşleştirme başlayınca, 8766, TLS), zihni ve sesi barındırır; Ollama'ya 11434'ten gider, üretilen skill testlerini ayrı bir sandbox sürecinde çalıştırır, verisini %LOCALAPPDATA%\BigOne altında, anahtarlarını Windows Kimlik Bilgisi Yöneticisi'nde tutar. BİLGİSAYAR · KULLANICI OTURUMU bigone-desktop.exe Tauri 2 · sistem tepsisi bigone (CLI) sunucu yoksa aynı süreçte Kimlik Bilgisi Yöneticisi BigOne/<sağlayıcı> bigone-core.exe bigone serve · Python 3.12 API 127.0.0.1:8765 Telefon kapısı :8766 · TLS Zihin + el 2 işçi Ses Whisper · Piper HTTP + Bearer · WS /v1/events token arayüze hiç verilmez --unsafe-lan olmadan LAN'a açılmaz Ollama 127.0.0.1:11434 bigone-sandbox.exe üretilen skill testleri %LOCALAPPDATA%\BigOne config.toml · data\bigone.db logs · skills · models Android telefon aynı Wi-Fi · eşleştirmeyle açılır TLS · pin
06Süreçler, portlar ve veri. Sandbox süreci yalnızca BigOne'ın yazdığı skill'lerin testlerini çalıştırır.
AdresNeNe zaman
127.0.0.1:8765BigOne API · REST + WebSocket /v1/eventsher zaman, yalnızca bu bilgisayar
0.0.0.0:8766Telefon kapısı · TLSeşleştirme başlayınca; telefon eşleşik kaldıkça
127.0.0.1:11434Ollama · yerel modelOllama kuruluysa
04 · Veri nerede durur

Hepsi kendi kullanıcı klasöründe

Yolİçerik
%LOCALAPPDATA%\Programs\BigOneProgram (yönetici izni gerekmez)
%LOCALAPPDATA%\BigOne\config.tomlAyarlar
%LOCALAPPDATA%\BigOne\data\bigone.dbTek SQLite dosyası: sohbet, hafıza, onaylar, denetim kaydı, görevler
%LOCALAPPDATA%\BigOne\skills\Senin ve BigOne'ın yazdığı skill'ler (generated, git ile sürümlü)
%LOCALAPPDATA%\BigOne\models\Ses modelleri
%LOCALAPPDATA%\BigOne\data\tls\Telefon için kendinden imzalı sertifika (EC P-256)
Windows Kimlik Bilgisi YöneticisiAPI anahtarları, BigOne/<sağlayıcı> adıyla; dosyada, logda, veritabanında yok

BIGONE_HOME ortam değişkeni kök klasörü değiştirir. BigOne açılırken veritabanını açmadan önce bir deneme dosyası yazar: yazma bir MSIX paketinin gizli kopyasına düşüyorsa başlamayı reddeder ve nedenini söyler.