Naeratav puuvillategelane algsest Cottoni logost, taust ja kiri eemaldatud
Tagasi saali

Cotton

Translation workflow

Genereeritud tõlgetest ülevaadatavad tulemused.

Mängudialoogi tõlketöövoog.

2026.05.06 — 2026.05.26

Tööprojekt · tõlgete töötlemine, verdikt ja ülevaatuse tee

  • VeebirakendusTeostatud · arenduskeskkond

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

Skoorid, kordused ja inimese ülevaatus, igaüks oma piiri juures.

Genereerimine ja verdikt jagavad sõnastikku ning kohtunikmudeli raporteeritud kohustusliku värava tõrget ei saa keskmisega tasa teha. Tõlke ja verdikti vaheolekud salvestatakse, korduste ja kulude piirid hoitakse ammendatud mandaatidest lahus ning seiskunud tööd naasevad põhjuse järgi järjekorda või ülevaatusele.

See tööprojekt ühendab tõlgete genereerimise, mudeli raporteeritud kvaliteediverdikti, kordused ja inimese ülevaatuse üheks vooks.

Repositooriumi algusest kuni lepingu ajal kinnitatud tööni

Tõlgete redigeerimise ja kinnitamise vaadetest, API-st ja tööde töötlejast koosnev veebirakendus, mis töötab arenduskeskkonnas.

Verdiktivoo kaart · privaatsete teostuskirjete põhjal
Cotton: tõlke verdikt · kordus · taastamineAPI commitib lähteteksti ja sihtkeeled andmebaasi ning paneb seejärel iga sihtkeele kohta töö järjekorda. Worker lukustab rea, kontrollib katset, loob mustandi ja edenemisoleku, genereerib tõlke sõnastiku abil ja kutsub kohtunikmudelit eraldi sama sõnastikuga. Tõlge (Tx1) ja verdikt koos tõenditega (Tx2) salvestatakse eraldi tehingutes. Kood koondab verdikti nii, et kohustusliku värava tõrget ei tehta keskmisega tasa: läbinu viiakse lõpule, läbikukkunu saab uue käigu, käigu- või kulupiir saadab selle inimese ülevaatusele ning kvoodi- või autentimissignaal peatab kulud ja ootab mandaadi kontrolli. Aegunud tööde kontroll vaatab kuni 200 üle 10 minuti vanust mustandit: järjekorrast puuduv, millel on katseid alles, pannakse uuesti järjekorda, ja katsed ammendanu läheb olenevalt tulemuse olemasolust ülevaatusele või mandaadi kontrolli.Lähtetekst · sihtkeeledSalvestatud segmendidInimese ülevaatusneeds_review · mitte kinnitusMandaadi kontrollneeds_credentialAPI · töö registreerimineJärjekorda pärast commititTööjärjekordBullMQ · töö IDTöö sisenemineRealukk · katse kontrollSõnastik · kontekstTööruumi sõnastikTõlkekäikGenereerimine · mudelikutseKohtunikmudeli kutse · parsimineVerdikti reeglidKohustuslik värav · kaalutud keskmineKordus · kuludKäigud · kulu · kvootTõlke olekMustand · edenemineTõlke · verdikti readOlek · kutselogiLõpuleviimineLõplik tehingJärjekorra kontrollJärjekorra oleku võrdlusAegunud tööde kontrollÜle 10 min vanused mustandid · kuni 200Sisend · järjekordGenereerimine · verdiktOlek · vastuvõttTaastamine · inimese otsus1 lähtetekst · Lähtetekst · sihtkeeled → Järjekorda pärast commitit12 pärast commitit · Järjekorda pärast commitit → BullMQ · töö ID23 töö edastamine · BullMQ · töö ID → Realukk · katse kontroll34edenemisrida5katse lubatud1sõnastik2 sama sõnastik · Tööruumi sõnastik → Kohtunikmudeli kutse · parsimine23Tx1 · tõlge4Tx2 · verdikt5 skoorid · väravad · Kohtunikmudeli kutse · parsimine → Kohustuslik värav · kaalutud keskmine56verdikt7pass8lõplik kirje1verdikt2järgmine käik3piir · katkestus4kvoot · autentimine5käsitsi jätkamine1aegunud mustand2alla piiri3uuesti järjekorda4 tulemus olemas · Üle 10 min vanused mustandid · kuni 200 → Inimese ülevaatus45tulemust pole

Registreerimine → sisenemine

Järjekorda pärast andmebaasi commitit; worker lukustab rea, kontrollib katset ja loob mustandi.

  1. Lähtetekst · sihtkeeledAndmed: lähtetekstJärjekorda pärast commititAPI · töö registreerimine

    Lähtesegmendid ja projekti sihtkeeled salvestatakse andmebaasi. Kliendiandmeid ei näidata.

  2. Järjekorda pärast commititAPI · töö registreerimineAndmed: pärast commititBullMQ · töö IDTööjärjekord

    Pärast andmebaasi commitit pannakse iga aktiivse sihtkeele kohta järjekorda töö päringupõhise ID-ga. Kui järjekorda panemine ebaõnnestub, logitakse ainult hoiatus ja commitit tagasi ei võeta (atomaarset outbox'i ei ole), mistõttu ongi olemas aegunud tööde kontroll.

  3. BullMQ · töö IDTööjärjekordKäivitus · hinnang: töö edastamineRealukk · katse kontrollTöö sisenemine

    BullMQ annab töö workerile asünkroonselt üle.

  4. Realukk · katse kontrollTöö sisenemineAndmed: edenemisridaMustand · edenemineTõlke olek

    Tehingu sees lukustatakse edenemisrida ja luuakse tõlke mustand. Juba lõpule viidud või mandaadi tõttu peatatud tööde automaatsed kordused jäetakse vahele; käsitsi päringuid käsitletakse eraldi.

  5. Realukk · katse kontrollTöö sisenemineKäivitus · hinnang: katse lubatudGenereerimine · mudelikutseTõlkekäik

    Katsete arv kasvab piiri piires ühe võrra ja seejärel algab tõlkekäik.

Genereerimine → verdikt → lõpuleviimine

Genereerimine ja verdikt kasutavad sama sõnastikku; tõlge ja verdikt salvestatakse eraldi ning kood koondab verdikti enne lõpuleviimist.

  1. Tööruumi sõnastikSõnastik · kontekstAndmed: sõnastikGenereerimine · mudelikutseTõlkekäik

    Tööruumi sõnastik ja kontekst otsitakse üles ning antakse genereerimisele.

  2. Tööruumi sõnastikSõnastik · kontekstAndmed: sama sõnastikKohtunikmudeli kutse · parsimineTõlkekäik

    Verdikt saab samad sõnastikupiirangud.

  3. Genereerimine · mudelikutseTõlkekäikAndmed: Tx1 · tõlgeTõlke · verdikti readTõlke olek

    Mudelit kutsutakse otse või en-US-pivoti kaudu ning kutse, sündmus ja edenemine kirjutatakse ühes tehingus. Kui töö käivitub pärast kokkujooksmist uuesti, võivad tõlkekutse ja selle kulu korduda.

  4. Kohtunikmudeli kutse · parsimineTõlkekäikAndmed: Tx2 · verdiktTõlke · verdikti readTõlke olek

    Kohtuniku skoorid ja tõendid lisatakse üks kord tõlke ja käigu kohta; duplikaat leiab olemasoleva rea ning viited kirjutatakse ainult esimesel lisamisel. See ei ole sama tehing mis tõlke puhul.

  5. Kohtunikmudeli kutse · parsimineTõlkekäikAndmed: skoorid · väravadKohustuslik värav · kaalutud keskmineVerdikti reeglid

    Kohtunikmudeli vastus parsitakse dimensioonipõhisteks skoorideks ja väravatulemusteks. Kas sõnastik läbiti, on see, mida kohtunikmudel raporteerib.

  6. Kohustuslik värav · kaalutud keskmineVerdikti reeglidKäivitus · hinnang: verdiktKäigud · kulu · kvootKordus · kulud

    Iga raporteeritud kohustusliku värava tõrge tähendab nulli ja läbikukkumist; alles siis rakendatakse kaalutud keskmist ja dimensioonipõhiseid lävendeid. Üldlävend 8.0 on konfiguratsiooni vaikeväärtus, mitte vaadeldud tõlkekvaliteet.

  7. Käigud · kulu · kvootKordus · kuludKäivitus · hinnang: passLõplik tehingLõpuleviimine

    Läbinu viiakse lõpule olekuga translated.

  8. Lõplik tehingLõpuleviimineAndmed: lõplik kirjeOlek · kutselogiTõlke olek

    Kandidaat, olek, skoor ja käigud viiakse lõpule ning lõpetatud edenemine koos olekulogiga kirjutatakse ühes tehingus. Tõlge valmis-sündmus väljastatakse ainult oleku translated korral.

Kordus · kulupiirid

Läbimata tähendab uut käiku; piir tähendab inimese ülevaatust; kvoot või autentimine peatab kulud ja ootab, et operaator jätkaks.

  1. Kohustuslik värav · kaalutud keskmineVerdikti reeglidKäivitus · hinnang: verdiktKäigud · kulu · kvootKordus · kulud

    Iga raporteeritud kohustusliku värava tõrge tähendab nulli ja läbikukkumist; alles siis rakendatakse kaalutud keskmist ja dimensioonipõhiseid lävendeid. Üldlävend 8.0 on konfiguratsiooni vaikeväärtus, mitte vaadeldud tõlkekvaliteet.

  2. Käigud · kulu · kvootKordus · kuludKäivitus · hinnang: järgmine käikGenereerimine · mudelikutseTõlkekäik

    Läbimata tõlge genereeritakse uuesti koos eelmise tõlke ja kriitikaga. Ka kohustusliku värava tõrget võib enne korrata, selle asemel et see läheks otse inimesele.

  3. Käigud · kulu · kvootKordus · kuludKäivitus · hinnang: piir · katkestusInimese ülevaatus

    Kui käigud saavad otsa või kululagi saabub, viiakse töö lõpule olekuga needs_review. Lõpule viidud tähendab, et töötlus lõppes, mitte et inimene selle kinnitas.

  4. Käigud · kulu · kvootKordus · kuludTõrge · piirang: kvoot · autentimineMandaadi kontroll

    Kvoodi- või autentimissignaal peatab kulud ja seab oleku needs_credential. Automaatset üleminekut teisele kontole või mudelipakkujale ei ole. Edastusvead ilma peatamissignaalita lähevad tagasi BullMQ kordusse.

  5. Mandaadi kontrollKäivitus · hinnang: käsitsi jätkamineBullMQ · töö IDTööjärjekord

    Mandaadid üle kontrollinud operaator käivitab töö sõnaselgelt uuesti.

Aegunud tööde taastamine

Vanad mustandid jagatakse põhjuse järgi: järjekorrast puuduv pannakse uuesti järjekorda, katsed ammendanu läheb inimese otsustada.

  1. Mustand · edenemineTõlke olekVaatlus · aruanne: aegunud mustandÜle 10 min vanused mustandid · kuni 200Aegunud tööde kontroll

    Loetakse kuni 200 kandidaati, mis on olnud mustandid üle 10 minuti, vanimast alates. Päring ei võta lukku ning uuendused ja logimine käivad eraldi lausetena, seega ei kirjeldata seda võidujooksuvaba pakktöötlusena.

  2. Üle 10 min vanused mustandid · kuni 200Aegunud tööde kontrollKäivitus · hinnang: alla piiriJärjekorra oleku võrdlusJärjekorra kontroll

    Kui katseid on vähem kui piir (3), võrreldakse tööd järjekorra olekutega active, waiting, delayed ja prioritized. Koodis tuleb katsed ammendatud-haru enne seda järjekorra kontrolli.

  3. Järjekorra oleku võrdlusJärjekorra kontrollKäivitus · hinnang: uuesti järjekordaBullMQ · töö IDTööjärjekord

    Kui tööd järjekorras ei ole, pannakse see uuesti järjekorda. API kasutab päringu järelliitega ID-sid, kontroll aga otsib segmendi ja keele ID-d, seega ei kirjeldata seda kõigi pooleli olevate päringute vastendamisena.

  4. Üle 10 min vanused mustandid · kuni 200Aegunud tööde kontrollKäivitus · hinnang: tulemus olemasInimese ülevaatus

    Kui kõik 3 katset on kasutatud ja tõlketulemus on olemas, läheb töö olekusse needs_review.

  5. Üle 10 min vanused mustandid · kuni 200Aegunud tööde kontrollKäivitus · hinnang: tulemust poleMandaadi kontroll

    Kui kõik 3 katset on kasutatud ja tulemust pole, läheb töö olekusse needs_credential.

Kõik ühendused sama kaaluga. Vali voog, et tõsta esile ainult selle tee koos nummerdatud sammudega.

  • Pidevjoon · sisendi, tulemuste ja kirjete suund
  • Kriipsjoon · käivitus, hinnang, päring
  • Pikad punktid · vaatlus ja aruandlus, hinnangust eraldi
  • Lühikesed kriipsud · tõrge, peatumine, piirang
  • Paks must joon · valitud voog; numbrid näitavad järjekorda
  • Kast · koodi või oleku piir, nimi päises
  • Sisemine silt · selle piiri komponent
  • Punktiirjoonega kast · sellest piirist väljas
  • Oranž kontuur · koht, kus mudel otsustab
  • Genereerimine · kulud · lõpuleviimine
  • Sisenemine · verdikti reeglid · kontroll
  • Järjekord · olek · kirjed
  • Registreerimine · järjekorra kontroll

Joonistatud privaatsete teostus- ja arenduskirjete põhjal. Kliendiandmeid ja kooditeid ei näidata.

Üks kontrollring
26. mai 2026, üks arenduskeskkonna kontrollring: 200 kontrollitud, 106 olekumuutust, 2 uuesti järjekorda. Olekumuutus ei ole edukas tõlge ning 106 jaotust sihtolekute kaupa ei ole salvestatud.
Miks mitte täpselt üks kord
Kirjed kirjutatakse ilma duplikaatideta, kuid kui töö käivitub pärast kokkujooksmist uuesti, võivad mudelikutsed ja nende kulu korduda. Samaaegsuse piir on protsessipõhine, mitte kogu klastri ulatuses.
Verdikti ulatus
See, et keskmine ei saa sõnastiku tõrget katta, on koondamisreegel raporteeritud väravate üle. See ei tõenda, et iga keelatud termin leitakse või et kvaliteet on emakeelse tasemega.