Aliran kerja penyetempatan katalog produk
Updated 2026-09-05
Jana tampalan teks, kekalkan fakta produk dalam kod, kemudian semak maksudnya. Kes tempatan 20 produk menunjukkan bahawa 40 draf bahasa yang sah secara struktur masih boleh memerlukan pembetulan.
Bekukan sumber sebelum menterjemah
Eksport katalog dan kekalkan snapshot sumber yang tidak boleh diubah. Rekod asal, masa eksport dan semakan atau hash failnya. Berikan setiap varian identiti yang stabil dan semak pengecam yang hilang atau berganda sebelum mencipta tugasan bahasa. Simpan manifes pasangan produk-locale yang ingin anda proses.
Asingkan penyediaan sumber daripada terjemahan. Selesaikan ukuran yang bercanggah, unit yang tiada dan dakwaan yang tidak disokong bersama pemilik produk terlebih dahulu. Menormalkan eksport pembekal mungkin perlu; rekodkan pembetulan tersebut sebagai perubahan sumber dan minta pemilik meluluskan garis dasar yang terhasil sebelum kerja bahasa bermula.
Asingkan fakta dilindungi daripada teks boleh sunting
Cipta rekod dilindungi untuk SKU, harga, mata wang, unit, hubungan varian dan nilai operasi lain. Jana tampalan teks sahaja. Pada masa pemasangan, salin nilai dilindungi terus daripada sumber dan bandingkannya sekali lagi supaya model tidak menjadi pihak berkuasa untuk medan yang sekadar dilihatnya sebagai konteks.
Jadikan dakwaan boleh dijejaki juga. Pautkan pernyataan yang diluluskan kepada bukti dan arahkan langkah draf menandakan perkara yang tidak disokong. Konfigurasi berikut ialah dasar saluran paip ilustratif, bukan fail yang diterima oleh Shopify atau WooCommerce. Adapter anda mesti memetakannya kepada kontrak destinasi sebenar.
{
"identity": ["product_id", "variant_id", "locale"],
"protected": ["sku", "price_minor", "currency", "unit", "parent_id"],
"editable": ["title", "description", "care_text"],
"revisionInputs": ["source", "glossary", "prompt"],
"releaseRequires": ["field_checks", "fact_review", "language_review"],
"destinationWrite": "separate_authorization"
}Lampirkan glosari dan ringkasan locale
Ringkasan locale harus mengenal pasti khalayak, nada, istilah yang diluluskan dan peraturan persembahan. Asingkan konsep produk daripada ejaan pilihan. W3C ITS mentakrifkan istilah dan metadata terjemahan yang boleh memaklumkan sistem penyetempatan lebih kaya; aliran kerja ini menggunakan rekod editorial berversi yang lebih ringkas.
Selesaikan istilah samar dengan contoh daripada kategori sebenar. Jika entri glosari berubah, kenal pasti calon yang terjejas dan tentukan sama ada calon itu perlu dijana semula atau disunting secara bersasar. Kaitkan setiap locale dengan sumber diluluskan yang sama. Jangan biarkan satu versi terjemahan menjadi sumber perantaraan yang tidak disemak untuk locale lain.
Kes tempatan: 20 produk, 40 tampalan bahasa
Katalog beku yang mengandungi 20 produk sintetik diterjemahkan kepada 20 tampalan bahasa Jepun dan 20 bahasa Jerman oleh ejen terjemahan yang dikonfigurasi secara jelas untuk gpt-5.6-luna dengan penaakulan xhigh. Setiap tampalan hanya mengandungi sku, locale, title dan description. Assembler menyalin price, currency, material dan dimensions daripada source.json, jadi pemeliharaan fakta itu ialah sifat saluran paip dan bukannya tugas penyalinan yang diserahkan kepada model.
Fail validated-ja.json dan validated-de.json yang disimpan masing-masing mengandungi 20 baris dan senarai failures yang kosong. Pemasangan semula baca sahaja sepadan dengan kedua-dua output tersimpan. Gunakan corak ini dalam kelompok anda sendiri: kekalkan semakan sumber, simpan tampalan bahasa secara berasingan dan sahkan liputan serta medan yang dibenarkan sebelum memasang pakej semakan.

| Artifak kes | Hasil direkodkan | Keadaan semakan |
|---|---|---|
| source.json | 20 produk sintetik; semakan beku | Fakta lekapan berautoriti |
| validated-ja.json | 20 baris dipasang; 0 kegagalan struktur | Semakan semantik menunggu |
| validated-de.json | 20 baris dipasang; 0 kegagalan struktur | Semakan semantik menunggu |
| raw-ja.json | Tampalan Jepun asal dikekalkan | Sebelum dua pembetulan semakan AI |
Jalankan semakan tentu sebelum semakan editorial
Sahkan skema output, medan yang dibenarkan, pemetaan pengecam, semakan sumber, teks yang diperlukan dan nilai yang dilindungi. Bandingkan bilangan placeholder menggunakan tatabahasa templat sebenar aplikasi. Urai markup dan jangan gunakan penggantian teks umum pada HTML. Tahan rekod cacat dan jangan meminta pengimport membaikinya.
Untuk fail semakan hamparan, OWASP mendokumentasikan risiko suntikan formula dan ketiadaan transformasi CSV selamat yang universal. Gunakan dasar eksport yang disemak untuk alat hamparan terpilih dan asingkan artifak itu daripada import mesin. Menambah awalan escape untuk paparan manusia tidak boleh mengubah SKU secara tidak sengaja dalam payload kedai.
Ikat keputusan semakan pada semakan kandungan
Berikan fakta sumber, konteks glosari, calon dan isu berstruktur kepada penyemak. Minta keputusan fakta dan bahasa dibuat secara berasingan. Rekod siapa yang meluluskan kandungan dan semakan yang dilihatnya. Penyemak boleh menerima frasa setempat sambil menahan dakwaan yang memerlukan bukti; rekod harus menyatakan perbezaan itu.
Dalam kes tempatan, semakan AI membetulkan DEMO-003 Jepun daripada ungkapan yang membayangkan kadbod beralun kepada ungkapan yang selaras dengan lapisan kadbod dalam sumber. Ia juga menjelaskan DEMO-010 supaya bermaksud dua pemegang secara keseluruhan. Output asal kekal dalam raw-ja.json. Kedua-dua bahasa yang dipasang masih membawa review_status: unreviewed dan translation_semantic_review: pending: pembetulan ini bukan kelulusan penutur asli atau pedagang.
| Artifak | Tujuan | Mesti mengenal pasti |
|---|---|---|
| Snapshot sumber | Input berautoriti | Produk dan semakan sumber |
| Rekod calon | Teks setempat yang dicadangkan | Locale, percubaan dan glosari |
| Keputusan semakan | Kebenaran menggunakan calon itu | Penyemak dan semakan kandungan |
| Pakej import | Tampalan destinasi minimum yang diluluskan | Adapter dan medan sasaran |
| Laporan baca balik | Hasil tersimpan yang diperhatikan | ID destinasi dan perbezaan |
Pasang dan sahkan pakej destinasi
Pilih calon yang diluluskan dan semasa dengan sumber, kemudian ubah hanya medan yang dibenarkan. API terjemahan Shopify menggunakan kontrak resource dan digestnya; penggunaan WooCommerce memerlukan pemetaan produk dan, untuk berbilang bahasa, lapisan penyetempatan yang disahkan. Pakej semakan umum itu sendiri bukan import kedai universal.
Uji import kecil yang dibenarkan dalam staging. Simpan hasil pengimport, baca semula medan sasaran dan periksa tingkah laku produk serta locale. Selaraskan set produk yang dirancang dengan hasil tersimpan. Asingkan baris yang gagal dan kekalkan nilai terdahulu untuk pembalikan berskop teliti jika diperlukan.
Rekod hasil dan hadnya
Manifes yang lengkap harus memautkan sumber, glosari, prompt, calon, semakan, kelulusan dan hasil destinasi. Rekod penggunaan sebenar untuk setiap percubaan apabila bukti tersedia, termasuk percubaan semula. Kekalkan penggunaan yang hilang dan hasil semakan yang hilang sebagai tidak diketahui secara jelas. Fail yang boleh diurai bukan bukti bahawa kedai menerimanya.
Untuk kes tempatan berskop ini, model yang dipilih ialah Luna, bukan Astra, dan tiada panggilan get laluan atau import kedai sebenar. Penggunaan API, ID permintaan dan pengebilan tidak didedahkan; model_api_usage dan model_api_cost kekal null, bukan sifar. Langkah seterusnya ialah kelulusan semantik diikuti ujian destinasi yang dibenarkan secara berasingan.
Soalan lazim
Apakah artifak saluran paip minimum yang berguna?
Snapshot sumber yang dipautkan kepada calon, hasil pengesahan dan keputusan semakan untuk satu pasangan produk-locale. Rekod itu kemudiannya boleh dipetakan ke dalam tampalan destinasi yang disahkan.
Patutkah harga sumber dihantar melalui model?
Masukkan konteks yang diperlukan sahaja. Kekalkan harga berautoriti di luar output boleh sunting dan salin terus daripada sumber ketika memasang rekod yang mengandunginya.
Bagaimanakah saya menghalang terjemahan pendua?
Gunakan identiti produk-locale yang stabil bersama semakan sumber, glosari dan prompt. Kekalkan percubaan semula sebagai percubaan kerja yang dimaksudkan, bukan rekod baharu yang tidak berkaitan.
Bolehkah satu CSV digunakan untuk penyemak dan pengimport?
Utamakan artifak berasingan. Nota semakan dan transformasi keselamatan khusus hamparan boleh tidak sesuai untuk medan awam atau import mesin.
Adakah lulus pengesahan medan membuktikan kualiti terjemahan?
Tidak. Kes tempatan lulus semakan struktur untuk 40 baris yang dipasang, namun semakan AI menemui ungkapan Jepun yang perlu dibetulkan. Medan yang disalin daripada sumber kekal utuh sementara maksud penerangan masih memerlukan semakan.