CLI референца¶

Co-op Translator инсталира следеће командне улазне тачке:

translate
evaluate
migrate-links
co-op-review
co-op-translator-mcp

Команде translate, evaluate, migrate-links и co-op-review прослеђују се преко co_op_translator.__main__, који одабира имплементацију команде на основу позваног имена скрипта. MCP сервер користи co_op_translator.mcp.server директно.

Ако се одлучујете између CLI, Python API и MCP, почните са Изаберите ваш радни ток.

Конзолни излаз¶

Интерактивни терминали користе Rich форматирање за заглавље команде, индикатор напретка и сажетке. CI и неинтерактивни излаз аутоматски прелазе на обичан текст.

Поставите CO_OP_TRANSLATOR_OUTPUT_STYLE=plain да приморате обичан излаз, или CO_OP_TRANSLATOR_OUTPUT_STYLE=rich да приморате Rich излаз. Поставите CO_OP_TRANSLATOR_NO_PROGRESS=1 да задржите сажетке уз потискивање живих трака напретка.

Користите translate --json-events progress.ndjson када други систем треба машински читљив напредак. CLI наставља да приказује људски оријентисан излаз, док NDJSON фајл прима верзионисане догађаје co-op.translation.event.v1 са стабилним пољима као што су type, stage_key, completed, total, и current_path.

Први кораци са CLI¶

Почните овде ако користите Co-op Translator из терминала:

Конфигуришите LLM провајдера како је описано у Конфигурација.
Изаберите тип садржаја који желите да преведете.
Прво покрените фокусирану команду, нпр. превод само Markdown датотека.
Користите --dry-run пре великих промена у репозиторијуму.
После превођења користите co-op-review да проверите структуру и свежину.

Циљ	Команда за почетак
Превод Markdown докумената	`translate -l "ko" -md`
Превод нотебука	`translate -l "ko" -nb`
Превод текста на сликама	`translate -l "ko" -img`
Преглед рада без уписивања фајлова	`translate -l "ko" -md --dry-run`
Преглед постојећих превода	`co-op-review -l "ko"`
Ажурирање линкова у нотебуцима и Markdown-у	`migrate-links -l "ko" --dry-run`
Изложите алате MCP клијенту	Конфигуришите MCP сервер уместо директног покретања CLI команди.

translate¶

Преводи Markdown датотеке, нотебуке и текст са слика у један или више циљних језика.

translate -l "ko ja fr"

Уобичајени примери¶

Преведите само Markdown:

translate -l "de" -md

Преведите само нотебуке:

translate -l "zh-CN" -nb

Преведите Markdown и слике:

translate -l "pt-BR" -md -img

Ажурирајте постојеће преводе брисањем и поновним креирањем:

translate -l "ko" -u

Покрените без интерактивних упита:

translate -l "ko ja" -md -y

Сачувајте логове:

translate -l "ko" -s

Запишите структуриране догађаје напретка:

translate -l "ko ja" -md --json-events progress.ndjson

Опције¶

Опција	Обавезно	Опис
`-l`, `--language-codes`	Да	Језичке шифре раздвојене размаком, као што су "es fr de", или "all".
`-r`, `--root-dir`	Не	Корен пројекта. По подразумеваној вредности је текући директоријум.
`-u`, `--update`	Не	Брише постојеће преводе за изабране језике и поново их креира.
`-img`, `--images`	Не	Преводи само фајлове са сликама.
`-md`, `--markdown`	Не	Преводи само Markdown датотеке.
`-nb`, `--notebook`	Не	Преводи само Jupyter notebook датотеке.
`-d`, `--debug`	Не	Укључи debug логовање у конзоли.
`-s`, `--save-logs`	Не	Сачувај DEBUG ниво логова у `<root-dir>/logs/`.
`--json-events`	Не	Записује машински читљиве догађаје напретка превођења у NDJSON формату.
`-x`, `--fix`	Не	Поново преводи Markdown фајлове са ниским поверењем на основу претходних резултата процене.
`-c`, `--min-confidence`	Не	Праг поверења за `--fix`. По подразумеваној вредности `0.7`.
`--add-disclaimer`, `--no-disclaimer`	Не	Додаје или потискује обавештења о машинском преводу. По подразумеваној вредности омогућено у CLI-ју.
`-f`, `--fast`	Не	Застарели брзи режим за слике.
`-y`, `--yes`	Не	Аутоматски потврђује упите, корисно у CI.
`--repo-url`	Не	URL репозиторијума који се користи у савету за sparse-checkout у табели језика у README-у.
`--migrate-language-folders`	Не	Преименује застареле алтернативне фасцикле, као `cn` или `tw`, у канонске BCP 47 фасцикле.
`--dry-run`	Не	Преглед миграције језичких фасцикли и процена превођења без уписивања фајлова.

Ако није наведен флаг типа, translate обрађује Markdown, нотебуке и слике. Превод слика захтева конфигурацију Azure AI Vision.

evaluate¶

Оцени квалитет преведеног Markdown-а за један језик.

Експериментално

evaluate је експерименталан. Може користити проверу квалитета засновану на правилима и на LLM-у, уписује резултате процене у метаподатке превода, а његов модел бодовања и руковaње метаподацима могу се променити.

evaluate -l "ko"

Уобичајени примери¶

Користите строжи праг за ниско поверење:

evaluate -l "es" -c 0.8

Покрените само проверу засновану на правилима:

evaluate -l "fr" -f

Покрените само проверу засновану на LLM-у:

evaluate -l "ja" -D

Опције¶

Опција	Обавезно	Опис
`-l`, `--language-code`	Да	Једна језичка шифра која ће се процењивати. Алтернативне шифре се нормализују.
`-r`, `--root-dir`	Не	Корен пројекта. По подразумеваној вредности је текући директоријум.
`-c`, `--min-confidence`	Не	Праг који се користи при навођењу превода са ниским поверењем. По подразумеваној вредности `0.7`.
`-d`, `--debug`	Не	Укључи debug логовање.
`-s`, `--save-logs`	Не	Сачувај DEBUG ниво логова у `<root-dir>/logs/`.
`-f`, `--fast`	Не	Само процена заснована на правилима.
`-D`, `--deep`	Не	Само LLM-базирана процена.

По подразумеваној вредности, evaluate користи и процену засновану на правилима и LLM-базирану процену. Резултати се уписују у метаподатке превода и сумирају у конзоли.

co-op-review¶

Покрените детерминистичке провере одржавања превода без API акредитива.

Бета

co-op-review је бета детерминистичка команда за преглед. Не позива провајдере модела нити уписује фајлове, али њене провере и шема излаза за проблеме могу да еволуирају.

co-op-review -l "ko"

Уобичајени примери¶

Прегледајте корејске и јапанске преводе из текућег директоријума:

co-op-review -l "ko ja"

Прегледајте одређени корен пројекта:

co-op-review -l "fr" -r ./my-course

Прегледајте само README након превода само README-а:

translate -l "ko" --readme-only -y
co-op-review -l "ko" --readme-only --format github

--readme-only игнорише друге документе и угнежђене README-ове. Не успе ако корен README.md недостаје. У комбинацији са --changed-from, прегледа само README када је тај изворни фајл промењен. Превод само README-а оставља изворни README неизмењеним, укључујући и било које маркере за заједничке секције.

Прегледајте само изворне фајлове који су се променили у односу на базни реф:

co-op-review -l "ko" --changed-from origin/main

Штампајте Markdown у GitHub формату за CI сажетке:

co-op-review -l "ko ja" --changed-from origin/main --format github

Опције¶

Опција	Обавезно	Опис
`-l`, `--language-code`	Не	Језичка шифра за преглед. Може бити прослеђена више пута или као вредност раздвојена размаком. По подразумеваној вредности сви откривени језици превода.
`-r`, `--root-dir`	Не	Корен пројекта. По подразумеваној вредности је текући директоријум.
`--changed-from`	Не	Git ref који се користи да ограничи преглед на променљиве изворне фајлове.
`--readme-only`	Не	Преглед само коренског `README.md` превода.
`--format`	Не	Формат излаза: `text` или `github`. По подразумеваној вредности `text`.

co-op-review тренутно проверава: недостајуће преведене фајлове, недостајуће или застареле метаподатке превода, интегритет frontmatter-а и code-fence-ова у Markdown-у, невалидан преведени notebook JSON и недостајуће локалне циљеве за Markdown или image линкове. Недостајући линкови су по подразумеваној вредности упозорења; структурни проблеми и проблеми свежине доводе до неуспеха команде.

co-op-translator-mcp¶

Покрените Co-op Translator MCP сервер за агенте, уреднике и MCP-компатибилне клијенте.

co-op-translator-mcp

Подразумевани транспорт је stdio. Погледајте водич MCP сервер за конфигурацију клијента, алате, ресурсе и безбедносне напомене.

Опције¶

Опција	Обавезно	Опис
`--transport`	Не	MCP транспорт: `stdio`, `streamable-http`, или `sse`. По подразумеваној вредности `stdio`.

migrate-links¶

Поново обради преведене Markdown фајлове и ажурирај notebook линкове тако да упућују на преведене нотебуке када су доступни.

migrate-links -l "ko ja"

Уобичајени примери¶

Преглед измена линкова:

migrate-links -l "ko" --dry-run

Обрада свих подржаних језика без потврде:

migrate-links -l "all" -y

Поново пиши линкове само када постоје преведени нотебуци:

migrate-links -l "ko" --no-fallback-to-original

Опције¶

Опција	Обавезно	Опис
`-l`, `--language-codes`	Да	Језичке шифре раздвојене размаком, или "all".
`-r`, `--root-dir`	Не	Корен пројекта. По подразумеваној вредности је текући директоријум.
`--image-dir`	Не	Директоријум за преведене слике релативно у односу на корен. По подразумеваној вредности `translated_images`.
`--dry-run`	Не	Прикажите фајлове који би се променили без уписивања ажурирања.
`--fallback-to-original`, `--no-fallback-to-original`	Не	Користи оригиналне notebook линкове када недостају преведени нотебуци. По подразумеваној вредности омогућено.
`-d`, `--debug`	Не	Укључи debug логовање.
`-s`, `--save-logs`	Не	Сачувај DEBUG ниво логова у `<root-dir>/logs/`.
`-y`, `--yes`	Не	Аутоматски потврђује упите када се обрађују сви језици.

Окружење¶

Када команда захтева акредитиве провајдера, конфигуришите један од ових скупова провајдера. translate --dry-run и co-op-review не захтевају акредитиве провајдера:

# Azure OpenAI
AZURE_OPENAI_API_KEY="..."
AZURE_OPENAI_ENDPOINT="https://<resource>.openai.azure.com/"
AZURE_OPENAI_MODEL_NAME="gpt-4o"
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME="<deployment>"
AZURE_OPENAI_API_VERSION="2024-12-01-preview"

# Или OpenAI
OPENAI_API_KEY="..."
OPENAI_CHAT_MODEL_ID="gpt-4o"

# Или Anthropic
ANTHROPIC_API_KEY="..."
ANTHROPIC_MODEL="claude-..."

Превод слика додатно захтева Azure AI Vision:

AZURE_AI_SERVICE_API_KEY="..."
AZURE_AI_SERVICE_ENDPOINT="https://<resource>.cognitiveservices.azure.com/"

Структура излаза¶

Текстуални преводи се уписују у:

translations/<language-code>/<original-path>

Преведени излаз слика се уписује у:

translated_images/<language-code>/<original-path>

На пример, превођење README.md и docs/setup.md на корејски даје:

translations/ko/README.md
translations/ko/docs/setup.md

Примери CLI команда за копирање и лепљење¶

Преведите Markdown на три језика:

translate -l "ko ja fr" -md

Преведите само нотебуке:

translate -l "zh-CN" -nb

Преведите само слике:

translate -l "pt-BR" -img

Преглед превода Markdown-а без уписивања фајлова:

translate -l "de es" -md --dry-run

Поправите преводе Markdown-а са ниским поверењем:

evaluate -l "ko" -c 0.8
translate -l "ko" --fix -c 0.8 -md

Покрените CI-пријатељски превод Markdown-а:

translate -l "ko ja" -md -y -s

Прегледајте преведени излаз:

co-op-review -l "ko ja"

Преглед миграције линкова:

migrate-links -l "ko" --dry-run