Özgün Cotton logosundan arka planı ve yazısı kaldırılmış gülümseyen pamuk karakteri
Salona dön

Cotton

Translation workflow

Üretilen çevirileri incelenebilir sonuçlara dönüştürmek.

Oyun diyalogları için bir çeviri iş akışı.

2026.05.06 — 2026.05.26

İş projesi · çeviri işleme, yargı ve inceleme yolu

  • Web uygulamasıUygulandı · geliştirme

Cotton vocabulary

Lens
Refinement Loop
Translation
Quality Estimation
Workflow
Job Control
Human Review
  1. prompt layers
  2. glossary
  3. generation
  4. revision
  1. judge
  2. hard gate
  3. score
  1. intake
  2. checkpoint
  3. spend control
  4. stale sweep
  1. approval
  2. correction
  3. audit trail

Prompt Layers: SYSTEM_PROMPT_L0 · buildTranslateUserMessage · L1 CONTRACT · L3 SPEAKER · L6 SOURCE · L7 INSTRUCTION · ICU PLACEHOLDER · INLINE TAG · TARGET TEXT ONLY · FORCED MAPPING · L2 GLOSSARY · speaker_keyGlossary: glossary_term · fetchGlossaryHits · canonical_form · forbidden_translations · SUBSTRING MATCH · FORCED MAPPING · FORBIDDEN ALTERNATIVE · L2 GLOSSARY · glossary_hits · glossary_complianceGeneration: AdapterRegistry · anthropic-sdk · openai-sdk · claude-local · codex-local · llm_plan · PIVOT_VIA · shouldPivot · COTTON_ADAPTER_CONCURRENCY · NODE_OPTIONS · pivot_register_carry · translation.refinedRevision: buildTranslateUserMessage · L7 INSTRUCTION · runRefinementLoop · priorAttempt · priorCritique · REJECTED BY THE JUDGE · maxTurns · willRetry · RefinementHooks · HOOK ABORT · turn_count_to_final · critique_for_retry · failingDimensions · cost_ceiling_usd · needs_reviewJudge: glossary_hits · runJudge · JUDGE_SYSTEM_PROMPT · judgeModel · TEMPERATURE 0 · parseJudgeResponse · FOUR-SECTION XML · VERBATIM CHUNKS · severity · critique_for_retry · judge_citation · missingHardGates · TRIGGER ABSENT = PASS · judge.scoredHard Gate: ICU PLACEHOLDER · INLINE TAG · FORBIDDEN ALTERNATIVE · hard_gate_fail · hardGatePassed · glossary_compliance · cps_budget_compliant · icu_validity · inline_tag_preserved · length_constraint · HARD GATE FIRST · missingHardGates · TRIGGER ABSENT = PASSScore: HARD GATE FIRST · computeVerdict · cottonEvalScore · WEIGHTED AVERAGE · tone_register · personality_consistent · emotional_state_match · cultural_marker_preserved · accuracy · pivot_register_carry · auto_approve_threshold · failingDimensions · approval_gate · judge.scoredIntake: processXlsxBytes · classifySheetName · parseGoogleSheetsUrl · source_file · content_sha256 · extractStageDirection · speaker_key · ingest_session · segment.ingested · github.push.receivedCheckpoint: translation_progress · last_completed_step · turn_translated · turn_judged · finalized · jobEntryGuard · SELECT FOR UPDATE · attempt_count · DEFAULT_MAX_RESUME_ATTEMPTS · TWO-TX SPLIT · ON CONFLICT DO NOTHINGSpend Control: llm_plan · costCap · cost_ceiling_usd · rateLimit · FailoverDispatcher · haltOnQuota · detectQuotaFromStream · quota_daily_exhausted · auth_revoked · NO AUTO-SWAP · needs_credential · POST /:id/resumeStale Sweep: COTTON_ADAPTER_CONCURRENCY · NODE_OPTIONS · attempt_count · runStaleSweep · STALE_THRESHOLD_INTERVAL · DLQ_ATTEMPT_CAP · LIMIT 200 · re_enqueued · dead_lettered · ORPHAN RE-ENQUEUE · IN-FLIGHT SET · /health/queues · maxStalledCount · needs_reviewApproval: auto_approve_threshold · ingest_session · SELECT FOR UPDATE · needs_credential · POST /:id/resume · POST /:id/approve · POST /:id/unapprove · POST /:id/reject · APPROVE_FROM · REJECT_FROM · needs_review · reviewer_id · HITL · approval_gate · translation.approved · EDIT & APPROVE · actor_idCorrection: POST /:id/correct · corrected_text · CORRECT_FROM · EDIT & APPROVE · human_corrected_segments · human-corrected-after-mt · translation.human_corrected · supersedes · NEW REVISION · IMMUTABLE HISTORYAudit Trail: turn_count_to_final · severity · judge_citation · content_sha256 · segment.ingested · github.push.received · translation.approved · human_corrected_segments · translation.human_corrected · IMMUTABLE HISTORY · event_log · appendNextEvent · ULID · AGGREGATE VERSION · translation_state_log · actor_id · llm_call_log · telemetryHook · judge.scored · translation.refined

Puanlar, yeniden denemeler ve insan incelemesi, her biri kendi sınırında.

Üretim ve yargı sözlüğü paylaşır; hakem modelin raporladığı bir hard-gate başarısızlığı ortalama puanla telafi edilemez. Ara çeviri ve yargı durumları kaydedilir, yeniden deneme ve maliyet sınırları tükenmiş kimlik bilgilerinden ayrı tutulur ve takılmış işler nedene göre kuyruğa ya da incelemeye döner.

Bu iş projesi çeviri üretimini, modelin raporladığı kalite yargısını, yeniden denemeleri ve insan incelemesini tek bir akışta birleştirir.

Deponun başlangıcından katılım süresince doğrulanan çalışmaya kadar

Çeviri düzenleme ve onay ekranlarından, bir API'den ve bir iş worker'ından oluşan, geliştirme ortamında çalışan bir web uygulaması.

Yargı akışı haritası · gizli uygulama kayıtlarından
Cotton çeviri yargısı · yeniden deneme · kurtarmaAPI kaynak metni ve hedef yerel ayarları veritabanına commit'ler, ardından her hedef yerel ayar için bir işi kuyruğa alır. Bir worker satırı kilitler, denemeyi kontrol eder, draft'ı ve ilerleme durumunu oluşturur, sözlükle bir çeviri üretir ve aynı sözlükle ayrıca bir hakem modeli çağırır. Çeviri (Tx1) ve kanıtıyla birlikte yargı (Tx2) ayrı işlemlerde kaydedilir. Kod yargıyı, bir hard-gate başarısızlığı ortalamayla telafi edilmeyecek biçimde toplar: geçiş kesinleştirilir, başarısızlık bir tur daha alır, tur ya da maliyet sınırı onu insan incelemesine gönderir, bir kota ya da kimlik doğrulama sinyali harcamayı durdurur ve kimlik bilgisi kontrolünü bekler. Bayat tarama 10 dakikadan eski en fazla 200 draft'a bakar: denemesi kalmış ama kuyrukta olmayan yeniden kuyruğa alınır, denemelerini tüketen ise sonuç olup olmamasına göre incelemeye ya da kimlik bilgisi kontrolüne gider.Kaynak · hedef yerel ayarlarSaklanan segmentlerİnsan incelemesineeds_review · onay değilKimlik bilgisi kontrolüneeds_credentialAPI · iş kaydıCommit'ten sonra kuyruğa alİş kuyruğuBullMQ · iş kimliğiİş girişiSatır kilidi · deneme kontrolüSözlük · bağlamÇalışma alanı sözlüğüÇeviri turuÜret · model çağrısıHakem model çağrısı · ayrıştırmaHüküm kurallarıHard gate · ağırlıklı ortalamaYeniden deneme · harcamaTurlar · maliyet · kotaÇeviri durumuDraft · ilerlemeÇeviri · yargı satırlarıDurum · çağrı günlüğüKesinleştirmeSon işlemKuyruk kontrolüKuyruk durumunu karşılaştırBayat tarama10 dk'dan eski draft'lar · en fazla 200Girdi · kuyrukÜretim · yargıDurum · kabulKurtarma · insan kararı1kaynak2 commit'ten sonra · Commit'ten sonra kuyruğa al → BullMQ · iş kimliği23işi ilet4ilerleme satırı5denemeye izin verildi1sözlük2aynı sözlük3Tx1 · çeviri4Tx2 · yargı5 puanlar · kapılar · Hakem model çağrısı · ayrıştırma → Hard gate · ağırlıklı ortalama56hüküm7pass8son kayıt1hüküm2sonraki tur3sınır · iptal4kota · kimlik doğrulama5elle devam ettirme1bayat draft2 sınırın altında · 10 dk'dan eski draft'lar · en fazla 200 → Kuyruk durumunu karşılaştır23yeniden kuyruğa al4sonuç var5sonuç yok

Kayıt → giriş

Veritabanı commit'inden sonra kuyruğa alınır; bir worker satırı kilitler, denemeyi kontrol eder ve draft'ı oluşturur.

  1. Kaynak · hedef yerel ayarlarVeri: kaynakCommit'ten sonra kuyruğa alAPI · iş kaydı

    Kaynak segmentler ve projenin hedef yerel ayarları veritabanında saklanır. Müşteri verileri gösterilmez.

  2. Commit'ten sonra kuyruğa alAPI · iş kaydıVeri: commit'ten sonraBullMQ · iş kimliğiİş kuyruğu

    Veritabanı commit'inden sonra her etkin hedef yerel ayar için istek kapsamlı bir kimliğe sahip bir iş kuyruğa alınır. Kuyruğa alma başarısız olursa yalnızca bir uyarı günlüğe yazılır ve commit geri alınmaz (atomik outbox yok); bayat taramanın var olma nedeni budur.

  3. BullMQ · iş kimliğiİş kuyruğuÇalıştırma · yargı: işi iletSatır kilidi · deneme kontrolüİş girişi

    BullMQ işi bir worker'a eşzamansız olarak verir.

  4. Satır kilidi · deneme kontrolüİş girişiVeri: ilerleme satırıDraft · ilerlemeÇeviri durumu

    Bir işlem içinde ilerleme satırı kilitlenir ve bir draft çeviri oluşturulur. Kesinleştirilmiş ya da kimlik bilgisi nedeniyle duraklatılmış işlerin otomatik yeniden denemeleri atlanır; elle yapılan istekler ayrıca ele alınır.

  5. Satır kilidi · deneme kontrolüİş girişiÇalıştırma · yargı: denemeye izin verildiÜret · model çağrısıÇeviri turu

    Deneme sayısı sınırı içinde bir artar, ardından çeviri turu başlar.

Üret → yargıla → kesinleştir

Üretim ve yargı aynı sözlüğü kullanır; çeviri ve yargı ayrı kaydedilir, kod kesinleştirmeden önce yargıyı toplar.

  1. Çalışma alanı sözlüğüSözlük · bağlamVeri: sözlükÜret · model çağrısıÇeviri turu

    Çalışma alanı sözlüğü ve bağlamı aranır ve üretime aktarılır.

  2. Çalışma alanı sözlüğüSözlük · bağlamVeri: aynı sözlükHakem model çağrısı · ayrıştırmaÇeviri turu

    Yargı aynı sözlük kısıtlarını alır.

  3. Üret · model çağrısıÇeviri turuVeri: Tx1 · çeviriÇeviri · yargı satırlarıÇeviri durumu

    Model doğrudan ya da bir en-US ara dil üzerinden çağrılır; çağrı, olay ve ilerleme tek bir işlemde yazılır. İş bir çökmeden sonra yeniden çalışırsa çeviri çağrısı ve maliyeti tekrarlanabilir.

  4. Hakem model çağrısı · ayrıştırmaÇeviri turuVeri: Tx2 · yargıÇeviri · yargı satırlarıÇeviri durumu

    Hakem puanları ve kanıtı her çeviri ve tur için bir kez eklenir; bir yineleme mevcut satırı bulur ve alıntılar yalnızca ilk eklemede yazılır. Çeviriyle aynı işlem değildir.

  5. Hakem model çağrısı · ayrıştırmaÇeviri turuVeri: puanlar · kapılarHard gate · ağırlıklı ortalamaHüküm kuralları

    Hakem modelin yanıtı boyut başına puanlara ve kapı sonuçlarına ayrıştırılır. Sözlüğün geçip geçmediği hakem modelin raporladığı şeydir.

  6. Hard gate · ağırlıklı ortalamaHüküm kurallarıÇalıştırma · yargı: hükümTurlar · maliyet · kotaYeniden deneme · harcama

    Raporlanan herhangi bir hard-gate başarısızlığı sıfır ve başarısızlık demektir; ağırlıklı ortalama ve boyut başına eşikler ancak ondan sonra uygulanır. 8.0'lık genel eşik bir yapılandırma varsayılanıdır, gözlenmiş bir çeviri kalitesi değil.

  7. Turlar · maliyet · kotaYeniden deneme · harcamaÇalıştırma · yargı: passSon işlemKesinleştirme

    Bir geçiş translated olarak kesinleştirilir.

  8. Son işlemKesinleştirmeVeri: son kayıtDurum · çağrı günlüğüÇeviri durumu

    Aday, durum, puan ve turlar kesinleştirilir; finalized ilerleme ve durum günlüğü tek bir işlemde yazılır. Çeviri tamamlandı olayı yalnızca translated için yayılır.

Yeniden deneme · harcama sınırları

Geçmemek bir tur daha demektir; bir sınır insan incelemesi demektir; kota ya da kimlik doğrulama harcamayı durdurur ve bir operatörün devam ettirmesini bekler.

  1. Hard gate · ağırlıklı ortalamaHüküm kurallarıÇalıştırma · yargı: hükümTurlar · maliyet · kotaYeniden deneme · harcama

    Raporlanan herhangi bir hard-gate başarısızlığı sıfır ve başarısızlık demektir; ağırlıklı ortalama ve boyut başına eşikler ancak ondan sonra uygulanır. 8.0'lık genel eşik bir yapılandırma varsayılanıdır, gözlenmiş bir çeviri kalitesi değil.

  2. Turlar · maliyet · kotaYeniden deneme · harcamaÇalıştırma · yargı: sonraki turÜret · model çağrısıÇeviri turu

    Geçemeyen bir çeviri önceki çeviri ve critique ile yeniden üretilir. Bir hard-gate başarısızlığı bile doğrudan bir kişiye gitmek yerine önce yeniden denenebilir.

  3. Turlar · maliyet · kotaYeniden deneme · harcamaÇalıştırma · yargı: sınır · iptalİnsan incelemesi

    Turlar bittiğinde ya da maliyet tavanına ulaşıldığında iş needs_review olarak kesinleştirilir. Kesinleştirilmiş, işlemenin bittiği anlamına gelir; bir kişinin onayladığı anlamına gelmez.

  4. Turlar · maliyet · kotaYeniden deneme · harcamaHata · sınır: kota · kimlik doğrulamaKimlik bilgisi kontrolü

    Bir kota ya da kimlik doğrulama sinyali harcamayı durdurur ve needs_credential'ı ayarlar. Başka bir hesaba ya da sağlayıcıya otomatik geçiş yoktur. Durdurma sinyali taşımayan iletim hataları BullMQ yeniden denemesine döner.

  5. Kimlik bilgisi kontrolüÇalıştırma · yargı: elle devam ettirmeBullMQ · iş kimliğiİş kuyruğu

    Kimlik bilgilerini kontrol etmiş bir operatör açıkça yeniden başlatır.

Bayat iş kurtarma

Eski draft'lar nedene göre ayrılır: kuyrukta olmamak yeniden kuyruğa almak, denemelerin tükenmesi bir insan kararı demektir.

  1. Draft · ilerlemeÇeviri durumuGözlem · rapor: bayat draft10 dk'dan eski draft'lar · en fazla 200Bayat tarama

    10 dakikadan uzun süredir draft olan en fazla 200 aday, en eskiden başlayarak okunur. Sorgu kilit almaz ve güncellemeler ile günlükler ayrı ifadeler olarak çalışır; bu yüzden yarış durumundan arınmış bir toplu işlem olarak tanımlanmaz.

  2. 10 dk'dan eski draft'lar · en fazla 200Bayat taramaÇalıştırma · yargı: sınırın altındaKuyruk durumunu karşılaştırKuyruk kontrolü

    Denemeler sınırdan (3) azsa iş active, waiting, delayed ve prioritized kuyruk durumlarıyla karşılaştırılır. Kodda denemelerin tükendiği dal bu kuyruk kontrolünden önce gelir.

  3. Kuyruk durumunu karşılaştırKuyruk kontrolüÇalıştırma · yargı: yeniden kuyruğa alBullMQ · iş kimliğiİş kuyruğu

    İş kuyrukta değilse yeniden kuyruğa alınır. API istek son ekli kimlikler kullanırken tarama segment ve yerel ayar kimliğini arar; bu yüzden sürmekte olan her istekle eşleştiği söylenmez.

  4. 10 dk'dan eski draft'lar · en fazla 200Bayat taramaÇalıştırma · yargı: sonuç varİnsan incelemesi

    3 denemenin tümü kullanılmış ve bir çeviri sonucu varsa iş needs_review'a gider.

  5. 10 dk'dan eski draft'lar · en fazla 200Bayat taramaÇalıştırma · yargı: sonuç yokKimlik bilgisi kontrolü

    3 denemenin tümü kullanılmış ve sonuç yoksa iş needs_credential'a gider.

Her bağlantı aynı kalınlıkta. Yalnızca yolunu numaralı adımlarla vurgulamak için bir akış seçin.

  • Düz çizgi · girdi, sonuç ve kayıtların yönü
  • Kesikli · çalıştırma, yargı, istek
  • Uzun noktalar · gözlem ve raporlama, yargıdan ayrı
  • Kısa kesikler · hata, durma, sınır
  • Kalın siyah çizgi · seçilen akış; numaralar sırayı verir
  • Kutu · bir kod ya da durum sınırı, adı başlığında
  • İç çip · o sınırın bir bileşeni
  • Noktalı kutu · o sınırın dışı
  • Turuncu çerçeve · bir modelin karar verdiği yer
  • Üretim · harcama · kesinleştirme
  • Giriş · hüküm kuralları · tarama
  • Kuyruk · durum · kayıtlar
  • Kayıt · kuyruk kontrolü

Gizli uygulama ve geliştirme kayıtlarından çizildi. Müşteri verileri ve kod yolları gösterilmez.

Tek bir tarama
May 26, 2026, geliştirme ortamında tek bir tarama döngüsü: 200 kontrol edildi, 106 durum geçişi, 2 yeniden kuyruğa alındı. Bir durum geçişi başarılı bir çeviri değildir ve 106'nın hedef duruma göre dağılımı kaydedilmedi.
Neden tam olarak bir kez değil
Kayıtlar yinelenmeden yazılır, ama bir iş çökmeden sonra yeniden çalışırsa model çağrıları ve maliyetleri tekrarlanabilir. Eşzamanlılık sınırı küme genelinde değil, süreç başınadır.
Hükmün kapsamı
Bir ortalamanın sözlük başarısızlığını örtmesini engellemek, raporlanan kapılar üzerinde bir toplama kuralıdır. Her yasaklı terimin bulunduğunu ya da kalitenin ana dil düzeyinde olduğunu kanıtlamaz.