AI-For-Beginners/translations/km/troubleshoot.md

មគ្គុទេសក៍ដោះស្រាយបញ្ហា AI-សម្រាប់អ្នកដំណើរកាត់ចាប់ផ្តើម

មគ្គុទេសក៍នេះជួយអ្នកដោះស្រាយបញ្ហាទូទៅដែលជួបប្រទៈពេលប្រើប្រាស់ ឬចូលរួមចំណែកក្នុងឃ្លាំង AI-For-Beginners។ បញ្ហា និងអ្វីដែលទៅជាមួយនឹងវារួមមាន ប្រែវត្ថុ, រលក្ខណៈ, សេចក្ដីពន្យល់ និងដំណោះស្រាយជាជំហ៊ាន។

---

តារាងមាតិកា

• បញ្ហាទូទៅ
• បញ្ហាក្នុងការដំឡើង
• បញ្ហាកំណត់រចនា
• ការប្រតិបត្តិលើកំណត់ត្រា
• បញ្ហាផ្នែកប្រសិទ្ធភាព
• បញ្ហាគេហទំព័រពុម្ពភាគ
• បញ្ហា​ចូលរួមធ្វើការ
• សំណួរញឹកញាប់
• ការទទួលជំនួយ

---

បញ្ហាទូទៅ

1. ឃ្លាំងមិនអាចកើនឡើងបានត្រឹមត្រូវ

ជំពូក៖ ការក្លូនអនុញ្ញាតឲ្យអ្នកចម្លងឃ្លាំងទៅកាន់ម៉ាស៊ីនរបស់អ្នក។

រោគសញ្ញា៖

• ព័តមានកំហុស៖ fatal: repository not found
• ព័តមានកំហុស៖ Permission denied (publickey)

មូលហេតុដែលអាចមាន៖

• អាសយដ្ឋាន URL របស់ឃ្លាំងមិនត្រឹមត្រូវ
• សិទ្ធិការអនុញ្ញាតមិនគ្រប់គ្រាន់
• កូនសោ SSH មិនបានកំណត់រចនា

ដំណោះស្រាយ៖

1. ពិនិត្យអាសយដ្ឋាន URL របស់ឃ្លាំង។
   ប្រើអាសយដ្ឋាន HTTPS៖

   git clone https://github.com/microsoft/AI-For-Beginners.git
   

2. ប្តូរទៅ HTTPS ប្រសិនបើ SSH បរាជ័យ។
   ប្រសិនបើអ្នកឃើញ Permission denied (publickey) សូមប្រើតំណ HTTPS ខាងលើជំនួស SSH ។
3. កំណត់រចនាកូនសោ SSH (មិនបាច់ធ្វើក៏បាន)។
   ប្រសិនបើអ្នកចង់ប្រើ SSH សូមអនុវត្តតាម មគ្គុទេសក៏នៃ SSH របស់ GitHub។

---

បញ្ហាក្នុងការដំឡើង

2. បញ្ហាបរិបទ Python

ជំពូក៖ ឃ្លាំងអាស្រ័យលើ Python និងបណ្ណាល័យគ្រប់យ៉ាង។

រោគសញ្ញា៖

• កំហុស៖ ModuleNotFoundError: No module named '<package>'
• កំហុសនាំចូលពេលរត់ script ឬ notebook

មូលហេតុដែលអាចមាន៖

• មិនបានដំឡើងទំនាក់ទំនង
• ជំរើស Python មិនត្រឹមត្រូវ

ដំណោះស្រាយ៖

1. បង្កើតបរិបទវីរុស។

   python -m venv venv
   source venv/bin/activate   # នៅលើ Windows: venv\Scripts\activate
   

2. ដំឡើងទំនាក់ទំនង។

   pip install -r requirements.txt
   

3. ពិនិត្យជំរើស Python។
   ប្រើ Python 3.7 ឬថ្មីជាង។

   python --version
   

3. Jupyter មិនបានដំឡើង

ជំពូក៖ កំណត់ត្រាគឺជាធនធានសិក្សាអគ្គិសនីសំខាន់មួយ។

រោគសញ្ញា៖

• កំហុស៖ jupyter: command not found
• កំណត់ត្រាបរាជ័យក្នុងការចាប់ផ្តើម

មូលហេតុដែលអាចមាន៖

• មិនបានដំឡើង Jupyter

ដំណោះស្រាយ៖

1. ដំឡើង Jupyter Notebook។

   pip install notebook
   

   ឬ ប្រសិនបើប្រើ Anaconda៖

   conda install notebook
   

2. ចាប់ផ្តើម Jupyter Notebook។

   jupyter notebook
   

4. ទំនាក់ទំនងជំនាន់បញ្ហា

ជំពូក៖ គម្រោងអាចខូចប៉ះពាល់ ប្រសិនបើជំនាន់កញ្ចប់មិនស្របគ្នា។

រោគសញ្ញា៖

• កំហុស ឬ ការព្រមានអំពីជំនាន់ដែលមិនបា្រក់គ្នា

មូលហេតុដែលអាចមាន៖

• កញ្ចប់ Python ចាស់ ឬ ប៉ះពាល់គ្នា

ដំណោះស្រាយ៖

1. ដំឡើងនៅក្នុងបរិបទស្អាត។
   លុបបរិបទ venv/conda ចាស់ ហើយបង្កើតថ្មី។
2. ប្រើជំនាន់ត្រឹមត្រូវ។
   ជានិច្ចបញ្ចូល:

   pip install -r requirements.txt
   

   ប្រសិនបើបរាជ័យនេះ សូមដំឡើងកញ្ចប់ខ្វះដូចបានពណ៌នា​នៅ README ។

---

បញ្ហាកំណត់រចនា

5. ព្រំដែនបរិបទមិនបានកំណត់

ជំពូក៖ ម៉ូឌុលមួយចំនួនប្រហែលត្រូវការកូនសោ ស្លាក ឬការកំណត់រចនា។

រោគសញ្ញា៖

• កំហុស៖ KeyError ឬ ការព្រមានអំពីការខ្វះ config

មូលហេតុដែលអាចមាន៖

• មិនបានកំណត់ព្រំដែនបរិបទដែលត្រូវការ

ដំណោះស្រាយ៖

1. ពិនិត្យឯកសារ .env.example ឬឯកសារលាយៗ។
2. បង្កើតឯកសារ .env ហើយបំពេញតម្លៃដែលត្រូវការ។
3. ផ្ទុកឡើង Terminal ឬ IDE របស់អ្នកបន្ទាប់ពីកំណត់ environment variables។

---

ការប្រតិបត្ដិលើកំណត់ត្រា

6. កំណត់ត្រាមិនផ្ទុកឬមិនដំណើរការ

ជំពូក៖ កំណត់ត្រា Jupyter ត្រូវការការកំណត់រចនាឲ្យត្រឹមត្រូវ។

រោគសញ្ញា៖

• កំណត់ត្រាបរាជ័យក្នុងការចាប់ផ្តើម
• អន្ដរជាតិសម្រង់មិនបើកឡើងស្វ័យប្រវត្តិ

មូលហេតុដែលអាចមាន៖

• មិនបានដំឡើង Jupyter
• បញ្ហាការកំណត់រចនាក្នុងកម្មវិធីរុករក

ដំណោះស្រាយ៖

1. ដំឡើង Jupyter (មើលបញ្ហាក្នុងការដំឡើងខាងលើ)។
2. បើកកំណត់ត្រាដោយដៃ​។
   • ចម្លង URL ពី Terminal (ឧ. http://localhost:8888/?token=...) ហើយបិទវាទៅកម្មវិធីរុករក។

7. Kernel បែកបាក់ ឬ ហើយត្រូវបិទរយះពេលយូរ

ជំពូក៖ Kernel កំណត់ត្រាអាចបែកដោយសារកំណត់ធនធានឬកូដមានកំហុស។

រោគសញ្ញា៖

• Kernel ស្លាប់ ឬ ចាប់ផ្តើមឡើងវិញជាបន្តបន្ទាប់
• កំហុសចុះពីអង្គចងចាំ (out-of-memory)

មូលហេតុដែលអាចមាន៖

• ទិន្នន័យធំ
• កូដ ឬ កញ្ចប់មិនស្របគ្នា

ដំណោះស្រាយ៖

1. ចាប់ផ្តើម Kernel ថ្មី។
   ប្រើប៊ូតុង "Restart Kernel" នៅក្នុង Jupyter។
2. ពិនិត្យការប្រើប្រាស់អង្គចងចាំ។
   បិទកម្មវិធីដែលមិនបានប្រើ។
3. រត់កំណត់ត្រានៅលើវេទិកាបណ្តាញ។
   ប្រើ Google Colab ឬ Azure Notebooks។

---

បញ្ហាផ្នែកប្រសិទ្ធភាព

8. កំណត់ត្រារត់យឺត

ជំពូក៖ ភារកិច្ច AI មួយចំនួនតម្រូវឲ្យមានអង្គចងចាំ និង CPU ច្រើន។

រោគសញ្ញា៖

• រត់យឺត
• សំឡេងកង្ហារលេបក្តៅម៉ាស៊ីនកុំភ្លេច

មូលហេតុដែលអាចមាន៖

• ទិន្នន័យ ឬ ម៉ូឌែលធំ
• អង្គចងចាំក្នុងប្រព័ន្ធមានកំណត់

ដំណោះស្រាយ៖

1. ប្រើវេទិកាបណ្តាញ។
   • បញ្ចូលកំណត់ត្រាទៅ Colab ឬ Azure Notebooks។
2. កាត់បន្ថយទំហំទិន្នន័យ។
   • ប្រើទិន្នន័យគំរូសម្រាប់ហាត់ប្រាណ។
3. បិទកម្មវិធីមិនចាំបាច់។
   • ទទួលបាន RAM ល្អបំផុតសម្រាប់ប្រព័ន្ធ។

---

បញ្ហាគេហទំព័រពុម្ពភាគ

9. មាតិកាផ្សាប់មិនបានផ្ទុក

ជំពូក៖ សៀវភៅអេឡិចត្រូនិចបង្ហាញមេរៀន និងជំពូក។

រោគសញ្ញា៖

• មាតិកាយ៉ាងណាមួយ (ឧ. Transformers/BERT) ខ្វះ ឬ មិនបើកឡើង

បញ្ហាល្បី៖

• បញ្ហា #303: “18 Transformers. BERT. មិនអាចបើកបាននៅលើគេហទំព័រពុម្ពភាគ។” មានហេតុពីកំហុសឈ្មោះឯកសារ (READMEtransformers.md ជំនួសឲ្យ README.md)។

ដំណោះស្រាយ៖

1. ពិនិត្យកំហុសប្តូរឈ្មោះឯកសារ។
   ប្រសិនបើអ្នកជាអ្នកចូលរួម សូមធានាថាឯកសារជំពូកមានឈ្មោះជា README.md។
2. រាយការណ៍ឯកសារខ្វះ។
   បើកបញ្ហារបស់ GitHub ជាមួយឈ្មោះជំពូក និងព័ត៌មានកំហុស។

---

បញ្ហាចូលរួមធ្វើការ

10. PR មិនទទួល ឬ ការសាងសង់បរាជ័យ

ជំពូក៖ ការចូលរួមត្រូវតែឆ្លងកាត់ការធ្វើតេស្ដ និងអនុវត្តផែនការទាញយក។

រោគសញ្ញា៖

• ការស្នើប្រាក់ចូលRejected
• កំហុសក្នុង CI/CD pipeline

មូលហេតុដែលអាចមាន៖

• ទេស្ដបរាជ័យ
• មិនអនុវត្តតាមស្តង់ដារកូដ

ដំណោះស្រាយ៖

1. អានក្រុមប្រឹក្សាចូលរួម។
   • អនុវត្តតាម CONTRIBUTING.md របស់ឃ្លាំង។
2. ធ្វើតេស្ដក្នុងម៉ាស៊ីនមូលដ្ឋានមុនចុចបញ្ជូន។
3. ពិនិត្យច្បាប់ linting ឬតម្រូវការរចនា។

---

សំណួរញឹកញាប់

តើខ្ញុំអាចស្វែងរកជំនួយសម្រាប់ម៉ូឌុលជាក់លាក់នៅណា?

• ម៉ូឌុលនីមួយៗភាគច្រើនមាន README របស់វា។ ចាប់ផ្តើមនៅទីនោះសម្រាប់ការដំឡើង និងកំណត់ប្រើប្រាស់។

តើធ្វើដូចម្តេចដើម្បីរាយការណ៍កំហុស ឬស្នើសុំមុខងារថ្មី?

• បើកបញ្ហា GitHub ជាមួយការពិពណ៌នាស្រួលយល់ និងជំហ៊ានសម្រាប់បង្កើតតាម។

តើខ្ញុំអាចស្នើសុំជំនួយប្រសិនបើបញ្ហារបស់ខ្ញុំមិនមានក្នុងបញ្ជីទេ?

• បាន! ស្វែងរកបញ្ហាដែលមានជាមុនសិន ហើយប្រសិនបើមិនមានបញ្ហារបស់អ្នក សូមបង្កើតបញ្ហាថ្មី។

---

ការទទួលជំនួយ

• ពិនិត្យបញ្ហា៖ GitHub Issues
• សួរសំណួរ៖ ប្រើការពិភាក្សា GitHub ឬបើកបញ្ហា។
• សហគមន៍៖ មើលតំណភ្ជាប់ឃ្លាំងសម្រាប់ជម្រើសជជែក/វេទិកា។

---

បានបន្តបន្ទាប់ចុងក្រោយ៖ 2025-09-20

---

ការផ្សងព្រេង:
ឯកសារនេះបានបកប្រែដោយប្រើសេវាកម្មបកប្រែ AI Co-op Translator។ ខណៈពេលយើងខិតខំប្រឹងប្រែងដើម្បីភាពត្រឹមត្រូវ សូមពាក់ព័ន្ធថាបកប្រែដោយកម្មវិធីអាចមានខុសត្រូវ ឬកំហុសបាន។ ឯកសារដើមដែលនៅក្នុងភាសាគោលត្រូវបានទទួលស្គាល់ថាជាដើមឯកសារដែលមានសុពលភាព។ សម្រាប់ព័ត៌មានសំខាន់ ការបកប្រែដោយមនុស្សជំនាញគឺគួរឱ្យយកចិត្តទុកដាក់។ យើងមិនទទួលខុសត្រូវចំពោះការយល់មិនអាចកើតមាន ឬក៏ការបកប្រត្យាសខុសផ្សេងៗពីការប្រើប្រាស់បកប្រែនេះឡើយ។