Αναφορά 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__, το οποίο επιλέγει την υλοποίηση της εντολής βάσει του ονόματος του εκτελούμενου script. Ο διακομιστής 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	Αντί να εκτελέσετε εντολές CLI απευθείας, διαμορφώστε τον Διακομιστή MCP.

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`	Όχι	Ενεργοποιήστε την καταγραφή αποσφαλμάτωσης στην κονσόλα.
`-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, γράφει αποτελέσματα αξιολόγησης στα metadata της μετάφρασης, και το μοντέλο βαθμολόγησης και η συμπεριφορά των μεταδεδομένων μπορεί να αλλάξουν.

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`	Όχι	Ενεργοποιήστε καταγραφή αποσφαλμάτωσης.
`-s`, `--save-logs`	Όχι	Αποθήκευση αρχείων καταγραφής επιπέδου DEBUG κάτω από `<root-dir>/logs/`.
`-f`, `--fast`	Όχι	Μόνο αξιολόγηση βάσει κανόνων.
`-D`, `--deep`	Όχι	Μόνο αξιολόγηση βάσει LLM.

Από προεπιλογή, το evaluate χρησιμοποιεί τόσο αξιολόγηση βάσει κανόνων όσο και βάσει LLM. Τα αποτελέσματα γράφονται στα μεταδεδομένα μετάφρασης και συνοψίζονται στην κονσόλα.

co-op-review¶

Εκτελέστε ντετερμινιστικούς ελέγχους συντήρησης μετάφρασης χωρίς διαπιστευτήρια API.

Beta

co-op-review είναι μια beta ντετερμινιστική εντολή ελέγχου. Δεν καλεί παρόχους μοντέλων ούτε γράφει αρχεία, αλλά οι έλεγχοι της και το σχήμα εξόδου ζητημάτων ενδέχεται να εξελιχθούν.

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 αμετάβλητο, συμπεριλαμβανομένων τυχόν δεικτών κοινών τμημάτων.

Επανεξέταση μόνο των αρχείων πηγής που άλλαξαν σε σχέση με ένα βασικό ref:

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

Εκτύπωση εξόδου σε μορφή GitHub-flavored Markdown για συνοψίσεις 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 Markdown και φρακτών κώδικα, μη έγκυρο μεταφρασμένο JSON σημειωματάριων, και ελλείποντες τοπικούς στόχους συνδέσμων Markdown ή εικόνων. Οι ελλείποντες σύνδεσμοι είναι προειδοποιήσεις από προεπιλογή· προβλήματα δομής και επικαιρότητας αποτυγχάνουν την εντολή.

co-op-translator-mcp¶

Εκτελέστε τον διακομιστή Co-op Translator MCP για agents, editors και πελάτες συμβατούς με MCP.

co-op-translator-mcp

Ο προεπιλεγμένος μεταφορέας είναι stdio. Δείτε τον οδηγό Διακομιστής MCP για ρύθμιση πελατών, εργαλεία, πόρους και σημειώσεις ασφάλειας.

Επιλογές¶

Επιλογή	Απαιτείται	Περιγραφή
`--transport`	Όχι	MCP μεταφορά: `stdio`, `streamable-http`, ή `sse`. Προεπιλογή `stdio`.

migrate-links¶

Επεξεργαστείτε ξανά μεταφρασμένα αρχεία Markdown και ενημερώστε τους συνδέσμους των σημειωματάριων ώστε να δείχνουν σε μεταφρασμένα σημειωματάρια όταν αυτά είναι διαθέσιμα.

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`	Όχι	Χρησιμοποιήστε αρχικούς συνδέσμους σημειωματάριων όταν λείπουν μεταφρασμένα σημειωματάρια. Ενεργοποιημένο από προεπιλογή.
`-d`, `--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

Εκτέλεση μετάφρασης Markdown φιλικής για CI:

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

Επανεξέταση μεταφρασμένης εξόδου:

co-op-review -l "ko ja"

Προεπισκόπηση μετανάστευσης συνδέσμων:

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