
Cotton
Translation workflow
Genereeritud tõlgetest ülevaadatavad tulemused.
Mängudialoogi tõlketöövoog.
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
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.
Registreerimine → sisenemine
Järjekorda pärast andmebaasi commitit; worker lukustab rea, kontrollib katset ja loob mustandi.
Lähtetekst · sihtkeeledAndmed: lähtetekstJärjekorda pärast commitit
API · töö registreerimineLähtesegmendid ja projekti sihtkeeled salvestatakse andmebaasi. Kliendiandmeid ei näidata.
Järjekorda pärast commitit
API · töö registreerimineAndmed: pärast commititBullMQ · töö IDTööjärjekordPä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.
BullMQ · töö ID
TööjärjekordKäivitus · hinnang: töö edastamineRealukk · katse kontrollTöö sisenemineBullMQ annab töö workerile asünkroonselt üle.
Realukk · katse kontroll
Töö sisenemineAndmed: edenemisridaMustand · edenemineTõlke olekTehingu 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.
Realukk · katse kontroll
Töö sisenemineKäivitus · hinnang: katse lubatudGenereerimine · mudelikutseTõlkekäikKatsete 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.
Tööruumi sõnastik
Sõnastik · kontekstAndmed: sõnastikGenereerimine · mudelikutseTõlkekäikTööruumi sõnastik ja kontekst otsitakse üles ning antakse genereerimisele.
Tööruumi sõnastik
Sõnastik · kontekstAndmed: sama sõnastikKohtunikmudeli kutse · parsimineTõlkekäikVerdikt saab samad sõnastikupiirangud.
Genereerimine · mudelikutse
TõlkekäikAndmed: Tx1 · tõlgeTõlke · verdikti readTõlke olekMudelit 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.
Kohtunikmudeli kutse · parsimine
TõlkekäikAndmed: Tx2 · verdiktTõlke · verdikti readTõlke olekKohtuniku 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.
Kohtunikmudeli kutse · parsimine
TõlkekäikAndmed: skoorid · väravadKohustuslik värav · kaalutud keskmineVerdikti reeglidKohtunikmudeli vastus parsitakse dimensioonipõhisteks skoorideks ja väravatulemusteks. Kas sõnastik läbiti, on see, mida kohtunikmudel raporteerib.
Kohustuslik värav · kaalutud keskmine
Verdikti reeglidKäivitus · hinnang: verdiktKäigud · kulu · kvootKordus · kuludIga 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.
Käigud · kulu · kvoot
Kordus · kuludKäivitus · hinnang: passLõplik tehingLõpuleviimineLäbinu viiakse lõpule olekuga translated.
Lõplik tehing
LõpuleviimineAndmed: lõplik kirjeOlek · kutselogiTõlke olekKandidaat, 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.
Kohustuslik värav · kaalutud keskmine
Verdikti reeglidKäivitus · hinnang: verdiktKäigud · kulu · kvootKordus · kuludIga 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.
Käigud · kulu · kvoot
Kordus · kuludKäivitus · hinnang: järgmine käikGenereerimine · mudelikutseTõlkekäikLä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.
Käigud · kulu · kvoot
Kordus · kuludKäivitus · hinnang: piir · katkestusInimese ülevaatusKui 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.
Käigud · kulu · kvoot
Kordus · kuludTõrge · piirang: kvoot · autentimineMandaadi kontrollKvoodi- 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.
Mandaadi kontrollKäivitus · hinnang: käsitsi jätkamineBullMQ · töö ID
TööjärjekordMandaadid ü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.
Mustand · edenemine
Tõlke olekVaatlus · aruanne: aegunud mustandÜle 10 min vanused mustandid · kuni 200Aegunud tööde kontrollLoetakse 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.
Üle 10 min vanused mustandid · kuni 200
Aegunud tööde kontrollKäivitus · hinnang: alla piiriJärjekorra oleku võrdlusJärjekorra kontrollKui 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.
Järjekorra oleku võrdlus
Järjekorra kontrollKäivitus · hinnang: uuesti järjekordaBullMQ · töö IDTööjärjekordKui 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.
Üle 10 min vanused mustandid · kuni 200
Aegunud tööde kontrollKäivitus · hinnang: tulemus olemasInimese ülevaatusKui kõik 3 katset on kasutatud ja tõlketulemus on olemas, läheb töö olekusse needs_review.
Üle 10 min vanused mustandid · kuni 200
Aegunud tööde kontrollKäivitus · hinnang: tulemust poleMandaadi kontrollKui 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.