Watch / 值更
WATCH TEKNİK KILAVUZU / OTURUM DEVİR

OpenCode, Claude ve Codex Çift Yönlü Oturum Devri Kılavuzu

OpenCode oturumları ~/.local/share/opencode/opencode.db içinde tutar. WATCH_OPENCODE_DB, Watch'ı başka bir dosyaya yönlendirir. Watch oturumları, iletileri ve parçaları tek bir SQLite işleminde yazar ve başarısız olursa geri alır. Desteklenmeyen araç alanları metne dönüşür. Sonraki yanıtlar yapılandırdığınız modele bağlıdır.

Ticari bulut ajanlarından OpenCode'daki yerel açık kaynak modellere geçerken (veya bulut ajanlarına geri devrederken) bu kılavuz, SQLite işlemsel veri yalıtımıyla çift yönlü devir için Watch'ın nasıl kullanılacağını açıklar.

Yayın: 2026-09-21 Güncelleme: 2026-09-23 Geçerli sürüm: Watch v0.1.1
Temel İşletim Sınırı

OpenCode oturum depolaması için tek bir ilişkisel SQLite veritabanı kullanır (varsayılan ~/.local/share/opencode/opencode.db); ACID işlemsel bütünlük ve yapılandırılmış sorgular sağlar. Hassas görevleri yerel olarak barındırılan açık kaynak modellere (OpenCode içinde Ollama veya vLLM aracılığıyla) taşımak ya da uç bulut modellerine (Claude/Codex) geri devretmek istediğinizde Watch doğrulanmış çift yönlü bir köprü sağlar.

Yalnızca sona eklenen JSONL dosyalarına dayanan araçların aksine OpenCode oturumları sessions, messages ve parts dahil olmak üzere normalleştirilmiş ilişkisel tablolarda düzenler. Doğrudan dış müdahale yabancı anahtar kısıtlarını bozabilir. Watch, UnifiedTurn soyutlamasını tam dizin bağlamını (cwd) ve zaman damgalarını koruyarak OpenCode'un ilişkisel şemasına temiz biçimde eşler.

  1. Adım 1: Kaynak oturum ID'sini ve çalışma dizinini belirle

    Etkin oturum ID'nizi bulun. Claude Code dosyaları ~/.claude/projects/ içinde, Codex ~/.codex/sessions/ içinde saklar; OpenCode oturumları genel olarak benzersiz ID'lerle dizinler. Proje sınırı hizasını korumak için çalışma dizininin mutlak bir yol olduğunu doğrulayın.

  2. Adım 2: Hedef veritabanı durumunu ön denetle (Check)

    Hedef OpenCode veritabanını yoklamak için Watch CLI'yi --check ile çalıştırın. Watch, eşzamanlı yazma çekişmesini önlemek için ~/.local/share/opencode/opencode.db (veya WATCH_OPENCODE_DB ile belirtilen özel yol) üzerindeki yazma izinlerini ve kilitleri doğrular.

  3. Adım 3: Çift yönlü devri yürüt (Handoff)

    Watch Desktop'ta kaynak oturumu seçip OpenCode'u hedefleyin veya CLI open komutunu çalıştırın. Watch artımlı turları çıkarır, sessions, messages ve parts üzerinde atomik SQLite işlemleri yürütür ve hedef oturum ID'sini verir.

  4. Adım 4: Oturumu OpenCode'da yerel olarak sürdür (Resume)

    Dönüşümden sonra çalışma dizininde opencode -s <session-id> çalıştırın veya Watch Desktop'taki başlat düğmesini kullanın. OpenCode, kayıtlı konuşmayı o çalışma dizininde yükler.

# 1. Preflight: Verify target OpenCode database writability npm run watch -- open <claude-session-id> --to opencode --check --json # 2. Handoff: Transfer session into OpenCode SQLite database npm run watch -- open <claude-session-id> --to opencode --json # 3. Reverse handoff: Transfer from OpenCode back to Claude or Codex npm run watch -- open <opencode-session-id> --to claude --json
Güvenlik Kısıtları ve Sorumluluk Reddi

1. Veritabanı yalıtımı ve yedekler: Watch varsayılan olarak ~/.local/share/opencode/opencode.db üzerinde çalışır ve test ortamlarında WATCH_OPENCODE_DB kullanır. Yazma tek bir SQLite işlemidir ve başarısız olursa geri alınır. 2. Araç çağrısı gösterimleri: kayıtlar şemalar arasında eşlenir; desteklenmeyen tescilli parametreler yapılandırılmış metne dönüşür. 3. Modelin devamı: Watch, kaydedilmiş oturum kaydını ve çalışma dizinini yazar. Her araç olayının korunduğunu garanti etmez. Sonraki yanıtlar yapılandırdığınız modele bağlıdır.

Sık sorulan sorular

OpenCode'un SQLite depolamasının JSONL'ye göre avantajı nedir?

SQLite, ACID işlemleri ve sağlam dizinleme sağlar; beklenmedik sonlanmada satır kesilmesi veya dosya bozulması riskini ortadan kaldırır. WATCH_OPENCODE_DB geçersiz kılması da yalıtılmış test ortamlarını kolaylaştırır.

OpenCode'dan dışarı devrederken özel model akıl yürütme düşünceleri korunur mu?

Watch, eşleyebildiği kullanıcı istemlerini, asistan metnini, düşünme izlerini ve araç çıktılarını kopyalar. Desteklenmeyen araç alanları metne dönüşür; bu nedenle kopya, OpenCode satırının tam bir kopyası değildir.

Watch çalışma dizini uyuşmazlığını nasıl önler?

Watch, kaynak oturumun mutlak cwd'sini OpenCode oturum kaydına kesin olarak bağlar. opencode -s <session-id> ile sürdürürken OpenCode o çalışma alanına kilitlenir ve yanlış dizinde kazara düzenlemeleri önler.

Resmi kaynaklar ve doğrulama kayıtları

Watch ana sayfasına dön Watch Desktop’u indir