
Cotton
Translation workflow
Üretilen çevirileri incelenebilir sonuçlara dönüştürmek.
Oyun diyalogları için bir çeviri iş akışı.
Cotton vocabulary
- prompt layers
- glossary
- generation
- revision
- judge
- hard gate
- score
- intake
- checkpoint
- spend control
- stale sweep
- approval
- correction
- 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ı.
Kayıt → giriş
Veritabanı commit'inden sonra kuyruğa alınır; bir worker satırı kilitler, denemeyi kontrol eder ve draft'ı oluşturur.
Kaynak · hedef yerel ayarlarVeri: kaynakCommit'ten sonra kuyruğa al
API · iş kaydıKaynak segmentler ve projenin hedef yerel ayarları veritabanında saklanır. Müşteri verileri gösterilmez.
Commit'ten sonra kuyruğa al
API · iş kaydıVeri: commit'ten sonraBullMQ · iş kimliğiİş kuyruğuVeritabanı 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.
BullMQ · iş kimliği
İş kuyruğuÇalıştırma · yargı: işi iletSatır kilidi · deneme kontrolüİş girişiBullMQ işi bir worker'a eşzamansız olarak verir.
Satır kilidi · deneme kontrolü
İş girişiVeri: ilerleme satırıDraft · ilerlemeÇeviri durumuBir 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.
Satır kilidi · deneme kontrolü
İş girişiÇalıştırma · yargı: denemeye izin verildiÜret · model çağrısıÇeviri turuDeneme 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.
Ç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.
Çalışma alanı sözlüğü
Sözlük · bağlamVeri: aynı sözlükHakem model çağrısı · ayrıştırmaÇeviri turuYargı aynı sözlük kısıtlarını alır.
Üret · model çağrısı
Çeviri turuVeri: Tx1 · çeviriÇeviri · yargı satırlarıÇeviri durumuModel 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.
Hakem model çağrısı · ayrıştırma
Çeviri turuVeri: Tx2 · yargıÇeviri · yargı satırlarıÇeviri durumuHakem 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.
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.
Hard gate · ağırlıklı ortalama
Hüküm kurallarıÇalıştırma · yargı: hükümTurlar · maliyet · kotaYeniden deneme · harcamaRaporlanan 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.
Turlar · maliyet · kota
Yeniden deneme · harcamaÇalıştırma · yargı: passSon işlemKesinleştirmeBir geçiş translated olarak kesinleştirilir.
Son işlem
KesinleştirmeVeri: son kayıtDurum · çağrı günlüğüÇeviri durumuAday, 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.
Hard gate · ağırlıklı ortalama
Hüküm kurallarıÇalıştırma · yargı: hükümTurlar · maliyet · kotaYeniden deneme · harcamaRaporlanan 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.
Turlar · maliyet · kota
Yeniden deneme · harcamaÇalıştırma · yargı: sonraki turÜret · model çağrısıÇeviri turuGeç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.
Turlar · maliyet · kota
Yeniden deneme · harcamaÇalıştırma · yargı: sınır · iptalİnsan incelemesiTurlar 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.
Turlar · maliyet · kota
Yeniden 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.
Kimlik bilgisi kontrolüÇalıştırma · yargı: elle devam ettirmeBullMQ · iş kimliği
İş kuyruğuKimlik 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.
Draft · ilerleme
Çeviri durumuGözlem · rapor: bayat draft10 dk'dan eski draft'lar · en fazla 200Bayat tarama10 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.
10 dk'dan eski draft'lar · en fazla 200
Bayat 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.
Kuyruk durumunu karşılaştır
Kuyruk 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.
10 dk'dan eski draft'lar · en fazla 200
Bayat taramaÇalıştırma · yargı: sonuç varİnsan incelemesi3 denemenin tümü kullanılmış ve bir çeviri sonucu varsa iş needs_review'a gider.
10 dk'dan eski draft'lar · en fazla 200
Bayat 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.