laravel ai translator

Kargnas/Laravel-ai-translator

เครื่องมือการแปลที่ใช้พลังงาน AI สำหรับไฟล์ภาษา Laravel

คุณสมบัติใหม่: สไตล์ภาษาที่กำหนดเอง

เราได้ขยายขีดความสามารถของเราด้วยการสนับสนุนสไตล์ภาษาที่กำหนดเองช่วยให้การแปลที่ไม่เหมือนใครและสร้างสรรค์ เรียนรู้เพิ่มเติมเกี่ยวกับสไตล์ภาษาที่กำหนดเอง

ภาพรวม

Laravel AI Translator เป็นเครื่องมือที่ทรงพลังที่ออกแบบมาเพื่อปรับปรุงกระบวนการโลคัลไลเซชันในโครงการ Laravel มันทำให้งานที่น่าเบื่อของการแปลสตริงในหลายภาษาใช้ประโยชน์จากโมเดล AI ขั้นสูงเพื่อให้การแปลที่มีคุณภาพสูงและรับรู้

ประโยชน์หลัก:

• การประหยัดเวลา: แปลไฟล์ภาษาทั้งหมดของคุณด้วยคำสั่งง่ายๆหนึ่งคำสั่ง
• AI-powered: ใช้โมเดลภาษาที่ทันสมัย ​​(GPT-4, GPT-4O, GPT-3.5, Claude) เพื่อคุณภาพการแปลที่เหนือกว่า
• การทำความเข้าใจบริบทอย่างชาญฉลาด: จับความแตกต่างคำศัพท์ทางเทคนิคและนิพจน์เฉพาะของลาเวลล์ได้อย่างถูกต้อง
• การรวมที่ไร้รอยต่อ: ทำงานภายในโครงสร้างโครงการ Laravel ที่มีอยู่ของคุณรักษาโครงสร้างไฟล์ภาษาที่ซับซ้อน

ไม่ว่าคุณจะทำงานในโครงการส่วนบุคคลหรือแอปพลิเคชันขนาดใหญ่ Laravel AI นักแปลช่วยลดความซับซ้อนของกระบวนการสากลทำให้คุณสามารถมุ่งเน้นไปที่การสร้างคุณสมบัติที่ยอดเยี่ยมแทนที่จะเป็นมวยปล้ำด้วยการแปล

คุณสมบัติที่สำคัญ

• ตรวจจับโฟลเดอร์ภาษาทั้งหมดในไดเรกทอรี lang ของคุณโดยอัตโนมัติ
• แปลไฟล์ภาษา PHP จากภาษาต้นทาง (ค่าเริ่มต้น: ภาษาอังกฤษ) เป็นภาษาอื่น ๆ ทั้งหมด
• รองรับผู้ให้บริการ AI หลายรายสำหรับการแปลที่ชาญฉลาดและรับรู้บริบท
• เก็บรักษาตัวแปรแท็ก HTML รหัสพหุภาคีและโครงสร้างซ้อนกัน
• รักษาโทนเสียงและสไตล์ที่สอดคล้องกันในการแปล
• รองรับกฎการแปลที่กำหนดเองเพื่อเพิ่มคุณภาพและข้อกำหนดเฉพาะของโครงการ
• ประมวลผลไฟล์ภาษาขนาดใหญ่ประหยัดเวลาและความพยายามอย่างมีประสิทธิภาพ
• เคารพระบบการแปลของ Laravel เพื่อให้มั่นใจว่าเข้ากันได้กับการตั้งค่าที่มีอยู่ของคุณ
• ฟังก์ชั่น chunking สำหรับการแปลที่ประหยัดต้นทุน: ประมวลผลหลายสตริงในคำขอ AI เดียวลดต้นทุน API อย่างมีนัยสำคัญและการปรับปรุงประสิทธิภาพ
• การตรวจสอบความถูกต้องของสตริงเพื่อให้แน่ใจว่ามีความแม่นยำในการแปล: ตรวจสอบและตรวจสอบการแปล AI โดยอัตโนมัติเพื่อจับและแก้ไขข้อผิดพลาดหรือการแปลผิด ๆ

นอกจากนี้เครื่องมือนี้ได้รับการออกแบบมาเพื่อแปลไฟล์ภาษาของคุณอย่างชาญฉลาด:

• ความเข้าใจในบริบท: วิเคราะห์คีย์เพื่อพิจารณาว่าพวกเขาเป็นตัวแทนของปุ่มคำอธิบายหรือองค์ประกอบ UI อื่น ๆ หรือไม่
• ความแม่นยำทางภาษา: รักษารูปแบบคำกาลและเครื่องหมายวรรคตอนในการแปล
• การจัดการตัวแปร: เคารพและรักษาตัวแปรไฟล์ภาษาของคุณในระหว่างการแปล
• การปรับความยาวอัจฉริยะ: ปรับความยาวการแปลให้พอดีกับข้อ จำกัด UI ที่เป็นไปได้
• ความสอดคล้องของเสียง: รักษาโทนเสียงที่สอดคล้องกันในการแปล, ปรับแต่งได้ผ่านการกำหนดค่า

คุณต้องการทราบว่ามันทำงานอย่างไร? ดูพรอมต์ใน src/AI

รูปแบบภาษาที่กำหนดเอง

นอกเหนือจากการแปลภาษามาตรฐานแล้วแพ็คเกจนี้ยังรองรับสไตล์ภาษาที่กำหนดเองซึ่งช่วยให้มีการแปลที่ไม่ซ้ำกันและสร้างสรรค์

สไตล์ในตัว

แพ็คเกจประกอบด้วยรูปแบบภาษาในตัวหลายรูปแบบ:

• ko_kp : เกาหลีสไตล์เกาหลีเหนือ
• ภาษาถิ่นและภาษาต่าง ๆ ในภูมิภาคต่างๆ

สิ่งเหล่านี้จะพร้อมใช้งานโดยอัตโนมัติและไม่ต้องการการกำหนดค่าเพิ่มเติม

ตัวอย่างสไตล์ที่กำหนดเอง: Reddit English

เพื่อเป็นการสาธิตความสามารถในการจัดแต่งทรงผมที่กำหนดเองเราได้ใช้ภาษาอังกฤษ "Reddit Style":

สไตล์นี้เลียนแบบภาษาที่ไม่เป็นทางการมักจะพบใน Reddit ซึ่งมี:

• การใช้ถากถางอย่างเสรี
• อินเทอร์เน็ตสแลงและการอ้างอิง meme
• ความสงสัยขี้เล่น

ตัวอย่างการกำหนดค่า:

 ' locale_names ' => [
    ' en_reddit ' => ' English (Reddit) ' ,
],
' additional_rules ' => [
    ' en_reddit ' => [
        " - Incorporate sarcasm and exaggeration " ,
        " - Use popular internet slang and meme references " ,
        " - Add humorous calls for sources on obvious statements " ,
    ],
],

การสร้างสไตล์ที่กำหนดเอง

คุณสามารถสร้างรูปแบบภาษาที่กำหนดเองของคุณเองโดยเพิ่มรายการใหม่ไปยัง locale_names และ additional_rules ในการกำหนดค่า สิ่งนี้ช่วยให้คุณปรับการแปลให้กับผู้ชมหรือแพลตฟอร์มที่เฉพาะเจาะจง

สไตล์ที่กำหนดเองเหล่านี้นำเสนอวิธีที่สร้างสรรค์ในการปรับแต่งการแปลของคุณเพิ่มไหวพริบที่เป็นเอกลักษณ์ให้กับเนื้อหาที่มีการแปลของคุณ ใช้อย่างรับผิดชอบเพื่อเพิ่มความผูกพันของผู้ใช้ในขณะที่รักษาความชัดเจนและความเหมาะสมสำหรับผู้ชมของคุณ

ข้อกำหนดเบื้องต้น

• PHP 8.0 หรือสูงกว่า
• Laravel 8.0 หรือสูงกว่า

การติดตั้ง

1. ติดตั้งแพ็คเกจผ่านนักแต่งเพลง:

   composer require kargnas/laravel-ai-translator

2. เพิ่มคีย์ OpenAI API ลงในไฟล์ .env ของคุณ:

    OPENAI_API_KEY=your-openai-api-key-here
   

   คุณสามารถรับคีย์ API ได้จากเว็บไซต์ OpenAI

   (หากคุณต้องการใช้ Claude ของมานุษยวิทยาแทนดูขั้นตอนที่ 4 ด้านล่างสำหรับคำแนะนำการกำหนดค่า)

3. (ไม่บังคับ) เผยแพร่ไฟล์การกำหนดค่า:

   php artisan vendor:publish --provider= " KargnasLaravelAiTranslatorServiceProvider "

   ขั้นตอนนี้เป็นทางเลือก แต่แนะนำหากคุณต้องการปรับแต่งพฤติกรรมของแพ็คเกจ มันจะสร้างไฟล์ config/ai-translator.php ที่คุณสามารถแก้ไขการตั้งค่าต่างๆ

4. (ไม่บังคับ) หากคุณต้องการใช้ Claude ของมนุษย์แทน GPT ของ OpenAI ให้อัปเดตไฟล์ config/ai-translator.php :

    ' ai ' => [
       ' provider ' => ' anthropic ' ,
       ' model ' => ' claude-3-5-sonnet-20240620 ' ,
       ' api_key ' => env ( ' ANTHROPIC_API_KEY ' ),
   ],

   จากนั้นเพิ่มคีย์ API มานุษยวิทยาลงในไฟล์ .env ของคุณ:

    ANTHROPIC_API_KEY=your-anthropic-api-key-here
   

   คุณสามารถรับคีย์ API มานุษยวิทยาได้จากเว็บไซต์มานุษยวิทยา เพื่อผลลัพธ์ที่ดีที่สุดเราขอแนะนำให้ใช้โมเดล Claude-3-5-Sonnet สำหรับการแปลของคุณมากกว่า Openai GPT โมเดลนี้ให้การแปลที่แม่นยำและเป็นธรรมชาติมากขึ้น

5. ตอนนี้คุณพร้อมที่จะใช้นักแปล Laravel AI!

การใช้งาน

หากต้องการแปลไฟล์ภาษาของคุณให้เรียกใช้คำสั่งต่อไปนี้:

php artisan ai-translator:translate

คำสั่งนี้จะ:

1. รับรู้โฟลเดอร์ภาษาทั้งหมดในไดเรกทอรี lang ของคุณ
2. ใช้ AI เพื่อแปลเนื้อหาของไฟล์สตริงในภาษาต้นทางภาษาอังกฤษ (คุณสามารถเปลี่ยนภาษาต้นทางในไฟล์กำหนดค่า)

ตัวอย่าง

กำหนดไฟล์ภาษาอังกฤษ:

 <?php

return [
    ' notifications ' => [
        ' new_feature_search_sentence ' => ' New feature: Now you can type sentences not only words. Even in your languages. The AI will translate them to Chinese. ' ,
        ' refresh_after_1_min ' => ' Refresh after 1 minutes. New content will be available! (The previous model: :model, Updated: :updated_at) ' ,
    ]
];

แพ็คเกจจะสร้างการแปลเช่นนี้:

• เกาหลี (KO-KR):

   <?php
  return array (
    ' notifications.new_feature_search_sentence ' => ' 새로운 기능: 이제 단어뿐만 아니라 문장도 입력할 수 있어요. 심지어 여러분의 언어로도 가능해요. ' ,
    ' notifications.refresh_after_1_min ' => ' 1분 후에 새로고침하세요. 새로운 내용이 준비될 거예요! (이전 모델: :model, 업데이트: :updated_at) ' ,
  );

• ภาษาจีน (zh-cn):

   <?php
  return array (
    ' notifications.new_feature_search_sentence ' => '新功能：现在你不仅可以输入单词，还可以输入句子。甚至可以用你的语言。 ' ,
    ' notifications.refresh_after_1_min ' => ' 1分钟后刷新。新内容即将到来！（之前的模型：:model，更新时间：:updated_at） ' ,
  );

• ไทย (th-th):

   <?php
  return array (
    ' notifications.new_feature_search_sentence ' => ' ฟีเจอร์ใหม่: ตอนนี้คุณพิมพ์ประโยคได้แล้ว ไม่ใช่แค่คำเดียว แม้แต่ภาษาของคุณเอง ' ,
    ' notifications.refresh_after_1_min ' => ' รีเฟรชหลังจาก 1 นาที จะมีเนื้อหาใหม่ให้ดู! (โมเดลก่อนหน้า: :model, อัปเดตเมื่อ: :updated_at) ' ,
  );

• - เกาหลี (เกาหลีเหนือ):

   <?php
  return array (
    ' notifications.new_feature_search_sentence ' => ' 혁명적 새로운 기능: 동무들! 이제 단어뿐만 아니라 문장도 입력하여 단어의 력사를 확인할 수 있습니다. 모국어로도 괜찮습니다. 인공지능이 중국어로 번역해드리겠습니다. ' ,
    ' notifications.refresh_after_1_min ' => ' 1분후에 새로고침하십시요. 새로운 내용을 볼수 있습니다! (이전 모델: :model, 갱신: :updated_at) ' ,
  );

• - ภาษาอังกฤษ (Reddit):

   <?php
  return array (
    ' notifications.new_feature_search_sentence ' => ' Whoa, hold onto your keyboards, nerds! We ' ve leveled up our search game. Now you can type entire sentences, not just measly words. Mind. Blown. And get this - it even works in your weird non-English languages! Our AI overlord will graciously translate your gibberish into Chinese. You ' re welcome. ' ,
    ' notifications.refresh_after_1_min ' => ' Yo, hit that F5 in 60 seconds, fam. Fresh content incoming! (Previous model was :model, last updated when dinosaurs roamed the Earth at :updated_at) ' ,
  );

การกำหนดค่า

หากคุณต้องการปรับแต่งการตั้งค่าคุณสามารถเผยแพร่ไฟล์กำหนดค่า:

php artisan vendor:publish --provider= " KargnasLaravelAiTranslatorServiceProvider "

สิ่งนี้จะสร้างไฟล์ config/ai-translator.php ซึ่งคุณสามารถแก้ไขการตั้งค่าต่อไปนี้:

• source_directory : หากคุณใช้ไดเรกทอรีอื่นสำหรับไฟล์ภาษาแทนไดเรกทอรี lang เริ่มต้นคุณสามารถระบุได้ที่นี่

• ai : กำหนดค่ารหัสผู้ให้บริการ AI รุ่นและ API ที่นี่ นี่คือคำแนะนำของเราสำหรับรุ่นที่ดีที่สุด:

  ผู้ให้บริการ	แบบอย่าง	ค่าใช้จ่าย (I/O ต่อโทเค็น 1M)	descrpition
  มานุษยวิทยา	Claude-3-5-Sonnet-201240620	$ 3.00 / $ 15.00	คุณภาพที่ดีที่สุดช้าไปหน่อย เราแนะนำ
  มานุษยวิทยา	Claude-3-Haiku-201240307	$ 0.25 / $ 1.25	คุณภาพต่ำ แต่ดีกว่า GPT-3.5
  Openai	GPT-4O	$ 5.00 / $ 15.00	คุณภาพที่สมดุลและความเร็วสูง
  Openai	GPT-4O-MINI	$ 0.15 / $ 0.60	คุณภาพที่สมดุลและราคาถูก

  นี่คือรุ่นที่แนะนำซึ่งมีราคาแพงหรือมีคุณภาพต่ำ:

  ผู้ให้บริการ	แบบอย่าง	ค่าใช้จ่าย (I/O ต่อโทเค็น 1M)
  มานุษยวิทยา	Claude-3-Opus-201240229	$ 15.00 / $ 75.00
  มานุษยวิทยา	Claude-3-Sonnet-201240229	$ 3.00 / $ 15.00
  Openai	GPT-4-turbo	$ 10.0 / $ 30.0
  Openai	GPT-3.5-turbo	$ 0.50 / $ 1.50

• locale_names : การแมปรหัสสถานที่นี้กับชื่อภาษาช่วยเพิ่มคุณภาพการแปลโดยการให้บริบทกับ AI

• additional_rules : เพิ่มกฎที่กำหนดเองลงในพรอมต์การแปล สิ่งนี้มีประโยชน์สำหรับการปรับแต่งรูปแบบของข้อความหรือสร้างรูปแบบภาษาใหม่ทั้งหมด

ตัวอย่างการกำหนดค่า:

 <?php

return [
    ' source_directory ' => ' lang ' ,

    ' ai ' => [
        ' provider ' => ' openai ' , // or 'anthropic'
        ' model ' => ' gpt-4o ' , // or 'gpt-4', 'gpt-3.5-turbo', 'claude-3-5-sonnet-20240620'
        ' api_key ' => env ( ' OPENAI_API_KEY ' ), // or env('ANTHROPIC_API_KEY')
    ],

    ' locale_names ' => [
        ' en ' => ' English ' ,
        ' ko ' => ' Korean ' ,
        ' zh_cn ' => ' Chinese (Simplified) ' ,
        // ... other locales
    ],

    ' additional_rules ' => [
        ' default ' => [
            " Use a friendly and intuitive tone of voice, like the service tone of voice of 'Discord'. " ,
        ],
        ' ko ' => [
            " 한국의 인터넷 서비스 '토스'의 서비스 말투 처럼, 유저에게 친근하고 직관적인 말투로 설명하고 존댓말로 설명하세요. " ,
        ],
    ],
];

ตรวจสอบให้แน่ใจว่าได้ตั้งค่าคีย์ API ของผู้ให้บริการ AI ที่คุณเลือกไว้ในไฟล์ .env ของคุณ

ประเภทไฟล์ที่รองรับ

ปัจจุบันแพ็คเกจนี้รองรับไฟล์ภาษา PHP ที่ใช้โดย Laravel เท่านั้น ไม่รองรับไฟล์ภาษา JSON และไม่มีแผนที่จะเพิ่มการสนับสนุนสำหรับพวกเขาในอนาคต

ทำไมไฟล์ PHP เท่านั้น?

เราขอแนะนำให้ใช้ไฟล์ PHP สำหรับการจัดการการแปลโดยเฉพาะอย่างยิ่งเมื่อจัดการกับหลายภาษา นี่คือเหตุผล:

1. โครงสร้าง : ไฟล์ PHP อนุญาตให้มีโครงสร้างที่มีการจัดระเบียบมากขึ้นด้วยอาร์เรย์ซ้อนกันทำให้ง่ายต่อการจัดกลุ่มการแปลที่เกี่ยวข้อง

2. ความคิดเห็น : คุณสามารถเพิ่มความคิดเห็นในไฟล์ PHP เพื่อให้บริบทหรือคำแนะนำสำหรับนักแปล

3. ประสิทธิภาพ : ไฟล์ PHP นั้นเร็วขึ้นเล็กน้อยเมื่อเทียบกับไฟล์ JSON เนื่องจากไม่ต้องการการแยกวิเคราะห์

4. ความยืดหยุ่น : ไฟล์ PHP อนุญาตให้มีการทำงานที่ซับซ้อนมากขึ้นเช่นการใช้ตัวแปรหรือเงื่อนไขในการแปลของคุณ

5. ความสามารถในการปรับขนาด : เมื่อจัดการการแปลจำนวนมากในหลายภาษาโครงสร้างไดเรกทอรีของไฟล์ PHP จะทำให้ง่ายต่อการนำทางและบำรุงรักษา

หากคุณใช้ไฟล์ JSON สำหรับการแปลของคุณเราขอแนะนำให้ย้ายไปยังไฟล์ PHP เพื่อความเข้ากันได้ดีขึ้นกับแพ็คเกจนี้และปรับปรุงการจัดการการแปลของคุณ

บริการ AI

แพ็คเกจนี้รองรับทั้งรุ่น GPT ของ OpenAI และ Claude ของมานุษยวิทยาสำหรับการแปลแต่ละอันมีจุดแข็งของตัวเอง:

• Openai
• มานุษยวิทยา

รายการสิ่งที่ต้องทำ

เรากำลังทำงานอย่างต่อเนื่องเพื่อปรับปรุงนักแปล Laravel AI นี่คือคุณสมบัติและการปรับปรุงที่เรากำลังวางแผน:

• ใช้การตรวจสอบอย่างเข้มงวดสำหรับการแปล:
  • ตรวจสอบว่าตัวแปรได้รับการเก็บรักษาไว้อย่างถูกต้องในสตริงที่แปล
  • ตรวจสอบให้แน่ใจว่ามีการดูแลรักษาตัวยึดตำแหน่งและไวยากรณ์เฉพาะ Laravel
  • ตรวจสอบความสอดคล้องในกฎการพึ่งพหูพจน์ในการแปล
• เขียนรหัสทดสอบเพื่อให้แน่ใจว่าน่าเชื่อถือและจับปัญหาที่อาจเกิดขึ้น
• ใช้ฟังก์ชันการทำงานเพื่อรักษาโครงสร้างอาร์เรย์ของสตริงในระหว่างการแปล
• ขยายการสนับสนุนสำหรับ LLM อื่น ๆ (เช่นราศีเมถุน)

หากคุณต้องการมีส่วนร่วมในงานเหล่านี้โปรดส่งคำขอดึง!

การบริจาค

ยินดีต้อนรับ! โปรดส่งคำขอดึง

ใบอนุญาต

ใบอนุญาต MIT (MIT) โปรดดูไฟล์ใบอนุญาตสำหรับข้อมูลเพิ่มเติม

การให้เครดิต

• สร้างโดย Sangrak Choi
• แรงบันดาลใจจากการศึกษาภาษาจีนกลาง