Internasionalisasi Plugin Karyawan AI
Teks antarmuka pengelolaan dalam plugin karyawan AI harus mengikuti bahasa antarmuka saat ini. Tool dan Skill dapat menggunakan file locale milik plugin melalui introduction, sedangkan kolom profil karyawan AI ditangani dengan cara berbeda.
Konten yang perlu diinternasionalisasi
Biasanya, Anda perlu menginternasionalisasi teks yang ditampilkan kepada administrator atau pengguna:
introduction.titledanintroduction.aboutuntuk Toolintroduction.titledanintroduction.aboutuntuk Skill- Teks pada kartu frontend, modal, dan tombol tindakan
definition.name, definition.description, deskripsi schema, isi Skill, dan system prompt karyawan AI terutama ditujukan untuk model. Jangan mengubah nama stabil Tool atau isi workflow hanya untuk menerjemahkan antarmuka.
Menerjemahkan teks antarmuka pengelolaan Tool dan Skill
introduction pada Tool dapat menggunakan templat terjemahan {{t(...)}}:
Gunakan format yang sama pada frontmatter SKILLS.md milik Skill:
Nilai ns harus sama dengan namespace internasionalisasi yang benar-benar digunakan plugin.
Menambahkan file bahasa
File locale plugin disimpan di src/locale/. Gunakan key yang sama untuk setiap bahasa dan ubah hanya teks yang sesuai.
Menambahkan teks bahasa Inggris
Tambahkan konten berikut ke src/locale/en-US.json:
Menambahkan teks bahasa Tionghoa
Tambahkan konten berikut ke src/locale/zh-CN.json:
Batasan profil karyawan AI saat ini
Kolom nickname, position, bio, dan greeting pada profil karyawan AI tidak menggunakan mekanisme templat {{t(...)}} di atas. Saat runtime, karyawan bawaan saat ini menerjemahkan string mentah tersebut dalam namespace @nocobase/plugin-ai, sehingga plugin pihak ketiga tidak boleh menganggap namespace kustom akan berlaku secara otomatis.
Jika Anda tidak menambahkan logika pelokalan terpisah, pilih satu bahasa default untuk profil karyawan dan letakkan teks antarmuka Tool, Skill, serta interaksi frontend dalam file locale milik plugin.
Tautan terkait
- Pengembangan Plugin Karyawan AI — Kembali ke ikhtisar panduan pengembangan
- Mendefinisikan Tool Sisi Server — Menggunakan templat terjemahan pada pengantar Tool
- Mendefinisikan Skill — Menggunakan templat terjemahan pada frontmatter Skill
- Mendefinisikan Karyawan AI Bawaan — Mempelajari kolom profil karyawan
- Menambahkan Interaksi Frontend ke Tool — Menambahkan terjemahan antarmuka pada kartu dan modal frontend

